PRG2LOUT(1) UNIX System V PRG2LOUT(1)
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
Page 1 (printed 6/9/00)
PRG2LOUT(1) UNIX System V PRG2LOUT(1)
baseline to baseline.
-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.
-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.
Page 2 (printed 6/9/00)
PRG2LOUT(1) UNIX System V PRG2LOUT(1)
AUTHOR
Jeffrey H. Kingston
Page 3 (printed 6/9/00)
