NAME

       nysynopt - tool to list contents of specialized-format patches

SYNOPSIS

       nysynopt pam options cradle [ print ] [ .go ]

DESCRIPTION

       nysynopt  is  a  tool in the Nypatchy suite of programs for working with Patchy Master Files (PAM files);
       see nypatchy(1).  Like nylist, it can print a listing (including line numbers) of the contents  of  these
       files.   However, it permits fine-tuning of the output through the use of a cradle file whose syntax is a
       subset of the nypatchy instruction set.  It also expands sequences inline.

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.  cradle is the set of instructions for nysynopt.  If cradle is not given  (or  is
       replaced  with  "-"),  standard  input  is  assumed.   This  argument  may  also be replaced by the three
       characters "EOF" to indicate that there is no cradle.

       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.

       I      Line numbers for individual PAM files should each start at zero.

       M      Missing sequences should be signalled.

       S      Start each new deck on a new page.

       X      Do not signal actions.

       Y      Do not expand sequences called by +CDE.

       Z      Do not expand sequences called by +SEQ.

       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),  nylist(1),  nymerge(1),  nypatchy(1),  nyshell(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 "nysynopt 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                                       NYSYNOPT(1)