home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / dos / util / help2doc / hlp2doc.txt < prev   
Text File  |  1994-07-18  |  6KB  |  129 lines
  1.  
  2.  
  3.       HLP2DOC  - Windows Help File to Winword Document File Conversion
  4.  
  5.                       Wolfgang Beyer    30.6.94
  6.  
  7.                         (C)     Wolfgang Beyer
  8.  
  9. HLP2DOC is a DOS utility to convert a Windows 3.x Help File to a Word for
  10. Windows 2.0 Document File including formatting information. There is also
  11. a windows front end program H2DSTART for easy handling.
  12.  
  13. This Version (1.37) of HLP2DOC is freeware, you may give it to anyone who
  14. want it.
  15.  
  16.                 !!! Use HLP2DOC at your own risk !!!
  17.  
  18. Please save any documents you have opened before you load a doc file that
  19. was produced by hlp2doc, there is a (small) possibility of winword crashing or
  20. hanging.
  21.  
  22. Version 1.37 supports fonts arial, times new roman and courier at all
  23. possible sizes. Attributes bold, italic, underlined, strike through and
  24. as well as topics highlighting (green/underlined) are handled.
  25. Some colors are implemented, lines and boxes should be displayed.
  26.  
  27. New:  No more "Link Errors" on most help files
  28.  
  29. I want to extend hlp2doc to support imbedded pictures (bitmaps), but I dont't
  30. know if I can do this.
  31.  
  32. HLP2DOC uses up to 13 temporary files, be sure to have enough free disk space
  33. and at least FILES=20 in your CONFIG.SYS. Running from a ram disk gives you
  34. much better performance.
  35. HLP2DOC outputs a dot on every 8 KB written, so you can see if it is still
  36. working when processing a large help file.
  37.  
  38. Command line
  39. ------------
  40. hlp2doc [-p] helpfile[.hlp]     or     hlp2doc [-p] helpfile.mvb
  41.  
  42. hlp2doc writes a file <helpfile>.doc to the actual directory, where <helpfile>
  43. is the name of the input file.
  44. When specified with the optional parameter '-p', hlp2doc puts a form feed
  45. at the end of each help topic, otherwise only two empty lines are inserted
  46. to save paper on printing.
  47.  
  48. Known Bugs:
  49. -----------
  50. - some HLP files run into a "link error", this may result in missing
  51.   topics at the end of the DOC-file.
  52. - the default tab stops are always set at 0.8 cm, which is not appropriate
  53.   for all files.
  54.  
  55. Drawbacks:
  56. ----------
  57. - Bitmaps (BMP) appear as big dot
  58. - HLP2DOC is rather slow, big help files may take some minutes
  59. - A maximum of 6 Tabulator stop positions is entered
  60.  
  61. How it was done:
  62. ----------------
  63. I have to thank Ron Burk and Peter Davis for their work on the structure
  64. of the Windows Help Files which was published in Dr. Dobbs Journal some time
  65. ago. In addition I had to spend a lot of time to analyze the mysteries of
  66. the HLP and DOC files, printing many sides of paper with hex dumps. I will
  67. upload a description of all that I found out on the DOC file structure as well
  68. as the HLP file structure soon, first I have to write it down in readable form.
  69.  
  70. HLP2DOC is written in Turbo-C for DOS.
  71.  
  72. Windows front end:
  73. ------------------
  74. Steve Martindill wrote a windows front end for HLP2DOC named H2DSTART that
  75. I inluded in the distribution file. It needs the Visual Basic Runtime system
  76. VBRUN300.DLL that you can upload from various ftp server.
  77.  
  78. History
  79. -------
  80. Version 1.07    12.4.94         Initial release
  81.  
  82. Version 1.08    15.4.94         Bugfixes:
  83.                                   - HLP2DOC 1.07 crashed on HLP files with
  84.                                     big paragraph formatting links
  85.                                     (e.g. with more than 4 TAB definitions)
  86.                                   - Some produced HLP files caused WINWORD to
  87.                                     hang because of paragraph formatting
  88.                                     information in wrong order
  89.                                   - Text indenting was wrong in some cases
  90.                                     (format code x81)
  91.  
  92. Version 1.13    19.4.94           - Support of boxes, lines, colors and
  93.                                     all font sizes, fonts courier and tnr
  94.                                   - improved memory utilization (bigger
  95.                                     help files are possible)
  96.                                   - Bug that caused winword to crash in
  97.                                     some cases corrected
  98.  
  99. Version 1.22    16.5.94         Bugfixes:
  100.                                   - Very big helpfiles can be processed.
  101.                                     (winword.hlp 2.0 was successfully tested)
  102.                                   - Adjusted default tabs
  103.                                   - Crash on files with many internal files
  104.                                     is fixed
  105.                                   - Shifting of formatting information in
  106.                                     some cases is fixed.
  107.  
  108. Version 1.27     6.6.94           - support of winhelp tables
  109.  
  110. Version 1.28    12.6.94           - Reads Phrases in Pieces, so help files
  111.                                     with very big phrase tables now can be
  112.                                     processed.
  113.  
  114. Version 1.32    18.6.94           - Support of .mvb files
  115.                                   - Correction of some bugs of the previous
  116.                                     versions.
  117.  
  118. Version 1.37    16.7.94           - Occurence of "Topic Link Errors" reduced.
  119.                                   - Additional format codes supported.
  120.                                   - 2 small bugs fixed.
  121.  
  122.                            ------------------
  123.  
  124. HLPDC137.ZIP containing HLP2DOC.EXE, HLP2DOC.TXT (this text) and H2DSTART.EXE
  125. is uploaded to ftp.lrz-muenchen.de in directory /pub/comp/platforms/pc/windows.
  126.  
  127. Any comments and suggestions are welcome.
  128. Email: beyer@lrz-muenchen.de.
  129.