aboutsummaryrefslogtreecommitdiffstats
path: root/man/c2lout.txt
blob: 47349d60bd61acf3f530173b1a4d5b4f1fb8ade6 (plain) (blame)
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



User Commands                                           C2LOUT(1)



NAME
     c2lout - convert C and C++ source code into Lout

SYNOPSIS
     c2lout [ options ] Cfiles...

DESCRIPTION
     Reformat C and C++ source code for input to the  Lout  docu-
     ment  formatting  system, taking care of comments, character
     strings, tab characters, etc.

     c2lout reads the named C and C++ files and  produces  output
     suitable for input to lout -s.  Thus,

          c2lout foo.c | lout -s | lpr

     will print foo.c on a PostScript printer.   Each  file  will
     start on a new page, preceded by its name in bold.

OPTIONS
     -pfixed
          Use a fixed width font (the default).

     -pvarying
          Use a varying-width italic font  with  non-italic  bold
          keywords.

     -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 C or C++ 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, c2lout simulates tabs with spaces.
          With this option, c2lout simulates tabs with Lout tabu-
          lation operators; width is the width of one tab  inter-
          val  in  the final print, measured in Lout units.  This
          guarantees alignment of characters following tabs  even
          with  varying-width  fonts,  provided  width  is suffi-
          ciently large.  For example, -T0.5i produces  half-inch
          tab intervals.

     -u   Print usage information on stderr and exit.

     -V   Print version information on stderr and exit.

  Raw Mode
     There is a raw mode usage of c2lout invoked  by  a  -r  flag
     (must be the first argument).  This converts one C file into
     Lout-readable source without any heading or trailing  infor-
     mation.  Synopsis:

          c2lout  -r  -i infile  -o outfile   -e errfile   -t num
          -T width

     Users should never need this mode; it is  invoked  automati-
     cally  from  within  Lout  by the @CP symbol from the cprint
     package (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