home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 505.dms / 505.adf / DOCS / Jump.Doc < prev    next >
Text File  |  1989-09-09  |  11KB  |  394 lines
  1.                              Jump 
  2.  
  3.                             Topics 
  4.  
  5.                    1.   Introduction. 
  6.  
  7.                    2.   Usage. 
  8.  
  9.                    3.   Copyright. 
  10.  
  11.                    4.   Distribution.   
  12.  
  13.                    5.   BUG reports. 
  14.  
  15.                    6.   Donations. 
  16.  
  17. 1. Introduction. 
  18.  
  19. This program has been developed to enable users to access programs
  20. which are several subdirectories down. It can best be described as
  21. a CASE command for use with batchfiles. The user is asked to input
  22. a character.  The program then executes a batchfile, which must be
  23. in the S: directory, called Jump.CMD.  This file contains a number
  24. of labels and depending on the inputted character a skip to one of
  25. these labels is made. The program checks if the inputted character
  26. is one of those that that has been  specified in the options list.
  27.  
  28. Features.
  29.  
  30. - Fully compatible with both Workbench V1.2 and V1.3.
  31. - Works with all Amigas.
  32. - Supports most AmigaDos devices.
  33. - The built-in Help function. Just type Jump ?.
  34. - Allow easy access to programs  which are several  subdirectories
  35.   down.
  36. - Extensive checking on validity of inputted characters.
  37. - One key execution of the program. With WB 1.3 rename Jump.Bat as
  38.   J and set it's script bit. Or put it under a (function) key with
  39.   one of the various setkey programs.
  40.    
  41. 2. Usage      
  42.  
  43. Usage : Jump <options>
  44.  
  45. Where <options> is a list of characters  that are consideres valid
  46. valid input.
  47.  
  48. How to use this program? Well it is fairly simple. 
  49.  
  50. First create a file called: Jump.BAT in your S: directory. This is
  51. the file to execute.
  52.  
  53. Eg.:
  54.  
  55. -----------------------------------------------------------------
  56. Type s:Jump.SCR
  57. Jump qwertyuiopasdfghijklzxcvbnm1234567890-=\/
  58. -----------------------------------------------------------------
  59.  
  60. Where the characters after the Jump command signify the characters
  61. that are valid inputs. These must be identical to the names of the
  62. labels in Jump.CMD.
  63.  
  64. Jump.SCR is an example of a file displaying a menu on your screen.
  65. Eg.
  66.  
  67. -----------------------------------------------------------------
  68.                          Jump Example Menu
  69.  
  70. A.  Sonix V2.0       N.  DPaint II          1.  Photo Synthesis
  71. B.  AudioMaster      O.  DPaint II(PAL)     2.  Photon Paint
  72. C.  Perfect Sound    P.  DPaint III         3.  Sculpt 4D
  73. D.  Deluxe Music     Q.  PixMate            4.  VideoScape 3D
  74. E.  68000er Sampler  R.  DigiPaint 320x200  5.  DBW-Render
  75. F.  Future Sound     S.  DigiPaint 320x400  6.  L.C.A.
  76. G.  Instant Music    T.  DigiView V2.0      7.  Caligari
  77. H.  Music Studio     U.  DigiView Gold      8.  FantaVision
  78. I.  GfA Basic        V.  DigiView Gold(PAL) 9.  AmigaTex
  79. J.  Amiga Basic      W.  Perfect Vision     0.  RIM-5
  80. K.  Lattice C V5.0   X.  The Director       -.  Micro Fiche Plus
  81. L.  Aztec   C V3.6   Y.  Tv*Show V1.03      =.  SuperBase Pro
  82. M.  Modula II        Z.  Diamond            \.  WordPerfect 4.1 
  83.  
  84.                  Press / to quit without selecting.
  85. -----------------------------------------------------------------
  86.  
  87. This example uses some of the more popular! programs for clarity. 
  88. These programs are not included with Jump. 
  89.  
  90. Now follows an example,  taking the above menu as a guide, of the
  91. file S:JUMP.CMD.
  92.  
  93. -----------------------------------------------------------------
  94. .Key hop
  95. Skip <hop>
  96. LAB a
  97. cd dh0:audio/sonix
  98. run SONIX
  99. QUIT
  100. LAB b
  101. cd dh0:audio/audiomaster
  102. run AudioMaster
  103. QUIT
  104. LAB c
  105. cd dh0:audio/PerfectSound
  106. run PSound
  107. QUIT
  108. LAB d
  109. cd dh0:audio/DeluxeMusic
  110. Run DeluxeMusic
  111. QUIT
  112. LAB e
  113. cd dh0:audio/SoundSamplers
  114. Run Digi68000
  115. QUIT
  116. LAB f
  117. cd dh0:audio/SoundSamplers
  118. Run FutureSound
  119. QUIT
  120. LAB g
  121. cd dh0:audio/InstantMusic
  122. ASK "Needs WorkBench 1.1. Continue Y/N " 
  123. IF WARN
  124.    RUN InstantMusic
  125. ENDIF
  126. QUIT
  127. LAB h
  128. cd dh0:audio/MusicStudio
  129. ASK "Needs WorkBench 1.1. Continue Y/N " 
  130. IF WARN
  131.    Exec Start.BAT
  132. ENDIF
  133. QUIT
  134. LAB i
  135. cd dh0:Development/GfA
  136. run GfABasic
  137. QUIT
  138. LAB j
  139. cd dh0:Development/AmigaBasic
  140. run AmigaBasic
  141. QUIT
  142. LAB k
  143. cd dh0:development/LC
  144. exec start.bat
  145. QUIT
  146. LAB l
  147. cd dh0:development/Aztec3.6
  148. exec start.bat
  149. QUIT
  150. LAB m
  151. cd dh0:development/Modula_II
  152. exec start.bat
  153. QUIT
  154. LAB n
  155. cd dh0:video/Dpaint_II
  156. run Dpaint
  157. QUIT
  158. LAB o
  159. cd dh0:video/DPaint_II
  160. run Dpaint-Pal
  161. QUIT
  162. LAB p
  163. cd dh0:video/Dpaint_III
  164. run Dpaint
  165. QUIT
  166. LAB q
  167. cd dh0:video/PixMate
  168. Run Pixmate
  169. QUIT
  170. LAB r
  171. cd dh0:video/DigiPaint
  172. run Digi-Paint
  173. QUIT
  174. LAB s
  175. cd dh0:video/DigiPaint   
  176. run Digi-Paint -400
  177. QUIT
  178. LAB t
  179. cd dh0:video/DigiView2.0
  180. C:Run Digi-View
  181. QUIT
  182. LAB u
  183. cd dh0:video/DigiView-Gold
  184. C:Run Digi-View.NTSC
  185. QUIT
  186. LAB v
  187. cd dh0:video/DigiView-Gold
  188. C:Run Digi-View.PAL
  189. QUIT
  190. LAB w
  191. cd dh0:video/PerfectVision
  192. C:Run PV
  193. QUIT
  194. LAB x
  195. cd dh0:Development/director
  196. run TXED
  197. QUIT
  198. LAB y
  199. cd dh0:development/Tv*Show
  200. run TvShow_EDIT
  201. QUIT
  202. LAB z
  203. cd dh0:video/Diamond
  204. C:Run Diamond
  205. QUIT
  206. LAB 1
  207. cd dh0:video/ps
  208. stack 50000
  209. PS
  210. QUIT
  211. LAB 2
  212. cd dh0:video/PhotonPaint
  213. run PhotonPaint
  214. QUIT
  215. LAB 3
  216. cd dh0:video/Sculpt4D
  217. exec start.bat 
  218. QUIT
  219. LAB 4
  220. cd dh0:video/VideoScape
  221. exec start.bat 
  222. QUIT
  223. LAB 5
  224. cd dh0:video/DBW-Render
  225. exec start.bat 
  226. QUIT
  227. LAB 6
  228. cd dh0:video/LCA
  229. exec start.bat 
  230. QUIT
  231. LAB 7
  232. cd dh0:video/Caligari
  233. exec start.bat 
  234. QUIT
  235. LAB 8
  236. cd dh0:video/FantaVision
  237. exec start.bat 
  238. QUIT
  239. LAB 9
  240. cd dh0:video/AmigaTex
  241. exec start.bat 
  242. QUIT
  243. LAB 0
  244. cd dh0:video/RIM-5
  245. exec start.bat 
  246. QUIT
  247. LAB -
  248. cd dh0:video/MFFPlus
  249. exec start.bat 
  250. QUIT
  251. cd dh0:video/SuperBase
  252. exec start.bat 
  253. LAB =
  254. QUIT
  255. LAB \
  256. Assign WP:    dh0:business/wp
  257. Assign PRINT: dh0:business/wp
  258. cd dh0:business/wp
  259. wp 
  260. Assign > NIL: WP:    list
  261. Assign > NIL: PRINT: list
  262. cd dh0:
  263. QUIT
  264. LAB /
  265. QUIT
  266. ------------------------------------------------------------------
  267.  
  268. The files: Jump.BAT, Jump.CMD and Jump.SCR should also be included
  269. on this disk.  Feel free to use and adapt them to your own system.
  270. Although Jump was initially developed for a harddisk,  it can also
  271. be used with floppydrives. Just substitute the volumename for dh0:
  272. and the system will ask you for that specific volume.  If you want
  273. to make the most use of Jumps capabilities, I would advice to read
  274. BANTAM's The AmigaDOS Manual. It will give you the information you
  275. need to create batch files that can be called from Jump.CMD.    
  276.  
  277. Requirements: 
  278.  
  279. - A standard Amiga with 512KByte of memory will suffice. Make sure
  280.   though, that there is enough  free memory or the program aborts.
  281. - The file <Jump.CMD> must be present in the S: directory and also
  282.   syntacticly identical to the above example.  Ie., the first line
  283.   must be: ".key varname", and the  second line: "skip <varname>".
  284.   Labels should have a one character name.   
  285.  
  286. The program should support all regular  Amiga devices. I tested it 
  287. with DF0: to DF2:, VD0:, VDK:, RAM:, CARD: and DH0: to DH2:. It is 
  288. compatible with both  WorkBench 1.2 and 1.3. I haven not tested it 
  289. with 1.1 though. 
  290.  
  291. NOTICE: 
  292.  
  293. This software is  supplied as is, and  neither the  author nor the 
  294. distributor is liable or responsible for any  damage to either the 
  295. computer or any pheripherals or media this software is used on. 
  296.  
  297. 3. Copyright. 
  298.  
  299. This program is considered FreeWare. It may be copied freely. When
  300. doing so please adhere to the following rules.
  301.  
  302. - The program may not be used or bundled by any software retailing
  303.   over US$ 10.00 (British £ 3.00), or it's equivalent in any other 
  304.   currency, without prior written permission from the author. 
  305.  
  306. - This document must always accompany the program. 
  307.  
  308. - This document may not be altered.
  309.  
  310. - The unaltered files: Jump.BAT, Jump.CMD and Jump.SCR must always
  311.   accompany the Jump program and this document.
  312.  
  313. - The author  retains the right to  remove this  program  from the 
  314.   Public Domain at any time, without prior notification. 
  315.  
  316. 4. Distribution. 
  317.  
  318. Distribution rights are  hereby, of course,  granted to Fred Fish, 
  319. and any other non-profit organisation.  Persons wanting to include 
  320. this program, and / or it's  source on any disk retailing over US$ 
  321. 10.00 ( British £3.00 ), or it's equivalent in any other currency,
  322. must first obtain written permission for this from the author. 
  323.  
  324. 5. BUG-Reports. 
  325.  
  326. Known Bugs:
  327.  
  328. - None, as of 14th May 1989
  329.  
  330. Send Report To:
  331.  
  332. Although I've had this program extensively tested, there is always
  333. the possibility of something being overlooked.  So If you've found
  334. a bug, or you think that you might have found a bug,  please print
  335. out the following form on you printer,  fill in all the neccessary
  336. details, and sent it to the address mentioned on it. Thanks! 
  337.  
  338. ------------------- Cut Here Please ------------------------------ 
  339.  
  340. +----------------------------------------------------------------+ 
  341. |                           BUG Report                           | 
  342. +----------------------------------------------------------------+ 
  343. | Program     : Jump            Version     : 1.00               | 
  344. +----------------------------------------------------------------+ 
  345. | Bug         :                                                  | 
  346. |                                                                | 
  347. |                                                                | 
  348. |                                                                | 
  349. |                                                                | 
  350. |                                                                | 
  351. |                                                                | 
  352. +----------------------------------------------------------------+ 
  353. | Additional information                                         | 
  354. | Error code  :                                                  | 
  355. |                                                                | 
  356. |                                                                | 
  357. |                                                                | 
  358. |                                                                | 
  359. |                                                                | 
  360. |                                                                | 
  361. +----------------------------------------------------------------+ 
  362. | Sent to:    P. Kolenbrander                                    | 
  363. |             <BUG-Report Jump V1.00>                            | 
  364. |             Turfveldenstraat 37                                | 
  365. |             NL-5632 XH  EINDHOVEN                              | 
  366. |             The NETHERLANDS                                    | 
  367. |                                                                | 
  368. +----------------------------------------------------------------+ 
  369.        
  370. ------------------- Cut Here Please ------------------------------ 
  371.  
  372. 6. Donations. 
  373.  
  374. This program is considered Freeware. Meaning that if you find this
  375. program useful, you are kindly requested to make this noted to the 
  376. author.  Preferably by means of a (cash!) donation or other useful
  377. token of appreciation.  This is not mandatory as is with Shareware 
  378. programs however.
  379.  
  380. If you have any cash to spare, it is always welcome. Unfortunately 
  381. I have my expenses also. Donations in other form, like disks, (PD) 
  382. software, Sonix Scores!, home-built programs / hardware  etc,  are
  383. of course also welcome. Remember: 
  384.  
  385.             'It is better to give than to receive!' 
  386.   (I've given you this program, so now it's you turn, isn't it?) 
  387.  
  388. Enjoy the program! 
  389.  
  390. My address is: P. Kolenbrander 
  391.                Turfveldenstraat 37 
  392.                NL-5632 XH  EINDHOVEN 
  393.                HOLLAND 
  394.