home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / zip / diskutil / dscan12.lzh / DSCAN12 / MENU.TRB < prev    next >
Text File  |  1985-11-19  |  7KB  |  294 lines
  1. /* This is the POPUP tree for DISKSCAN release 1.2/2.2's README. */
  2. /* To view this in a more logical fashion, run the README program. */
  3. #:0
  4. X:20
  5. Y:2
  6. T:    POPHELP By Todd Burkey
  7. T:
  8. T:Uh-oh. You need HELP for POPHELP?
  9. T:OK, the first thing to remember is
  10. T:that in POPHELP, you really only
  11. T:need to use the four arrow keys
  12. T:and the ESC key. The up and down
  13. T:arrows will move you up and down in
  14. T:the current pop-up...but only when
  15. T:there is selectable (blue) text in
  16. T:the popup. Note that this popup has
  17. T:NO selectable text...you can just
  18. T:read it and exit. Which brings us
  19. T:to the left and right arrow keys.
  20. T:The right key gets you into a menu,
  21. T:while the left key moves you back
  22. T:out of a menu. The ESC key? It gets
  23. T:you out of the popups altogether.
  24. T:You can press the LEFT ARROW now.
  25.  
  26. #:1
  27. X:10
  28. Y:12
  29. T: NEW DISKSCAN INFO 
  30. +:How to install   ->
  31. =:10
  32. +:Popups for help  ->
  33. =:2
  34. +:Extra Disk Info  ->
  35. =:3
  36. +:Some bugs fixed  ->
  37. =:4
  38. +:Extra documents  ->
  39. =:5
  40. +:Future plans     ->
  41. =:6
  42. +:Program Limits   ->
  43. =:7
  44.  
  45. #:10
  46. X:15
  47. Y:12
  48. T:DISKSCAN is very simple to install. Just copy
  49. T:DSCAN22.PRG, DISKSCAN.KEY, and DISKSCAN.MNU to
  50. T:your favorite spot for utilities on your HD
  51. T:or a DEDICATED floppy (i.e. something with
  52. T:room for big printout files, databases, etc)
  53. T:and you are all set.  Note that DISKSCAN.MNU
  54. T:must be present if you want on-line help,
  55. T:and DISKSCAN.KEY is necessary if you wish to
  56. T:redefine the command invoke keys and some of
  57. T:the program options.
  58.  
  59. #:2
  60. X:15
  61. Y:14
  62. T:Popup help was added to DISKSCAN to clean up the HELP
  63. T:option and also pave the way for extended help and
  64. T:menu selection routines. This mechanism also allows
  65. T:the user to add their own help, since the help file
  66. T:is external to the program code.
  67. +:Help on POPHELP ->
  68. =:20
  69.  
  70. #:3
  71. X:20
  72. Y:10
  73. T:Several new commands were added to allow you to see
  74. T:Extended Disk Info. You can now activate/deactivate
  75. T:a window that provides more info about a disk (only
  76. T:ones you have documented, of course).  Note that in
  77. T:this first version, the option may be slow for very
  78. T:big files, since I haven't had time to optimize it.
  79. T: 
  80. +:Extended Disk Info File: DISKSCAN.INF
  81. =:13
  82. +:Activating & Deactivating This Thing 
  83. =:14
  84.  
  85. #:13
  86. X:10
  87. Y:8
  88. T:                  DISKSCAN.INF File Format
  89. T:The format of this file is very simple. It consists of one line that
  90. T:contains a '~' character followed immediately by a disk name, then up
  91. T:to 6 more lines (47 chars max per line) of description for that disk.
  92. T:Note that the disk name must match exactly that of the name used in
  93. T:DISKSCAN.
  94. T: 
  95. T: Sample Format for DISKSCAN.INF:
  96. T: 
  97. T:~HDSCAN Backup Disk
  98. T:This disk contains the sources for HDSCAN
  99. T:versions 2.3, 2.4, 2.5, 2.6, and 3.0 (the
  100. T:unix version).
  101.  
  102. #:14
  103. X:10
  104. Y:12
  105. T:Y key:  Yank in extended disk descriptions from DISKSCAN.INF
  106. T:y key:  Toggle the extended disk info window on and off
  107.  
  108. #:4
  109. X:20
  110. Y:14
  111. T:I only found 1 bug in DISKSCAN 2.1. When viewing files, I
  112. T:would open them via: ifp=fopen(fromstr,op) and for some
  113. T:strange reason, I was closing them via: fclose(fromstr).
  114. T:Now, why this always worked ok for me I'll never know.
  115.  
  116. #:5
  117. X:30
  118. Y:12
  119. T:The updated documenatation is in DISKSCAN.DOC.
  120. T:Sorry, but my printed manuals alway run behind
  121. T:my updates to DISKSCAN.  I hope that with README
  122. T:and the on disk documents I have covered most
  123. T:of the new features.
  124.  
  125. #:6
  126. X:20
  127. Y:8
  128. T:DISKSCAN 'hope'-list...subject to change
  129. T:----------------------------------------
  130. T: 1) Bug fixes - Ongoing
  131. T: 2) POPUP Menu Selection - Version 2.2
  132. T: 3) Improved user interface - Ongoing
  133. T: 4) Improve the Extra Info option -???
  134. T:    (it is slow and messy now).
  135.  
  136. #:7
  137. X:25
  138. Y:11
  139. T:Current Program Limitations
  140. T:---------------------------
  141. T: 1) # files scanned  = 7000
  142. T: 2) # of disk names  = 500
  143. T: 3) # of unique dirs = 300
  144. T: 
  145. T:Note: DISKSCAN's a memory hog
  146. T:    so 512K owners may not be
  147. T:    able to invoke other big
  148. T:    programs within DISKSCAN.
  149.  
  150. /* Real help for POPHELP */
  151. #:20
  152. X:12
  153. Y:8
  154. T:GETTING STARTED
  155. +:Moving Around  
  156. =:22
  157. +:Some Comments  
  158. =:23
  159. +:Technical Info 
  160. =:26
  161.  
  162. #:26
  163. X:30
  164. Y:10
  165. +:MENU.TRB Format
  166. =:27
  167. +:COLOR Tables   
  168. =:28
  169.  
  170. #:27
  171. X:3
  172. Y:4
  173. T:The file MENU.TRB is processed by POPHELP's build_menu routine and
  174. T:drives the entire menu structure of POPHELP. The format of MENU.TRB
  175. T:is very simple. For example, the following is a sample 2 level menu
  176. T:with comments (note the comments can't really be part of the line):
  177. T:#:1             <-we are defining menu # 1
  178. T:X:10            <-the popup box will start at cursor column 10
  179. T:Y:4             <-and at cursor row number 4
  180. T:T:WELCOME       <-just some text to put in red (color #1)
  181. T:+:More Help     <-text for another menu selection
  182. T:=:2             <-go to menu 2 when the above text is selected
  183. T:#:2             <-all done with menu 1, so lets define menu 2 now
  184. T:X:5             <-new coordinates
  185. T:Y:6             <-new coordinates
  186. T:1:070           <-redefine color 1 (the text) to be green (RGB)
  187. T:<:afile.txt     <-menu 2 popup text is read from a file 
  188.  
  189. #:60
  190. X:20
  191. Y:8
  192. 1:530
  193. 2:053
  194. T:For RGB users only 
  195. T:  You were warned  
  196. +:Some soft colors   
  197. =:61
  198. +:Some Putrid ones   
  199. =:62
  200. +:Late night colors  
  201. =:63
  202.  
  203. #:61
  204. X:5
  205. Y:3
  206. 0:054
  207. 1:410
  208. 2:046
  209. 3:222
  210. T:Pastels?
  211. T:0:054
  212. T:1:500
  213. T:2:066
  214. T:3:333
  215.  
  216. #:62
  217. X:5
  218. Y:3
  219. 0:070
  220. 1:770
  221. 2:077
  222. 3:707
  223. T:Putrid
  224. T:0:070
  225. T:1:770
  226. T:2:077
  227. T:3:707
  228.  
  229. #:63
  230. X:5
  231. Y:3
  232. 0:000
  233. 1:700
  234. 2:007
  235. 3:770
  236. T:Brighter
  237. T:0:000
  238. T:1:700
  239. T:2:007
  240. T:3:770
  241.  
  242. #:28
  243. X:2
  244. Y:4
  245. T:Colors can be changed from the default setup dynamically within the menus,
  246. T:but extreme care should be taken so you don't screw things up for people
  247. T:who use monochrome monitors. The technique is quite simple. Within the
  248. T:MENU.TRB file, include the following fields when you want a new color:
  249. T:0:006          <--change color 0 to light blue (normal background)
  250. T:1:600          <--change color 1 to red (non-selectable text)
  251. T:2:000          <--change color 2 to black (for the shadow)
  252. T:3:775          <--change color 3 to off white (popup background).
  253. T:Note that the default color can be over-ridden by specifying a new color
  254. T:for menu # 1 (the first popup that is displayed by POPHELP).
  255. +:Some sample colors maps.
  256. =:60
  257.  
  258. #:22
  259. X:14
  260. Y:10
  261. +:ARROW KEYS 
  262. =:24
  263. +:HOW TO QUIT
  264. =:25
  265.  
  266. #:25
  267. X:40
  268. Y:12
  269. T:1) Press the ESC key. This takes
  270. T:   out of the help selection.
  271. T:2) Press the Q key. This exits  
  272. T:   you from the demo.
  273.  
  274. #:24
  275. X:30
  276. Y:12
  277. T:RIGHT ARROW = Select the hilited menu  
  278. T:LEFT ARROW  = Move to menu we came from
  279. T:UP ARROW    = Move up in the menu list 
  280. T:DOWN ARROW  = Move down in the list    
  281.  
  282. #:23
  283. X:15
  284. Y:11
  285. T:POPHELP is a simple, but clean, mechanism
  286. T:for both externalized and internally held
  287. T:help information. It was written only for
  288. T:fun, but may prove useful in standardized
  289. T:help utilities as its' features are tuned
  290. T:up and refined.  Any comments from anyone
  291. T:out there? Or is this idea just too wierd
  292. T:and far-fetched.
  293.  
  294.