<!-- $XConsortium: he_htag2.sgm /main/6 1996/09/08 19:52:26 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<RefEntry Id="CDEMX.MAN19.rsml.1">
<RefMeta>
<RefEntryTitle>dthelp_htag2</RefEntryTitle>
<ManVolNum>user cmd</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Command>dthelp_htag2</Command></RefName>
<RefPurpose>second pass for parse of HelpTag source
</RefPurpose>
</RefNameDiv>
<!-- CDE Common Source Format, Version 1.0.0-->
<!-- *************************************************************************-->
<!-- **  (c) Copyright 1993, 1994 Hewlett-Packard Company-->
<!-- **  (c) Copyright 1993, 1994 International Business Machines Corp.-->
<!-- **  (c) Copyright 1993, 1994 Sun Microsystems, Inc.-->
<!-- **  (c) Copyright 1993, 1994 Novell, Inc.-->
<!-- *************************************************************************-->
<RefSynopsisDiv>
<CmdSynopsis>
<Command>dthelp_htag2  -</Command>
<Arg Choice="opt">cdhot</Arg>
<Arg>file</Arg>
<Arg Choice="opt">outfile</Arg>
</CmdSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para>The
<Command>dthelp_htag2</Command> executable
is invoked by
&cdeman.dthelptag; as the second
pass of translating HelpTag markup into SDL.
The
<Command>dthelp_htag2</Command> executable accepts the output of the first pass of
dthelptag (either
&cdeman.dthelp.htag1; or
&cdeman.dthelp.ctag1;) and computes the byte
offsets of virtual pages to be used in the runtime display of the SDL
volume.
If only one file is specified on the command line, the output file
will overwrite the input file.
If two files are specified, the output
will be placed in the second.
If the input file has no .sdl extension, one will be added.
If a
second file name is specified for output, it will be used without
modification.
The options to
<Command>dthelp_ctag2</Command> are:
</Para>
<VariableList>
<VarListEntry>
<Term>&minus;c:</Term>
<ListItem>
<Para>compress the SDL document on a per virtual page basis &minus; if
the document is already compressed, this command will result
in no change to the document.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>&minus;d:</Term>
<ListItem>
<Para>decompress an SDL document &minus; if the document is already
compressed, this command will result in no change to the
document; however, the byte offsets of virtual pages will be
recomputed.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>&minus;h:</Term>
<ListItem>
<Para>print a help message and exit.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>&minus;o:</Term>
<ListItem>
<Para>perform peephole optimization of the SDL document.
In
particular, <Literal>&lt;FORM></Literal> elements containing only a single <Literal>&lt;BLOCK></Literal> or
<Literal>&lt;FORM></Literal> without a user supplied identifier are replaced by that
single <Literal>&lt;BLOCK></Literal> or <Literal>&lt;FORM></Literal> with the identifier of the original
(outer) <Literal>&lt;FORM></Literal>.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>&minus;t:</Term>
<ListItem>
<Para>eliminate any <Literal>&lt;TOSS></Literal> sub-elements that are not used in this SDL
document.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>SEE ALSO</Title>
<Para>&cdeman.dthelptag;, &cdeman.dthelp.htag1;, &cdeman.dthelp.ctag1;, &cdeman.dtsdldtd;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 01:31:55-->
