SGMLTOOLS(1)						      General Commands Manual						      SGMLTOOLS(1)

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,jade-
       tex,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 (pre-
	      ferred) 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 Doc-
	      Book 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 SGML-
	      tools 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)