home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / customise / beeperror / !BeepError / !Help < prev    next >
Encoding:
Text File  |  1993-09-01  |  4.6 KB  |  126 lines
  1. BeepError v0.33
  2. ~~~~~~~~~~~~~~~
  3. © 30th August 1993
  4.  
  5. By Piers Wombwell
  6.  
  7. Introduction
  8. ~~~~~~~~~~~~
  9. This is BeepError - a desktop patch to change the system beep to a chosen
  10. sample, which maybe different depending on the error.
  11.  
  12. Configuration
  13. ~~~~~~~~~~~~~
  14. To configure BeepError, double click on the icon, and you will get a list of
  15. errors (currently for ADFS, SparkFS and ArcFS), and a list of samples the
  16. program knows about. If the sample list is empty, you will need to add some
  17. samples (see later). Click on the error you wish to assign (say 'Drive
  18. Empty'), and then a sample on the right. You will notice that the error is
  19. now shaded in grey to show that it has a sample assigned to it.
  20.  
  21. Do this for as many errors as you like, and click SELECT on 'Apply' to save
  22. these settings, and to load the module into RAM. This only takes 1k of RAM,
  23. so is hardly going to affect your computing. Click 'Cancel' if you do not
  24. wish to save your settings, or load the module into RAM.
  25.  
  26. Now, generate that error!
  27.  
  28. Auto-loading
  29. ~~~~~~~~~~~~
  30. To load this in a !Boot file, you must first configure it, as shown above.
  31. Then add the following two lines to your !Boot file:
  32. *Run <pathname>.!BeepError.!Boot
  33. *RMLoad <BeepError$Dir>.BeepError
  34.  
  35. Running the !Boot is necessary since it sets the path for the samples, which
  36. the module relys on. An error will occur if you have not previously
  37. configured BeepError as described above.
  38.  
  39. Changing the samples
  40. ~~~~~~~~~~~~~~~~~~~~
  41. The program should come with a set of samples. If you decide to use them,
  42. they (and any extras) must be kept inside the application so they can be
  43. found when the selected error occurs. They are not kept in RAM all the time,
  44. since I already say goodbye to about 1Meg of RMA on startup, and I couldn't
  45. cope with anymore going :-). If the program cannot find the samples, or they
  46. cannot be read for any reason, the default system beep will be played
  47. instead.
  48.  
  49. To add some new samples, simply copy them into the directory 'Samples' inside
  50. the application.
  51.  
  52. Adding more errors
  53. ~~~~~~~~~~~~~~~~~~
  54. You can add your own errors to the program. Have a look in the directory
  55. 'Errors' inside the application. The leafname is displayed as the group
  56. heading in dark grey in the error list window. Each line is a new error (must
  57. be terminated with ASCII 10. I suppose I ought to make it any control
  58. character). Anyway, you should be able to work out the format from the
  59. existing files.
  60.  
  61. Things not to worry about
  62. ~~~~~~~~~~~~~~~~~~~~~~~~~
  63. The memory usage of this is minimal. Generally under 1k of RMA space is used.
  64. When a sample is played, the required amount of memory is claimed, and the
  65. sample is loaded into the System Sprites area. Once the error window is
  66. clicked on, the memory is given back. This stops any fragmentation of the
  67. RMA, and keeps memory usage to under 1k.
  68.  
  69. Errors reported by Filer_Action are not intercepted, so do not get the sample
  70. played.
  71.  
  72. Things to look forward for
  73. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  74. A 'Try' icon to play the sample.
  75.  
  76. Edit the current configuration.
  77.  
  78. Deselecting a sample - currently, it doesn't actually work, although it may
  79. appear to in the window.
  80.  
  81. You shouldn't be able to select a group heading (such as ADFS). Oops.
  82.  
  83. Comments in the error files (starting with ‘;’, ‘#’ or ‘|’)
  84.  
  85. There seems to be a problem with restoring the pitch of the system beep.
  86. Oops.
  87.  
  88. Contacting me
  89. ~~~~~~~~~~~~~
  90. Erm.... If you really want to contact me (I'd really appreciate suggestions),
  91. you can contact me in any of the following ways:
  92.  
  93. Email:
  94. P.Wombwell@rhbnc.ac.uk
  95. Piers@garbo.uwasa.fi (if the wonderful vax is down again)
  96.  
  97. Arcade BBS:
  98. Username: Piers
  99. Phone numbers: 081-654 2212 (4 ridiculously fast lines(anything up to 14.4k))
  100.                081-655 4412 (1 even faster line (16.somethingk bps))
  101. "log on - it's grate" (a certain omnipresent person who wrote the best
  102. template editor ever seen this side of 9th September '93)
  103.  
  104. Snail Mail:
  105. 34 Hereford Road
  106. Wanstead
  107. London
  108. E11 2EA
  109.  
  110. Thanks to
  111. ~~~~~~~~~
  112. Everyone at Arcade BBS
  113. Tim Browse for some suggestions long before I ever got round to thinking
  114. about releasing the first version, and help on playing samples.
  115. David Pilling for the idea of using the System Sprites area to save the RMA.
  116. Mark Smith for the ArcFS error numbers (his text file even happened to be in
  117. the correct format for this program, so I didn't have to do anything :-) )
  118.  
  119. Distribution
  120. ~~~~~~~~~~~~
  121. This program is Freeware. This means I retain the copyright, but you can
  122. distribute it freely, as long as no part is altered (including this !Help
  123. file). It may not be distributed by any PD library, or any other organization
  124. who may charge for it (or the media it is on), nor may you use any part of it
  125. in your own programs, without my prior written permission.
  126.