home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / INTER32C.ZIP / INT2GUID.ZIP / INT2GUID.DOC < prev    next >
Encoding:
Text File  |  1992-07-12  |  3.1 KB  |  73 lines
  1. The program INT2GUID converts the Interrupt list files into an input file
  2. for the TurboPower Software MAKEHELP program to create a GUIDE or POPHELP
  3. Popup Reference Machine database. The program is a transcription of INT2QH
  4. written by Kai Uwe Rommel.
  5.  
  6. GUIDE is included in some versions of the Turbo Professional package, and
  7. POPHELP is included in the Object Professional package from TurboPower
  8. Software. MAKEHELP is included in both packages and compiles help files
  9. for its accompanying popup program.
  10.  
  11. INT2GUID reads either the interrup.lst file or the partial interrup.a ...
  12. files, and other files defined in the INT2GUID and in the configuration file
  13. INT2GUID.CFG. The files must be located in the current directory. The
  14. created MakeHelp source file is written to standard output and can be
  15. redirected. Two temporary files topic.tmp and subtopic.tmp are created in
  16. the current directory during the process.
  17.  
  18. The configuration file allows conditional compilation, and it is configured
  19. for a compilation that is acceptable by both versions of MAKEHELP. It can
  20. be edited for compilations optimized for GUIDE or POPHELP, see comments in
  21. INT2GUID.CFG.
  22.  
  23. From the 2/91 list, INT2GUID creates a 1.6M source file for MAKEHELP which
  24. then creates a help database of about 1.3M (poor compression ratio!).
  25. INT2GUID executes i 1'15" on a 20 MHz 386 based machine, and MAKEHELP
  26. executes in 2'40".
  27.  
  28. The 2/91 Interrupt list, and other files used for this help system,
  29. includes about 2500 topics. The topics are in general listed in 18 lines
  30. sub and sub-sub indices, and the sub indices are again listed in the main
  31. index. GUIDE and POPHELP can also pop up on a topic indicated by an
  32. interrupt number at the cursor's position on the screen.
  33.  
  34. GUIDE is capable of handling about 4300 topics, and POPHELP can handle
  35. about 5000.
  36.  
  37. Bent Lynggaard.
  38.  
  39.  
  40. 1992-04-16. INT2GUID generates a 2.3 MB file with 3505 topics from the
  41. INTER29x files (February 1992), and the database file is 1.8 MB long.
  42.  
  43. Please notice that the INT2GUID.CFG file generates code acceptable by
  44. both GUIDE and POPHELP. It can be optimized for either popup system by
  45. editing lines 73-76.
  46.  
  47. ---------------------
  48. Version 1.06 updates:
  49.  
  50. INT2GUID.EXE included in INTER30C will not load because my original
  51. program with debug information was stripped with an erroneous version
  52. of Borland's TDSTRIP program. Unfortunately, I did not test the stripped
  53. program. (Erroneous versions of TDSTRIP are 1991-02-13 2:00 and 1991-03-14
  54. 1:00. 1992-03-10 3:00 works fine.)
  55.  
  56. Previous versions of INT2GUID does not handle the letters U, u, etc.
  57. after INT nn (introduced in INTER30) very well. This is fixed in INT2GUID
  58. v. 1.06.
  59.  
  60. Some INT 60 calls in INTER30 use DI to pass a parameter. INT2GUID v. 1.06
  61. accepts any register as a carrier of a parameter, rather than just AX, AH,
  62. and AL.
  63.  
  64. The many index entries caused by INT 60 when DI was not accepted as a
  65. parameter uncovered a bug, which was fixed.
  66.  
  67. INT2GUID v. 1.06 uses the information in the divider lines between interrupts
  68. as window headings and thus also for cursor word search targets. This gives
  69. more selective searches.
  70.  
  71. Bent Lynggaard <lynggaard@risoe.dk>
  72.  
  73.