$ Help Text syntax
# syntax
K Help Text Syntax;Text Syntax;Syntax
@ Help Text Syntax

{\b In start of the topic (these must follow immediately the previous topic):}
 
 * build tag
          Specifies a build tag. Optional
 $ Title String
          Specifies the title used in Help History. Required
 # context
          Used when creating hyperlink/definitions to this topic. Required
 K Keyword
          Specifies a keyword for Search. Separate multiple keywords by ';' (semicolon). Optional
 + browse seq
          Specifies browse sequence. Optional
 ! Macro()
          Starts =Windows Help Macro=[help_macros]. optional

also defined by Help Text Format, if followed immediately the previous definitions:
 @ Title
          Specifies a non-scrolling title at top of the help topic. Optional


{\b After the previous definitions starts the topic text:}

Any 8-bit ascii text is accepted, also =rtf-statements=[!JumpKeyword("tcwhelp.hlp", "RTF Tokens")] {\fs16 (link)}. If ' \_ ', ' \= ', ' \[ ' or ' \] ' -characters are used, they must be preceded by ' \\ ' (backslash). Backslash (\\) must be written \\\\. For example you should write: "Type in \\\=Command() to start the macro" if you want the \= to be displayed.

Definition:
	\_text to be defined\_\[context\]
Hyperlink:
	\=topic to jump to\=\[context\]
'context' must be defined as a context string in one of the available topics. Don't leave space between \_ (or \=) and \[ !!

You can intend a paragraph by starting it with the '>'-character.

{\b Topic text ends with three minus signs in a beginning of a new line:}
 ---

{\b See also:}
    Using =windows Help Macros=[help_macros].
    Reference for =RTF tokens=[ !JumpKeyword("tcwhelp.hlp", "RTF Tokens") ] {\fs16(a link to Borland C++ 3.1 help)}.
    =Inserting links=[ insert_link ]
    =Inserting pictures=[ pictures ] in your help file.
    =Syntax highlighting=[ highlight ].
---
$ Inserting pictures
# pictures
K Inserting pictures;Pictures;Bitmaps
@ Inserting pictures in your help file

You can also insert pictures in your help file. This is done with one of the following statements:

    {\b \\\'7bbmc {\i picture}\\\'7d} 	inserts a metafile or bitmap in the text
    {\b \\\'7bbml {\i picture}\\\'7d}	inserts a metafile or bitmap at the left margin
    {\b \\\'7bbmc {\i picture}\\\'7d} 	inserts a metafile or bitmap at the right margin

{\i picture} specifies the filename of the bitmap or the metafile (with .bmp or .wmf -extension). The picture must be in the same directory as the help project.

An easier way to insert a picture without having to remember the above syntax, is to use the menu command {\b Edit->Insert Picture}. This prompts you with a dialog showing you all the BMP-files in your project directory. You can then choose the right picture, and it's placement (text, right or left margin) with the radio buttons. Pressing OK-button inserts the picture.

Pictures can also contain a hyperlink or definition. Simply insert picture in your help text with one of the previous statements, select the whole statement and =insert a link=[ insert_link ]. The result looks for example like this:

   {\b  \=\\\'7bbmc {\i picture.bmp}\\\'7d\=\[ picturedefinition \]}
---
$ Syntax highlighting
# highlight
K Syntax highlighting
@ Syntax highlighting

Help text edit windows have a special syntax highlighting, which means, that the text is coloured when it has a special meaning. This helps the user to write the help text correctly.

Colours used in the syntax highlighting are:

Start of the topic:		red text
Non-scrolling title:		purple text
Defined or hyperlink text:	green text
Definition/hyperlink context:	blue text

See =help-text syntax=[ syntax ].
---