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
|
.TH C2LOUT 1
.SH NAME
c2lout - convert C and C++ source code into Lout
.SH SYNOPSIS
\fBc2lout\fR [ \fIoptions\fR ] \fIC\(en\&files\fR...
.SH DESCRIPTION
Reformat C and C++ source code for input to the Lout document formatting
system, taking care of comments, character strings, tab characters, etc.
.LP
.B c2lout
reads the named C and C++ files and produces output
suitable for input to
.BR "lout -s" .
Thus,
.LP
.RS
.B "c2lout foo.c | lout -s | lpr"
.RE
.LP
will print
.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 \-pfixed
Use a fixed width font (the default).
.TP
.B \-pvarying
Use a varying-width italic font with non-italic bold keywords.
.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 C or C++ 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 c2lout
simulates tabs with spaces. With this option,
.B c2lout
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 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 c2lout
invoked by a
.B -r
flag (must be the first argument). This converts one C file into
Lout-readable source without any heading or trailing information.
Synopsis:
.LP
.RS
.B c2lout
.B \-r
.BI \-i \ infile
.BI \-o \ outfile
.BI \-e \ errfile
.BI \-t \ num
.BI \-T \ width
.RE
.LP
Users should never need this mode; it is invoked automatically
from within Lout by the
.B @CP
symbol from the
.B cprint
package (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
|
