aboutsummaryrefslogtreecommitdiffstats
path: root/man/prg2lout.txt
diff options
context:
space:
mode:
authorJeffrey H. Kingston <jeff@it.usyd.edu.au>2010-09-14 19:35:24 +0000
committerJeffrey H. Kingston <jeff@it.usyd.edu.au>2010-09-14 19:35:24 +0000
commitd4b68bb27f42afb8338f35f9fda0c467ec5d8787 (patch)
tree26e8947ef0a82e8150e46ebd0b257ec5cd13c0ed /man/prg2lout.txt
parent2c0ebbabd66ba21d3224bf58678bf62998b94c2c (diff)
downloadlout-d4b68bb27f42afb8338f35f9fda0c467ec5d8787.tar.gz
Lout 3.18.
git-svn-id: http://svn.savannah.nongnu.org/svn/lout/trunk@5 9365b830-b601-4143-9ba8-b4a8e2c3339c
Diffstat (limited to 'man/prg2lout.txt')
-rw-r--r--man/prg2lout.txt96
1 files changed, 96 insertions, 0 deletions
diff --git a/man/prg2lout.txt b/man/prg2lout.txt
new file mode 100644
index 0000000..991315d
--- /dev/null
+++ b/man/prg2lout.txt
@@ -0,0 +1,96 @@
+
+
+NAME
+ prg2lout - convert computer program text into Lout
+
+SYNOPSIS
+ prg2lout -l language [ options ] files...
+
+DESCRIPTION
+ Reformat computer program text for input to the Lout docu-
+ ment formatting system, taking care of comments, character
+ strings, tab characters, etc.
+
+ prg2lout reads the named program source files and produces
+ output suitable for input to lout -s. Thus,
+
+ prg2lout -l C foo.c | lout -s | lpr
+
+ will print the C program foo.c on a PostScript printer.
+ Each file will start on a new page, preceded by its name in
+ bold.
+
+OPTIONS
+ -llanguage
+ (Compulsory.) Files are written in this programmming
+ language. Run prg2lout -u to see the list of languages
+ available.
+
+ -pfixed
+ Use a fixed width font (the default for C).
+
+ -pvarying
+ Use a varying-width italic font with non-italic bold
+ keywords (the default for Eiffel).
+
+ -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 source 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, prg2lout simulates tabs with
+ spaces. With this option, prg2lout 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 follow-
+ ing 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, including available
+ languages, and exit.
+
+ -V Print version information on stderr and exit.
+
+ Raw Mode
+ There is a raw mode usage of prg2lout invoked by a -r flag
+ (must be the first argument). This converts one program
+ file into Lout-readable source without any heading or trail-
+ ing information. Synopsis:
+
+ prg2lout -r -i infile -o out -e err -t num -T width
+
+ Users should never need this mode; it is invoked automati-
+ cally from within Lout by symbols supplied with the standard
+ configuration (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