1 DVI
     html-norm - normalize HTML	tags

2 SYNOPSIS
 SYNOPSIS
     html-norm [sgmlnorm-options]
2 	------[	in-html-file-or	<in-html-file-]	>out-html-file
 	      [	in-html-file or	<in-html-file ]	>out-html-file

2 DESCRIPTION
 DESCRIPTION
     html-norm is a convenient interface to  sgmlnorm(1),  a  tag
     normalizer	 for SGML files.  It conceals the details of pro-
     viding the	HTML grammar files needed by the normalizer.

     It	is a good idea to run html-norm	on any	HTML  files  that
     you  plan	to  filter  with html-pretty(1)	to ensure correct
     indenting.

2 OPTIONS
 OPTIONS
     All  command-line	options	 are  passed   on   directly   to
     sgmlnorm(1);  none	are interpreted	by html-norm itself.  For
     convenience,  the	sgmlnorm(1)   option   descriptions   are
     repeated here.  html-norm supplies	the -c catalog-file and	-
     k c options.

     -c	catalog-file	       Provide the full	path name of  the
2 			------SGML--catalog-file,-which	is-needed
 			      SGML  catalog file, which	is needed
2 			------to-relate	the-document-type-name-in
 			      to relate	the document type name in
2 			------the-initial-SGML
 			      the initial 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
 			      defines the syntax of the	SGML tags
2 			------in-the-remainder-of-the-file.
 			      in the remainder of the file.

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

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

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

     -e			       Describe	open  entities	in  error
2 			------messages.	--Error	-messages--always
 			      messages.	  Error	 messages  always

2 			------include-the-position--of	the--most
 			      include the position  of	the  most
2 			------recently-opened-external-entity.
 			      recently opened external entity.

     -k	cm		       This option requires either c,  or
2 			------m,--or--both,-in-either-order.--The
 			      m,  or  both, in either order.  The
2 			------letter-c	requests--output--of--any
 			      letter c	requests  output  of  any
2 			------embedded	SGML-comments;-otherwise,
 			      embedded	SGML comments; otherwise,
2 			------comments	are--normally--discarded.
 			      comments	are  normally  discarded.
2 			------The--letter--m--requests	output-of
 			      The  letter  m  requests	output of
2 			------marked-sections.	-[It--is--unclear
 			      marked sections.	 [It  is  unclear
2 			------what--the	-m--option-is-supposed-to
 			      what  the	 m  option is supposed to
2 			------do.]
 			      do.]

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

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

2 			------sgmldecl	-----Warn--about--various
 			      sgmldecl	     Warn  about  various
2 					-----dubious	construc-
 					     dubious	construc-
2 					-----tions--in	the--SGML
 					     tions  in	the  SGML
2 					-----declaration.
 					     declaration.

2 			------should	-----Warn--about--various
 			      should	     Warn  about  various
2 					-----recommendations-made
 					     recommendations made
2 					-----in	ISO-8879-that-the
 					     in	ISO 8879 that the
2 					-----document	does--not
 					     document	does  not
2 					-----comply	----with.
 					     comply	    with.
2 					-----(Recommendations-are
 					     (Recommendations are
2 					-----expressed	-----with
 					     expressed	     with
2 					-----``should'',--as-dis-
 					     ``should'',  as dis-
2 					-----tinct-from	-require-
 					     tinct from	 require-
2 					-----ments-which-are-usu-
 					     ments which are usu-
2 					-----ally-expressed--with
 					     ally expressed  with
2 					-----``shall''.)
 					     ``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
 			      undefined	     Warn about	undefined
2 					-----elements:	-elements
 					     elements:	 elements
2 					-----used-in-the-DTD--but
 					     used in the DTD  but
2 					-----not-defined.
 					     not defined.

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

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

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

2 			------min-tag	-----Warn-about	minimized
 			      min-tag	     Warn about	minimized
2 					-----start--and	end-tags.
 					     start  and	end-tags.
2 					-----Equivalent	to-combi-
 					     Equivalent	to combi-
2 					-----nation--of	unclosed,
 					     nation  of	unclosed,
2 					-----empty-and-net--warn-
 					     empty and net  warn-
2 					-----ings.
 					     ings.

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

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

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

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

2 			------The----following	---values-----for
 			      The    following	   values     for
2 			------warning_type-disable-errors:
 			      warning_type 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-ele-
 				   reference  value which no ele-
2 				---ment	-has--as--its--ID.----The
 				   ment	 has  as  its  ID.    The
2 				---effect--will	-be--as	-if--each
 				   effect  will	 be  as	 if  each
2 				---attribute-declared--as--an--ID
 				   attribute declared  as  an  ID
2 				---reference---value---had---been
 				   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
 				   Do not give an  error  when	a
2 				---character-that-is-not-a-signi-
 				   character that is not a signi-
2 				---ficant-character-in-the-refer-
 				   ficant character in the refer-
2 				---ence	concrete-syntax	occurs-in
 				   ence	concrete syntax	occurs in
2 				---a-literal-in	the-SGML-declara-
 				   a literal in	the SGML declara-
2 				---tion.---This	-may-be	useful-in
 				   tion.   This	 may be	useful in
2 				---conjunction-with-certain-buggy
 				   conjunction with certain buggy
2 				---test	suites.
 				   test	suites.

2 SEE-ALSO
 SEE ALSO
     html-check(1), html-ncheck(1), html-pretty(1), html-spam(1),
     htmlchek(1),   nsgmls(1),	sgmlnorm(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
