![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to vlp.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1|
Return to vlp.1 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1 |
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.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.