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.
<!DOCTYPE document-type-name PUBLIC ``...\''>declaration to a grammar file that defines the syntax of the SGML tags in the remainder of the file.
This option is always required, because the current version of sgmlnorm has no built-in default catalog location.
At some UNIX sites, a suitable option will be -c /usr/local/lib/html-check/lib/catalog
<!DOCTYPE document-type-name SYSTEM ``filename''>declarations. Multiple -d options are allowed.
- Warn about mixed content models that do not allow #pcdata anywhere.
- Warn about various dubious constructions in the SGML declaration.
- Warn about various recommendations made in ISO 8879 that the document does not comply with. (Recommendations are expressed with ``should'', as distinct from requirements which are usually expressed with ``shall''.)
- Warn about defaulted references.
- Warn about duplicate entity declarations.
- Warn about undefined elements: elements used in the DTD but not defined.
- Warn about unclosed start and end-tags.
- Warn about empty start and end-tags.
- Warn about net-enabling start-tags and null end-tags.
- Warn about minimized start and end-tags. Equivalent to combination of unclosed, empty and net warnings.
- Warn about unused short reference maps: maps that are declared with a short reference mapping declaration but never used in a short reference use declaration in the DTD.
- Warn about parameter entities that are defined but not used in a DTD.
- Warn about conditions that should usually be avoided (in the opinion of the author). Equivalent to: mixed, should, default, undefined, sgmldecl, unused-map, unused-param, empty and unclosed.
A warning can be disabled by using its name prefixed with no-. Thus -wall will enable all warnings except those about duplicate entity declarations.
The following values for warning_type disable errors:
- Do not give an error for an ID reference value which no element has as its ID. The effect will be as if each attribute declared as an ID reference value had been declared as a name.
- Do not give an error when a character that is not a significant character in the reference concrete syntax occurs in a literal in the SGML declaration. This may be useful in conjunction with certain buggy test suites.
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: <firstname.lastname@example.org> WWW URL: http://www.math.utah.edu/~beebe