NYDIFF(1) General Commands Manual NYDIFF(1)NAME
nydiff - tool to compare two versions of a specialized-format patch
SYNOPSIS
nydiff oldpam newpam name options [ print ] [ .go ]
DESCRIPTION
nydiff is a tool in the Nypatchy suite of programs for working with Patchy Master Files (PAM files); see nypatchy(1). Specifically, it
compares two different versions of the same PAM file and generates a "correction patch" that can be used by nypatchy to update the older
version to the newer version.
USAGE
The parameter oldpam is the name of the older version of the PAM file (a default extension of ".car" is assumed), newpam is the name of the
newer version, print is the output file to write to (the default is standard output if omitted), and options is a sequence of single-char-
acter flags. The parameter name is the name to be used for the correction file to be generated (the specific filename will be name.ucra
for a correction patch to be used by Nypatchy).
The command should be ended with ".go" unless one wants to enter the Nypatchy interactive shell.
OPTIONS
Note that options should be given as a single string of characters with no space separation and no use of the - character (except that it
can be used in place of the options field if no options are desired). Alphabetic options are not case-sensitive.
A "anyway" - Bypass the first sanity check on sufficient matching.
F "force" - Bypass the second sanity check on sufficient matching.
H Print help information only.
SEE ALSO fcasplit(1), nycheck(1), nyindex(1), nylist(1), nymerge(1), nypatchy(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 "nydiff 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.
Mar 12, 2008 NYDIFF(1)
Check Out this Related Man Page
NYPATCHY(1) General Commands Manual NYPATCHY(1)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 com-
mences 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.
Mar 12, 2008 NYPATCHY(1)