NAME

       lout - prepare Lout document for printing

SYNOPSIS

       lout [ options ] file...

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.  White space between  flags  and  their  associated  option
       values is optional.

       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

   Output
       -o filename
              Direct output to filename instead of to stdout.

       -e filename
              Direct error messages to filename instead of to stderr.

       -a     Use "filename:linenum:colnum:message" alternative error message format (useful with
              Emacs compilation mode and other tools).

   Output format
       -EPS   Produce  output  in the form of an EPS (Encapsulated PostScript) file, suitable for
              inclusion in another document.  Useful with stand-alone illustrations.

       -p     Produce plain text output instead of PostScript.

       -P     Like -p, but with a form-feed character between pages.

       -Z     Produce Adobe Portable Document Format (PDF) output.  This includes links, but  the
              more advanced graphics packages of Lout are not supported.

       -PDF   Synonym for -Z.

       -t     Ignore  texture-changing options; everything that would otherwise have been printed
              using a texture will be printed in solid colour.

   Cross-reference database
       -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
              referencing are stored in one directory.

       -l     Use ASCII order when sorting index entries etc.; the default depends on the COLLATE
              compilation option (use -V option to find out your default value).

       -L     Use your locale's order when sorting index entries etc.; the default depends on the
              COLLATE compilation option (use -V option to find out your default value).

   Execution of filters
       -S     Safe execution: disable all calls to system(3), instead echoing the  commands  that
              would  have  been  executed.   Although this makes the Lout run certainly safe, the
              PostScript output file may not be.

       -U     Unsafe execution: allow calls to system(3).  This is usually the default  behavior,
              but  it  is possible to make safe execution the default during installation (use -V
              option to find out whether this was done or not), hence the need for this flag.

   Changing document setup options
       --option{value}
              Set setup file option to value, overriding any value  assigned  to  option  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.

   Searching for files
       -i filename
              Search the directories of the  include  file  path  (see  below)  for  filename  or
              filename.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
              directory,  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 metrics 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.

   Miscellaneous options
       -r num Run Lout num times, producing output only on the last  run.   Useful  for  bringing
              cross references up to date quickly.

       -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
              mentioned in database clauses and build index files.

       -u     Print usage information on stderr and exit.

       -V     Print version information on stderr and exit.

       -M     Use less memory and run more slowly (the cross reference  database  index  will  be
              kept in a file rather than in memory).

       -w     Show the total number of non-empty words printed in the output file.  This includes
              words and numbers in page headers and footers; section numbers and  other  numbers;
              every  punctuation  character in a font different from its adjacent word; and every
              little fragment of every equation; so it will always somewhat overestimate the true
              number.

FILES AND ENVIRONMENT VARIABLE

       Default include file directory:   LOUTLIB/include
       Default databases directory:      LOUTLIB/data
       Default font metrics directory:   LOUTLIB/font
       Default hyphenation directory:    LOUTLIB/hyph
       Default character mappings dir.:  LOUTLIB/maps
       Default locales directory:        LOUTLIB/locale

       The  default  library  directory,  usually  /usr/local/lib/lout, can be changed by setting
       environment variable LOUTLIB to an alternative directory name.

SEE ALSO

       prg2lout(1), lpr(1), ghostview(1)

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

                                                                                          LOUT(1)