sgmlnorm

SGMLNORM(1)                                                        SGMLNORM(1)

NAME
       sgmlnorm - normalize SGML documents

       An  SGML  System Conforming to International Standard ISO 8879 -- Stan-
       dard 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 decla-
       ration and prolog, it will have the same ESIS as the original SGML doc-
       ument, with the following exceptions:

       o The  output  of  sgmlnorm does not protect against the recognition of
         short reference delimiters, so any USEMAP declarations  must  be  re-
         moved from the DTD.

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

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

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

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

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

       o 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 ex-
         ample, 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 in-
              formation 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  iden-
              tifier  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. Mul-
              tiple -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  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.

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

       -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  stor-
              age 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

SP                               05 July 1999                      SGMLNORM(1)