Windows Software Help Files Formats

Are you still wondering which help file format to use for your Windows software? The selection depends on your software and on the information that is in your help files. Each help file format has its own unique features that may be useful in certain situations. Generally, I would recommend that you use different help files for different situations.

HTML (On-line manual): Hypertext Markup Language

The help system may consist of number of HTML pages. Each page is usually devoted to a specific topic and includes cross-links to other HTML pages. Often, there is a table of contents that allows fast navigation across the topic areas. Additionally, pages may contain special navigation links: next page, previous page, indexes, etc.

Usually the HTML help pages are uploaded on the product’s Website. Creating online help is preferable if your software is platform independent and users can also read the help file in their Web browsers on any operating system. Storing help files as HTML pages on your web site is also useful if you frequently update your documentation by adding new topics and pages. In this case, users do not have to download the entire help file after each update to their computer.

Moreover, the online help manual which is a part of your website generates a targeted traffic. People can easily find your product because the online help allows your website to be more visible in relevant search results on search engines. The new visitors will consider your products seriously when they see a well made help system. Also, if a first time users experience difficulties with your software and needs technical support, you may easily resolve the issue by referring them to a particular page of your online help. With just one click, the users will see screenshots and explanations which will help them to solve the problem.

CHM (HTML Help): Microsoft Compressed HTML Help

CHM is a help format introduced by Microsoft in 1997. The CHM help file is a set of web pages written in a subset of HTML and compressed together with LZX compression. The CHM file has a hyperlinked table of contents. It may also contain word indexes, and therefore, the CHM format is optimized for reading and searching.

The CHM file seems to be the most convenient way to deliver your software help in a single indexed file together with your program. Through the functions provided by hhctrl.ocx library, you may invoke HTML Help functions from any programming language. This HTMLhelp API allows opening a specific topic within the CHM file. Thus, with the CHM file you can easily implement a context sensitive help functionality in your software application.

For Windows users, this help file can be compiled with the HTML Help Workshop, which is distributed by Microsoft at no charge. Besides the HTML Help Workshop, there are commercial tools for creating CHM files faster and easier.

Although the CHM format was originally invented for the Windows platform, there are some tools which can read and navigate these files (e.g. xCHM, KchmViewer, GnoCHM, Chmox for OS X, or Chamonix for OS X), but they lack the various features of the Microsoft Windows tools.

HLP: Microsoft WinHelp

HLP (Microsoft WinHelp) is a proprietary format for help files that can be displayed by the Microsoft Help browser (winhelp.exe or winhlp32.exe modules). WinHelp 1.0 was introduced by Microsoft in 1990.

The source files require that you compile a .hlp file consisting of one or more Rich Text Format (RTF) documents and a help project file with the extension .hpj, along with any image files (.bmp, .wmf, or .shg) that are used within the Help file. An optional table of contents file with the extension .cnt can also be created for use with the .hlp file. The final help file can be compiled using a WinHelp compiler, which is distributed by Microsoft at no charge or by using a commercial help authoring program.

Although less advanced than the later CHM (Microsoft Compressed HTML Help) format, HLP remains a popular Help platform from the Windows 3.0 platform through to Windows XP. Support of HLP files was removed in Windows Vista; therefore the HLP file format is considered obsolete.

PDF: Portable Document Format

PDF is a document file format created by Adobe Systems in 1993 and is now being prepared for submission as an ISO standard. Each PDF file encapsulates the text, fonts, images, and vector graphics that compose the document. While PDF can describe very simple one page documents, it may also be used for multiple pages, complex documents that use a variety of fonts, graphics, colors, and images.

The PDF help file is preferable for platform independent applications because it is used for representing two-dimensional documents in a device independent and resolution independent fixed-layout format. PDF supports forms, links, and bookmarks that allow easy navigation in the document. Because PDF represents documents as a sequential set of pages, it is convenient for printing. PDF supports encryption and digital rights management restrictions.

You can distribute your PDF help file with your software as well as store it remotely on your website. Web search engines, like Google, may index the text content of the PDF file and it will appear in the relevant search engine results.

There are many programs for creating PDFs, including the PDF printing capability built in to Mac OS X, the multi-platform OpenOffice.org, Microsoft Office 2007 (a free download from Microsoft is required), PDF print drivers for Microsoft Windows, and Adobe Acrobat itself. There is also specialized software for editing PDF help files, e.g. Dr.Explain.

RTF: Rich Text Format & DOC: Microsoft Word

RTF is a proprietary document file format developed by DEC in 1987 for cross-platform document interchange. Then, RTF format was purchased by Microsoft around 1990, who extended the standard. Most text processors are able to read and write RTF documents.

DOC (an abbreviation of ‘document’) is a Microsoft Word file format. Proprietary DOC files often contain more text formatting information (as well as scripts and ‘undo’ information) than files using RTF and HTML, but are usually less compatible.

Like PDF, RTF & DOC are good for printing documentation, while they may look slightly different in various readers on different operating systems, specifically graphics and embedded objects. These formats may be less convenient for complex documents with multiple pages and objects because of the significant amount of computer memory consumed while being displayed.

These formats may be created with numerous text editing software programs as well as with specialized help authoring software that supports RTF\DOC output.

TXT: Plain Text File

TXT is a computer file which contains only ordinary textual characters with essentially no formatting. Text file is meant to be read as is. The main disadvantages of using TXT files for help are: no graphics, formatting, or navigation. As a result, TXT is only preferable for short documents like installation and release notes and legal documents. Usually TXT documentation is distributed with simple and relatively small applications, like PDA programs or games. You may create a TXT file in any text editor.

Conclusion

Evaluate how your software can be distributed and how people will use it. Do they need a context help file in the application or will they print out the entire help file and keep the manual on their desk? How often will you update the help file? Is it relatively easy to distribute together with your program files or is it better to store it on the website? Answering these questions will help you decide which format is best.

Often the combination of approaches will work best. You may keep the HTML manual on your website for reference and it may attract people from search engines, distribute the CHM file with the application for context sensitive help, and upload the printable version of the help file in PDF or RTF\DOC format on the public website for those who may want to print out the entire document as a reference.

Dennis Crane, the author of Dr.Explain, specializes in help authoring software development. He is online at http://www.drexplain.com

You are permitted to reprint this text as long as it includes copyright notice and link to our web site.

How to Open .HLP WinHelp Files in Windows 10

Due to some security concerns related to now-very-outdated WinHelp files that usually come with .HLP file extension, Microsoft decided to pull the plug and stopped supporting these files in Windows Vista, 7, 8.x and now in Windows 10. Before Windows 10, users had option to download WinHlp32 Viewer (KB917607) from Microsoft’s website and install it on their PC if they needed to view the HLP files. But Windows 10 users have no such luck since Microsoft has decided not to offer any such option for them. And if you try to install the KB917607 hotfix released for Windows 7 or 8.x on your Windows 10 system, then it displays the update incompatibility message.

So what the Windows 10 users are supposed to do? If you really want to access the .HLP files on your Windows 10, then we at TrishTech.com have created a tiny utility that can extract WinHlp32.exe from KB917607 hotfix files for you. First you have to extract the files from this hotfix and then replace the ones from the Windows folder with these files.

Part 1: Extraction of Files

Visit https://support.microsoft.com/en-us/kb/917607 and download 32-bit WinHlp32.exe hotfix for Windows 8 (32-bit version has “x86” in the file name). If you are having any trouble downloading, try using Firefox web browser instead of Edge or Internet Explorer.
Download our tool – magic.zip. Extract magic.exe from the downloaded archive.
Put both magic.exe and the downloaded KB917607 update MSU file (e.g., Windows8-RT-KB917607-x86.msu) in the same folder.
Double-click on magic.exe and wait a couple of seconds. Now you have WinHlp32.exe and supporting files for your use. You can delete magic.exe if you want. Do not delete the Windows8-RT-KB917607-x86.msu file, it is needed for Part 2.

Part 2: Replacing Files in Windows Folder

Download replace-winhlp32.zip, extract replace.bat from it and copy it in the same folder where you have extracted the WinHlp32.exe file and other helper files.
Skip this step if you use English as the Windows interface language. If you are not using English as the default Windows system language, then edit replace.bat and change en-US to your own language in the last line. For example, if you want Russian language, then replace en-US with ru-RU, if you use French then replace with fr-FR and so on.
Download Process Hacker from https://github.com/processhacker/processhacker/releases. You can download the installer version and install it in your PC. But I personally like the portable (binaries) version which does not need to be installed.
Launch Process Hacker with elevated privileges (right-click on ProcessHacker.exe and select Run as administrator). Keep it running.
Double-click on Windows8-RT-KB917607-x86.msu to launch the update. Of course, this update is not for Windows 10 and will fail. Do not close any dialogs or error messages that it shows.
Quickly switch back to Process Hacker, locate TrustedInstaller.exe in the list of processes, right-click on it and select Miscellaneous → Run as this user from the right-click menu.
In the program command type cmd.exe and click on the OK button.
When the command prompt window opens up, change the drive letter and path to the folder where you have extracted WinHlp32.exe and Replace.bat. For example, if you have extracted these files to E:\Helper, then first type E: and press Enter in the command prompt. Then type CD E:\Helper in the command prompt and press Enter.
Next, type Replace.bat in the command prompt and press Enter. You will see that it is copying and replacing files.
Close the command prompt window, the Process Hacker window and any other windows opened through these instructions. Now your system is ready for opening .HLP files. Just double-click on any .HLP file and it will be opened in the familiar Windows Help.

While this makes it very easy for you to use the older and very dated help viewer for your Windows 10 PC, you should keep in mind that this viewer could also be vulnerable to all kinds of security risks. This is the main reason Microsoft has dropped the support for such help files. Make sure the .HLP files you open using this WinHlp32.exe viewer come from trustworthy and reliable sources.