home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / desktop / tsel106a.arj / TSELECT.CFG < prev    next >
Text File  |  1992-04-03  |  7KB  |  181 lines
  1. .......TSELECT.CFG...........for Version 1.06 of TSR-Select...........
  2. .
  3. .      Quadrant Computer Systems    May 1991 - Feb 1992
  4. .
  5. .All lines starting with a period are comments and are ignored.
  6. .Blank lines are also ignored.
  7. .
  8. .  If you are using the Editor in SELECTC, remember that F2 is Save,
  9. .  and the [ESC] key will exit the editor.  If you exit before saving,
  10. .  any changes you made will be lost.  Press the F1 key for help.
  11. .
  12. .
  13. .      FORMATTING THE CONFIGURATION FILE
  14. .
  15. .     Menu Items begin with an asterisk (*)
  16. .        The menu item names longer than 30 characters are truncated.
  17. .        TSELECT will "grow" the width of the menu to accomodate up to 30.
  18. .
  19. .     Short Cut key specifier line begins with $ (see below)
  20. .
  21. .     All commands required prior to the executable begin with <
  22. .
  23. .     All commands required after the executable begin with >
  24. .
  25. .     The line which executes the program begins with +
  26. .        This line should contain the command (with any parameters)
  27. .        required to execute the program.  The command must have the
  28. .        fully qualified drive and path in front of it, and the program
  29. .        extension must be correct.  For example:  DBASE TEST is NOT valid.
  30. .        C:DBASE.EXE TEST is NOT valid.  C:\DBASE\DBASE TEST is NOT valid.
  31. .        C:\DBASE\DBASE.EXE TEST *is* valid.
  32. .
  33. .        NOTE:  You may also use '@' in place of '+'... using '@' will NOT
  34. .        check for the existence of the executable program... this is
  35. .        actually required if you want to execute an internal DOS command
  36. .        since there is no file for TSELECT to check for.
  37. .
  38. .   As an example, the following menu item would begin with a
  39. .   change of directory to C:\DATA\DBASE, changing the path statement,
  40. .   executing DBASE, then returning the original drive/path, and
  41. .   resetting the path:
  42. .
  43. .       *dBASE                  ; menu selection
  44. .       $1                      ; position of short-cut character in *
  45. .       <ECHO OFF               ; suggested for appearances sake
  46. .       <CLS
  47. .       <SET OPATH=%PATH%
  48. .       <PATH C:\DBASE
  49. .       <C:
  50. .       <CD \DATA\DBASE
  51. .       +C:\DBASE\DBASE.EXE ProgramX    ; ProgramX is a .PRG program
  52. .       >PATH %OPATH%
  53. .       >SET OPATH=
  54. .
  55. .  Immediately following the Menu Selection line (starts with *) is the
  56. .  element that tells TSR-Select which character in the Menu Selection line
  57. .  is to be the short-cut character, the key the user can press to select
  58. .  the item without having to first highlight the selection and press
  59. .  ENTER.  If this is left out, the first character will be used.  If
  60. .  the character chosen competes with a menu selection with the same
  61. .  short-cut key, when the user presses the key, only the first selection
  62. .  will ever be selected.  The only way for the other selection to be
  63. .  executed is if the user highlights it and presses ENTER.
  64. .
  65. .  Below are the real lines of this configuration file.  The total
  66. .  number of lines allowed is 400.  There is no specific limit of
  67. .  lines for any menu selection as long as the total is less than 400.
  68. .  Comment lines are not counted as part of the total.
  69. .
  70. .   Default hotkey is Alt-LeftShift-M.....................
  71.  
  72. .   To change the hotkey definition, enter the line ".HOTKEY:$xxxx" so
  73. .   that the period is in column one, immediately before the first '*'
  74. .   selection.  The 'xxxx' is a hexidecimal code, defined as:
  75. .
  76. .             $0800  Alt
  77. .             $0400  Ctrl
  78. .             $0200  LeftShift
  79. .             $0100  RightShift
  80. .             $  xx  Scan code for main key
  81. .
  82. .             Add the byte on the left for the key combination,
  83. .             then select the scan code for the main key as the
  84. .             byte on the right.  For example, for Alt-Ctrl, add up
  85. .             $08 plus $04, which is $0A.. the scan code for Z is $2C,
  86. .             so:
  87. .
  88. .   Example:  .HOTKEY:$0A2C     changes hotkey to Alt-LeftShift-Z
  89. .
  90. .             as another example, if you wanted the hotkey to be
  91. .             Ctrl-LeftShift-M:   .HOTKEY:$0632
  92. .
  93. .             NOTE:  Yes! There is a period ('.') just prior to the
  94. .             keyword 'HOTKEY'... although periods are supposed to
  95. .             identify comment lines, this is the one exception.
  96. .
  97. .             Keep in mind that scan codes are NOT the same as ASCII codes.
  98. .
  99. .             Single key hotkeys are possible by just leaving the left byte
  100. .             at $00; for example, $0054 turns the SysReq key into the hotkey.
  101. .             (Make sure you *have* a SysReq key!  Some keyboards do not!)
  102. .             Another example: $0058 makes F12 the hotkey.  Refer to the
  103. .             documentation for a table of all scan codes.  You can also
  104. .             use the SCANKEY utility.
  105. .
  106. .             Some scan codes just plain don't work as hotkeys; if you configure
  107. .             a scan code and when you run TSELECT you receive the error message:
  108. .             'Error defining popup procedure', then you've choosen a hotkey
  109. .             that will not work.  Sometimes you won't receive the error message
  110. .             but the hotkey still doesn't work.  There is some experimentation involved,
  111. .             and it is best if you do not choose something really outrageous.
  112. .             Unless every PC you have is identical, then it is possible that
  113. .             a hotkey you choose that works on one PC may not work on another.
  114. .             <Alt>-<x-Shift>-<character> is almost always safe, as is
  115. .             <Ctrl>-<x-Shift>-<character>.
  116. .
  117. *Mail
  118. $1
  119. <CLS
  120. +Z:\MAIL.EXE
  121. .
  122. *Chat
  123. $1
  124. <CLS
  125. +Z:\CHAT.EXE
  126. .
  127. *SetPrint
  128. $2
  129. <cls
  130. +Z:\SETPRINT.EXE
  131. .
  132. *EndSpool
  133. $1
  134. <CLS
  135. +Z:\ENDSPOOL.EXE
  136. .
  137. *LastMsg                 ; this is a comment... all characters after
  138. $1                       ; a semicolon are ignored.
  139. <cls
  140. +Z:\LASTMSG.EXE
  141. >pause
  142. .
  143. *Send
  144. $1
  145. <cls
  146. +Z:\SEND.EXE
  147. >cls                     ; see explanation below as to why this is here
  148. .
  149. .*dBASE                  ; menu selection
  150. .$2                      ; position of short-cut character in *
  151. .<ECHO OFF               ; suggested for appearances sake
  152. .<CLS
  153. .<SET OPATH=%PATH%
  154. .<PATH C:\DBASE
  155. .<C:
  156. .<CD \DATA\DBASE
  157. .+C:\DBASE\DBASE.EXE
  158. .>PATH %OPATH%
  159. .>SET OPATH=
  160. .>cls          ; see comment immediately below re: this line
  161. .
  162. . There is a bug in all versions of TSR-Select which will not read
  163. . the last command line of the last menu entry (the >cls above).  The work
  164. . around is to put some harmless command as the last command line, e.g.,
  165. . the >cls command above.
  166. .
  167. . If there are more than 15 entries, all entries after the 15th entry
  168. . are ignored, and no error message is generated.
  169. .
  170. . If you have input only one entry then TSR-Select will not generate a
  171. . pop-up menu, but will execute that one selection immediately after
  172. . you press the hot-key.  When exiting that selection, the user is
  173. . returned immediately to the foreground application.
  174. .
  175. .
  176. .  WARNING:  Do NOT attempt to use TSR-Select to execute a program that
  177. .            makes low-level modifications to the DOS file system.
  178. .            Programs to avoid include CHKDSK, disk de-fragmenters,
  179. .            and physical directory sorters like Norton's DIRSORT.
  180. .
  181.