home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1996 February / PCWK0296.iso / sharewar / dos / program / interupt / winhelp / i2wtest / readme < prev    next >
Encoding:
Text File  |  1994-07-31  |  2.9 KB  |  58 lines
  1. These files are included to ease the testing of the INT2WHLP program.
  2.  
  3. It is suggested that the files are copied to a directory used only for
  4. this test, prefferably a subdirectory under the directory with the INT2WHLP
  5. files. The included INT2WHLP.CFG configuration file defines the current
  6. directory for both input and output. Thus, the compilation of the files is
  7. as easy as
  8.     <path\>INT2WHLP [options]
  9.     HC31 INTWIN
  10. where <path\> is the path to the INT2WHLP program, and [options] are
  11. options that can optionally be passed to INT2WHLP. The commands suggest
  12. that HC31.EXE is somewhere on the DOS path.
  13.  
  14. Well, it's actually easier than that, because the batch file BUILD.BAT
  15. can pass up to 10 options to INT2WHLP, and then automatically start HC31.
  16. BUILD.BAT assumes that the test files are in a subdirectory under INT2WHLP's
  17. directory, so it uses "..\" for "<path\>". This can be changed by editing
  18. line 3 of BUILD.BAT. Then for example
  19.     BUILD -1+ -t-
  20. will build a help file with single-entry interrupts listed in the main
  21. index, and with tables appearing in the main help window rather than in a
  22. secondary window, and
  23.     BUILD -r40
  24. will build a help file where the tables are not separate topics (Interrupt
  25. List release 40 style).
  26.  
  27. To ease the tests even further, the test package includes a Program
  28. Information File BUILD.PIF, which can request parameters and start
  29. BUILD.BAT from within Windows. Make an icon that starts BUILD.PIF with working
  30. directory = test directory, and another icon that runs <testdir>\INTWIN.HLP.
  31. This makes it very easy to compile with different options and start WINHELP
  32. to show the results. Exit WINHELP before a new compilation to avoid sharing
  33. conflicts.
  34.  
  35. The files in this package are truncated files from the Interrupt List and
  36. tiny test files, and therefore INT2WHLP compiles them in a about one
  37. second, and the HC31 compilation takes only some seconds. This gives the
  38. user an easy way to experiment with fonts, font sizes, background colors,
  39. etc - use the NOTEPAD editor to edit the [CONFIG] section of INT2WHLP.CFG.
  40. For experiments with multi columns index, rename the file INTERRUP.LST
  41. to INTERRUP.A. This causes the file INTERRUP.B to be appended to the
  42. compilation, with rows and columns of index entries in a 4, 8, or 16 column
  43. index. The compilation time will be 3-4 times longer.
  44.  
  45. The package demonstrates also the flexibility of the file inclusion
  46. facilities in the INT2WHLP program. The TEST-?.TXT files were created in a
  47. text editor and the TEST-?.RTF files were created in WINWORD and exported
  48. as RTF files. The index to the system included as "WINDOW 4" is in file
  49. TEST-1.RTF.
  50.  
  51. Finally, the package can be used for experimenting with the SEL_TOPIC.RTF
  52. file, se the paragraph 'TO TEST THE "SEL_TOPC" WINDOW' in the INT2WHLP.CFG
  53. file included in this package.
  54.  
  55. If INTERRUP.LST was renamed to INTERRUP.A, it would be a good idea to
  56. rename it back again after the experiments.
  57.  
  58.