home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / asmutl / musicbox.lbr / -READ.ME next >
Encoding:
Text File  |  1988-04-02  |  2.4 KB  |  59 lines
  1.             >>>> M U S I C B O X  <<<<
  2.  
  3.     This library contains a group of files intended to help the novice
  4. Z-system user understand and use the SLR relocating macro assembler and
  5. linker (Z80ASM and SLRNKP).  They are intended to demonstrate relocatable code,
  6. PUBLIC and EXTERN referances and use of the CSEG, DSEG and COMMON pseudo-ops.
  7.  
  8.     They assemble to produce files that generate "music" on any AM radio
  9. placed close to the computer (FCC Class B not withstanding).
  10.  
  11.     The programs contained here are fairly simple in their individual
  12. construction and may be easily assembled, edited and linked.  A ZEX command
  13. file is included to perform this step automatically for these files - it 
  14. may be run by typing "ZEX MUSICBOX" and adding the name of the file that you
  15. wish to build eg.
  16.  
  17.     To build DAISY.COM you would type....
  18.  
  19.             ZEX MUSICBOX DAISY
  20.  
  21.     This will use Z80ASM to assemble a number of files, these files will
  22. then be linked together by SLRNKP to produce a single output file (in this
  23. case named DASIY.COM).  The output file may then be run in the same manner
  24. as any other program and will produce music on any AM radio placed close to
  25. the computer - you may need to adjust the radio tuning and position for
  26. maximum effect.  Those of you who are musically inclined should find it
  27. possible to transcribe other pieces of music for this system.
  28.  
  29.     If you place the Z-system libraries (VLIB, Z3LIB and SYSLIB) in the
  30. same directory as the MUSICBOX files then the ZEX command file will detect
  31. their presence and will build a ZCPR3 compatible version of the requested
  32. file - otherwise a CP/M 2.2 compatible program is produced.
  33.  
  34.     For further details examine (or print) the enclosed files.
  35.  
  36.  
  37. Files included.
  38.  
  39.  1. -READ   .ME        - General package information.
  40.  2. CRC     .CRC    - CRC info.
  41.  
  42.  3. DAISY   .Z80    - Musical score #1
  43.  4. FOOL    .Z80    - Musical score #2
  44.  5. SCALE   .Z80    - Musical score #3
  45.  
  46.  6. MUSICBOX.INF    - Text file used by ZEX command file.
  47.  7. MUSICBOX.ZEX    - ZEX command file for building programs.
  48.  
  49.  8. CPM     .Z80    - Equates required for final link.
  50.  9. MACROS  .LIB    - Macros used in various individual files.
  51. 10. NOTES   .LIB    - Equates defining three octaves of notes.
  52.  
  53. 11. MUSIC   .Z80    - CP/M compatible source code.
  54.  
  55. 12. ZMUSIC  .Z80    - ZCPR3 compatible source code.
  56. 13. MUTILS  .Z80    - Utilities required by ZMUSIC.Z80
  57.  
  58.  
  59.