shithub: purgatorio

ref: 5611a46d8fb04ec3fd60c05a1486743cea98a311
dir: /man/1/cook/

View raw version
.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.