DOCUMENT:Q122141  08-NOV-1994  [FOXPRO]
TITLE   :INF: How to Build a Sample Windows-Style Help File
PRODUCT :Microsoft FoxPro
PROD/VER:2.5x 2.60 2.60a
OPER/SYS:WINDOWS
KEYWORDS:kbtool kbusage

------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft FoxPro for Windows, versions 2.5x, 2.6, 2.6a
------------------------------------------------------------------------

SUMMARY
=======

In FoxPro, you have the choice of creating a .DBF-style Help file or a
Windows-style Help file. This article describes how to create a simple
Windows-style Help file that contains several topics with titles and
keywords.

This article assumes that you have read through the "Help Compiler Guide"
and are familiar with the concepts presented below. This article is
intended for use in conjunction with the "Help Compiler Guide."

MORE INFORMATION
================

To create a Windows-style Help file, you need the following:

 - The FoxPro Distribution Kit (DK), which includes the Help compiler.

 - A text editor or a word processor, such as Microsoft Word for Windows,
   capable of saving files in Rich Text Format (RTF).

Below is a list of the characters used in the Custom Footnote Mark text
box, and their descriptions.

   Character     Description
   -------------------------

   #             Context String
   $             Title
   K             Keywords

This article describes how to create an RTF file and a Help project file
using Word 6.0 for Windows, and then how to compile the RTF and Help
project files into a Help file.

To Create the RTF File
----------------------

 1. Open a new document in Word.

 2. From the Tools menu, choose Options. Select the View tab, and then
    select the following check boxes:

     - Paragraph Marks
     - Hidden Text
     - Line Breaks and Fonts as Printed

 3. From the Insert Menu, choose Footnote.

 4. Type "#" (without the quotation marks) in the Custom Footnote Mark text
    box. This opens the footnote pane.

 5. Type "Contents" (without the quotation marks) in the footnote pane.

 6. Click the document window, and then repeat the footnote procedure
    (steps 3-5) using the following entries in the appropriate parts of the
    document:

       Body of Document
       ----------------

       #$K

       Footnote of Document
       --------------------

       #Contents
       $Contents
       KContents;Main

 7. In the document window, type "{bmc fox.bmp}Contents" (without
    the quotation marks), and then press ENTER. The new entries should
    appear in the body of the document as follows:

       #$K{bmc fox.bmp}Contents

 8. In the document window, select the word "Contents", and then format it
    as Arial, 18pt, bold. Press ENTER.

 9. In the document window, type "Topic Onetopic_one" (without the
    quotation marks), and then press ENTER.

10. Select "Topic One" and format it as double-underline.

11. Select "topic_one" and format it as hidden text.

12. Repeat steps 9-11, using "Topic Twotopic_two" and "Topic
    Threetopic_three" (without the quotation marks).

13. In the document window, type "Topic Three" (without the quotation
    marks), and then press ENTER. From the Insert menu, choose Break.

14. Insert a footnote, typing "#" (without the quotation marks) in the
    Custom Footnote Mark text box.  Type "topic_one" (without the quotation
    marks) in the footnote pane.

15. In the document window, type "Topic One" (without the quotation marks)
    next to the "#". Press ENTER, and then TAB, to create and indent a new
    line. Type "This is Topictopic_def one!" (without the quotation marks).
    The new entries should appear as follows:

       Body of Document
       ----------------

       #Topic One
             This is Topictopic_def one!

       Footnote of Document
       --------------------

       #topic_one

16. Format "Topic" as a single underline, and "topic_def" as hidden text.

17. Repeat steps 13-14 using "Topic Two" and "Topic Three" (without the
    quotation marks). Type some text.

18. After "Topic Three", insert another page break, and then insert a
    footnote with "#" (without the quotation marks) as the Custom Footnote
    Mark.

19. Type "topic_def" (without the quotation marks) in the footnote pane.

20. Type "Topic" (without the quotation marks) in the body, next to "#".
    Press ENTER, then TAB, and then type some text.  The new entries should
    appear as follows:

       Body of Document
       ----------------

       #Topic
             This is another topic.

       Footnote of Document
       --------------------

       #topic_def

21. Save the document as an RTF file with the name HELP.RTF.

To Create the Help Project File
-------------------------------

1. Open a new document in Word, and then type the following:

      [OPTIONS]
      Compress=OFF
      WARNING=3
      ERRORLOG=error.log
      REPORT=ON

      [FILES]
      help.rtf

      [WINDOWS]
      main="My Help File",(0,0,1023,1023),,, (192,192,192)

2. Save the document as a text file with the name HELP.HPJ.

3. Close HELP.RTF and HELP.HPJ and then minimize Word.

To Compile the Help File
------------------------

1. Run an MS-DOS prompt session. Use the MS-DOS "CD" (change directory)
   command to move to the directory containing the HC31.EXE file.

2. Type "HC31 HELP" (without the quotation marks) to compile the Help
   project.

   NOTE: Any compilation errors that may occur are displayed on the screen.

3. After the Help project has successfully been compiled, type "EXIT"
   (without the quotation marks) to close the MS-DOS prompt session.

4. Start Windows File Manager. Locate and double-click HELP.HLP to view
   the compiled Help file.

For more information, see the "Help Compiler Guide."

Additional reference words: FoxWin 2.50 2.50a 2.50b 2.60 2.60a graphical-
style
help example
KBCategory: kbtool kbusage
KBSubcategory:

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 1994.