1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
.TH PRG2LOUT 1
.SH NAME
prg2lout - convert computer program text into Lout
.SH SYNOPSIS
\fBprg2lout\fR -l \fIlanguage\fR [ \fIoptions\fR ] \fIfiles\fR...
.SH DESCRIPTION
Reformat computer program text for input to the Lout document formatting
system, taking care of comments, character strings, tab characters, etc.
.LP
.B prg2lout
reads the named program source files and produces output
suitable for input to
.BR "lout -s" .
Thus,
.LP
.RS
.B "prg2lout -l C foo.c | lout -s | lpr"
.RE
.LP
will print the C program
.B foo.c
on a PostScript printer. Each file will start on a new page, preceded
by its name in bold.
.SH OPTIONS
.TP
.B \-llanguage
(Compulsory.) Files are written in this programmming language. Run
\fIprg2lout -u\fR to see the list of languages available.
.TP
.B \-pfixed
Use a fixed width font (the default for C).
.TP
.B \-pvarying
Use a varying-width italic font with non-italic bold keywords (the
default for Eiffel).
.TP
.B \-psymbol
Use a varying-width italic font with mathematical symbols and
non-italic bold keywords.
.TP
.B \-n
Do not print the file name before each source file.
.TP
.BI \-f " font"
Select a font family.
The default is
.B \-fCourier
for
.BR \-pfixed ,
and
.B \-fTimes
for
.B \-pvarying
and
.BR \-psymbol .
.TP
.BI \-s " size"
Select a Lout font size. The default is
.B -s9p
(meaning 9 points) for
.BR \-pfixed ,
and
.B \-s10p
for
.B \-pvarying
and
.BR \-psymbol .
These work well with 80-character-wide programs.
.TP
.BI \-v " vsize"
Select a Lout vertical inter-line gap. The default is
.B -v1.1fx
meaning 1.1 times the font size measured from baseline to baseline.
.TP
.BI \-b " num"
Select a blank line scale factor. The default is
.B -b1.0
meaning no scaling. A good alternative is 0.6.
.TP
.BI \-t " num"
Set the tab interval to
.I num
characters (default is
.BR \-t8 ).
.TP
.BI \-T " width"
Without this option,
.B prg2lout
simulates tabs with spaces. With this option,
.B prg2lout
simulates tabs with Lout tabulation operators;
.I 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
.I width
is sufficiently large. For example,
.B -T0.5i
produces half-inch tab intervals.
.TP
.BI \-L " number"
Attach line numbers to the program text, beginning with
.I 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.
.TP
.BI \-N
Do not print line numbers on blank lines.
.TP
.BI \-M
Like \-N but do not assign line numbers to blank lines.
.TP
.BI \-S " filename"
Use
.I 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
.I prg2lout
as command line arguments.
.TP
.B \-u
Print usage information on stderr, including available languages, and exit.
.TP
.B \-V
Print version information on stderr and exit.
.SS Raw Mode
There is a \(lq\&raw mode\(rq usage of
.B prg2lout
invoked by a
.B -r
flag (must be the first argument). This converts one program file into
Lout-readable source without any heading or trailing information.
Synopsis:
.LP
.RS
.B prg2lout
.B \-r
.BI \-i \ infile
.BI \-o \ out
.BI \-e \ err
.BI \-t \ num
.BI \-T \ width
.RE
.LP
Users should never need this mode; it is invoked automatically
from within Lout by symbols supplied with the standard configuration
(see reference).
.SH SEE ALSO
.BR lout (1),
.BR lpr (1),
.BR ghostview (1).
.SH REFERENCES
.LP
Jeffrey H. Kingston,
.I
\(lq\&A User's Guide to the Lout Document Formatting System\(rq\c
\&, Chapter 11.
.SH AUTHOR
.LP
Jeffrey H. Kingston
|
