NAME

       sgmlnorm - normalize SGML documents

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

SYNOPSIS

       sgmlnorm [ -Cdemnv ]  [ -bbctf ]  [ -ccatalog ]  [ -Ddir ]  [  -iname  ]   [  -wwarning  ]
       sysid...

DESCRIPTION

       sgmlnorm  prints  on  the  standard  output  a  normalized  document instance for the SGML
       document contained in the concatenation of the entities with system identifiers sysid...

       When the normalized instance is prefixed with the original SGML declaration and prolog, it
       will have the same ESIS as the original SGML document, with the following exceptions:

       • The  output  of  sgmlnorm  does  not  protect against the recognition of short reference
         delimiters, so any USEMAP declarations must be removed from the DTD.

       • The normalized instance will use the reference delimiters, even if the original instance
         did not.

       • If  marked  sections  are  included  in  the  output  using the -m option, the reference
         reserved names will be used for the status keywords even if the  original  instance  did
         not.

       • Any ESIS information relating to the SGML LINK feature will be lost.

       The normalized instance will not use any markup minimization features except that:

       • Any  attributes that were not specified in the original instance will not be included in
         the normalized instance.  (Current attributes will be included.)

       • If the declared value of an attribute was a name token group, and a value was  specified
         that  was  the  same  as  the  name  of the attribute, then the attribute name and value
         indicator will be omitted.  For example, with HTML sgmlnorm would  output  <DL  COMPACT>
         rather than <DL COMPACT="COMPACT">.

OPTIONS

       -bbctf Use  the  BCTF name bctf for output.  See nsgmls(1) for more information about this
              option.

       -cfile 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.

       -d     Output  a  document type declaration with the same external identifier as the input
              document, and with no internal declaration subset.  No check is performed that  the
              document instance is valid with respect to this DTD.

       -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.

       -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.

       -m     Output any marked sections that were in the input document instance.

       -n     Output any comments that were in the input document instance.

       -r     Raw output.  Don't perform any conversion on RSs and REs when printing the  entity.
              The entity would typically have the storage manager attribute records=asis.

       -v     Print the version number.

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

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/sgmlnorm.htm