65 lines
2.9 KiB
Plaintext
65 lines
2.9 KiB
Plaintext
Last Update: 09/17/96.
|
|
|
|
HSPLIT splits an input file in to two header files. The split is
|
|
controlled by tags written in the input file.
|
|
|
|
Traling parameters that are not preceded by a switch are assumed to be
|
|
input files. Multiple input files can be specifed. The -i switch can
|
|
also be used to specify the input file.
|
|
|
|
The header (output) files are specified through the -o switch. The first
|
|
one is the public header and the second one is the internal header.
|
|
|
|
A tag is a TagMarker plus a collection of subtags: like this:
|
|
|
|
<TagMarker>[begin/end][_public/internal/both][_subtag1[_subtag2]...][_if_str__comp_version | version]
|
|
|
|
The TagMarker and at least one other subtag are required to make up a valid
|
|
tag. Spaces are allowed between the TagMarker and the first subtag. All
|
|
other subtags are concatenated by "_" and no spaces are allowed between them.
|
|
The TagMarker must be specified in the proper case; subtags are not case
|
|
sensitive.
|
|
|
|
TagMarker is ";" by default. It can be changed by using the -c switch.
|
|
Only the last tag in a line is processed. All others are ignored.
|
|
Any text between a valid tag and the end of the line is ignored.
|
|
|
|
Untagged lines are copied to the public header only.
|
|
|
|
begin/end mark a block of lines. Blocks can be nested. If no begin/end is
|
|
specified, the tag only affects the line it's on. If one specified, it
|
|
must be the first subtag after the TagMarker.
|
|
|
|
public/internal/both determine what header file the line/block should go to.
|
|
If none of these is specified, the output goes to the public file only.
|
|
|
|
Subtags can be defined through the command line as follows:
|
|
-ta subtag1 subtag2 .... Process line/block
|
|
-ti subtag1 subtag2 .... Ignore tag
|
|
-ts subtag1 subtag2 .... Skip line/bloxk
|
|
Tags containing subtags specified through the -ta switch are parsed
|
|
and processed. Tags containing subtags specifed through -ti are
|
|
ignored; this is, the line/block is treated as untagged. Finally,
|
|
lines/blocks containing tags specified throgh -ts are skipped; this is,
|
|
the line/block is not written to any output file.
|
|
|
|
For compatibility with the old hsplit, several subtags are defined when
|
|
using the -4, -p, -e or -n command swithces. These subtags are processed,
|
|
ignored or skipped on a compatible way with the old hsplit.
|
|
|
|
For compatibility, tags containing undefined subtags are ignored. If the
|
|
-u switch (for Unknown) is specifed, such tags are skipped.
|
|
|
|
The version subtag is a 3 digit hex number, like 400, 40A or 500. There is
|
|
default version which can be changed through the -v switch. Tags containing
|
|
version subtags greater than the default/-v version are skipped. If no
|
|
version subtag is specified, the tag is processed according to the other
|
|
subtags.
|
|
|
|
the _if_str_comp_version subtag is used to generate #ifdef(str comp version)
|
|
#endif blocks/lines in the output file. if comp is not specified, it defaults
|
|
to ">=". if str itself contains "_", it should enclosed in (), like this:
|
|
if_(_foo_)_500 which generates #ifdef(_foo_ >= 500) - #endif.
|
|
|
|
|