Provided by: sp_1.3.4-1.2.1-49ubuntu1_amd64 bug

NAME

       sgml2xml - convert SGML to XML

       An SGML System Conforming to International Standard ISO 8879 — Standard 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. Multiple -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 entity. 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 options  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_option 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 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. 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 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.

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