1NYSHELL(1) General Commands Manual NYSHELL(1)
2
3
4
6 nyshell - tool to generate shell scripts to build nypatchy output
7
9 nyshell logfile options cradle [ print ] [ .go ]
10
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
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
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
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
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
81NYSHELL(1) General Commands Manual NYSHELL(1)
82
83
84
86 nyshell - tool to generate shell scripts to build nypatchy output
87
89 nyshell logfile options cradle [ print ] [ .go ]
90
92 nyshell is a tool in the Nypatchy suite of programs for working with
93 Patchy Master Files (PAM files); see nypatchy(1). Specifically, given
94 the log file of a nypatchy run, it can create a shell script to compile
95 all the source code files output by nypatchy. This program is similar
96 to fcasplit except that it takes the log file as input instead of a
97 source file, and it remembers which source code files have already been
98 compiled in previous runs.
99
101 logfile is the name of the log file coming from nypatchy, with a
102 default extension of ".log". A cradle file cradle may be given to add
103 additional setup options such as desired compilers or compiler flags to
104 use. (See the reference manual for more details.) print is the file
105 to which informational output should be written (the default is stan‐
106 dard output if omitted), and options is a sequence of single-character
107 flags. This program generates a shell script file named name.shfca
108 (with name being the part of logfile sans extension) that can be run to
109 build all object files. The file name.xqtlog "remembers" the current
110 state.
111
112 The command should be ended with ".go" unless one wants to enter the
113 Nypatchy interactive shell.
114
116 Note that options should be given as a single string of characters with
117 no space separation and no use of the - character (except that it can
118 be used in place of the options field if no options are desired).
119 Alphabetic options are not case-sensitive.
120
121 A Force recompilation of all routines.
122
123 B Bypass tests based on the .xqtlog file.
124
125 E Bypass tests based on the .xqtlog file if it is empty.
126
127 H Print help information only.
128
129 Q "quick" - Do not print the setup.
130
131 S Print the setup only (only together with H).
132
133 U "up to date" - Check that all .o files are ready to go into a
134 library.
135
136 V "verbose" - Print the complete setup.
137
139 fcasplit(1), nycheck(1), nydiff(1), nyindex(1), nylist(1), nypatchy(1),
140 nymerge(1), nysynopt(1), nytidy(1), yexpand(1)
141
142 The reference manual for the Nypatchy suite of programs is available in
143 compressed PostScript format at the following URL:
144 http://wwwasdoc.web.cern.ch/wwwasdoc/psdir/p5refman.ps.gz
145
146 Running the command "nyshell help .no" also gives some brief help on
147 usage. Running the command "nyshell - hs .no" prints the default setup
148 (compiler names and options) to be used in the generated shell scripts.
149
151 This manual page was written by Kevin McCarty <kmccarty@debian.org> for
152 the Debian GNU/Linux system (but may be used by others). It is
153 licensed under the GNU General Public License, version 2 or later (at
154 your choice).
155
157 Copyright (C) Kevin B. McCarty, 2008.
158
159
160
161 Mar 12, 2008 NYSHELL(1)