blob: 991315ddcdab1fd026ff0958b96793e03dcf3d7d (
plain) (
tree)
|
|
NAME
prg2lout - convert computer program text into Lout
SYNOPSIS
prg2lout -l language [ options ] files...
DESCRIPTION
Reformat computer program text for input to the Lout docu-
ment 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 sym-
bols 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 pro-
grams.
-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.
-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 follow-
ing tabs even with varying-width fonts, provided width
is sufficiently large. For example, -T0.5i produces
half-inch tab intervals.
-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 trail-
ing information. Synopsis:
prg2lout -r -i infile -o out -e err -t num -T width
Users should never need this mode; it is invoked automati-
cally 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
|
