Options

All options and swiches are case-insensitive. If you start hsc without any options, a short help message will be displayed.

HELP

Display a short help message.

[FROM=]inputfile_name

Specifies the input filename. To use stdin as input file, see PIPEIN.

[TO=]output_filename

Specifies the output filename. If no output file is given, stdout is used instead.

[DESTDIR]=destination_directory

Specifies the destination directory for output file.

ERRFILE=error_filename

Redirects error output to a file. By default, stderr ist used.

INCLUDE=INC

File(s) to include before main-input file is read. Useful to include macro-definitions without an <$include>. Recommended to be used within makefiles.

IGNORE=IGN

Ignore warning message number. Usually, IGNORE needs a numeric argument and can occure multiple. Example:

        IGNORE=21 IGN=18 IGN 3         (ignore warnings #21, #18, #3)

Additionally, you can give IGNORE some special values:

ALL

Ignore all non-error messages

NOTES

Ignore all notes

BADSTYLE

Ignore all bad style warnings

All these special values add new messages to the list of messages to be ignored, but do not reset any IGNOREs passed before.

MODE

Set base mode for syntax check. Legal values are PEDANTIC, NORMAL and RELAXED. Default is NORMAL. This only disables several messages and warnings from the beginning. Any IGNOREs passed before are reseted.

STATUS

Display several status messages (output goes to stderr). Legal flags are:

• QUIET: no status messages
• LINE: display name and line of file currently processing Included files are also displayed. After processing a file, the filename and the total number of lines remain visible.
• VERSION: display program title and version
• VERBOSE: enable verbose status messages; for example, the information displayed during the processing of <$exec> remains visible.

The above flags can be combined by separating them with a "|", eg STATUS=line|version, exept for QUIET.

STRIPTAGS=tag_list

Strip some specific tags from document. tag_list is a string, that contains all tags that should be stripped, sepparated by a "|". See also STRIPCOMMENT and STRIPEXTERNAL.

Switches

CHECKURI

Check existence of local URIs

COMPACT

Strip redundant linefeeds and white-spaces from output.

GETSIZE

Get width and height of images and set corresponding attributes with this values; only works for GIF and PiNG at the moment.

PIPEIN

Read input file from stdin

RPLCENT

Replace special charaters with its entity (eg "ü" becomes "&uuml").

SMARTENT

Replace special charaters "&", "<" and ">" with its entity (&, < and >) if they are surrounded by white-spaces. Also replace quotes by ".

STRIPCOMMENT

Strip all SGML-comments from input.

STRIPEXTERNAL

Strip tags, that reference to an external URI.