home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 505.dms / in.adf / DOCS / MakePlay.Doc < prev    next >
Encoding:
Text File  |  1989-09-09  |  7.6 KB  |  194 lines
  1.                            MakePlay 
  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 was developed to enable me,  with the use of only two
  20. commands,  to review the contents of any disk containing scores by
  21. playing all of them. Since I became fed up with typing play <file>
  22. for every score,  I devised this little, no thrills and no frills,
  23. program to do it for me by reading the scores directory and making
  24. a parameter file to be used by Play. 
  25.  
  26. Features:
  27.  
  28. - Fully compatible with both Workbench V1.2 and V1.3.
  29. - Works with all Amigas.
  30. - Supports most AmigaDos devices.
  31. - Play an entire disk of songs with only two simple commands.
  32. - Generated parameter file may be edited using any text editor.
  33. - The built-in Help function. Just type MakePlay ?.
  34.  
  35. 2. Usage      
  36.  
  37. Usage : MakePlay <SCORES> <INSTR> 
  38.  
  39. How to use this program? Well it is fairly simple, all you have to 
  40. input are, the path of the Scores you want to play and the path of
  41. the Instruments dir you want the program to use. If you don't want
  42. to play all the scores, you can use a text editor, like ED or TXEd
  43. to edit the parameter file. This file can be found on RAM: device.
  44. It is called: PlayFile.bat.
  45.  
  46. How do you review a disk?
  47.  
  48. 1.  Make sure both MakePlay and Mark Riley's 'Play' program are in
  49.     the C: directory of the disk you booted with.
  50. 2.  Check if the disk to be reviewed contains instruments.  if not
  51.     use an other instruments directory.
  52. 3.  Run MakePlay with the appropriate arguments.
  53. 4.  After MakePlay has finished, you have a list of all the scores
  54.     contained in the  parameter file.  (It might be a good idea to
  55.     redirect MakePlay's screen output to your printer, using the >
  56.     redirection command.) Now you can start Play, by typing either
  57.     'Play P=RAM:PlayFile.bat' or 'Play * P=RAM:PlayFile.bat'if you
  58.     want to run Play in the background. 
  59.  
  60. To clarify this I will give some examples. 
  61.  
  62. Scores    dir : DF0:Scores 
  63. Instrum.  dir : DF1:Instruments
  64.  
  65. Command line  : MakePlay DF0:Scores DF1:Instruments 
  66.                 MakePlay * DF0:Scores DF1:Instruments 
  67.  
  68. Scores    dir : DH0:Sonix/Scores 
  69. Instrum.  dir : DF1:My Files/Instr
  70.  
  71. Command line  : MakePlay DH0:Sonix/Scores "DF1:My Files/Instr"
  72.                 MakePlay * DH0:Sonix/Scores "DF1:My Files/Instr"
  73.  
  74. Requirements: 
  75.  
  76. - Both the Scores and the Instruments directory must exist.  There
  77.   is a check on this an if either does not exist, the program will
  78.   issue a message and quit.
  79.  
  80. - Since this program writes the  parameter file to RAM:, make sure
  81.   that that device can be accessed by the program. 
  82.  
  83. The program should support all regular  Amiga devices. I tested it 
  84. with DF0: to DF2:, VD0:, VDK:, RAM:, CARD: and DH0: to DH2:. It is 
  85. compatible with both  WorkBench 1.2 and 1.3. I haven not tested it 
  86. with 1.1 though. 
  87.  
  88. NOTICE: 
  89.  
  90. This software is  supplied as is, and  neither the  author nor the 
  91. distributor is liable or responsible for any  damage to either the 
  92. computer or any pheripherals or media this software is used on. 
  93.  
  94. 3. Copyright. 
  95.  
  96. This program is considered FreeWare. It may be copied freely. When
  97. doing so please adhere to the following rules.
  98.  
  99. - The program may not be used or bundled by any software retailing
  100.   over US$ 10.00 (British £ 3.00), or it's equivalent in any other 
  101.   currency, without prior written permission from the author. 
  102.  
  103. - This document must always accompany the program. 
  104.  
  105. - This document may not be altered.
  106.  
  107. - The author  retains the right to  remove this  program  from the 
  108.   Public Domain at any time, without prior notification. 
  109.  
  110. 4. Distribution. 
  111.  
  112. Distribution rights are  hereby, of course,  granted to Fred Fish, 
  113. and any other non-profit organisation.  Persons wanting to include 
  114. this program andd / or it's  source on any disk retailing over US$ 
  115. 10.00 ( British £3.00 ), or it's equivalent in any other currency,
  116. must first obtain written permission for this from the author. 
  117.  
  118. 5. BUG-Reports. 
  119.  
  120. Known Bugs:
  121.  
  122. - None as of 15th April 1989.
  123.  
  124. Send Report To:
  125.  
  126. Although I've had this program tested extensively,  there still is 
  127. the possibility that something has been overlooked.  If you find a
  128. bug, or you think you might have found a bug, please print out the
  129. following form on you printer, fill in the neccessary details, and
  130. sent it to the address mentioned on it. Thanks! 
  131.  
  132. ------------------- Cut Here Please ------------------------------ 
  133.  
  134. +----------------------------------------------------------------+ 
  135. |                           BUG Report                           | 
  136. +----------------------------------------------------------------+ 
  137. | Program     : MakePlay        Version     : 1.2                | 
  138. +----------------------------------------------------------------+ 
  139. | Bug         :                                                  | 
  140. |                                                                | 
  141. |                                                                | 
  142. |                                                                | 
  143. |                                                                | 
  144. |                                                                | 
  145. |                                                                | 
  146. +----------------------------------------------------------------+ 
  147. | Additional information                                         | 
  148. | Error code  :                                                  | 
  149. |                                                                | 
  150. |                                                                | 
  151. |                                                                | 
  152. |                                                                | 
  153. |                                                                | 
  154. |                                                                | 
  155. +----------------------------------------------------------------+ 
  156. | Sent to:    P. Kolenbrander                                    | 
  157. |             <BUG-Report MakePlay V1.2>                         | 
  158. |             Turfveldenstraat 37                                | 
  159. |             NL-5632 XH  EINDHOVEN                              | 
  160. |             The NETHERLANDS                                    | 
  161. |                                                                | 
  162. +----------------------------------------------------------------+ 
  163.        
  164. ------------------- Cut Here Please ------------------------------ 
  165.  
  166. 6. Donations. 
  167.  
  168. This program is considered Freeware. Meaning that if you find this
  169. program useful, you are kindly requested to make this noted to the 
  170. author.  Preferably by means of a (cash!) donation or other useful
  171. token of appreciation.  This is not mandatory as is with Shareware 
  172. programs however.
  173.  
  174. If you have any cash to spare, it is always welcome. Unfortunately 
  175. I have my expenses also. Donations in other form, like disks, (PD) 
  176. software, Sonix Scores!, home-built programs / hardware  etc,  are
  177. of course also welcome. Remember: 
  178.  
  179.             'It is better to give than to receive!' 
  180.   (I've given you this program, so now it's you turn, isn't it?) 
  181.  
  182. Enjoy the program! 
  183.  
  184. My address is: P. Kolenbrander 
  185.                Turfveldenstraat 37 
  186.                NL-5632 XH  EINDHOVEN 
  187.                HOLLAND 
  188.  
  189. No phone, not since some guy woke me at  04:00 AM ( My local time, 
  190. not his!). So, if you feel it is that  urgent to call me you won't   
  191. mind taking the trouble of finding out my phonenumber. But PLEASE! 
  192. check the  time-differences. I can get  pretty  uncooperative when 
  193. called out of bed in the middle of the night!
  194.