sgml2xml

SGML2XML(1)                                                        SGML2XML(1)

NAME
       sgml2xml - convert SGML to XML

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

SYNOPSIS
       sgml2xml [ -Cehilprvx ]  [ -bencoding ]  [ -ccatalog ]  [  -Ddir  ]   [
       -ffile ]  [ -iname ]  [ -wwarning ]  [ -xxml-output-option ]  sysid...

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

OPTIONS
       -bencoding
              Use encoding for output.  The default is  UTF-8.  See  nsgmls(1)
              for the possible encoding types.

       -ccatalog
              Use the catalog entry file file.

       -C     The  filename... arguments specify catalog files rather than the
              document entity. The document entity is specified by  the  first
              DOCUMENT entry in the catalog files.

       -Ddirectory
              Search directory for files specified in system identifiers. Mul-
              tiple -D options are allowed. See nsgmls(1) for more information
              about this option.

       -e     Describe open entities in error messages.

       -ffile Redirect errors to file.  This is useful only for shells that do
              not support redirection of stderr.

       -iname Pretend that <!ENTITY % name "INCLUDE"> occurs at the  start  of
              the  document  type  declaration subset in the SGML document en-
              tity. Since repeated definitions of an entity are ignored,  this
              definition  will  take  precedence over any other definitions of
              this entity in the document type declaration.  Multiple  -i  op-
              tions are allowed. If the SGML declaration replaces the reserved
              name INCLUDE then the new reserved name will be the  replacement
              text of the entity. Typically the document type declaration will
              contain <!ENTITY % name "IGNORE"> and will  use  %name;  in  the
              status keyword specification of a marked section declaration. In
              this case the effect of the option will be to cause  the  marked
              section not to be ignored.

       -v     Print the version number.

       -wtype Control  warnings  and  errors according to type.  See nsgmls(1)
              for the allowed values of type.

       -xxml-output-option
              Control the XML output, according to the value of xml_output_op-
              tion as follows:

              no-nl-in-tag
                     Don't  use  newlines  inside start-tags. Usually sgml2xml
                     uses newlines inside start-tags so as to reduce the prob-
                     ability of excessively long lines.

              id     Output attribute declarations for ID attributes.

              notation
                     Output declarations for notations.

              ndata  Output  declarations  for external data entities. XML re-
                     quires these to be NDATA. sgml2xml 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 us-
                     ing 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.

AUTHOR
       James Clark <jjc@jclark.com>

       Conversion  to  DocBook  and man page from original HTML documention by
       Steve Cheng <steve@ggi-project.org>.

SEE ALSO
       nsgmls(1)

       /usr/share/doc/sp/sx.htm

SP                               05 July 1999                      SGML2XML(1)