prg2lout - convert computer program text into Lout
prg2lout -l language [ options ] files...
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.
- -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.
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).
lout(1), lpr(1), ghostview(1).
Jeffrey H. Kingston, “A User's Guide to the Lout Document Formatting
System”, Chapter 11.