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.

                                                  Mar 12, 2008                                       NYPATCHY(1)