1 DVI
     sgmlnorm -	normalize SGML tags

2 SYNOPSIS
 SYNOPSIS
     sgmlnorm [	-c catalog-file	] [ -d file-directory-name ] [-e]
     [ -k cm ] [ -w warning_type ]
2 	------[	in-sgml-file-or	<in-sgml-file-]	>out-sgml-file
 	      [	in-sgml-file or	<in-sgml-file ]	>out-sgml-file

2 DESCRIPTION
 DESCRIPTION
     sgmlnorm is a tag normalizer for SGML  files.   It	 supplies
     all  omitted  optional  closing tags, helping to clarify the
     scope of each <TAG>  ...  </TAG> pair.

     spam(1)  is  another  SGML	 tag  normalizer  from	the  same
     software suite.

2 OPTIONS
 OPTIONS
     -c	catalog-file	  Provide the full path	name of	the  SGML
2 			-catalog--file,	which-is-needed	to-relate
 			 catalog  file,	which is needed	to relate
2 			-the-document-type-name	-in--the--initial
 			 the document type name	 in  the  initial
2 			-SGML
 			 SGML
2 			-<!DOCTYPE-document-type-name-PUBLIC-``...''>
 			 <!DOCTYPE document-type-name PUBLIC ``...''>
2 			-declaration--to--a--grammar--file---that
 			 declaration  to  a  grammar  file   that
2 			-defines--the--syntax-of-the-SGML-tags-in
 			 defines  the  syntax of the SGML tags in
2 			-the-remainder-of-the-file.
 			 the remainder of the file.

2 			-This-option-is	always-required,--because
 			 This option is	always required,  because
2 			-the--current--version-of-sgmlnorm-has-no
 			 the  current  version of sgmlnorm has no
2 			-built-in-default-catalog-location.
 			 built-in default catalog location.

2 			-At-some-UNIX-sites,--a	-suitable--option
 			 At some UNIX sites,  a	 suitable  option
2 			-will	be--------c--/usr/local/lib/html-
 			 will	be     -  c  /usr/local/lib/html-
2 			-check/lib/catalog
 			 check/lib/catalog

     - d directory-name	   Add	a  file	 directory  name  to  the
2 			-default-search	path-used-to-locate-files
 			 default search	path used to locate files
2 			-specified-in-system-identifiers-in
 			 specified in system identifiers in
2 			-<!DOCTYPE-document-type-name-SYSTEM--``filename''>
 			 <!DOCTYPE document-type-name SYSTEM  ``filename''>
2 			-declarations.	Multiple--d--options--are
 			 declarations.	Multiple -d  options  are
2 			-allowed.
 			 allowed.

     -e			  Describe open	entities  in  error  mes-
2 			-sages.	--Error	-messages--always-include
 			 sages.	  Error	 messages  always include
2 			-the-position-of-the-most-recently-opened
 			 the position of the most recently opened
2 			-external-entity.
 			 external entity.

     -k	cm		  This option requires either c, or m, or
2 			-both,	in--either--order.---The-letter	c
 			 both,	in  either  order.   The letter	c
2 			-requests-output--of--any--embedded--SGML
 			 requests output  of  any  embedded  SGML
2 			-comments;--otherwise,	comments-are-nor-
 			 comments;  otherwise,	comments are nor-
2 			-mally-discarded.--The-letter-m	-requests
 			 mally discarded.  The letter m	 requests
2 			-output	--of--marked--sections.	--[It--is
 			 output	  of  marked  sections.	  [It  is

2 			-unclear-what-the-m-option-is-supposed-to
 			 unclear what the m option is supposed to
2 			-do.]
 			 do.]

     -w	warning_type	  Control warnings and errors.	Multiple
2 			---w--options-are-allowed.--The	following
 			 - w  options are allowed.  The	following
2 			-values	of-warning_type	enable-warnings:
 			 values	of warning_type	enable warnings:

2 			-mixed		Warn-about-mixed--content
 			 mixed		Warn about mixed  content
2 					models	that-do	not-allow
 					models	that do	not allow
2 					#pcdata	anywhere.
 					#pcdata	anywhere.

2 			-sgmldecl	Warn-about-various--dubi-
 			 sgmldecl	Warn about various  dubi-
2 					ous--constructions-in-the
 					ous  constructions in the
2 					SGML-declaration.
 					SGML declaration.

2 			-should		Warn-about-various-recom-
 			 should		Warn about various recom-
2 					mendations--made--in--ISO
 					mendations  made  in  ISO
2 					8879--that--the	-document
 					8879  that  the	 document
2 					does---not--comply--with.
 					does   not  comply  with.
2 					(Recommendations------are
 					(Recommendations      are
2 					expressed	-----with
 					expressed	     with
2 					``should'',--as	-distinct
 					``should'',  as	 distinct
2 					from--requirements--which
 					from  requirements  which
2 					are---usually	expressed
 					are   usually	expressed
2 					with-``shall''.)
 					with ``shall''.)

2 			-default	Warn---about	defaulted
 			 default	Warn   about	defaulted
2 					references.
 					references.

2 			-duplicate	Warn---about	duplicate
 			 duplicate	Warn   about	duplicate
2 					entity-declarations.
 					entity declarations.

2 			-undefined	Warn-about-undefined-ele-
 			 undefined	Warn about undefined ele-
2 					ments:	elements--used-in
 					ments:	elements  used in
2 					the-DTD	but-not	defined.
 					the DTD	but not	defined.

2 			-unclosed	Warn-about-unclosed-start
 			 unclosed	Warn about unclosed start
2 					and-end-tags.
 					and end-tags.

2 			-empty		Warn--about--empty--start
 			 empty		Warn  about  empty  start
2 					and-end-tags.
 					and end-tags.

2 			-net		Warn--about--net-enabling
 			 net		Warn  about  net-enabling
2 					start-tags--and	null-end-
 					start-tags  and	null end-
2 					tags.
 					tags.

2 			-min-tag	Warn---about	minimized
 			 min-tag	Warn   about	minimized
2 					start	-and	end-tags.
 					start	 and	end-tags.
2 					Equivalent-to-combination
 					Equivalent to combination
2 					of--unclosed,--empty--and
 					of  unclosed,  empty  and
2 					net-warnings.
 					net warnings.

2 			-unused-map	Warn-about--unused--short
 			 unused-map	Warn about  unused  short
2 					reference-maps:	maps-that
 					reference maps:	maps that
2 					are-declared-with-a-short
 					are declared with a short
2 					reference	--mapping
 					reference	  mapping
2 					declaration---but---never
 					declaration   but   never
2 					used-in	a-short	reference
 					used in	a short	reference
2 					use--declaration--in--the
 					use  declaration  in  the
2 					DTD.
 					DTD.

2 			-unused-param	Warn---about	parameter
 			 unused-param	Warn   about	parameter
2 					entities-that-are-defined
 					entities that are defined
2 					but-not	used-in	a-DTD.
 					but not	used in	a DTD.

2 			-all		Warn---about---conditions
 			 all		Warn   about   conditions
2 					that--should--usually--be
 					that  should  usually  be
2 					avoided	(in--the--opinion
 					avoided	(in  the  opinion
2 					of	the	-author).
 					of	the	 author).
2 					Equivalent--to:	---mixed,
 					Equivalent  to:	   mixed,
2 					should,	--default,--unde-
 					should,	  default,  unde-
2 					fined,-sgmldecl,--unused-
 					fined, sgmldecl,  unused-
2 					map,--unused-param,-empty
 					map,  unused-param, empty
2 					and-unclosed.
 					and unclosed.

2 			-A-warning-can-be-disabled-by--using--its
 			 A warning can be disabled by  using  its
2 			-name--prefixed	-with--no-.--Thus--wall	-
 			 name  prefixed	 with  no-.  Thus -wall	-
2 			-wno-duplicate-will-enable--all	-warnings
 			 wno-duplicate will enable  all	 warnings
2 			-except	--those	-about	duplicate--entity
 			 except	  those	 about	duplicate  entity
2 			-declarations.
 			 declarations.

2 			-The-following	values	for--warning_type
 			 The following	values	for  warning_type
2 			-disable-errors:
 			 disable errors:

2 			-no-idref
 			 no-idref
2 			------Do-not-give--an--error--for--an--ID
 			      Do not give  an  error  for  an  ID
2 			------reference	-value	which--no-element
 			      reference	 value	which  no element
2 			------has-as-its-ID.--The-effect-will--be
 			      has as its ID.  The effect will  be
2 			------as-if-each-attribute-declared-as-an
 			      as if each attribute declared as an
2 			------ID---reference---value---had---been
 			      ID   reference   value   had   been
2 			------declared-as-a-name.
 			      declared as a name.

2 			-no-significant
 			 no-significant
2 			------Do-not-give-an-error-when	a-charac-
 			      Do not give an error when	a charac-
2 			------ter-that-is-not-a	significant-char-
 			      ter that is not a	significant char-
2 			------acter--in	-the--reference	-concrete
 			      acter  in	 the  reference	 concrete
2 			------syntax--occurs--in-a-literal-in-the
 			      syntax  occurs  in a literal in the
2 			------SGML-declaration.	-This-may-be-use-
 			      SGML declaration.	 This may be use-
2 			------ful--in--conjunction--with--certain
 			      ful  in  conjunction  with  certain
2 			------buggy-test-suites.
 			      buggy test suites.

2 SEE-ALSO
 SEE ALSO
     html-check(1), html-ncheck(1), html-norm(1), html-pretty(1),
     html-spam(1),  htmlchek(1),  nsgmls(1),  sgmls(1),	 spam(1),
     spent(1),

2 AUTHOR
 AUTHOR
     Nelson H. F. Beebe, Ph.D.
     Center for	Scientific Computing
     Department	of Mathematics
     University	of Utah
     Salt Lake City, UT	84112
     Tel: +1 801 581 5254
     FAX: +1 801 581 4148
     Email: <beebe@math.utah.edu>
     WWW URL: http://www.math.utah.edu/~beebe
