nylist(1) [debian man page]

NYLIST(1)						      General Commands Manual							 NYLIST(1)

NAME

       nylist - tool to list contents of specialized-format patches

SYNOPSIS

       nylist pam options [ print ] [ .go ]

DESCRIPTION

       nylist is a tool in the Nypatchy suite of programs for working with Patchy Master Files (PAM files); see nypatchy(1).  Specifically, it can
       print a listing (including line numbers) of the contents of these files.

USAGE

       The parameter pam is the name of the PAM file (a default extension of ".car" is assumed), print is the output file to write to (the default
       is standard output if omitted), and options is a sequence of single-character flags.

       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.

       E      Page ejects forced in the PAM file with +SEQ,QEJECT are honored (only if the S option is also given).

       H      Print help information only.

       S      Start each new deck on a new page.

       n      For n a number from 0 to 4 inclusive, assume 58, 62, 74, 84, or 98 lines per page in the output.	(The  default  is  110	lines  per
	      page.)  For n a number greater than or equal to 20, use that specific number of lines per page.

       +      Inhibit the initial page-eject.

SEE ALSO

       fcasplit(1), nycheck(1), nydiff(1), nyindex(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 "nylist 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 							 NYLIST(1)

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)