home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / c128 / util / kdsutils.sfx / compiler.doc next >
Encoding:
Text File  |  1990-12-02  |  7.8 KB  |  185 lines
  1. ╦EY─╧╙ ├OMPILER
  2. ├OPYRIGHT 1990 BY ╥ANDY ╫INCHESTER
  3.  
  4. ╔F YOU USE ╦EY─╧╙ OR UTILITIES, PLEASE AGREE TO THE FOLLOWING:
  5.  
  6. ╦EY─╧╙ ISN'T ╙HAREWARE, ╞REEWARE, ─EMOWARE, ├RIPPLEWARE, ╓APORWARE OR
  7. ANY OTHER KIND OF WARE.  ╔'M NOT LOOKING FOR DONATIONS, CONTRIBUTIONS,
  8. OR HANDOUTS.  ╨LEASE DON'T SEND MONEY.  ╨LEASE MAKE COPIES OF ╦EY─╧╙
  9. FOR YOUR FRIENDS AND USER GROUPS, AND UPLOAD TO BULLETIN BOARDS.  ═AKE
  10. SURE ALL DOCUMENTATION FILES ARE INCLUDED.
  11.  
  12. ─O NOT SELL ╦EY─╧╙ OR UTILITES.  ╨ERMISSION IS NOT GRANTED TO OFFER
  13. THEM FOR SALE ON "PUBLIC DOMAIN" DISKS.  ╒SER GROUPS MAY CHARGE A FEE
  14. FOR DISK DUPLICATION, BUT THAT FEE SHOULD NOT EXCEED $5.  ─ISTRIBUTION
  15. FOR PROFIT IS STRICTLY PROHIBITED.
  16.  
  17. ┴LL ╔ ASK IN RETURN IS IF YOU USE ╦EY─╧╙, LET ME KNOW.  ╫RITE ME A
  18. SHORT LETTER OR DROP A POSTCARD IN THE MAIL TO ME.  ╙END ME
  19. SUGGESTIONS, CRITICISMS, OR BUG REPORTS.  ┬ETTER YET, SEND ME A DISK
  20. WITH YOUR FAVORITE ├128 (NON-COMMERCIAL) PROGRAMS.  ╔F YOU'VE WRITTEN
  21. SOMETHING YOU CONSIDER USEFUL, PLEASE SEND ME A COPY.
  22.  
  23. ********** ╙PECIAL ╧FFER! ********** ╦EY─╧╙ ╞UNCTION ╥╧═ **********
  24.  
  25. ╘HE ╦EY─╧╙ ╞UNCTION ╥╧═ PLUGS INTO THAT EMPTY ╥╧═ SOCKET INSIDE YOUR
  26. 128 AND PUTS ALL THE ╦EY─╧╙ UTILITIES AND FUNCTION KEYS JUST A KEY
  27. PRESS AWAY.  ╦EY─╧╙ KEYS AND UTILITIES ARE AVAILABLE AS SOON AS YOU
  28. SWITCH ON YOUR ├128 AND LOAD ALMOST INSTANTLY.  ╧NCE YOU'VE TRIED
  29. ╦EY─╧╙, CONSIDER HAVING IT AS A PERMANANT PART OF YOUR COMPUTER.
  30. ╫RITE FOR MORE DETAILS.
  31.  
  32. ╥ANDY ╫INCHESTER
  33. ╨.╧. ┬OX 1074
  34. ├AMBRIDGE, ═┴  02142
  35.  
  36.  
  37. ╘HE ╦EY─╧╙ ├OMPILER IS USED TO DEFINE ├128 FUNCTION KEYS, AND SAVE THE
  38. DEFINITIONS TO A SHORT TWO BLOCK FILE THAT CAN BE ┬╠╧┴─ED BACK AT ANY
  39. TIME.  ─IFFERENT SETS OF FUNCTION KEYS FOR SPECIFIC PURPOSES CAN BE
  40. PREDEFINED AND RELOADED WHENEVER NEEDED.
  41.  
  42. ╘WENTY ╦EY─╧╙ KEY DEFINITIONS ARE PROVIDED WITH THE ╦EY─╧╙ ├OMPILER. 
  43. ╘HE FIRST TWELVE OF THESE DEFINITIONS HAVE BEEN RELEASED PRIOR TO THIS
  44. PROGRAM AND INCLUDE THEIR OWN DOCUMENTATION.  ─EFINITIONS 13 - 20 ARE
  45. NEW WITH THE ╦EY─╧╙ ├OMPILER, AND ARE SIMILAR IN OPERATION TO PREVIOUS
  46. DEFINITIONS.  ╔T IS RECOMMENDED THAT USERS OF THIS PROGRAM ALSO OBTAIN
  47. THE ORIGINAL ╦EY─╧╙ PROGRAM AND READ THE DOCUMENTATION.
  48.  
  49. ┴DDITIONALLY, KEYS THAT ARE DEFINED BEFORE RUNNING THE ╦EY─╧╙ ├OMPILER
  50. AND ARE NOT REDEFINED CAN BE SAVED ALONG WITH REDEFINED FUNCTION KEYS.
  51. ╘HIS ENABLES THE USER TO INCLUDE CUSTOM KEY DEFINITIONS ALONG WITH
  52. ╦EY─╧╙ KEYS.
  53.  
  54. ╥UNNING ╦EY─╧╙ ├OMPILER
  55.  
  56. ╦EY─╧╙ ├OMPILER IS STARTED BY THE ╥╒╬ COMMAND.  ┼XAMPLE:
  57.  
  58. ╥╒╬ "╦┼┘─╧╙ ├╧═╨╔╠┼╥"   (RUNS ╦EY─╧╙ ├OMPILER FROM DRIVE 8)
  59.  
  60. ╔F YOU ARE USING ╦EY─╧╙, PLACE THE CURSOR AT THE BEGINNING OF THE LINE
  61. FOR THE ╦┼┘─╧╙ ├╧═╨╔╠┼╥ ENTRY IN A ├┴╘┴╠╧╟ LISTING AND PRESS ╞2.
  62.  
  63. ╒SING ╦EY─╧╙ ├OMPILER
  64.  
  65. ╘HE ╦EY─╧╙ COMPILER INCLUDES THE FOLLOWING ╦EY─╧╙ KEY DEFINITIONS:
  66.  
  67. ----  --------------------------------------------------------------
  68.  1    ─╠╧┴─ A ┬ASIC PROGRAM FROM A DIRECTORY LISTING
  69.  2    ╥╒╬ A ┬ASIC PROGRAM FROM A DIRECTORY LISTING
  70.  3    ├┴╘┴╠╧╟ LISTING FROM THE ACTIVE DRIVE
  71.  4    ╥╒╬ A ├64 ┬ASIC PROGRAM FROM A DIRECTORY LISTING
  72.  5    ╘YPE A SEQUENTIAL TEXT FILE FROM A DIRECTORY LISTING
  73.  6    ╙├╥┴╘├╚ A FILE FROM A DIRECTORY LISTING
  74.  7    ╙ELECT A NEW DISK DRIVE
  75.  8    ╙├╥┴╘├╚ THEN ─╙┴╓┼ A PROGRAM FROM A DIRECTORY LISTING
  76.  9    ┬╧╧╘ DISK IN THE ACTIVE DRIVE OR FILE FROM A DIRECTORY LISTING
  77. 10    ╨╥╔╬╘ THE STRING "╧╬ ╒ (ACTIVE DRIVE) <╥┼╘╒╥╬>"
  78. 11    ╧╨┼╬ / ├╠╧╙┼ 1581 ╙UBDIRECTORY FROM DIRECTORY LISTING
  79. 12    ┼XECUTE BATCH (╙┼╤) FILE FROM DIRECTORY LISTING
  80. 13    ┬╠╧┴─ FILE FROM DIRECTORY LISTING
  81. 14    ├╧╠╠┼├╘ ON ACTIVE DRIVE
  82. 15    ─├╠┼┴╥ ON ACTIVE DRIVE
  83. 16    ─├╠╧╙┼ ON ACTIVE DRIVE
  84. 17    ─╙┴╓┼ WITH REPLACE FROM DIRECTORY LISTING
  85. 18    ─╓┼╥╔╞┘ ┬┴╙╔├ ╨╥O╟RAM FROM DIRECTORY LISTING
  86. 19    ╓┼╥╔╞┘ BINARY FILE FROM DIRECTORY LISTING
  87. 20    ─╙┴╓┼ WITH REPLACE AND ─╓┼╥╔╞┘ FROM DIRECTORY LISTING
  88.  
  89. ╘HE MENU PRESENTED OFFERS THREE CHOICES:  ─EFINE, ╙AVE, OR ╤UIT. 
  90. ╨RESSING '─' FOR DEFINE WILL PROMPT YOU TO ENTER A NUMBER FROM 1 TO 10
  91. FOR THE KEY TO DEFINE.  ╦EYS 1 THROUGH 8 ARE THE ╞1 THROUGH ╞8
  92. FUNCTION KEYS.  ╦EY 9 IS THE SHIFTED ╥╒╬/╙╘╧╨ KEY, AND ╦EY 10 IS THE
  93. ╚┼╠╨ KEY.
  94.  
  95. ┴FTER SELECTING A KEY, YOU WILL BE PROMPTED TO ENTER A DEFINITION. 
  96. ╙ELECT A DEFINITION FROM 1 TO 20 FROM THE LIST.  ╦EYS THAT ARE
  97. REDEFINED ARE DISPLAYED ALONG WITH THEIR NEW DEFINITIONS ON THE BOTTOM
  98. HALF OF THE SCREEN.
  99.  
  100. ╘HERE IS NO NEED TO DEFINE ALL TEN KEYS.  ╦EYS THAT ARE NOT DEFINED BY
  101. ╦EY─╧╙ ├OMPILER WILL RETAIN THE DEFINITIONS THEY HAD BEFORE RUNNING
  102. THE PROGRAM.  ╘HIS ALLOWS YOU TO INCLUDE YOUR OWN KEY DEFINITIONS
  103. ALONG WITH ╦EY─╧╙ KEYS.  ╞OR EXAMPLE, TO RETAIN THE DEFAULT ╞8 KEY
  104. DEFINITION, WHICH IS "═╧╬╔╘╧╥"+├╚╥$(13), SIMPLY DO NOT REDEFINE ╦EY 8
  105. WITH THE ╦EY─╧╙ ├OMPILER.
  106.  
  107. ┴FTER REDEFINING THE KEYS AS DESIRED, YOU CAN EITHER SAVE THE
  108. DEFINITIONS AS A BINARY FILE, OR QUIT TO ┬┴╙╔├.  ╨RESSING '╙' WILL ASK
  109. YOU TO ENTER THE NUMBER OF THE DRIVE ON WHICH TO SAVE YOUR KEY
  110. DEFINITIONS.  ╘HE NEXT PROMPT ASKS FOR A FILE NAME.  ╘HE DEFAULT
  111. FILENAME IS ╦┼┘─╧╙.╦┼┘.  ┘OU CAN PRESS ╥┼╘╒╥╬ TO SAVE THE FILE WITH
  112. THIS NAME, OR EDIT THE NAME TO SOMETHING ELSE.  ╔NSERT A '@' BEFORE
  113. THE NAME IN ORDER TO SAVE THE KEYS TO A FILE WITH THE SAME NAME.
  114.  
  115. ╒SING ╦┼┘─╧╙.╦┼┘ ─EFINITION ╞ILES
  116.  
  117. ╘O RELOAD A ╦┼┘─╧╙.╦┼┘ FILE, ENTER:
  118.  
  119. ┬╠╧┴─ "╦┼┘─╧╙.╦┼┘",╒(DRIVE NUMBER)
  120.  
  121. ╘HE FILE CAN ALSO BE LOADED FROM A CATALOG LISTING USING THE ╦EY─╧╙
  122. ┬╠╧┴─ DEFINITION (DEFINITION 13).  ╘HIS OPENS UP THE POSSIBILITY OF
  123. CHANGING FUNCTION KEY DEFINITIONS "ON THE FLY" BY USING THE SAME KEY
  124. FOR DEFINITION 13 IN SEVERAL DIFFERENT ╦┼┘ FILES.  ├HANGING KEY
  125. DEFINITIONS IS AS SIMPLE AS LISTING A DIRECTORY, MOVING THE CURSOR TO
  126. THE LINE WITH THE NAME OF THE ╦┼┘ FILE TO LOAD, AND PRESSING THE ┬╠╧┴─
  127. ╞ KEY.  ┬╠╧┴─╔╬╟ ╦┼┘ FILES DOES NOT ALTER ┬┴╙╔├ OR ML PROGRAMS IN MEMORY.
  128.  
  129. ╙TORING ╦┼┘─╧╙.╦┼┘ ╞ILES IN THE ╤UICK ┬ROWN ┬OX
  130.  
  131. ╦┼┘ FILES CAN ALSO BE STORED IN THE ╤UICK ┬ROWN ┬OX BATTERY BACKED ╥┴═
  132. CARTRIDGE.  ┬E SURE TO STORE THEM WITH A '+' AS THE FIRST CHARACTER
  133. FOR THE SIX CHARACTER ╤┬┬ FILE NAME.  ╘HIS PREVENTS THE ╤┬┬ OPERATING
  134. SYSTEM FROM ATTEMPTING TO EXECUTE THE ╦┼┘ FILE WHEN IT IS LOADED.  ╦┼┘
  135. FILES CONTAIN ONLY KEY DATA.  ╘HEY ARE NOT EXECUTABLE.
  136.  
  137. ╘HE MAIN ADVANTAGE TO STORING ╦┼┘ FILES IN THE ╤UICK ┬ROWN ┬OX IS THAT
  138. THEY CAN BE LOADED WITHOUT DISK ACCESS.  ╦┼┘ FILES STORED IN THE ╤┬┬
  139. ARE ALWAYS AVAILABLE AT ANY TIME AND WILL NOT ALTER PROGRAMS IN
  140. MEMORY.
  141.  
  142. ╒PDATE ╔NFORMATION, ╓900217
  143.  
  144. ┬UG FIX:
  145.  
  146. ╘HE ─RIVE SELECTION FUNCTION DID NOT WORK.  ┴FTER SELECTING A DRIVE
  147. NUMBER ON WHICH TO WRITE THE ╦EY─╧╙ FILE, THE FILE WOULD ALWAYS BE
  148. WRITTEN TO DRIVE 8.  ╘HIS FUNCTION NOW WORKS PROPERLY.
  149.  
  150. ╬EW ╞EATURE:
  151.  
  152. ╞UNCTION #10, "PRINT ╧╬ ╒ <ACTIVE DRIVE> + <╥┼╘╒╥╬>" HAS BEEN ENHANCED
  153. SO THAT IT NOW OPERATES ON A FILENAME IN A DIRECTORY LISTING.  ╔T
  154. STILL FUNCTIONS MUCH THE SAME WAY AS THE ORIGINAL DEFINITION, EXCEPT
  155. NOW IT TABS THREE TAB STOPS BEFORE PRINTING.
  156.  
  157. ╒PDATE ╓901112
  158.  
  159. ╘HE ├128'S SCREEN EDITOR'S DEFAULT TAB SETTINGS ARE RESTORED EACH TIME THE
  160. CATALOG IS LISTED WITH ╞3 (DEFINITION 3).  ╘HIS PREVENTS OTHER ╦EY─╧╙ KEYS
  161. FROM MALFUNCTIONING IF THE TAB SETTINGS HAVE SOMEHOW BEEN ALTERED.  ╘HANKS TO
  162. ╩OE ┬UCKELY FOR POINTING THIS OUT TO ME.
  163.  
  164. ╘HE OPEN/CLOSE 1581 SUBDIRECTORY KEY (DEFINITION 11) NOW DISPLAYS THE DISK STATUS MESSAGE FOR THE OPEN SUBDIRECTORY.  ╘HIS INFORMATION SHOWS THE
  165. STARTING AND ENDING TRACKS OF THE OPENED PARTITION.
  166.  
  167. ╒PDATE ╓901201 (VERSION 2)
  168.  
  169. ╘HE COMPILER NOW DISPLAYS THE NUMBER OF BYTES USED IN THE FUNCTION KEY
  170. BUFFER.  ╘HE SUM OF ALL TEN FUNCTION KEY DEFINITION CAN NOT EXCEED 246
  171. BYTES.  ╔F THE LENGTH OF THE SELECTED FUNCTION KEY DEFINITION PUTS THE
  172. TOTAL LENGTH OVER 246 BYTES, THE COMPILER WILL REFUSE TO ADD IT TO THE
  173. BUFFER AND DISPLAY A "┬UFFER OVERFLOW" ERROR MESSAGE.  ╘HANKS TO ┼RIC
  174. ╘REPANIER FOR SPOTTING THIS BUG AND SUGGESTING THE CORRECTION.
  175.  
  176. ╧THER MAJOR AND MINOR CHANGES WERE MADE.  ─EFINITION 5, FOR TYPING ╙┼╤
  177. FILES, HAS BEEN SIMPLIFIED.  ┴ REDUNDANT ESCAPE CODE SEQUENCE WAS REMOVED
  178. FROM DEFINITION 12.  ╘HE COMPILER HAS BEEN STREAMLINED AND COMPACTED TO
  179. REDUCE ITS SIZE.
  180.  
  181. ╥ANDY ╫INCHESTER
  182. ╨.╧. ┬OX 1074
  183. ├AMBRIDGE, ═┴  02142
  184.  
  185.