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)