windows-xp/Source/XPSP1/NT/sdktools/hsplit

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.