home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / canada-remote-systems / cpower / reutools.sda / READ.ME,U,W < prev    next >
Text File  |  2019-04-13  |  6KB  |  214 lines
  1. àü           ╙╒╨┼╥-├ ╥┼╒ ┴├├┼╙╙
  2.                BY ╦ ╟RAY
  3. 
  4. ╘HE ╩UNE 1989 ╘RANSACTOR ARTICLE
  5. EXPLAINED HOW TO MAKE ╥┴═─╧╙ WORK
  6. WITH ╙UPER-├.  ╘HESE ╥┼╒ PROGRAMS
  7. ARE INTENDED TO EXPAND ON THAT
  8. IDEA.
  9. 
  10. ₧├ONTENTS OF THE ╥┼╒ PROGRAM PACKAGE:
  11. 
  12. ƒREAD.ME -- THE DOCUMENTATION.
  13. ƒREU.C -- ├ SOURCE CODE FOR DIRECT
  14. ƒ         MANIPULATION OF THE ╥┼╒
  15. ƒ         FROM ╙UPER-├, COMPATIBLE
  16. ƒ         WITH ╥┴═─╧╙ V4.
  17. ƒREU.H -- A HEADER FILE DEFINING
  18. ƒ         EXTERNAL FUNCTIONS FROM
  19. ƒ         REU.C, FOR USE WHEN REU.C
  20. ƒ         IS COMPILED SEPARATELY.
  21. ƒINSTALL.STUB -- ═ACHINE ╠ANGUAGE
  22. ƒ         OBJECT CODE FOR THE NEW
  23. ƒ         AND IMPROVED ╥┴═─╧╙
  24. ƒ         INSTALLER PROGRAM.
  25. ƒRVIEW.C -- A DEMONSTRATION PROGRAM
  26. ƒ         SHOWING HOW THE ╥┼╒ FUNCTIONS
  27. ƒ         CAN BE USED TO CREATE A
  28. ƒ         ╥┴═─╧╙ COMPATIBLE ╥┼╒
  29. ƒ         MEMORY VIEWER.
  30. 
  31. ₧╒SING REU.C
  32. 
  33.   ╘HERE ARE FIVE USER-CALLABLE
  34.   FUNCTIONS.  ╘HEY ARE:
  35. ü  FETCH
  36.    CALLING SEQUENCE:
  37.    STATUS=FETCH(SIZE,C64ADDR,╥┼╒ADDR);
  38.     STATUS= THE CONTENTS OF THE
  39.             ╥┼╒ STATUS REGISTER
  40.             AFTER THE FETCH. (INT)
  41.       SIZE= ╬UMBER OF BYTES TO FETCH. (INT)
  42.    C64ADDR= ╙TARTING ADDRESS IN ├-64
  43.             MEMORY WHERE FETCHED DATA
  44.             WILL BE STORED. (CHAR*)
  45.    ╥┼╒ADDR= ╙TARTING ADDRESS IN ╥┼╒
  46.             MEMORY WHERE FETCHED DATA
  47.             IS TAKEN. (LONG)
  48. 
  49. ü  STASH
  50.    CALLING SEQUENCE:
  51.    STATUS=STASH(SIZE,C64ADDR,╥┼╒ADDR);
  52.     STATUS= THE CONTENTS OF THE
  53.             ╥┼╒ STATUS REGISTER
  54.             AFTER THE STASH. (INT)
  55.       SIZE= ╬UMBER OF BYTES TO STASH. (INT)
  56.    C64ADDR= ╙TARTING ADDRESS IN ├-64
  57.             MEMORY WHERE STASHED DATA
  58.             WILL BE TAKEN. (CHAR*)
  59.    ╥┼╒ADDR= ╙TARTING ADDRESS IN ╥┼╒
  60.             MEMORY WHERE STASHED DATA
  61.             IS STORED. (LONG)
  62. 
  63. ü  SWAP
  64.    CALLING SEQUENCE:
  65.    STATUS=SWAP(SIZE,C64ADDR,╥┼╒ADDR);
  66.     STATUS= THE CONTENTS OF THE
  67.             ╥┼╒ STATUS REGISTER
  68.             AFTER THE SWAP. (INT)
  69.       SIZE= ╬UMBER OF BYTES TO SWAP. (INT)
  70.    C64ADDR= ╙TARTING ADDRESS IN ├-64
  71.             MEMORY WHERE SWAPPED DATA
  72.             WILL BE EXCHANGED. (CHAR*)
  73.    ╥┼╒ADDR= ╙TARTING ADDRESS IN ╥┼╒
  74.             MEMORY WHERE SWAPPED DATA
  75.             IS EXCHANGED. (LONG)
  76. 
  77. ü  RALLOC
  78.    CALLING SEQUENCE:
  79.    ╥┼╒ADDR=RALLOC(SIZE)
  80.    ╥┼╒ADDR= ┴DDRESS IN ╥┼╒ MEMORY WHERE
  81.             ALLOCATED BLOCK BEGINS.  ╔F
  82.             INSUFFICIENT MEMORY IS AVAIL-
  83.             ABLE, THE RESULT WILL BE SET
  84.             TO 0╠. (LONG)
  85.       SIZE= ╙IZE OF THE ALLOCATED
  86.             BLOCK IN BYTES.  (INT)
  87. 
  88. ü  RFREE
  89.    CALLING SEQUENCE:
  90.    ╥┼╒ADDR=RFREE(SIZE)
  91.    ╥┼╒ADDR= ┴DDRESS IN ╥┼╒ MEMORY WHERE
  92.             FREED BLOCK ENDS.  ╔F ALL
  93.             MEMORY HAS BEEN FREED, THE
  94.             RESULT WILL BE SET TO THE
  95.             SIZE OF ╥┼╒ MEMORY. (LONG)
  96.       SIZE= ╙IZE OF THE ALLOCATED
  97.             BLOCK IN BYTES.  (INT)
  98. 
  99.   ┘OU CAN MAKE USE OF THESE FUNCTIONS
  100.   IN YOUR PROGRAM IN EITHER OF TWO
  101.   WAYS.  ┘OU CAN #INCLUDE THE SOURCE
  102.   FILE IN YOUR APPLICATION; OR YOU
  103.   CAN COMPILE REU.C SEPARATELY,
  104.   #INCLUDE THE HEADER FILE REU.H
  105.   IN YOUR APPLICATION, AND ENTER THE
  106.   NAME OF THE COMPILED REU.C IN
  107.   THE LINKER.
  108. 
  109. ₧╒SING REU.H
  110. 
  111.   ╘O USE THIS FILE, COMPILE REU.C
  112.   BY ITSELF.  ╔N YOUR APPLICATION,
  113.   START WITH '#INCLUDE "REU.H".'
  114.   ╘HIS WILL DEFINE THE FIVE FUNCTIONS.
  115.   ╫HEN YOU LINK YOUR PROGRAM, INCLUDE
  116.   THE NAME OF THE COMPILED REU.C
  117.   IN YOUR LIST OF LINK MODULES.
  118. 
  119. ₧╒SING INSTALL.STUB
  120. 
  121.   ╘HIS FILE IS THE STUB OF THE NEW
  122.   ╥┴═─╧╙ LOADER.  ╔T WILL NOT WORK
  123.   AS IS.  ╘O PREPARE IT FOR USE,
  124.   YOU MUST FIRST:
  125.   1) ╨LACE BOTH INSTALL.STUB AND
  126.      THE ╥┴═─╧╙ PROGRAM (YOU SHOULD
  127.      USE ╥┴═─╧╙64.┬╔╬4.2) ON THE
  128.      SAME FLOPPY DISK (DO NOT USE
  129.      THE ╥┴═DISK).
  130.   2) ╞ROM ╙UPER-├ ENTER THE COMMAND:
  131.      COM C0:INSTALL=INSTALL.STUB,RAMDOS64.BIN4.2
  132.      ╧R, FROM ┬┴╙╔├, ENTER THE COMMAND:
  133.      ╧╨┼╬ 1,8,15,"├0:╔╬╙╘┴╠╠=╔╬╙╘┴╠╠.╙╘╒┬,╥┴═─╧╙64.┬╔╬4.2":├╠╧╙┼ 1
  134.      ╘HIS WILL COMBINE THE STUB AND
  135.      THE ╥┴═─╧╙ CODE INTO A SINGLE
  136.      FILE THAT WILL BE MUCH SIMPLER
  137.      TO USE.
  138.   ╧NCE YOU HAVE THUS PREPARED THE NEW
  139.   INSTALL PROGRAM, IT IS READY TO USE.
  140.   ╘HE CALLING SYNTAX FROM ╙UPER-├ IS:
  141. 
  142.   INSTALL
  143.   OR
  144.   INSTALL I
  145. 
  146.   ┼NTERING JUST "INSTALL" WILL INSTALL
  147.   ╥┴═─╧╙ WITHOUT INITIALIZING IT.  ─O
  148.   THIS WHEN ╥┴═─╧╙ HAS BEEN DISABLED
  149.   BY A HARWARE RESET OR ALTERATION OF
  150.   THE SYSTEM VECTORS.  ╬EVER USE IT
  151.   AFTER YOU HAVE TURNED THE COMPUTER
  152.   OFF.
  153.   ┼NTERING "INSTALL I" WILL RUN THE
  154.   USUAL STARTUP CALL TO GET ╥┴═─╧╙
  155.   RUNNING ON A COLD MACHINE.  ╘HE
  156.   ╥┴═─╧╙ WILL BE INSTALLED AND
  157.   INITIALIZED AS AN EMPTY ╥┴═DISK.
  158. 
  159.   ╘HE NEW INSTALL CARRIES A COPY OF
  160.   ╥┴═─╧╙ WITH IT ALWAYS, AND CAN BE
  161.   RUN OFF ANY DISK WITHOUT THE NEED
  162.   TO KEEP A SEPARATE COPY OF THE
  163.   ╥┴═─╧╙ PROGRAM.
  164. 
  165. ₧╒SING RVIEW.C
  166. 
  167.   ╘HIS IS NOT A TERRIBLY USEFUL
  168.   PROGRAM, BUT IT DEMONSTRATES HOW
  169.   THE ╥┼╒ FUNCTIONS CAN BE USED.
  170.   ╔T IS A NON-DESTRUCTIVE ╥┼╒
  171.   MEMORY VIEWER.  ╙IMPLY ENTER AN
  172.   ╥┼╒ ADDRESS AND THE PROGRAM WILL
  173.   DISPLAY THE CONTENTS OF ╥┼╒
  174.   MEMORY AT THAT POINT.  ┴MBITIOUS
  175.   PROGRAMMERS COULD EXPAND THIS
  176.   INTO A FULL-FLEDGED ╥┼╒ MEMORY
  177.   EDITOR.
  178. 
  179. ₧─EVELOPING PROGRAMS WITH ╥┴═─╧╙
  180. 
  181.   ╘O USE THE DEVICE CONFIGURATION
  182.   PROGRAM "DEVICE" (INCLUDED ON YOUR
  183.   ORIGINAL ╙UPER-├ DISK) YOU MUST
  184.   MAKE THESE CHANGES TO THE ├ SOURCE
  185.   CODE AND RECOMPILE "DEVICE.C"
  186. 
  187.    ╠INE 76 (IN FUNCTION "SETDEV")
  188.    READS NOW:
  189.    STATIC CHAR STRING2[]="UIH";
  190.    SHOULD READ:
  191.    STATIC CHAR STRING2[]="U0>.";
  192.    ╠INE 97 (IN FUNCTION "SETDEV")
  193.    READS NOW:
  194.    █ STRING2[2]=NEW+'A'-8;
  195.    SHOULD READ:
  196.    █ STRING2[3]=NEW;
  197.    ╠INE 98 (IN FUNCTION "SETDEV")
  198.    READS NOW:
  199.    FPUTF(STRING2,3,COMCH);
  200.    SHOULD READ:
  201.    FPUTF(STRING2,4,COMCH);
  202. 
  203.   ╘HE EDITOR CE REQUIRES THAT THE
  204.   FILE NAME BE APPENDED WITH ",W"
  205.   WHEN SAVING A FILE TO ╥┴═DISK.
  206.   ╒SE THE EDITOR "F" COMMAND TO
  207.   ADD THE ",W" TO THE NAME OF THE
  208.   FILE WHEN YOU WANT TO SAVE IT.
  209. 
  210.   ╘HE LINKER CL REQUIRES THE FILE
  211.   NAME OF THE OBJECT FILE TO BE
  212.   APPENDED WITH ",P,W" WHEN LINKING
  213.   A PROGRAM ONTO THE ╥┴═DISK.