home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / hlp_auth / help2doc / hlp2doc.txt < prev   
Encoding:
Text File  |  1994-05-16  |  4.8 KB  |  113 lines
  1.  
  2.  
  3.       HLP2DOC  - Windows Help File to Winword Document File Conversion
  4.  
  5.                       Wolfgang Beyer    16.5.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.22) is still a beta version, there are bugs and drawbacks, but
  14. I think it may be of some interest. I dont't know any other programs which
  15. can do the HLP file conversion. HLP2DOC is freeware, you may give it to
  16. anyone who want it.
  17.  
  18.                 !!! Use HLP2DOC at your own risk !!!
  19.  
  20. Please save any documents you have opened before you load a doc file that
  21. was produced by hlp2doc, there is a (small) possibility of winword crashing or
  22. hanging.
  23.  
  24. Version 1.22 supports fonts arial, times new roman and courier at all
  25. possible sizes. Attributes bold, italic, underlined, strike through and
  26. as well as topics highlighting (green/underlined) are handled.
  27. Some colors are implemented, lines and boxes should be displayed.
  28.  
  29. I am working on a new version that should support imbedded pictures (bitmaps).
  30. This may take some time, please be patient.
  31.  
  32. HLP2DOC uses up to 12 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]
  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 "topic link error", this may result in missing
  51.   topics at the end of the DOC-file.
  52.  
  53. Drawbacks:
  54. ----------
  55. - Bitmaps (BMP) appear as big dot
  56. - HLP2DOC is rather slow, big help files may take some minutes
  57. - A maximum of 6 Tabulator stop positions is entered
  58. - Help tables are not yet formatted properly
  59.  
  60. How it was done:
  61. ----------------
  62. I have to thank Ron Burk and Peter Davis for their work on the structure
  63. of the Windows Help Files which was published in Dr. Dobbs Journal some time
  64. ago. In addition I had to spend a lot of time to analyze the mysteries of
  65. the HLP and DOC files, printing many sides of paper with hex dumps. I will
  66. upload a description of all that I found out on the DOC file structure as well
  67. as the HLP file structure soon, first I have to write it down in readable form.
  68.  
  69. HLP2DOC is written in Turbo-C for DOS.
  70.  
  71. Windows front end:
  72. ------------------
  73. Steve Martindill wrote a windows front end for HLP2DOC named H2DSTART that
  74. I inluded in the distribution file. Thank you Steve !
  75.  
  76. History
  77. -------
  78. Version 1.07    12.4.94         Initial release
  79.  
  80. Version 1.08    15.4.94         Bugfixes:
  81.                                   - HLP2DOC 1.07 crashed on HLP files with
  82.                                     big paragraph formatting links
  83.                                     (e.g. with more than 4 TAB definitions)
  84.                                   - Some produced HLP files caused WINWORD to
  85.                                     hang because of paragraph formatting
  86.                                     information in wrong order
  87.                                   - Text indenting was wrong in some cases
  88.                                     (format code x81)
  89.  
  90. Version 1.13    19.4.94           - Support of boxes, lines, colors and
  91.                                     all font sizes, fonts courier and tnr
  92.                                   - improved memory utilization (bigger
  93.                                     help files are possible)
  94.                                   - Bug that caused winword to crash in
  95.                                     some cases corrected
  96.  
  97. Version 1.22    16.5.94         Bugfixes:
  98.                                   - Very big helpfiles can be processed.
  99.                                     (winword.hlp was successfully tested)
  100.                                   - Adjusted default tabs
  101.                                   - Crash on files with many internal files
  102.                                     is fixed
  103.                                   - Shifting of formatting information in
  104.                                     some cases is fixed.
  105.  
  106.                          ------------------
  107.  
  108. HLPDC122.ZIP containing HLP2DOC.EXE, HLP2DOC.TXT (this text) and H2DSTART.EXE
  109. is uploaded to ftp.lrz-muenchen.de in directory /pub/comp/platforms/pc/windows.
  110.  
  111. Any comments and suggestions are welcome.
  112. Email: beyer@lrz-muenchen.de.
  113.