Node:chap 11, Next:, Previous:chap 10, Up:Top



How to use the front-end

When the Sgmltexi source is ready, all that is needed is the program sgmltexi to control the SGML parser and other elaborations.

sgmltexi [options]... sgml_source Command
This is the front-end for the SGML to Texinfo system.

--help
Display a brief help and exit.
--version
Display version information and exit.
--verbose
Display processing information.
--force
Force things.
--number-sections
Number sections for Info and HTML typesetting.
--clean
Remove stale files associated with the source name.
--input-encoding=encoding
Define an input encoding that will be converted automatically into entities. This option take precedence over the attribute charset of the sgmltexi element. Using this option the Texinfo source will be pure ASCII, and the command @documentencoding is used with the argument ISO-646.

Available encodings are: ISO-8859-1, ISO-8859-2, ... ISO-8859-10. All encodings are not fully supported, because of Texinfo limitations. Unsupported codes are shown with the name of the corresponding standard entity, like this: [ETH   ].

--sgml-include=parameter-entity
--include=parameter-entity
Assign the word INCLUDE to an SGML parameter entity.
--paper=paper
Define the paper format: letter, a4, a4wide, a4latex, small.
--setchapternewpage={on|off|odd}
Define the chapter paper feed, overriding the tag <setchapternewpage content="..."> inside the source.
--footnotestyle={end|separate}
Define the footnote location, overriding the tag <footnotestyle content="..."> inside the source.
--sgml-syntax
--sgml-check
Check SGML syntax and report errors.
--sp
SP output for debugging purpose.
--texi
--texinfo
Generate a Texinfo source output.
--dvi
Generate a DVI output.
--ps
--postscript
Generate a PostScript output.
--pdf
Generate a PDF output.
--info
Generate an Info output.
--text
Generate a text output.
--html
Generate an HTML output.
--xml
Generate a Texinfo XML output.
--docbook
Generate a Docbook XML output.

Each elaboration generates a file with .diag extention. This file contains the messages that may be shown with the option --verbose.