home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / asmutl / musicbox.lbr / MACROS.LZB / MACROS.LIÂ
Encoding:
Windows Setup INFormation  |  1988-04-02  |  3.3 KB  |  87 lines
  1. ; Edit version 1.01
  2. ;**************************************************************************
  3. ;**************************************************************************
  4. ;***                                    ***
  5. ;***    Macro library.                            ***
  6. ;***                                    ***
  7. ;**************************************************************************
  8. ;**************************************************************************
  9. ;
  10. ; File Name        : MACROS.LIB
  11. ; Module Name        : MUSICBOX
  12. ; Module Build File    : MUSICBOX.ZEX
  13. ; Author        : Edmund Cramp
  14. ; Creation Date        : 16-Apr-1987
  15. ;
  16. ; Assembler Name    : Z80ASM (SLR Systems)
  17. ; Linker Name        : SLRNKP (SLR Systems)
  18. ;
  19. ; Ammendment Record
  20. ; *****************
  21. ; Name        Date        Details of Ammendment
  22. ; ----        ----        ---------------------
  23. ; Edmund Cramp    16-Apr-1987    Initial file creation
  24. ; Edmund Cramp    17-Apr-1987    Version macro added.
  25. ; Edmund Cramp    19-Mar-1988    Modified for SLR assembler/linker.
  26. ; 
  27. ; Module Function
  28. ; ***************
  29. ;    This is the macro library for the MUSICBOX module.  It is often an
  30. ; advantage to place common macros in a seperate file so that they may be
  31. ; used in several modules.  When writing a macro it is very important to
  32. ; document with plenty of comments - you will probably only write the macro
  33. ; once but will use it many times and may not always remember the input
  34. ; parameters and limitations.  The macros below are all commented in one
  35. ; of two ways:-
  36. ;    i.    A text block ABOVE the macro describing its function and
  37. ;        input/output requirments and restrictions.
  38. ;    ii.    Internal comments starting with ";;" - these will not appear
  39. ;        in the final macro assembly listing and will not comsume
  40. ;        memory during the actual assembly as normal ";" delimited
  41. ;        comments would.
  42. ;    In general macros that are used globally (within several different
  43. ; modules) will be placed in this module - however specialised macros that
  44. ; are of a more limited application should be placed with the modules that
  45. ; use them.  This strategy will make the best use of macro table space in
  46. ; assemblers that keep their internal macro tables in mamory and will
  47. ; generally speed all assemblies.  The macro "NOTE" is in this class and is
  48. ; placed as a "Local Macro" within the modules using it.
  49. ;
  50. ;**************************************************************************
  51.  
  52. ;+
  53. ; Usage:    STRING    'ASCII text string'
  54. ; Macro to take a single ASCII text string as input and append CR,LF to it.
  55. ; The string is then terminated with a '$' for use with the CP/M BDOS print
  56. ; function.
  57. ;-
  58. STRING        MACRO    TEXT
  59.         DEFB    TEXT,0DH,0AH,'$'
  60.         ENDM
  61.  
  62. ;+
  63. ; Usage:    PRINT    label
  64. ; Macro to print a '$' terminated string on the console via CP/M function 9.
  65. ;-
  66. PRINT        MACRO    NAME
  67.         LD    DE,NAME        ;; Point to string
  68.         LD    C,9        ;; CP/M func - print terminated string.
  69.         CALL    BDOS        ;; Call operating system.
  70.         ENDM
  71.  
  72. ;+
  73. ; Usage:    VERSION
  74. ; Macro to generate a version number string from predefined symbol "VERSION".
  75. ; This symbol must have a value between 0 and 999.
  76. ;-
  77. MVERSN        MACRO
  78.         DEFB    [VERSION/100]+'0'
  79.         DEFB    '.'
  80.         DEFB    [VERSION MOD 100/10]+'0'
  81.         DEFB    [VERSION MOD 10]+'0'
  82.         ENDM
  83.  
  84. ;**************************************************************************
  85. ;***    End of MACROS.LIB                        ***
  86. ;**************************************************************************
  87.