NAME

vlp − Format Lisp programs to be printed with nroff, vtroff, or troff

SYNOPSIS

vlp [ options ] files

DESCRIPTION

Vlp formats the named files so that they can be run through nroff, vtroff, or troff to produce listings that line-up and are attractive.  The first non-blank character of each line is lined-up vertically, as in the source file.  Comments (text beginning with a semicolon) are printed in italics.  Each function’s name is printed in bold face next to the function.  This format makes Lisp code look attractive when it is printed with a variable width font. 

Normally, vlp works as a filter and sends its output to the standard output.  However, the −v switch pipes the output directly to vtroff.  If no files are specified, then vlp reads from the standard input. 

OPTIONS

−d Puts vlp into debugging mode. 

−f Formats Lisp code embedded in a document.  This is Vlp’s filtered mode, in which all lines are passed unmodified, except those lines between the directives .Ls and .Le.  The directive .Ls takes an optional argument that gives the point size for the embedded code.  If not size is specified, the size of the surrounding text is used. 

−l Prevents vlp from placing labels next to functions.  This switch is useful for embedded Lisp code, where the labels would be distracting. 

−p pointsize
Changes the size of the text from its default value of 8 points to the specified size of 6, 8, 10, or 12 points. Once set, the point size is used for all subsequent files. This point size does not apply to embedded text (see −f above). 

−T title
Specifies a title to be printed on each page. Each −T switch applies only to the next filename given.  If you want to specify titles for more than one file, include the −T option and a title before each filename on the command line.  Titles are not printed for embedded text (see −f, above).  This switch may not be used if vlp is reading from the standard input. 

−v Causes vlp to send its output to vtroff rather than the standard output. 

FILES

/usr/lib/vlpmacstroff/nroff macros

SEE ALSO

vgrind(1), lisp(1)

BUGS

Vlp transforms \ into \\ so that it will be printed out.  Hence, troff commands cannot be embedded in Lisp code. 

5 BSD  —  April 29, 1985