📄 spam.htm
字号:
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML Strict//EN"><HTML><HEAD><TITLE>SPAM</TITLE></HEAD><BODY><H1>SPAM</H1><H4>An SGML System Conforming toInternational Standard ISO 8879 --<BR>Standard Generalized Markup Language</H4><H2>SYNOPSIS</H2><P><CODE>spam</CODE>[<CODE>-Cehilprvx</CODE>][<CODE>-c<VAR>catalog_file</VAR></CODE>][<CODE>-D<VAR>directory</VAR></CODE>][<CODE>-f<VAR>file</VAR></CODE>][<CODE>-m<VAR>markup_option</VAR></CODE>][<CODE>-o<VAR>entity_name</VAR></CODE>][<CODE>-w<VAR>warning_type</VAR></CODE>]<CODE><VAR>sysid...</VAR></CODE><H2>DESCRIPTION</H2><P>Spam (SP Add Markup)is an SGML markup stream editor implemented using the SP parser.Spam parses the SGML document contained in<CODE><VAR>sysid...</VAR></CODE>and copies to the standard outputthe portion of the document entity containing the documentinstance, adding or changing markup as specified by the<CODE>-m</CODE> options.The <CODE>-p</CODE>option can be used to include the SGML declaration and prologin the output.The <CODE>-o</CODE>option can be used to output other entities.The<CODE>-x</CODE>option can be used to expand entity references.<P>The following options are available:<DL><DT><CODE>-c<VAR>file</VAR></CODE><DD>Use the catalog entry file<CODE><VAR>file</VAR></CODE>.<DT><CODE>-C</CODE><DD>This has the same effect as in <A HREF="nsgmls.htm#optC">nsgmls</A>.<DT><CODE>-D<VAR>directory</VAR></CODE><DD>Search<CODE><VAR>directory</VAR></CODE>for files specified in system identifiers.This has the same effect as in <A HREF="nsgmls.htm#optD">nsgmls</A>.<DT><CODE>-e</CODE><DD>Describe open entities in error messages.<DT><CODE>-f<VAR>file</VAR></CODE><DD>Redirect errors to<CODE><VAR>file</VAR></CODE>.This is useful mainly with shells that do not support redirectionof stderr.<DT><CODE>-h</CODE><DD>Hoist omitted tags out from the start of internal entities.If the text at the beginning of an internal entity causesa tag to be implied,the tag will usually be treated as being in that internal entity;this option will instead cause it to be treated as being in the entitythat referenced the internal entity.This option makes a difference in conjunction with<CODE>-momittag</CODE>or<CODE>-x -x</CODE>.<DT><CODE>-i<VAR>name</VAR></CODE><DD>This has the same effect as in <A HREF="nsgmls.htm#opti">nsgmls</A>.<DT><CODE>-l</CODE><DD>Prefer lower-case.Added names that were subject to upper-case substitutionwill be converted to lower-case.<DT><CODE>-m<VAR>markup_option</VAR></CODE><DD>Change the markup in the output according to the valueof<CODE><VAR>markup_option</VAR></CODE>as follows:<DL><DT><CODE>omittag</CODE><DD>Add tags that were omitted using omitted tag minimization.End tags that were omitted because the element hasa declared content of <SAMP>EMPTY</SAMP>or an explicit content referencewill not be added.<DT><CODE>shortref</CODE><DD>Replace short references by named entity references.<DT><CODE>net</CODE><DD>Change null end-tagsinto unminimized end-tags,and change net-enabling start-tagsinto unminimized start-tags.<DT><CODE>emptytag</CODE><DD>Change empty tags into unminimized tags.<DT><CODE>unclosed</CODE><DD>Change unclosed tags into unminimized tags.<DT><CODE>attname</CODE><DD>Add omitted attribute names and<CODE>vi</CODE>s.<DT><CODE>attvalue</CODE><DD>Add literal delimiters omitted from attribute values.<DT><CODE>attspec</CODE><DD>Add omitted attribute specifications.<DT><CODE>current</CODE><DD>Add omitted attribute specifications for current attributes.This option is implied by the<CODE>attspec</CODE>option.<DT><CODE>shorttag</CODE><DD>Equivalent to combination of<CODE>net</CODE>,<CODE>emptytag</CODE>,<CODE>unclosed</CODE>,<CODE>attname</CODE>,<CODE>attvalue</CODE>and<CODE>attspec</CODE>options.<DT><CODE>rank</CODE><DD>Add omitted rank suffixes.<DT><CODE>reserved</CODE><DD>Put reserved names in upper-case.<DT><CODE>ms</CODE><DD>Remove marked section declarations whose effective statusis IGNORE, and replace each marked section declarationwhose effective status is INCLUDE by its marked section.In the document instance, empty comments will be addedbefore or after the marked section declaration to ensurethat ignored record ends remain ignored.</DL><P>Multiple<CODE>-m</CODE>options are allowed.<DT><CODE>-o<VAR>name</VAR></CODE><DD>Output the general entity<CODE><VAR>name</VAR></CODE>instead of the document entity.The output will correspond to the first timethat the entity is referenced in content.<DT><CODE>-p</CODE><DD>Output the part of the document entity containing the SGML declaration(if it was explicitly present in the document entity)and the prolog before anything else.If this option is specified two or more times,then all entity references occurring between declarationsin the prolog will be expanded;this includes the implicit reference to the entitycontaining the external subset of the DTD, if there is one.Note that the SGML declaration will not be included if it wasspecified by an SGMLDECL entry in a catalog.<DT><CODE>-r</CODE><DD>Don't perform any conversion on RSs and REs when outputting the entity.The entity would typically have the storage manager attribute<CODE>records=asis</CODE>.<DT><CODE>-v</CODE><DD>Print the version number.<DT><CODE>-w<VAR>type</VAR></CODE><DD>Control warnings and errors according to<CODE><VAR>type</VAR></CODE>.This has the same effect as in <A HREF="nsgmls.htm#optw">nsgmls</A>.<DT><CODE>-x</CODE><DD>Expand references to entities that are changed.If this option is specified two or more times,then all references to entities that contain tagswill be expanded.</DL><H2>BUGS</H2><P>Omitted tags are added at the point where they areimplied by the SGML parser (except as modifiedby the<CODE>-h</CODE>option); this is often not quite where they are wanted.<P>The case of general delimiters is not preserved.<P>Incorrect results may be produced if a variant concrete syntax is usedwhich is such that there are delimiters in markup to be added that have aprefix that is a proper suffix of some other delimiter.<P>If an entity reference in a default value uses the default entity andan entity with that name is subsequently defined and that defaultvalue is added to the document instance, then the resulting documentmay not be equivalent to the original document.Spam will give a warning when the first two conditions are met.<P><ADDRESS>James Clark<BR>jjc@jclark.com</ADDRESS></BODY></HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -