---
name: "c2lout"
section: "1"
platform: "linux"
package: "lout"
version: "3.12-0.1"
release: "Debian 2.2 (Potato)"
platforms: ["linux"]
url: "https://new.carta.tech/c2lout"
---

# c2lout(1)

convert C and C++ source code into Lout

## NAME

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

## SYNOPSIS

c2lout \[ options \] C-files

## DESCRIPTION

Reformat C and C++ source code for input to the Lout document 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 myprog.c \| lout -s \| lpr

will print myprog.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 symbols 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 programs.

- \-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 tabulation operators; \<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 \<width\> is sufficiently large. For example, -T0.5i produces half-inch tab intervals.

- \-u

  Print usage information on stderr.

- \-V

  Print version information on stderr.

## RAW MODE

There is a "raw mode" usage of c2lout invoked by a -r flag.  This converts one C file into Lout-readable source without any heading or trailing information.  Synopsis:

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

Users should never need this mode; it is invoked automatically from within Lout by the @CP symbol from the cprint package (see reference).

## SEE ALSO

[lout(1)](/lout/1.md), [lpr(1)](/lpr/1.md), ghostview(1)

## REFERENCES

Jeffrey H. Kingston, "A User's Guide to the Lout Document Formatting System", Chapter 11.

## AUTHOR

Jeffrey H. Kingston