htmlhelp compiler: what changed
Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 2 | - | ||
| 3 | - | ||
| 4 | - | ||
| 5 | - | ||
| 6 | - | ||
| 7 | - | ||
| 8 | - | ||
| 9 | 1 | ## Overview | |
| 10 | 2 | ||
| 11 | 3 | The htmlhelp compiler chmcmd is a GPL licensed htmlhelp1 (CHM) helpfile compiler. | |
| 12 | 4 | ||
| 13 | 5 | The help file compiler's main program only performs command line handling. All other functionality (including .hhp loading functionality and HTML scanning) is done by FPC's [[chm]] package, which is licensed under a more permissive license (LGPL with static linking exception) | |
| 14 | 6 | ||
| 15 | 7 | Two formats are supported: | |
| 16 | 8 | ||
| 17 | 9 | * HTML help .hhp help projects (similar to those from the old Microsoft HTML Help workshop) | |
| 18 | 10 | * a superset that stores all information (including context data) in one .XML. | |
| 19 | 11 | ||
| 20 | 12 | ## History | |
| 21 | 13 | ||
| 22 | 14 | While the primary target of the [[chm]] package is the documentation tool [[FPDoc Editor|fpdoc]], a small commandline utility chmcmd was added for testing purposes. This utility simply created a TCHMProject instance, would load the .xml, and called the "writechm" method. The XML format had to list all files to be included (including .css and image files). | |
| 23 | 15 | ||
| 24 | 16 | In 2010, basic .hhp support was added, and the project was expanded to scan input files for extra files. | |
| 25 | 17 | ||
| 26 | 18 | ## Missing features | |
| 27 | 19 | ||
| 28 | 20 | See [[chm]] | |
| 29 | 21 | ||
| 30 | 22 | ## Performance | |
| 31 | 23 | ||
| 32 | 24 | The performance probably won't be great. Mostly because the program is written in a portable manner. | |
| 33 | 25 | ||
| 34 | 26 | The chm package has some support for doing the compression using multiple cores, but this has not been enabled by default for two reasons: | |
| 35 | 27 | ||
| 36 | 28 | 1. on Linux/FreeBSD this pulls in libpthread and libc which makes the binary distribution dependent (on FreeBSD and Linux, basic FPC binaries are fully static and use syscalls) | |
| 37 | 29 | 2. the savings are not that great (think 25% faster on a dual core) | |
| 38 | 30 | ||
| 39 | 31 | A Win32 binary is currently about 420k (uncompressed, but stripped). | |
| 40 | 32 | ||
| 41 | 33 | ## Download | |
| 42 | 34 | ||
| 43 | 35 | The HTML compiler is not available as a separate download, but is included in most FPC releases and snapshots. | |
| 44 | 36 | ||
| 45 | 37 | --- | |
| 46 | 38 | *From the Free Pascal wiki, page "chmcmd", as the Internet Archive kept it on 2025-05-14, last changed on 2015-10-24. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |