aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
Diffstat (limited to 'man')
-rw-r--r--man/c2lout.1133
-rw-r--r--man/c2lout.txt95
-rw-r--r--man/lout.110
-rw-r--r--man/lout.txt12
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
diff --git a/man/lout.1 b/man/lout.1
index 5b9b6bc..b20ea36 100644
--- a/man/lout.1
+++ b/man/lout.1
@@ -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