NAME¶
nypatchy - tool to work with specialized-format patches
SYNOPSIS¶
nypatchy pam fort cradle print cc as data [
fort2 cc2 as2 data2
]
DESCRIPTION¶
nypatchy is a tool for working with Patchy Master Files (PAM files). A
PAM file is an ordinary text file (generally with a three-letter extension of
".car") that holds source code interleaved with special
pre-processing instructions for
nypatchy. The source code may be in C,
FORTRAN, assembly language, or a combination of these. The pre-processing
instructions allow one to maintain separate optional patches independently,
for instance in the case of architecture-specific code. Details of the
pre-processing commands used by
nypatchy are beyond the scope of this
man page; the reader should refer to the full manual available from CERN.
Telling
nypatchy which set of patches to use may be done on standard
input or via a so-called
cradle file. Typically the cradle file will
contain one or more +USE statements as well as +EXE and +QUIT, for instance in
the case of the isajet Monte Carlo generator:
+USE,*ISAJET
+EXE
+PAM
+QUIT
USAGE¶
In the command line shown above,
pam is the PAM file, if any.
fort
is the name of the primary output source code file, if any.
cradle is
the name of the cradle file, if any (default is standard input, for instance a
here-doc).
print is the name of the file to receive printed output (the
default is standard output).
cc,
as,
data are the names
of the source code output files for data types CC, AS, DATA. The remaining
parameters are the source code output files to receive diverted material for
respective data types FORT, CC, AS, DATA.
Parameters may be omitted by substituting a dash - for them. Trailing parameters
may be cut short by giving "." or ".go"; the latter
commences execution immediately rather than starting the
nypatchy
interactive prompt.
nypatchy will return to the shell a code of 0 if successful, 1 if there
is a warning, and 2 if an error occurs. Since the program stops creating
output, but continues to run (in order to check for further errors) if an
error occurs, the user should be sure to test the error code $? after any
nypatchy run.
EXAMPLES¶
- nypatchy -- xyz .go
- reads the cradle (instructions) from file xyz.cra, which must list
all other files to be used.
- nypatchy .go << EOF
- <cradle>
- EOF
-
has the cradle given as a here-document.
- nypatchy zebra.car zebra.fca zebra.cra zebra.lis .go
- reads the PAM file zebra.car, outputting the resulting source code to
zebra.fca, taking the cradle from zebra.cra, with printing done to
zebra.lis.
SEE ALSO¶
fcasplit(1),
nycheck(1),
nydiff(1),
nyindex(1),
nylist(1),
nymerge(1),
nyshell(1),
nysynopt(1),
nytidy(1),
yexpand(1)
The reference manual for the Nypatchy suite of programs is available in
compressed PostScript format at the following URL:
http://wwwasdoc.web.cern.ch/wwwasdoc/psdir/p5refman.ps.gz
Running the command "nypatchy help .no" also gives some brief help on
usage.
AUTHOR¶
This manual page was written by Kevin McCarty <kmccarty@debian.org> for
the Debian GNU/Linux system (but may be used by others). It is licensed under
the GNU General Public License, version 2 or later (at your choice).
COPYRIGHT¶
Copyright (C) Kevin B. McCarty, 2008.