NAME

       sgmltools - process sgml files.

SYNOPSIS

       sgmltools    [-b    backend]    [-d]    [-v]    [-V]    [-h]    [-l]   [-s   dsssl_spec]   [-j   jadeopt]
       [--backend={onehtml,html,ps,dvi,rtf,txt,ld2db,jadetex,pdb,lynx,w3m}]        [--debug]         [--verbose]
       [--dsssl-spec=dsssl_spec] [--jade-opt=jadeopt] [--version] [--help] [--license]

DESCRIPTION

       sgmltools  is  the  central  driver  of  SGMLtools. You can use it to convert SGML input files to various
       formats, as indicated by the --backend switch.

   OPTIONS
       -b, --backend
              Select the backend to use. Currently, there are  five  different  backends  to  choose  from.   ps
              expects  a DocBook SGML file and will convert it into PostScript.  dvi expects a DocBook SGML file
              and will convert it into DVI.  rtf expects a DocBook SGML file  and  will  convert  it  into  RTF.
              onehtml  expects  a  DocBook  SGML file and will convert it into a single HTML; the resulting file
              will be put in the current directory (default).  html expects a DocBook SGML file and will convert
              it into HTML; the resulting files will be put in a subdirectory.  txt expects a DocBook SGML  file
              and  will  convert it into ASCII. Note that this backend actually uses the w3m (preferred) or lynx
              (if w3m not found) backends.  ld2db expects a LinuxDoc-SGML file and will convert it into  DocBook
              SGML.   jadetex  expects a DocBook SGML file and will convert it into JadeTeX input. Only use this
              if you know what you're doing.  pdb expects a DocBook SGML file and will convert it into the iSilo
              format used on Palm devices.  w3m expects a DocBook SGML file and will convert it into ASCII.  w3m
              does  a  better  job of exporting HTML as ASCII text than Lynx, since w3m understands tables.  One
              should normally use the txt backend and let sgmltools decide which ASCII  exporter  is  available.
              lynx  expects  a DocBook SGML file and will convert it into ASCII. One should normally use the txt
              backend and let sgmltools decide which ASCII exporter is available.

       -d, --debug
              Enable debugging. All temporary files will be left as is and possibly  extra  information  on  the
              processing steps is printed to stderr.

       -v, --verbose
              Be verbose. Information on commands executed, etcetera, will be printed to stdout.

       -s, --dsssl-spec
              Specify the DSSSL stylesheet to apply (see STYLESHEETS, below).

       -j, --jade-opt
              Pass additional options directly to Jade.

       -h, --help
              Print a usage message on standard output and exit successfully (tbd).

       -V, --version
              Print version information on standard output then exit successfully (tbd).

       -l, --license
              Print license information

STYLESHEETS

       The  DSSSL specification may be either a filename, a public identifier or a DSSSL alias (resolved via one
       of the alias files /etc/sgml/aliases and ~/.sgmlaliases to either a filename or a public identifier).

ENVIRONMENT VARIABLES

       TMPDIR Temporary directory. If it  is  on  a  local  filesystem,  a  lot  of  copying  will  be  avoided.
              Furthermore,  setting  this  will  prevent  SGMLtools from using /tmp and thus will prevent people
              trying to make use of race conditions.

       SGML_CATALOG_FILES
              The SGML Open catalog files to use for resolving public identifiers into system identifiers.

BUGS

       This is an early developer release, so don't expect it to behave in any useful way. It won't make  coffee
       or tea.

SOURCES

   sgmltools-lite
       http://sgmltools-lite.sourceforge.net

   w3m
       http://ei5nazha.yz.yamagata-u.ac.jp/~aito/w3m/eng

   iSilo Tools
       iSilo Palm readers and Linux encoders are available from:

       http://www.isilo.com

   DocBook Documentation
       The online version of 'DocBook: The Definitive Guide' can be found at:

       http://www.docbook.org

   OpenJade
       http://openjade.sourceforge.net

AUTHOR

       Copyright (c)2000, Cees A. de Groot <cg@sgmltools.org>.

                                                    SGMLtools                                       SGMLTOOLS(1)