20060303-partial

1 files changed, 97 insertions, 0 deletions

diff --git a/man/1/cook b/man/1/cook
new file mode 100644
index 00000000..55eddfa9
--- /dev/null
+++ b/man/1/cook
@@ -0,0 +1,97 @@
+.TH COOK 1
+.SH NAME
+cook \- SGML converter
+.SH SYNOPSIS
+.B cook
+[
+.B -f
+.I format
+] [
+.B -o
+.I outfile
+] [
+.I infile
+]
+.SH DESCRIPTION
+.B Cook
+reads a file in SGML format and produces an interpretation of the file in
+either LaTex or HTML format on standard output.
+.PP
+If no
+.I infile
+argument is present, the standard input is read.
+If an
+.I outfile
+argument is present, the results are written to that file instead
+of standard output.
+The
+.I format
+argument must be either
+.B html
+to produce HTML format output or one of:
+.BR latex ,
+.BR latexbook ,
+.BR latexpart ,
+.BR latexproc ,
+or
+.B latexslides
+to produce LaTex output.
+.PP
+The
+.B latexpart
+format assumes that the resulting output is to be included in
+the body of a controlling LaTex document. The other LaTex
+format options result in the generation of various LaTex
+wrapping commands.
+.PP
+.B Cook
+was designed to operate on the output of the
+.B Brutus
+editor (See 
+.IR brutus (1)
+) and so its mapping of SGML tags is closely linked to those
+generated by
+.IR brutus .
+.PP
+The following tags are recognised:
+.BR Author ,
+.BR Bold. "\fIn\fR,"
+.BR Caption ,
+.BR Example ,
+.BR Exercise ,
+.BR Extension ,
+.BR Float ,
+.BR Heading ,
+.BR Index ,
+.BR Index-topic ,
+.BR Italic. "\fIn\fR,"
+.BR Label ,
+.BR Label-ref ,
+.BR List ,
+.BR List-elem ,
+.BR No-fill ,
+.BR Par ,
+.BR Roman. "\fIn\fR,"
+.BR SGML ,
+.BR Title ,
+and
+.BR Type. "\fIn\fR,"
+where
+.I n
+is a character point size and must be one of:
+.BR 6 ,
+.BR 8 ,
+.BR 10 ,
+.BR 12 " or"
+.BR 16 .
+.SH FILES
+.B /dis/wm/brutus/
+.SH SOURCE
+.B /appl/cmd/cook.b
+.SH SEE ALSO
+.IR brutus (1)
+.SH DIAGNOSTICS
+.BR "Not an SGML file" :
+The first line of the input file must contain the SGML tag
+.B <SGML> 
+and nothing else.