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
|
.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 \-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
.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
|
