Home Man
Today's Posts

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for spam (redhat section 1)

OSPAM(1)				      ospam					 OSPAM(1)

       ospam  - An SGML System Conforming to International Standard ISO 8879 -- Standard General-
       ized Markup Language

       ospam [-Cehilprvx] [-ccatalog_file] [-Ddirectory]
	     [-ffile] [-mmarkup_option] [-oentity_name]
	     [-wwarning_type] [sysid...]

       ospam (OpenJade SP Add Markup) is an SGML  markup  stream  editor  implemented  using  the
       OpenSP  parser.	ospam parses the SGML document contained in sysid and copies to the stan-
       dard output the portion of the document entity containing the document instance, adding or
       changing  markup  as specified by the -m options. The -p option can be used to include the
       SGML declaration and prolog in the output. The -o option can be used to output other enti-
       ties. The -x option can be used to expand entity references.

       The following options are available:

       -cfile Use the catalog entry file file.

       -C     This has the same effect as in onsgmls(1).

	      Search  directory  for  files  specified	in  system identifiers. This has the same
	      effect as in onsgmls(1).

       -e     Describe open entities in error messages.

       -ffile Redirect errors to file. This is useful mainly with shells that do not support  re-
	      direction of stderr.

       -h     Hoist  omitted  tags  out  from  the start of internal entities. If the text at the
	      beginning of an internal entity causes a 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 entity that referenced the  internal  entity.  This  option
	      makes a difference in conjunction with -momittag or -x -x.

       -iname This has the same effect as in onsgmls(1).

       -l     Prefer lower-case. Added names that were subject to upper-case substitution will be
	      converted to lower-case.

	      Change the markup in the output according to the value of markup_option as follows:

	      omittag Add tags that were omitted using omitted tag minimization.  End  tags  that
	      were  omitted  because  the  element has a declared content of EMPTY or an explicit
	      content reference will not be added.

	      shortref Replace short references by named entity references.

	      net Change null end-tags into unminimized end-tags, and change net-enabling  start-
	      tags into unminimized start-tags.

	      emptytag Change empty tags into unminimized tags.

	      unclosed Change unclosed tags into unminimized tags.

	      attname Add omitted attribute names and vis.

	      attvalue Add literal delimiters omitted from attribute values.

	      attspec Add omitted attribute specifications.

	      current Add omitted attribute specifications for current attributes. This option is
	      implied by the attspec option.

	      shorttag Equivalent to combination of net, emptytag,  unclosed,  attname,  attvalue
	      and attspec options.

	      rank Add omitted rank suffixes.

	      reserved Put reserved names in upper-case.

	      ms Remove marked section declarations whose effective status is IGNORE, and replace
	      each marked section declaration whose effective status is  INCLUDE  by  its  marked
	      section. In the document instance, empty comments will be added before or after the
	      marked section declaration to ensure that ignored record ends remain ignored.

	      Multiple -m options are allowed.

       -oname Output the general entity name instead of the document entity. The output will cor-
	      respond to the first time that the entity is referenced in content.

       -p     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 declarations in the prolog will be expanded;  this  includes  the  implicit
	      reference to the entity containing the external subset of the DTD, if there is one.
	      Note that the SGML declaration will not be included  if  it  was	specified  by  an
	      SGMLDECL entry in a catalog.

       -r     Don't  perform any conversion on RSs and REs when outputting the entity. The entity
	      would typically have the storage manager attribute records=asis.

       -v     Print the version number.

       -wtype Control warnings and errors according to type. This has the same effect as in  ons-

       -x     Expand  references to entities that are changed. If this option is specified two or
	      more times, then all references to entities that contain tags will be expanded.

       Omitted tags are added at the point where they are implied by the SGML parser  (except  as
       modified by the -h option); this is often not quite where they are wanted.

       The case of general delimiters is not preserved.

       Incorrect  results may be produced if a variant concrete syntax is used which is such that
       there are delimiters in markup to be added that have a prefix that is a proper  suffix  of
       some other delimiter.

       If  an entity reference in a default value uses the default entity and an entity with that
       name is subsequently defined and that default value is added  to  the  document	instance,
       then  the  resulting  document  may not be equivalent to the original document. ospam will
       give a warning when the first two conditions are met.


       James Clark, Ian Castle <ian.castle@looksystems.co.uk>.

OpenJade				   January 2002 				 OSPAM(1)

All times are GMT -4. The time now is 03:39 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
Show Password