1PRG2LOUT(1)                 General Commands Manual                PRG2LOUT(1)
2
3
4

NAME

6       prg2lout - convert computer program text into Lout
7

SYNOPSIS

9       prg2lout -l language [ options ] files...
10

DESCRIPTION

12       Reformat  computer  program text for input to the Lout document format‐
13       ting system, taking care of comments, character  strings,  tab  charac‐
14       ters, etc.
15
16       prg2lout reads the named program source files and produces output suit‐
17       able for input to lout -s.  Thus,
18
19              prg2lout -l C foo.c | lout -s | lpr
20
21       will print the C program foo.c on a PostScript printer.  Each file will
22       start on a new page, preceded by its name in bold.
23

OPTIONS

25       -llanguage
26              (Compulsory.)   Files are written in this programmming language.
27              Run prg2lout -u to see the list of languages available.
28
29       -pfixed
30              Use a fixed width font (the default for C).
31
32       -pvarying
33              Use a varying-width italic font with  non-italic  bold  keywords
34              (the default for Eiffel).
35
36       -psymbol
37              Use  a  varying-width  italic font with mathematical symbols and
38              non-italic bold keywords.
39
40       -n     Do not print the file name before each source file.
41
42       -f font
43              Select a font family.  The default is -fCourier for -pfixed, and
44              -fTimes for -pvarying and -psymbol.
45
46       -s size
47              Select a Lout font size.  The default is -s9p (meaning 9 points)
48              for -pfixed, and -s10p for -pvarying and -psymbol.   These  work
49              well with 80-character-wide programs.
50
51       -v vsize
52              Select  a  Lout vertical inter-line gap.  The default is -v1.1fx
53              meaning 1.1 times the font size measured from baseline to  base‐
54              line.
55
56       -b num Select  a blank line scale factor.  The default is -b1.0 meaning
57              no scaling.  A good alternative is 0.6.
58
59       -t num Set the tab interval to num characters (default is -t8).
60
61       -T width
62              Without this option, prg2lout simulates tabs with spaces.   With
63              this option, prg2lout simulates tabs with Lout tabulation opera‐
64              tors; width is the width of one tab interval in the final print,
65              measured in Lout units.  This guarantees alignment of characters
66              following tabs even with varying-width fonts, provided width  is
67              sufficiently  large.  For example, -T0.5i produces half-inch tab
68              intervals.
69
70       -L number
71              Attach line numbers to the program text, beginning  with  number
72              or  1 if number is not given.  You may need to give the 1 anyway
73              to prevent .I prg2lout from taking a following file  name  as  a
74              number.
75
76       -N     Do not print line numbers on blank lines.
77
78       -M     Like -N but do not assign line numbers to blank lines.
79
80       -S filename
81              Use  filename  as  the  setup file instead of the system default
82              setup file.  The setup file determines the value of all  format‐
83              ting options not given to prg2lout as command line arguments.
84
85       -u     Print  usage  information  on  stderr,  including available lan‐
86              guages, and exit.
87
88       -V     Print version information on stderr and exit.
89
90   Raw Mode
91       There is a “raw mode” usage of prg2lout invoked by a -r flag  (must  be
92       the first argument).  This converts one program file into Lout-readable
93       source without any heading or trailing information.  Synopsis:
94
95              prg2lout -r -i infile -o out -e err -t num -T width
96
97       Users should never need this mode; it  is  invoked  automatically  from
98       within  Lout  by  symbols supplied with the standard configuration (see
99       reference).
100

SEE ALSO

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

REFERENCES

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

AUTHOR

109       Jeffrey H. Kingston
110
111
112
113                                                                   PRG2LOUT(1)
Impressum