Porting Windows Help Source Files from Version 3.0 to 3.1

 Last reviewed: July 23, 1997
Article ID: Q86080
3.10 WINDOWS kbtool

The information in this article applies to:

  • Microsoft Windows Software Development Kit (SDK) for Windows versions 3.1 and 3.0

To successfully compile source files developed for version 3.0 of the Microsoft Windows Help Compiler with version 3.1 of the Help Compiler, make the following two changes to the Help Project (HPJ) file:

  • In the [OPTIONS] section, replace the INDEX statement with the CONTENTS statement. The CONTENTS statement provides the same functionality; it specifies the context string of the highest-level topic. This topic is usually a table of contents or an index of the help file. The Windows Help application displays the contents topic whenever the user chooses the Contents button. The syntax of the CONTENTS statement is as follows: 

          [OPTIONS]
      CONTENTS=context-string
  • If the Help file contains any browse sequences, add the browse buttons to the button bar with the following statement in the [CONFIG] section: 

          [CONFIG]
      BrowseButtons()

    Version 3.1 of the Windows Help Compiler does not display the browse buttons by default. For more information on browse buttons, see page 28 of the "Programming Tools" manual included with the Microsoft Windows Software Development Kit (SDK) version 3.1.

Because version 3.1 of the Windows Help Compiler cannot produce backwardly compatible help files, the files it creates are incompatible with version 3.0 of Windows Help. However, Windows Help version 3.1 will run under Microsoft Windows 3.0 and is redistributable. See the License Agreement for the Microsoft Windows SDK version 3.1 for information about reproducing and distributing WINHELP.EXE with your product.

Additional reference words: 3.00 3.10 HC31 HC31.EXE HCP HCP.EXE
KBCategory: kbtool
KBSubcategory: TlsHlp
Keywords : kb16bitonly

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.

Last reviewed: July 23, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.