Annotation of 43BSDTahoe/man/man1/vlp.1, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1983 Regents of the University of California.
        !             2: .\" All rights reserved.  The Berkeley software License Agreement
        !             3: .\" specifies the terms and conditions for redistribution.
        !             4: .\"
        !             5: .\"    @(#)vlp.1       6.1 (Berkeley) 4/29/85
        !             6: .\"
        !             7: .TH VLP 1 "April 29, 1985"
        !             8: .UC 5
        !             9: .SH NAME
        !            10: vlp \- Format Lisp programs to be printed with nroff, vtroff, or troff
        !            11: .SH SYNOPSIS
        !            12: .B vlp
        !            13: [
        !            14: .B \-p
        !            15: .I pointsize
        !            16: ] [
        !            17: .B \-d
        !            18: ] [
        !            19: .B \-f
        !            20: ] [
        !            21: .B \-l
        !            22: ] [
        !            23: .B \-v
        !            24: ] [
        !            25: .B \-T
        !            26: .I title1
        !            27: ] file1 [
        !            28: .B \-T
        !            29: .I title2
        !            30: ] file2 ...
        !            31: .SH DESCRIPTION
        !            32: \fIVlp\fR
        !            33: formats the named files so that they can be run through nroff, vtroff, or
        !            34: troff to produce listings that line-up and are attractive.
        !            35: The first non-blank character of each line is lined-up vertically,
        !            36: as in the source file.
        !            37: Comments (text beginning with a semicolon)
        !            38: are printed in italics.
        !            39: Each function's name is printed in bold face next to the function.
        !            40: This format makes Lisp code look attractive when it is printed with a 
        !            41: variable width font.
        !            42: .PP
        !            43: Normally,
        !            44: \fIvlp\fR works as a filter and sends its output to the standard output.
        !            45: However,
        !            46: the 
        !            47: .B \-v
        !            48: switch pipes the output directly to vtroff.
        !            49: If no files are specified,
        !            50: then \fIvlp\fR reads from the standard input.
        !            51: .PP
        !            52: The following options are available:
        !            53: .TP
        !            54: .B \-p
        !            55: The
        !            56: .B \-p
        !            57: switch changes the size of the text from its default value of 8 points
        !            58: to one of 6, 8, 10, or 12 points.
        !            59: Once set, the point size is used for all subsequent files.
        !            60: This point size does not apply to embedded text (see \fI\-f\fR below).
        !            61: .TP
        !            62: .B \-d
        !            63: The 
        !            64: .B \-d
        !            65: switch puts \fIvlp\fR into debugging mode.
        !            66: .TP
        !            67: .B \-f
        !            68: .I Vlp
        !            69: has a filtered mode
        !            70: in which all lines are passed unmodified,
        !            71: except those lines between the directives \fB.Ls\fR and \fB.Le\fR.
        !            72: This mode can be used to format Lisp code that is embedded in a document.
        !            73: The directive \fB.Ls\fR takes an optional argument that gives the point
        !            74: size for the embedded code.
        !            75: If not size is specified,
        !            76: the size of the surrounding text is used.
        !            77: .TP
        !            78: .B \-l
        !            79: The
        !            80: .B \-l
        !            81: switch prevents \fIvlp\fR from placing labels next to functions.
        !            82: This switch is useful for embedded Lisp code,
        !            83: where the labels would be distracting.
        !            84: .TP
        !            85: .B \-v
        !            86: This switch cause \fIvlp\fR to send its output to vtroff rather than the
        !            87: standard output.
        !            88: .TP
        !            89: .B \-T
        !            90: A title to be printed on each page may be specified by using the 
        !            91: .B \-T
        !            92: switch.
        !            93: The 
        !            94: .B \-T
        !            95: switch applies only to the next file name given.
        !            96: Titles are not printed for embedded text (see 
        !            97: .BR \-f ,
        !            98: above).
        !            99: This switch may not be used if \fIvlp\fR is reading from the standard input.
        !           100: .SH FILES
        !           101: /usr/lib/vlpmacs               troff/nroff macros
        !           102: .SH AUTHOR
        !           103: Originally written by John K. Foderaro, with additional changes by
        !           104: Kevin Layer and James Larus.
        !           105: .SH SEE ALSO
        !           106: vgrind(1), lisp(1)
        !           107: .SH BUGS
        !           108: \fIvlp\fR transforms \\ into \\\\ so that it will be printed out.
        !           109: Hence, troff commands cannot be embedded in Lisp code.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.