home *** CD-ROM | disk | FTP | other *** search
/ The Best of the Best / _.img / 02154 / muzak2.arc / MUZAK.DOC < prev    next >
Text File  |  1986-07-09  |  7KB  |  114 lines
  1. MUZAK.DOC
  2. Documentation to  MUZAK.BAS and MUZAK.EXE
  3. Version 2.3  (9 July 1986)
  4.  
  5. Aaron Ross Priven
  6.  
  7. Music Written by Assorted Authors
  8.  
  9. REQUIREMENTS:  MS/PCDOS 2.0 or higher,   one double-sided  disk drive (or
  10. other storage device with the same or higher  capacity).   For  the  .BAS
  11. interpreted  version,   IBM  Cartridge BASIC,  IBM  Advanced  BASIC,   or
  12. Microsoft  GWBASIC is required. For the compiled version, MS/PCDOS 2.1 is
  13. required.  It has  been tested using IBM Advanced BASIC and the  compiled
  14. version using the IBM Basic Compiler 2.0 on an IBM PC-1 with the November
  15. 1981  ROM-BIOS and 320K of memory, 257 of which was available for use.  I
  16. am not sure exactly how much RAM is required, but 128K should do it.
  17.  
  18. USER LICENSE:  What's a license? This program is yours to modify, revamp,
  19. or delete, as the case may be. This is FREE.
  20.  
  21. INSTRUCTIONS:  To use MUZAK,  extract all the files with .MUZ  extensions
  22. from the archive MUZAK23.ARC,  as well as either MUZAK.BAS or  MUZAK.EXE.
  23. Start  MUZAK  from  the DOS prompt by typing "MUZAK"   for  the  compiled
  24. version  or,  making sure that the BASIC interpreter is available,   type
  25. BASICA (or  the  name  of your interpreter) MUZAK.   There  is   no  real
  26. advantage  to  running either version save  that  the  compiled   version
  27. requires  a  copy  of  COMMAND.COM to be  around when it exits,   and the
  28. interpreted  version  requires  a copy of BASICA.COM or  the   equivalent
  29. upon entry., except that if you use the -F or -D command line entries, it
  30. is easier (but not impossible) to use the compiled version. Once you have
  31. started  the program,  the "What Kind of Songs"  menu appears.    Pick  a
  32. selection  by   pressing  the appropriate  key.    Then the "Pick a Song"
  33. menu appears.    Pick  another selection.   The  song plays.  Either wait
  34. for  the song to end or hit <ESC>  to quit playing,  upon which  it  will
  35. return to the "Pick A Song" menu.  You may pick another selection, or hit
  36. <ESCAPE>   or <RETURN> to return to the "What Kind  of Songs"  menu.   If
  37. you  return  to the  "What Kind of  Songs"  menu,  you may  pick  another
  38. selection  or  hit  <ESCAPE>     to exit MUZAK, whereupon it will ask you
  39. if  you  REALLY  want  to  leave or  not.     This   should   be   rather
  40. straightforward.
  41.  
  42. COMMAND LINE OPTIONS:  There are two command line options. The first is -
  43. F.   This will get rid of the fancy "starry pattern"  which I found in an
  44. old PCBlue library disk.  I  personally like it,  but if you don't,  just
  45. type MUZAK -F (or MUZAK /F --  it stands for FAST)  and it'll go bye-bye.
  46. The  other  option is -D or /D (DEBUG)  and that will show each  line  of
  47. music as it's  being played.  I  expect this last will only appeal to me,
  48. but  so what.  If you can only run the interpreted version,  then this is
  49. how  you  access  the command lines:  load up GWBASIC or  BASICA  without
  50. running a program,  e.g.  so it prints the version number at the top when
  51. you load it.  Load MUZAK.BAS with the LOAD command.  Then type: COMMAND$=
  52. "-D"   or COMMAND$="-F"  or COMMAND$="/D /F"  or whatever.  The line must
  53. be  in  capitals  because I wrote it for the compiler  and  the  compiler
  54. automatically capitalizes it.   Then type GOTO 1000.   However,   it's  a
  55. big  pain.   Personally if it came to  that  I'd probably just modify the
  56. program, if I were you. Fortunately, I'm not.
  57.  
  58. LEAVING MUZAK:  The easiest way to leave MUZAK is to hit <ESCAPE> a  lot.
  59. It no longer matters how you leave. In fact, <CONTROL-BREAK> checking has
  60. been  added  in  the  compiled  version  (it  was  always  there  in  the
  61. interpreted version).
  62.  
  63. DOS   ENVIRONMENT:    MUZAK  has  been  rewritten  to  not  use  the  DOS
  64. environment.  This leaves off the biggest pain in MUZAK and eases my mind
  65. a lot. Now I don't look like quite the idiot programmer I did before.
  66.  
  67. ADDING FILES TO MUZAK:  This is a very easy thing to do.  The formats are
  68. found  in  the accompanying MUZFMT.DOC,  and the only other thing  really
  69. necessary is to know that a "music code"  is one of the codes found under
  70. the "PLAY" statement in some sort of BASIC manual.
  71.  
  72. COMPILING  MUZAK:   Well,  if you really want to (I only did  it  because
  73. somebody  asked),  I   just compiled it under the IBM BASIC Compiler  2.0
  74. (Microsoft  QuickBasic works just as well) with the parameters /N/O/D. As
  75. I understand it /N makes all programs,   line numbers or no, work faster.
  76. Then I LINKed it under IBM Link 2.3 with no parameters.
  77.  
  78. NOTE:   Some  (many)  of the new .MUZ files added with version  2.3   are
  79. unknown to the author,  meaning I don't know what they are!  Many if  not
  80. most of the ones marked "Programmed and Written Anonymously"  are  merely
  81. ones  I  don't  know about.  If you can help me with  this,   I'd  really
  82. appreciate  it!  Also I lost some of the BASIC programs I took them from,
  83. so I'm not sure of all of them because of THAT.
  84.  
  85. GETTING  IN TOUCH WITH THE AUTHOR:  Please DO!!!  I  am interested in all
  86. conversation  regarding  MUZAK because I'm starved for it!  A   lot  more
  87. people  have talked to me about it than before --  thanks --  and  Nelson
  88. Ford  even wrote a review in a Houston Software SIG about MUZAK (see  the
  89. accompanying file REVIEW.DOC), but the more the merrier!
  90.  
  91. JUST HOW EXACTLY TO TOUCH THE AUTHOR: Well,  the BBS I once had went down
  92. on account of lack of users. Oh well. Anyway, you can still contact me on
  93. the following BBS's:  TechNet, San Carlos, CA, (415)  595-5079; Charisma,
  94. San Mateo, CA, (415) 349-6576; or Kay+Fun, Belmont, CA,  (415)  572-8219.
  95. Also, a FIDO Node has started up near me. I forget the Fido address,  but
  96. the  name  is  "The  Dog Lab"  and the address  is  "somewhere  near  San
  97. Francisco, CA", which is where the sysop says Belmont is. Leave a message
  98. on  any one of these to "Aaron Priven"  and I'll respond.  I  do  have  a
  99. CompuServe UserID,  but the last time I was on must have been at least  3
  100. months ago, so I wouldn't count on it, but here it is: 74776,431. I'm not
  101. sure  exactly whose name it's in,  but it should work if you REALLY don't
  102. mind  waiting,   on a scale of months.   (Like a quick "You stink,   quit
  103. littering up BBSs with your garbage."  that might do  fine.)   Also,  you
  104. could write me using Real Live US Postal Service Mail, if you prefer.
  105.  
  106. Thank you for perusing this file.
  107.  
  108. =Aaron Ross Priven= 540 Sylvan Avenue San Mateo, CA 94403-3214 USA
  109.  
  110. , if you prefer.
  111.  
  112. Thank you for perusing this file.
  113.  
  114. =Aaron Ross