SGMLNORM(1) User Commands SGMLNORM(1) NAME sgmlnorm - normalize SGML tags SYNOPSIS sgmlnorm [ -c catalog-file ] [ -d file-directory-name ] [-e] [ -k cm ] [ -w warning_type ] [ in-sgml-file or out-sgml-file DESCRIPTION sgmlnorm is a tag normalizer for SGML files. It supplies all omitted optional closing tags, helping to clarify the scope of each ... pair. spam(1) is another SGML tag normalizer from the same software suite. OPTIONS -c catalog-file Provide the full path name of the SGML catalog file, which is needed to relate the document type name in the initial SGML 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 - d directory-name Add a file directory name to the default search path used to locate files specified in system identifiers in declarations. Multiple -d options are allowed. -e Describe open entities in error mes- sages. Error messages always include the position of the most recently opened external entity. -k cm This option requires either c, or m, or both, in either order. The letter c requests output of any embedded SGML comments; otherwise, comments are nor- mally discarded. The letter m requests output of marked sections. [It is Version 1.00 Last change: 14 December 1996 1 SGMLNORM(1) User Commands SGMLNORM(1) unclear what the m option is supposed to do.] -w warning_type Control warnings and errors. Multiple - w options are allowed. The following values of warning_type enable warnings: mixed Warn about mixed content models that do not allow #pcdata anywhere. sgmldecl Warn about various dubi- ous constructions in the SGML declaration. should Warn about various recom- mendations 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''.) default Warn about defaulted references. duplicate Warn about duplicate entity declarations. undefined Warn about undefined ele- ments: elements used in the DTD but not defined. unclosed Warn about unclosed start and end-tags. empty Warn about empty start and end-tags. net Warn about net-enabling start-tags and null end- tags. min-tag Warn about minimized start and end-tags. Equivalent to combination of unclosed, empty and net warnings. Version 1.00 Last change: 14 December 1996 2 SGMLNORM(1) User Commands SGMLNORM(1) unused-map 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. unused-param Warn about parameter entities that are defined but not used in a DTD. all Warn about conditions that should usually be avoided (in the opinion of the author). Equivalent to: mixed, should, default, unde- fined, sgmldecl, unused- map, unused-param, empty and unclosed. A warning can be disabled by using its name prefixed with no-. Thus -wall - wno-duplicate will enable all warnings except those about duplicate entity declarations. The following values for warning_type disable errors: no-idref 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. no-significant Do not give an error when a charac- ter that is not a significant char- acter in the reference concrete syntax occurs in a literal in the SGML declaration. This may be use- ful in conjunction with certain buggy test suites. 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), Version 1.00 Last change: 14 December 1996 3 SGMLNORM(1) User Commands SGMLNORM(1) spent(1), 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: WWW URL: http://www.math.utah.edu/~beebe Version 1.00 Last change: 14 December 1996 4