NAME

       prg2lout - convert computer program text into Lout

SYNOPSIS

       prg2lout -l language [ options ] files...

DESCRIPTION

       Reformat computer program text for input to the Lout document formatting system, taking care of comments,
       character strings, tab characters, etc.

       prg2lout reads the named program source files and produces output suitable for input to lout -s.  Thus,

              prg2lout -l C foo.c | lout -s | lpr

       will  print the C program foo.c on a PostScript printer.  Each file will start on a new page, preceded by
       its name in bold.

OPTIONS

       -llanguage
              (Compulsory.)  Files are written in this programmming language.  Run prg2lout -u to see  the  list
              of languages available.

       -pfixed
              Use a fixed width font (the default for C).

       -pvarying
              Use a varying-width italic font with non-italic bold keywords (the default for Eiffel).

       -psymbol
              Use a varying-width italic font with mathematical symbols and non-italic bold keywords.

       -n     Do not print the file name before each source file.

       -f font
              Select  a  font  family.   The  default  is  -fCourier  for -pfixed, and -fTimes for -pvarying and
              -psymbol.

       -s size
              Select a Lout font size.  The default is -s9p (meaning  9  points)  for  -pfixed,  and  -s10p  for
              -pvarying and -psymbol.  These work well with 80-character-wide programs.

       -v vsize
              Select  a  Lout  vertical  inter-line gap.  The default is -v1.1fx meaning 1.1 times the font size
              measured from baseline to baseline.

       -b num Select a blank line scale factor.  The default is -b1.0 meaning no scaling.  A good alternative is
              0.6.

       -t num Set the tab interval to num characters (default is -t8).

       -T width
              Without this option, prg2lout simulates tabs with spaces.  With this  option,  prg2lout  simulates
              tabs  with  Lout  tabulation operators; width is the width of one tab interval in the final print,
              measured in Lout units.  This guarantees alignment of characters following tabs even with varying-
              width fonts, provided width is sufficiently large.  For example,  -T0.5i  produces  half-inch  tab
              intervals.

       -L number
              Attach  line  numbers to the program text, beginning with number or 1 if number is not given.  You
              may need to give the 1 anyway to prevent .I prg2lout from  taking  a  following  file  name  as  a
              number.

       -N     Do not print line numbers on blank lines.

       -M     Like -N but do not assign line numbers to blank lines.

       -S filename
              Use  filename  as  the  setup  file  instead  of  the  system  default setup file.  The setup file
              determines the value of all formatting options not given to prg2lout as command line arguments.

       -u     Print usage information on stderr, including available languages, and exit.

       -V     Print version information on stderr and exit.

   Raw Mode
       There is a “raw mode” usage of prg2lout invoked by a -r flag (must be the first argument).  This converts
       one program file into Lout-readable source without any heading or trailing information.  Synopsis:

              prg2lout -r -i infile -o out -e err -t num -T width

       Users should never need this mode; it is invoked automatically from within Lout by symbols supplied  with
       the standard configuration (see reference).

SEE ALSO

       lout(1), lpr(1), ghostview(1).

REFERENCES

       Jeffrey H. Kingston, “A User's Guide to the Lout Document Formatting System”, Chapter 11.

AUTHOR

       Jeffrey H. Kingston

                                                                                                     PRG2LOUT(1)