Macro/Tag flags

Within <$MACRO> and <$DEFTAG>, you can use several flag to tell hsc how to handle this macro/tag. Legal flags for <$MACRO> are:

ONLYONCE (short: 1)

macro/tag is required at the most once within a document

REQUIRED (short: R)

macro/tag is required at least once within a document

MUST_BE_INSIDE (short: MBI)

Needs a string as argument, that contains a list of container tags, that must be started before tag is allowed to be used.
Example:
The tag <LI> must be used inside some sort of lists only, therefor it's MBI is set:

        MBI="ul|ol|dir|menu"

The '|' is used as a separator for multiple tags.

NOT_ALLOWED_WITHIN (short: NAW)

Like MBI, but this time tags that must not be used before are passed as argument. For example, a nested usage of <A> is not allowed, therefor

        NAW="a"

is used.

Additionally, the following flags can be used with <$DEFTAG>

CLOSE (short: C): macro/tag is a container and requires a coresponding closing tag
AUTOCLOSE (short: AC): Used for <P> and <LI>, which can be used as container or single tag depending on the HTML version.
JERK (short: J): tag is only used by jerks
OBSOLETE (short: O): macro/tag is obsolete and should not be used any more
SKIPLF (short: S): skip a linefeed ("\n") that comes immediatly after the tag

For examples, see the section about <$MACRO>.

Thomas Aglassinger ( agi@sbox.tu-graz.ac.at ), 21-Dec-1995