home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / UTILS / INTERRPT / INT2GUID / INT2GUID.CFG < prev    next >
Text File  |  1993-10-22  |  7KB  |  169 lines
  1. INT2GUIDE CONFIG
  2.  1 7 ;version, subversion
  3. ; This is a configuration file for the INT2GUID program. It has the following
  4. ; format:
  5. ; The file name must be INT2GUID.CFG
  6. ; Line 1 must be "INT2GUIDE CONFIG" to identify the file as a configuration
  7. ; file for INT2GUID.EXE.
  8. ; Line 2 must identify version and subversion numbers, so they can be read in
  9. ; "C" format "%u%u" (i.e. as positive decimal integers).
  10. ; The following lines starting with a semicolon (;) are comment lines.
  11. ;
  12. ;   Notice that this file is optimized for POPHELP. If it is used for the
  13. ;   GUIDE program, the line defining WIDTH, and the condition masks in topics
  14. ;   7 (Characters etc.) and X (Help) should be edited.
  15. ;
  16. ; Introduced i version 1.07: Lines up to a line starting with '=' are
  17. ; interpreted in the beginning of INT2GUID. The following commands are
  18. ; recognized 
  19. ;
  20. WIDTH 78 ; defines popup screen with. Use 80 for GUIDE or 78 for POPHELP
  21. ;
  22. MaxTopicLength 32000 ; defines the maximum number of characters written to
  23. ;   a topic. If the text is longer, it will be split into two or more topics,
  24. ;   and mutual cross references are inserted.
  25. ;
  26. Classification ; Enable "Classification" to include divider line function
  27. ;   classification character (column 9 in divider line) as part of topic
  28. ;   headings (function classification will be introduced in the interrupt
  29. ;   list after release 33).
  30. ;   If Classification is enabled, the mask in the last topic in this file
  31. ;   "Key to List" should read 1 to enable a reference to a key of function
  32. ;   classification characters, or else it should read 0.
  33. ;   Notice that enabling of Classification increases the length of topic
  34. ;   strings by 2 characters, and because the total length of all topic
  35. ;   strings is limited to 64 kilobytes, it might be necessary to disable
  36. ;   Classification as the number of topics increases in new releases of
  37. ;   the interrupt list.
  38. ;
  39. ; This ends the initial part of INT2GUID.CFG
  40. ========================================================================
  41. ;
  42. ; Each file included in the help system is identified by five lines:
  43. ; Line 1 is the file name. It may include a path.
  44. ; Line 2 is the entry in the help system index. It is truncated to 14
  45. ; characters.
  46. ; Line 3 is the selection field in the subindex. It is truncated or
  47. ; space-padded to 12 characters.
  48. ; Line 4 is the rest of the entry in the subindex. It is separated from the
  49. ; selection field by two spaces. It is truncated to 62 characters.
  50. ; Line 5 identify the file type and the number of extra topics defined in
  51. ; the file, and a condition mask. It is read in the "C" %u%u%i format (the
  52. ; %i format takes decimal integers, octal integers starting with 0 and
  53. ; hexadecimal integers starting with 0x, 64 = 0100 = 0x40).
  54. ; A non zero value in the first position identifies a command file, which
  55. ; may have commands and comments for the MAKEHELP program; if the value is
  56. ; zero, a leading space is inserted on lines starting with "!" or ";", and
  57. ; tabs are filtered to spaces. 0 should be used for files not specifically
  58. ; edited for the help system.
  59. ; The second value defines the number of extra topics used in a command
  60. ; file.
  61. ; The condition mask is used for conditional assembling of command files.
  62. ; Command files can include lines starting with "!! <condition>", where
  63. ; condition is a number. The following text is included only if condition = 0
  64. ; or (condition AND mask) <> 0. See ";Topic 7" below and file "int2guid.add"
  65. ; for examples.
  66. ;
  67. ; The 5-line entries may be separated by comment lines identified by a
  68. ; semicolon in the first column.
  69. ;
  70. ; The included files can have internal or mutual cross references, or
  71. ; references to the topics:
  72. ;   1. The main interrupt list.
  73. ;   2. The copyright notice.
  74. ;   3. The INTERRUP.LST entry.
  75. ;   4. The INTERRUP.1ST entry.
  76. ;   5. The GUIDE entry.
  77. ; Topics included herein are numbered 6 up, with consecutive numbers unless
  78. ; line 5 specifies extra topics.
  79. ; Line 5 in a command entry must specify at least the number of topics used
  80. ; in the included file, and it may specify extra entries for future
  81. ; expansions. Inside a command file with extra topics:
  82. ;   A. Use consecutive topic numbers, starting one higher than the file's
  83. ;      topic number.
  84. ;   B. Use topic names with 14 characters or less.
  85. ;   C. Use either the !NOINDEX command to exclude the topic from the main
  86. ;      index, or no index command at all to have the topics listed in
  87. ;      alphabetic order after all other entries.
  88. ;
  89. ; Included files:
  90. ;
  91. ; Topic 6. Ralf Brown's Interrupt Primer.
  92. interrup.pri
  93. Primer
  94. Primer
  95. What is an interrupt?
  96. 0 0 0 ;no commands, no extra topics, no mask
  97. ;
  98. ; Topic 7. Characters, scan codes etc. N.B. Extra topics!!!
  99. ; N.B. Mask value 4 optimizes for POPHELP, use 2 to optimize for GUIDE,
  100. ;      or use 1 for a help file acceptable by both GUIDE and POPHELP.
  101. int2guid.add
  102. Codes etc.
  103. Additional
  104. information: characters, colors, scan codes, pin assignments
  105. 1 13 4 ;commands, 7 extra topics used, 6 reserved.
  106. ;    mask values: 0: alphabetic index; 0x8000: no index
  107. ;    ORed with:   1: acceptable by both GUIDE and POPHELP
  108. ;         or      2; optimized for GUIDE
  109. ;         or      4; optimized for POPHELP
  110. ;    e.g. 0x8004 for no index, optimized for POPHELP
  111. ;
  112. ; Topic 8 + 13 = 21. Selected parts of INTERRUP.LST.
  113. ;   N.B. Extra topics!!!
  114. int2guid.tab
  115. Tables
  116. Tables
  117. PSP, Environment, Country, Errors
  118. 1 10 0 ;commands, 4 extra topics used, 6 more reserved.
  119. ;    mask values: 0: alphabetic index; 0x8000: no index
  120. ;
  121. ; Topic 22 + 10 = 32. Robin Walker's BIOS Memory List
  122. memory.lst
  123. BIOS List
  124. MEMLIST
  125. BIOS Memory List
  126. 0 0 0 ;no commands, no extra topics, no mask
  127. ;
  128. ; Topic 33. Wim Osterholt's Ports List
  129. ports.lst
  130. Ports List
  131. Ports
  132. List of I/O Ports
  133. 0 0 0 ;no commands, no extra topics, no mask
  134. ;
  135. ; Topic 34. Padgett Peterson's CMOS Memory Map
  136. cmos.lst
  137. CMOS Memory
  138. CMOS
  139. Memory Map
  140. 0 0 0 ;no commands, no extra topics, no mask
  141. ;
  142. ; Topic 35. Ralf Brown's GLOSSARY.LST.
  143. glossary.lst
  144. Glossary
  145. Glossary
  146. Common Computer Terms
  147. 0 0 0 ;no commands, no extra topics, no mask
  148. ;
  149. ; Topic X. Help. NB! last topic before Key to Index
  150. int2guid.hlp
  151. Help
  152. Help
  153. to this system
  154. 1 0 4;commands, no extra topics,
  155. ;   mask values:
  156. ;     2: Help to GUIDE.
  157. ;     4: Help to POPHELP.
  158. ;
  159. ; Topic XX. Key to index. NB! last topic before list
  160. int2guid.key
  161. Key to List
  162. Key to List
  163. Format of index entries
  164. 1 0 1 ;commands, no extra topics,
  165. ;   mask values:
  166. ;     0: disable reference to Function Classification.
  167. ;     1: enable the reference if Classification is enabled in the initial
  168. ;        part of this configuration file.
  169.