LOUT(1)
NAME
lout - prepare Lout document for printing
SYNOPSIS
lout [ -s ] files
DESCRIPTION
Invoke the Basser Lout interpreter on the concatenation of
the named files, producing a PostScript file on standard
output suitable for printing on PostScript printers using
lpr(1). If no files are named, stdin is used instead.
The special file name - may be used to denote standard
input. There may be white space between flags like -i and
their associated <filename> or <dirname> values.
An optional .lt suffix may be used for Lout source and
include files. When invoking files ending in this suffix
the suffix may be omitted.
OPTIONS
-s Suppress all reading and writing of the
cross reference database; other databases
are not affected. Useful when many simple
documents that don't do any cross refer-
encing are stored in one directory.
-EPS Produce output in the form of an EPS
(Encapsulated PostScript) file, suitable
for inclusion in another document.
-p Produce plain text output instead of
PostScript.
-P Like -p but with a form-feed character
between pages.
-S Safe execution: disable all calls to sys-
tem(3), instead echoing the commands that
would have been executed.
-e<filename> Direct error messages to <filename>
instead of to stderr.
-o<filename> Direct PostScript output to <filename>
instead of to stdout.
-i<filename> Search the directories of the include file
path (see below) for <filename> or <file-
name>.lt and include it. There may be
multiple -i options.
-I<dirname> Add <dirname> to the list of directories
searched for @Include files and -i option
files. There may be multiple -I options.
@Include first searches the current direc-
tory, then searches the -I directories in
the order given, and finally searches the
default include file directory (see
below). @SysInclude and the -i option
omit the search of the current directory.
-C<dirname> Add <dirname> to the list of directories
searched for Lout character mapping (.LCM)
files. There may be multiple -C options;
the directories are searched in the order
given, and finally the default character
mappings directory is searched (see
below).
-F<dirname> Add <dirname> to the list of directories
searched for font metrics (formerly .AFM)
files. There may be multiple -F options;
the directories are searched in the order
given, and finally the default font met-
rics directory is searched (see below).
-H<dirname> Add <dirname> to the list of directories
searched for hyphenation patterns files,
both unpacked (.lh) and packed (.lp).
There may be multiple -H options; the
directories are searched in the order
given, and finally the default hyphenation
directory is searched (see below).
-D<dirname> Add <dirname> to the list of directories
searched for Lout database files. There
may be multiple -D options. @Database
searches the current directory, then the
-D directories in the order given, and
finally searches the default databases
directory (see below). @SysDatabase omits
the search of the current directory.
--<opt>{<val>} Set setup file <opt> to <val>, overriding
any value assigned to <opt> in the setup
file. For example, --@PageType{Letter}
will set the @PageType setup file option
to Letter. The value may be a sequence of
words but not an arbitrary Lout object.
If there are spaces you must ensure that
it is passed to Lout as a single option;
the usual way to do this is to enclose it
in quotes.
-x Initializing run, not for ordinary use:
read and check all font files mentioned in
font definitions, read and check all
hyphenation files mentioned in language
definitions and build compressed versions,
read and check all database files men-
tioned in database clauses and build index
files.
-u Print usage information on stderr.
-V Print version information on stderr.
FILES
Binary file: /usr/bin/lout
Default include file directory: /usr/lib/lout/include
Default databases directory: /usr/lib/lout/data
Default font metrics directory: /usr/lib/lout/font
Default hyphenation directory: /usr/lib/lout/hyph
Default character mappings dir.: /usr/lib/lout/maps
Lout documentation directory: /usr/doc/lout
SEE ALSO
c2lout(1) lpr(1) ghostview(1)
MAILING LIST
A public mailing list for discussion of Lout exists. To
subscribe, mail lout-request@niif.spb.su with the word
subscribe in the Subject line, then wait one working day.
To post an item, mail it to lout@niif.spb.su.
REFERENCES
Jeffrey H. Kingston, "A User's Guide to the Lout Document
Formatting System," and "An Expert's Guide to the Lout
Document Formatting System."
AUTHOR
Jeffrey H. Kingston