[This local archive copy mirrored from the canonical site: http://www.jclark.com/sp/sx.htm 980310; links may not have complete integrity, so use the canonical document at this URL if possible.]

SX

An SGML System Conforming to International Standard ISO 8879 --
Standard Generalized Markup Language

SYNOPSIS

sx [ -Cehilprvx ] [ -bencoding ] [ -ccatalog_file ] [ -Ddirectory ] [ -ffile ] [ -wwarning_type ] [ -xxml_output_option ] sysid...

DESCRIPTION

SX converts SGML to XML. SX parses and validates the SGML document contained in sysid... and writes an equivalent XML document to the standard output. SX will warn about SGML constructs which have no XML equivalent.

The following options are available:

-bencoding
Use encoding for output. By default SX uses UTF-8.
-cfile
Use the catalog entry file file.
-C
This has the same effect as in nsgmls.
-Ddirectory
Search directory for files specified in system identifiers. This has the same effect as in nsgmls.
-e
Describe open entities in error messages.
-ffile
Redirect errors to file. This is useful mainly with shells that do not support redirection of stderr.
-iname
This has the same effect as in nsgmls.
-v
Print the version number.
-wtype
Control warnings and errors according to type. This has the same effect as in nsgmls.
-xxml_output_option
Control the XML output according to the value of xml_output_option as follows:
no-nl-in-tag
Don't use newlines inside start-tags. Usually SX uses newlines inside start-tags so as to reduce the probability of excessively long lines.
id
Output attribute declarations for ID attributes.
notation
Output declarations for notations.
ndata
Output declarations for external data entities. XML requires these to be NDATA. SX will warn about CDATA and SDATA external data entities and output them as NDATA entities.
cdata
Use XML CDATA sections for CDATA marked sections and for elements with a declared content of CDATA.
comment
Output comment declarations. Comment declarations in the DTD will not be output.
lower
Prefer lower case. Names that were subjected to upper-case substitution by SGML will be folded to lower case. This does not include reserved names; XML requires these to be in upper-case.
pi-escape
Escape &<> in the contents of processing instructions using the amp, lt and gt entities. This allows processing instructions to contain the string >?, but requires that applications handle the escapes.
empty
Use the <e/> syntax for element types e declared as EMPTY.
attlist
Output a ATTLIST declaration for every element specifying the type of all attributes. The default will always be #IMPLIED.

Multiple -x options are allowed.

James Clark
jjc@jclark.com