sgml2latex - create LaTeX, DVI, PostScript or PDF output from a

NAME

       sgml2latex  -  create  LaTeX,  DVI,  PostScript  or  PDF  output from a
       LinuxDoc DTD SGML source file

SYNOPSIS

       sgml2latex  [generic-option...]   [--output=tex|dvi|ps|pdf]  [--bibtex]
       [--makeindex]    [--pagenumber=n]    --quick   [--latex=hlatexp|platex]
       [--dvips=dvips|dvi2ps] file[.sgml]

DESCRIPTION

       sgml2latex is an old and obsoleted form of the latex converter  command
       of  LinuxDoc-Tools.   It is recommended to switch the new form linuxdoc
       -B latex now.  It converts a LinuxDoc DTD SGML  source  file  to  LaTeX
       output,  using  the nsgmls(1) or onsgmls(1) parser, and the sgmlsasp(1)
       translator.  Using the LaTeX output, and the latex(1)  text  formatter,
       you  can  then  create  DVI  output,  and  PostScript  output using the
       dvips(1) converter. Output will appear in file.tex  for  LaTeX  output,
       file.dvi  for  DVI output, or file.ps for PostScript output, where file
       is the name of the SGML source file.

       Using  the LaTeX output, and the pdflatex(1) text  formatter,  you  can
       then create a nice PDF output, suitable for viewing with PDF viewers as
       xpdf(1), acroread(1) or ghostview(1).

       The attribute/value pair "output=latex2e" is set for conditionals.

OPTIONS

sgml2latex accepts all the generic options described in linuxdoc(1),
and the following specific options:

--output=fmt, -o
Specify the desired output format. The specifier fmt may be
‘‘tex’’, ‘‘dvi’’, ‘‘ps’’, or ‘‘pdf’’.

Note: This version does not overwrite/remove the intermediate files:
tex file for dvi output, or tex/dvi files for ps output. This is
different behavior from the original SGML-Tools 1.0.9, so you are
warned here.

--bibtex, -b
Process the generated TeX with bibtex(1).

--makeindex, -m
Generate a TeX index file suitable for processing with
makeindex(1) from and <idx> and <cdx> tags present in the SGML
source.

--pagenumber, -n
Set the starting page number in the output DVI or PS file.

--quick, -q
Do only one pass of LaTeX formatting. This is often not
sufficient to produce final output (because of references, etc.)
but is useful for spotting TeX errors and justification
problems.

--pass, -P
The argument of the pass option is inserted just after the LaTeX
preamble generated by the document-type tag. Specify the
desired output format. The specifier fmt may be ‘‘tex’’,
‘‘dvi’’, ‘‘ps’’, or ‘‘pdf’’.

--latex=alternate_latex_command, -x
This option is currently for Korean and Japanese. The
alternate_latex_command can be ‘‘latex’’ (default), ‘‘hlatexp’’
(for Korean), ‘‘platex’’ or ‘‘jlatex’’ (for Japanese). This
option can be used to render Korean document using HLaTeXp, or
to render Japanese document using pLaTeX/jLaTeX. If not, HLaTeX
should be installed to render Korean document. On the other
hand, Japanese document can be rendered with jLaTeX
(which is the default when ‘‘-c nippon’’ is specified), so if
you already have jLaTeX, you may not need to install the pLaTeX.

--dvips=alternate_dvips_command, -s
This option is currently for Japanese. The
alternate_dvips_command can be ‘‘dvips’’ or ‘‘dvi2ps’’. If you
don’t know this, then you may not need this.

file The SGML source file, named either file or file.sgml

FILES

       Many  files  and  executables in /usr/share/linuxdoc-tools and /usr/bin
       are used.

BUGS

       None known.

AUTHOR

       Originally written by Greg Hankins <greg.hankins@cc.gatech.edu>,  based
       on scripts by Tom Gordon and Alexander Horz. Later rewritten by Cees de
       Groot   <cg@cdegroot.com>.    PDF   patches   by   Juan    Jose    Amor
       <jjamor@hispalinux.es>.    Currently   maintained   by  Taketoshi  Sano
       <sano@debian.org> for Linuxdoc-Tools.