FreeBSD Manual Pages
LOUT(1) General Commands Manual LOUT(1) 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 in- cludes 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 data- base; 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 de- pends 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 de- fault 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 de- fault 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 charac- ter mapping (.LCM) files. There may be multiple -C options; the directories are searched in the order given, and finally the de- fault 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 de- fault 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 or- der given, and finally the default hyphenation directory is searched (see below). -D dirname Add dirname to the list of directories searched for Lout data- base 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 direc- tory (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. Use- ful 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 hyphen- ation files mentioned in language definitions and build com- pressed 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 data- base 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 foot- ers; section numbers and other numbers; every punctuation char- acter in a font different from its adjacent word; and every lit- tle fragment of every equation; so it will always somewhat over- estimate 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 di- rectory 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 Sys- tem". AUTHOR Jeffrey H. Kingston LOUT(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES AND ENVIRONMENT VARIABLE | SEE ALSO | REFERENCES | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lout&sektion=1&manpath=FreeBSD+Ports+15.0>