Including Comments and Writer's Memos

Frequently it is useful to include within your source files comments that are not intended to be part of the help text. Text marked with the comment element is always ignored by the HelpTag software. Comments can be used to make notes to yourself or another author, or to exclude some markup without taking it out of the file.

In addition to standard comments, HelpTag also provides a <memo> element for entering writer's memos. Memo notes appear in your help topics during reviews, but not when you make your final help files. Authors commonly use the <memo> element to write questions or make notes to reviewers.

To insert a comment

Use the comment begin marker () as shown:

The HelpTag software ignores all markup between the . A comment cannot be nested within another comment.

Example. Here's an example that has two comments, a line before the paragraph, and a single word within the paragraph.

   <!-- Here is my rough draft of the introduction: -->



   Welcome to my application.  This software

   is <!-- perhaps --> the fastest and most 

   efficient software you'll ever own.

To insert a writer's memo

Use the <memo> element as shown:
<memo> text <\memo>

By default, the text within the <memo> element is ignored by the HelpTag software (just like a comment). However, if you add the memo option to your helptag.opt file (or specify the memo option with the helptag command), all memos within your help volume appear in a bold font.

Example. Suppose you are writing about your application and have a question for the project team. You can include the question within the text using the <memo> element like this:

   <memo>Team:  Will the product also 

   support 32-bit characters?<\memo>

If you process the help volume with the following command (or include memo in your helptag.opt file), the memo appears in the help text in a bold font.

   helptag  volume  memo

If the memo option is not used (or the nomemo option is used), the text within the memo is ignored and does not appear in the help text.

Including Comments and Writer's Memos

Technical documentation

» Table of Contents

» Glossary

» Index

To insert a comment

To insert a writer's memo