xenial (1) sgml2xml.1.gz

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