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)