diff options
Diffstat (limited to 'man')
-rw-r--r-- | man/c2lout.1 | 133 | ||||
-rw-r--r-- | man/c2lout.txt | 95 | ||||
-rw-r--r-- | man/lout.1 | 10 | ||||
-rw-r--r-- | man/lout.txt | 12 |
4 files changed, 11 insertions, 239 deletions
diff --git a/man/c2lout.1 b/man/c2lout.1 deleted file mode 100644 index 472e530..0000000 --- a/man/c2lout.1 +++ /dev/null @@ -1,133 +0,0 @@ -.TH C2LOUT 1 -.SH NAME -c2lout - convert C and C++ source code into Lout -.SH SYNOPSIS -\fBc2lout\fR [ \fIoptions\fR ] \fIC\(en\&files\fR... -.SH DESCRIPTION -Reformat C and C++ source code for input to the Lout document formatting -system, taking care of comments, character strings, tab characters, etc. -.LP -.B c2lout -reads the named C and C++ files and produces output -suitable for input to -.BR "lout -s" . -Thus, -.LP -.RS -.B "c2lout foo.c | lout -s | lpr" -.RE -.LP -will print -.B foo.c -on a PostScript printer. Each file will start on a new page, preceded -by its name in bold. -.SH OPTIONS -.TP -.B \-pfixed -Use a fixed width font (the default). -.TP -.B \-pvarying -Use a varying-width italic font with non-italic bold keywords. -.TP -.B \-psymbol -Use a varying-width italic font with mathematical symbols and -non-italic bold keywords. -.TP -.B \-n -Do not print the file name before each C or C++ file. -.TP -.BI \-f " font" -Select a font family. -The default is -.B \-fCourier -for -.BR \-pfixed , -and -.B \-fTimes -for -.B \-pvarying -and -.BR \-psymbol . -.TP -.BI \-s " size" -Select a Lout font size. The default is -.B -s9p -(meaning 9 points) for -.BR \-pfixed , -and -.B \-s10p -for -.B \-pvarying -and -.BR \-psymbol . -These work well with 80-character-wide programs. -.TP -.BI \-v " vsize" -Select a Lout vertical inter-line gap. The default is -.B -v1.1fx -meaning 1.1 times the font size measured from baseline to baseline. -.TP -.BI \-t " num" -Set the tab interval to -.I num -characters (default is -.BR \-t8 ). -.TP -.BI \-T " width" -Without this option, -.B c2lout -simulates tabs with spaces. With this option, -.B c2lout -simulates tabs with Lout tabulation operators; -.I width -is the width of one tab interval in the final print, measured in Lout -units. This guarantees alignment of characters following tabs even -with varying-width fonts, provided -.I width -is sufficiently large. For example, -.B -T0.5i -produces half-inch tab intervals. -.TP -.B \-u -Print usage information on stderr and exit. -.TP -.B \-V -Print version information on stderr and exit. -.SS Raw Mode -There is a \(lq\&raw mode\(rq usage of -.B c2lout -invoked by a -.B -r -flag (must be the first argument). This converts one C file into -Lout-readable source without any heading or trailing information. -Synopsis: -.LP -.RS -.B c2lout -.B \-r -.BI \-i \ infile -.BI \-o \ outfile -.BI \-e \ errfile -.BI \-t \ num -.BI \-T \ width -.RE -.LP -Users should never need this mode; it is invoked automatically -from within Lout by the -.B @CP -symbol from the -.B cprint -package (see reference). -.SH SEE ALSO -.BR lout (1), -.BR lpr (1), -.BR ghostview (1). -.SH REFERENCES -.LP -Jeffrey H. Kingston, -.I -\(lq\&A User's Guide to the Lout Document Formatting System\(rq\c -\&, Chapter 11. -.SH AUTHOR -.LP -Jeffrey H. Kingston diff --git a/man/c2lout.txt b/man/c2lout.txt deleted file mode 100644 index 47349d6..0000000 --- a/man/c2lout.txt +++ /dev/null @@ -1,95 +0,0 @@ - - - -User Commands C2LOUT(1) - - - -NAME - c2lout - convert C and C++ source code into Lout - -SYNOPSIS - c2lout [ options ] Cfiles... - -DESCRIPTION - Reformat C and C++ source code for input to the Lout docu- - ment formatting system, taking care of comments, character - strings, tab characters, etc. - - c2lout reads the named C and C++ files and produces output - suitable for input to lout -s. Thus, - - c2lout foo.c | lout -s | lpr - - will print foo.c on a PostScript printer. Each file will - start on a new page, preceded by its name in bold. - -OPTIONS - -pfixed - Use a fixed width font (the default). - - -pvarying - Use a varying-width italic font with non-italic bold - keywords. - - -psymbol - Use a varying-width italic font with mathematical sym- - bols and non-italic bold keywords. - - -n Do not print the file name before each C or C++ file. - - -f font - Select a font family. The default is -fCourier for - -pfixed, and -fTimes for -pvarying and -psymbol. - - -s size - Select a Lout font size. The default is -s9p (meaning - 9 points) for -pfixed, and -s10p for -pvarying and - -psymbol. These work well with 80-character-wide pro- - grams. - - -v vsize - Select a Lout vertical inter-line gap. The default is - -v1.1fx meaning 1.1 times the font size measured from - baseline to baseline. - - -t num - Set the tab interval to num characters (default is - -t8). - - -T width - Without this option, c2lout simulates tabs with spaces. - With this option, c2lout simulates tabs with Lout tabu- - lation operators; width is the width of one tab inter- - val in the final print, measured in Lout units. This - guarantees alignment of characters following tabs even - with varying-width fonts, provided width is suffi- - ciently large. For example, -T0.5i produces half-inch - tab intervals. - - -u Print usage information on stderr and exit. - - -V Print version information on stderr and exit. - - Raw Mode - There is a raw mode usage of c2lout invoked by a -r flag - (must be the first argument). This converts one C file into - Lout-readable source without any heading or trailing infor- - mation. Synopsis: - - c2lout -r -i infile -o outfile -e errfile -t num - -T width - - Users should never need this mode; it is invoked automati- - cally from within Lout by the @CP symbol from the cprint - package (see reference). - -SEE ALSO - lout(1), lpr(1), ghostview(1). - -REFERENCES - Jeffrey H. Kingston, A User's Guide to the Lout Document - Formatting System, Chapter 11. - -AUTHOR - Jeffrey H. Kingston @@ -8,7 +8,7 @@ .SH NAME lout - prepare Lout document for printing .SH SYNOPSIS -\fBlout\fR [ \fIoption\fR ] \fIfile\fR... +\fBlout\fR [ \fIoptions\fR ] \fIfile\fR... .SH DESCRIPTION Invoke the Basser Lout interpreter on the concatenation of the named files, producing a PostScript file on standard output suitable for @@ -16,7 +16,7 @@ printing on PostScript printers using .IR lpr (1). If no files are named, stdin is used instead. The special file name .RB ` \|\-\| ' -may be used to denote standard input. There white space between flags +may be used to denote standard input. White space between flags and their associated option values is optional. .LP An optional @@ -42,8 +42,8 @@ Use "\c .IR linenum :\c .IR colnum :\c .I message\c -\&" alternative error message format useful with Emacs compilation -mode and other tools. +\&" alternative error message format (useful with Emacs compilation +mode and other tools). .SS Output format .TP \" \n(oi .B \-EPS @@ -244,7 +244,7 @@ can be changed by setting environment variable to an alternative directory name. .SH SEE ALSO .LP -.BR c2lout (1), +.BR prg2lout (1), .BR lpr (1), .BR ghostview (1) .SH MAILING LIST diff --git a/man/lout.txt b/man/lout.txt index 9638390..c09a943 100644 --- a/man/lout.txt +++ b/man/lout.txt @@ -9,7 +9,7 @@ NAME lout - prepare Lout document for printing SYNOPSIS - lout [ option ] file... + lout [ options ] file... DESCRIPTION Invoke the Basser Lout interpreter on the concatenation of @@ -17,8 +17,8 @@ DESCRIPTION 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. - There white space between flags and their associated option - values is optional. + 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 @@ -33,8 +33,8 @@ OPTIONS 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. + message format (useful with Emacs compilation mode and + other tools). Output format -EPS Produce output in the form of an EPS (Encapsulated @@ -170,7 +170,7 @@ FILES AND ENVIRONMENT VARIABLE alternative directory name. SEE ALSO - c2lout(1), lpr(1), ghostview(1) + prg2lout(1), lpr(1), ghostview(1) MAILING LIST A public mailing list for discussion of Lout exists. To |