home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 505.dms / 505.adf / DOCS / SmusCopy.Doc < prev    next >
Text File  |  1989-09-09  |  11KB  |  245 lines
  1.                            SmusCopy
  2.  
  3.                             Topics
  4.  
  5.                    1.   History & Acknowledgements.
  6.  
  7.                    2.   Usage.
  8.  
  9.                    3.   Copyright.
  10.  
  11.                    4.   Distribution.  
  12.  
  13.                    5.   BUG reports.
  14.  
  15.                    6.   Donations.
  16.  
  17. 1. History.
  18.  
  19. I developed this program because of the following reasons:
  20.  
  21. - I found a program  'MC-Info'. Though it did not work with Sonix,
  22.   (it was meant for MusiCraft) it gave me the basic idea for this.
  23. - I wanted to get a little order in my collection of Sonix Scores.
  24. - I was left with a large amount of spare time at work so I talked
  25.   my employer into letting me study C (Him thinking it was for his
  26.   benefit only, little did he know!). So I started out with an old
  27.   IBM XT ( floppies only! ), Turbo C version 1.0 and Les Hancock's
  28.   'The C Primer'. ( study during workhours of course, and being an
  29.   IBM agent, having no Amiga's). 
  30. - I got a little fed up with  having to  check every score for the 
  31.   instruments it needed. Not having enough reason to justify me to
  32.   buy Sonix, (I like music, but can't write it!) I had to use TYPE
  33.   opt H for this. As I progressed with my C studies(!), I felt the
  34.   need for some  programming practice. So I looked for some useful
  35.   project.  This started the development of the bits and pieces of
  36.   C coding that have have now become the program SmusCopy.
  37.  
  38. < In this context, thanks to Mark Riley for releasing his 'Play' >
  39. < as FreeWare.  To all you out there who use it!! If you haven't >
  40. < already, pay the guy his $10, the program is worth every cent! >
  41.  
  42. After a lot of headaches and GURU's, probably due to the fact that
  43. this is my first real C program, here it is. I found out fast that
  44. all the time and  effort I put into  developing it,  have not been
  45. in vain. After acquiring a harddisk, I wanted to copy my favourite
  46. scores onto it.  Using 'Smuscopy' not only saved me a considerable
  47. amount of time,  but also enabled me to put only those instruments
  48. on the harddisk that were loaded by the scores.   
  49.  
  50.  
  51. Version History : V1.0A, July 1988.
  52.                   Aztec C, Regular GURU meditations.
  53.                   Cause: Memory allocation problems (my fault)
  54.                          32 bits / 16 bits problems (Who hasn't?)
  55.                          File access problems (also my fault)
  56.                   V1.1A, August 1988.
  57.                   Aztec C, Occasional GURU meditation.
  58.                   Cause: 32 bits/16 bits (slow learner, I know!)
  59.                   V1.2A, August 1988.
  60.                   Aztec C, .ss files over 32KB will not copy.
  61.                   Cause: using UNIX, not DOS file access.
  62.                   V1.3A, August 1988.
  63.                   Aztec C, seems to be working ok now.
  64.                   V1.3L September 1988
  65.                   Lattice C, ported from Aztec to see if possible.
  66.                   Liked the result, so it became the official one.
  67.                   V1.4L September 1988
  68.                   Lattice C, some optimizing and housecleaning.
  69.                   V1.5  April 1989
  70.                   Lattice C, Made (more or less) ANSI-C compatible.
  71.                   Added a check on empty files.
  72.                   V1.6  July 1989
  73.                   Lattice C, Bug Fix!. V1.5 introduced a bug. .instr
  74.                   files would not always be closed. This produces an
  75.                   'Object in Use' message when trying to delete it.
  76.                   Problem solved. (Those nasty braces!. And those
  77.                   things always crop up when I am on holiday!!!!)
  78.  
  79. Acknowledgements.
  80.  
  81. - Fred Fish, for  supplying me with the  incentive to develop this
  82.   program, by means of his Fish PD collection. (special thanks for
  83.   LibFish 16!).
  84. - The guys at EA, for putting the information that I needed in the
  85.   Public Domain. 
  86. - The author of the program MC-Info, whoever he (or she!) is.
  87. - Pieter, for giving me some pointers (no pun intended), and other
  88.   helpful information.
  89. - Mark Riley, for  providing me with an  inexpensive way of access
  90.   to all those Sonix scores.
  91.  
  92. 2. Usage     
  93.  
  94. Usage : SmusCopy <SOURCE> <DESTINATION> <SCORE>
  95.  
  96. How to use this program? Well it is fairly simple, all you have to
  97. input are, the SOURCE device, the DESTINATION device, and the name
  98. of the SCORE, without the <.smus> suffix. The program assumes that
  99. both the source- and the  destination  device contain a Scores and
  100. an  Instruments directory. There is no need to  specify either the
  101. Scores or the Instruments  directory in either device. The  device
  102. can also be a path, in that case it must end with a /.  To clarify
  103. this I will give some examples.
  104.  
  105. Score to copy : DF0:Scores/Jolene.smus
  106. Copy to       : DF1:
  107.  
  108. Command line  : SmusCopy DF0: DF1: Jolene
  109.  
  110. Score to copy : DH0:Sonix/Scores/Jolene.smus
  111. Copy to       : DF1:
  112.  
  113. Command line  : SmusCopy DH0:Sonix/ DF1: Jolene
  114.  
  115. Score to copy : DH0:Sonix/Scores/Miami Sky.smus
  116. Copy to       : DH1:SmusPlay
  117.  
  118. Command line  : SmusCopy DH0:Sonix/ DH1:Smusplay/ "Miami Sky"
  119.  
  120. Requirements:
  121.  
  122. - Both the Scores and the Instruments directory must reside on the
  123.   same device/path. It is not possible,  when copying a score from
  124.   DF0:, to copy the instruments from DF0:Sonix or DF1:. I  did not
  125.   have the need for it,  and  it would only make the  program more
  126.   difficult to use, needing more arguments. 
  127.  
  128. - On both the source- and the destination device/path, the Scores-
  129.   and Instruments directory should exist.
  130.  
  131. - Make sure that there is enough space on the destination for both
  132.   the score and all it's instruments. If not you will get an error
  133.   message.
  134.  
  135. - An Amiga with a minimum of 512KByte.
  136.  
  137. The program should support all regular  Amiga devices. I tested it
  138. with DF0: to DF3:, VD0:, VDK:, RAM:, CARD: and DH0: to DH2:. It is
  139. compatible with both  WorkBench 1.2 and 1.3. I haven not tested it
  140. with 1.1 though.
  141.  
  142. NOTICE:
  143.  
  144. This software is  supplied as is, and  neither the  author nor the
  145. distributor is liable or responsible for any  damage to either the
  146. computer or any pheripherals or media this software is used on.
  147.  
  148. 3. Copyright.
  149.  
  150. Copyright 1988 by P. Kolenbrander.
  151.  
  152. This program is considered FreeWare. If you use it however, please
  153. read the chapter 'Donations' at the end of this document.  You may
  154. freely copy this program. When doing it, you must adhere  to these 
  155. few rules.
  156.  
  157. - The program may not be used or bundled by any software retailing
  158.   over US$ 10.00 (British £ 3.00), or it's equivalent in any other
  159.   currency, without prior written permission from the author.
  160.  
  161. - This document file must always accompany the program.
  162.  
  163. - This document file may not be altered by anyone.
  164.  
  165. - The author  retains the right to  remove this  program  from the
  166.   Public Domain at any time, without prior notification.
  167.  
  168. 4. Distribution.
  169.  
  170. Distribution rights are  hereby, of course,  granted to Fred Fish,
  171. and any other non-profit organisation.  Persons wanting to include
  172. this program and / or it's  source on any disk  retailing over US$
  173. 10.00 (British £ 3.00),  or it's equivalent in any other  currency
  174. must first obtain written permission for this from the author.
  175.  
  176. 5. BUG-Reports.
  177.  
  178. Accidents will happen and I'm only human. If you find a bug or you
  179. think you  might have found a bug, please  print out the following
  180. form on you printer,  fill in the  neccessary details, and sent it
  181. to the address mentioned on it. Thanks!
  182.  
  183. ------------------- Cut Here Please ------------------------------
  184.  
  185. +----------------------------------------------------------------+
  186. |                           BUG Report                           |
  187. +----------------------------------------------------------------+
  188. | Program     : SmusCopy        Version     : 1.6                |
  189. +----------------------------------------------------------------+
  190. | Bug         :                                                  |
  191. |                                                                |
  192. |                                                                |
  193. |                                                                |
  194. |                                                                |
  195. |                                                                |
  196. |                                                                |
  197. +----------------------------------------------------------------+
  198. | Additional information                                         |
  199. | Error code  :                                                  |
  200. |                                                                |
  201. |                                                                |
  202. |                                                                |
  203. |                                                                |
  204. |                                                                |
  205. |                                                                |
  206. +----------------------------------------------------------------+
  207. | Sent to:    P. Kolenbrander                                    |
  208. |             <BUG-Report SmusCopy V1.6>                         |
  209. |             Turfveldenstraat 37                                |
  210. |             NL-5632 XH  EINDHOVEN                              |
  211. |             The NETHERLANDS                                    |
  212. |                                                                |
  213. +----------------------------------------------------------------+
  214.       
  215. ------------------- Cut Here Please ------------------------------
  216.  
  217. 6. Donations. 
  218.  
  219. This program is considered Freeware. Meaning that if you find this
  220. program useful, you are kindly requested to make this noted to the 
  221. author.  Preferably by means of a (cash!) donation or other useful
  222. token of appreciation.  This is not mandatory as is with Shareware 
  223. programs however.
  224.  
  225. If you have any cash to spare, it is always welcome. Unfortunately 
  226. I have my expenses also. Donations in other form, like disks, (PD) 
  227. software, Sonix Scores!, home-built programs / hardware  etc,  are
  228. of course also welcome. Remember: 
  229.  
  230.             'It is better to give than to receive!' 
  231.   (I've given you this program, so now it's you turn, isn't it?) 
  232.  
  233. Enjoy the program! 
  234.  
  235. My address is: P. Kolenbrander 
  236.                Turfveldenstraat 37 
  237.                NL-5632 XH  EINDHOVEN 
  238.                HOLLAND 
  239.  
  240. No phone, not since some guy woke me at  04:00 AM ( My local time, 
  241. not his!). So, if you feel it is that  urgent to call me you won't   
  242. mind taking the trouble of finding out my phonenumber. But PLEASE! 
  243. check the  time-differences. I can get  pretty  uncooperative when 
  244. called out of bed in the middle of the night!
  245.