1NYSHELL(1)                  General Commands Manual                 NYSHELL(1)
2
3
4

NAME

6       nyshell - tool to generate shell scripts to build nypatchy output
7

SYNOPSIS

9       nyshell logfile options cradle [ print ] [ .go ]
10

DESCRIPTION

12       nyshell  is  a  tool in the Nypatchy suite of programs for working with
13       Patchy Master Files (PAM files); see nypatchy(1).  Specifically,  given
14       the log file of a nypatchy run, it can create a shell script to compile
15       all the source code files output by nypatchy.  This program is  similar
16       to  fcasplit  except  that  it takes the log file as input instead of a
17       source file, and it remembers which source code files have already been
18       compiled in previous runs.
19

USAGE

21       logfile  is  the  name  of  the  log  file coming from nypatchy, with a
22       default extension of ".log".  A cradle file cradle may be given to  add
23       additional setup options such as desired compilers or compiler flags to
24       use.  (See the reference manual for more details.)  print is  the  file
25       to  which  informational output should be written (the default is stan‐
26       dard output if omitted), and options is a sequence of  single-character
27       flags.   This  program  generates  a shell script file named name.shfca
28       (with name being the part of logfile sans extension) that can be run to
29       build  all  object files.  The file name.xqtlog "remembers" the current
30       state.
31
32       The command should be ended with ".go" unless one wants  to  enter  the
33       Nypatchy interactive shell.
34

OPTIONS

36       Note that options should be given as a single string of characters with
37       no space separation and no use of the - character (except that  it  can
38       be  used  in  place  of  the  options field if no options are desired).
39       Alphabetic options are not case-sensitive.
40
41       A      Force recompilation of all routines.
42
43       B      Bypass tests based on the .xqtlog file.
44
45       E      Bypass tests based on the .xqtlog file if it is empty.
46
47       H      Print help information only.
48
49       Q      "quick" - Do not print the setup.
50
51       S      Print the setup only (only together with H).
52
53       U      "up to date" - Check that all .o files are ready to  go  into  a
54              library.
55
56       V      "verbose" - Print the complete setup.
57

SEE ALSO

59       fcasplit(1), nycheck(1), nydiff(1), nyindex(1), nylist(1), nypatchy(1),
60       nymerge(1), nysynopt(1), nytidy(1), yexpand(1)
61
62       The reference manual for the Nypatchy suite of programs is available in
63       compressed PostScript format at the following URL:
64       http://wwwasdoc.web.cern.ch/wwwasdoc/psdir/p5refman.ps.gz
65
66       Running  the  command  "nyshell help .no" also gives some brief help on
67       usage.  Running the command "nyshell - hs .no" prints the default setup
68       (compiler names and options) to be used in the generated shell scripts.
69

AUTHOR

71       This manual page was written by Kevin McCarty <kmccarty@debian.org> for
72       the Debian GNU/Linux system  (but  may  be  used  by  others).   It  is
73       licensed  under  the GNU General Public License, version 2 or later (at
74       your choice).
75

77       Copyright (C) Kevin B. McCarty, 2008.
78
79
80
81                                 Mar 12, 2008                       NYSHELL(1)
Impressum