windows-server-2003/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.