Brotikasten/BROTCD01.iso/c128/c142.d64/compiler.doc

Text File | 1995-08-09 | 8KB | 185 lines

╦EY─╧╙ ├OMPILER
├OPYRIGHT 1990 BY ╥ANDY ╫INCHESTER

╔F YOU USE ╦EY─╧╙ OR UTILITIES, PLEASE AGREE TO THE FOLLOWING:

╦EY─╧╙ ISN'T ╙HAREWARE, ╞REEWARE, ─EMOWARE, ├RIPPLEWARE, ╓APORWARE OR
ANY OTHER KIND OF WARE.  ╔'M NOT LOOKING FOR DONATIONS, CONTRIBUTIONS,
OR HANDOUTS.  ╨LEASE DON'T SEND MONEY.  ╨LEASE MAKE COPIES OF ╦EY─╧╙
FOR YOUR FRIENDS AND USER GROUPS, AND UPLOAD TO BULLETIN BOARDS.  ═AKE
SURE ALL DOCUMENTATION FILES ARE INCLUDED.

─O NOT SELL ╦EY─╧╙ OR UTILITES.  ╨ERMISSION IS NOT GRANTED TO OFFER
THEM FOR SALE ON "PUBLIC DOMAIN" DISKS.  ╒SER GROUPS MAY CHARGE A FEE
FOR DISK DUPLICATION, BUT THAT FEE SHOULD NOT EXCEED $5.  ─ISTRIBUTION
FOR PROFIT IS STRICTLY PROHIBITED.

┴LL ╔ ASK IN RETURN IS IF YOU USE ╦EY─╧╙, LET ME KNOW.  ╫RITE ME A
SHORT LETTER OR DROP A POSTCARD IN THE MAIL TO ME.  ╙END ME
SUGGESTIONS, CRITICISMS, OR BUG REPORTS.  ┬ETTER YET, SEND ME A DISK
WITH YOUR FAVORITE ├128 (NON-COMMERCIAL) PROGRAMS.  ╔F YOU'VE WRITTEN
SOMETHING YOU CONSIDER USEFUL, PLEASE SEND ME A COPY.

********** ╙PECIAL ╧FFER! ********** ╦EY─╧╙ ╞UNCTION ╥╧═ **********

╘HE ╦EY─╧╙ ╞UNCTION ╥╧═ PLUGS INTO THAT EMPTY ╥╧═ SOCKET INSIDE YOUR
128 AND PUTS ALL THE ╦EY─╧╙ UTILITIES AND FUNCTION KEYS JUST A KEY
PRESS AWAY.  ╦EY─╧╙ KEYS AND UTILITIES ARE AVAILABLE AS SOON AS YOU
SWITCH ON YOUR ├128 AND LOAD ALMOST INSTANTLY.  ╧NCE YOU'VE TRIED
╦EY─╧╙, CONSIDER HAVING IT AS A PERMANANT PART OF YOUR COMPUTER.
╫RITE FOR MORE DETAILS.

╥ANDY ╫INCHESTER
╨.╧. ┬OX 1074
├AMBRIDGE, ═┴  02142


╘HE ╦EY─╧╙ ├OMPILER IS USED TO DEFINE ├128 FUNCTION KEYS, AND SAVE THE
DEFINITIONS TO A SHORT TWO BLOCK FILE THAT CAN BE ┬╠╧┴─ED BACK AT ANY
TIME.  ─IFFERENT SETS OF FUNCTION KEYS FOR SPECIFIC PURPOSES CAN BE
PREDEFINED AND RELOADED WHENEVER NEEDED.

╘WENTY ╦EY─╧╙ KEY DEFINITIONS ARE PROVIDED WITH THE ╦EY─╧╙ ├OMPILER.
╘HE FIRST TWELVE OF THESE DEFINITIONS HAVE BEEN RELEASED PRIOR TO THIS
PROGRAM AND INCLUDE THEIR OWN DOCUMENTATION.  ─EFINITIONS 13 - 20 ARE
NEW WITH THE ╦EY─╧╙ ├OMPILER, AND ARE SIMILAR IN OPERATION TO PREVIOUS
DEFINITIONS.  ╔T IS RECOMMENDED THAT USERS OF THIS PROGRAM ALSO OBTAIN
THE ORIGINAL ╦EY─╧╙ PROGRAM AND READ THE DOCUMENTATION.

┴DDITIONALLY, KEYS THAT ARE DEFINED BEFORE RUNNING THE ╦EY─╧╙ ├OMPILER
AND ARE NOT REDEFINED CAN BE SAVED ALONG WITH REDEFINED FUNCTION KEYS.
╘HIS ENABLES THE USER TO INCLUDE CUSTOM KEY DEFINITIONS ALONG WITH
╦EY─╧╙ KEYS.

╥UNNING ╦EY─╧╙ ├OMPILER

╦EY─╧╙ ├OMPILER IS STARTED BY THE ╥╒╬ COMMAND.  ┼XAMPLE:

╥╒╬ "╦┼┘─╧╙ ├╧═╨╔╠┼╥"   (RUNS ╦EY─╧╙ ├OMPILER FROM DRIVE 8)

╔F YOU ARE USING ╦EY─╧╙, PLACE THE CURSOR AT THE BEGINNING OF THE LINE
FOR THE ╦┼┘─╧╙ ├╧═╨╔╠┼╥ ENTRY IN A ├┴╘┴╠╧╟ LISTING AND PRESS ╞2.

╒SING ╦EY─╧╙ ├OMPILER

╘HE ╦EY─╧╙ COMPILER INCLUDES THE FOLLOWING ╦EY─╧╙ KEY DEFINITIONS:

----  --------------------------------------------------------------
 1    ─╠╧┴─ A ┬ASIC PROGRAM FROM A DIRECTORY LISTING
 2    ╥╒╬ A ┬ASIC PROGRAM FROM A DIRECTORY LISTING
 3    ├┴╘┴╠╧╟ LISTING FROM THE ACTIVE DRIVE
 4    ╥╒╬ A ├64 ┬ASIC PROGRAM FROM A DIRECTORY LISTING
 5    ╘YPE A SEQUENTIAL TEXT FILE FROM A DIRECTORY LISTING
 6    ╙├╥┴╘├╚ A FILE FROM A DIRECTORY LISTING
 7    ╙ELECT A NEW DISK DRIVE
 8    ╙├╥┴╘├╚ THEN ─╙┴╓┼ A PROGRAM FROM A DIRECTORY LISTING
 9    ┬╧╧╘ DISK IN THE ACTIVE DRIVE OR FILE FROM A DIRECTORY LISTING
10    ╨╥╔╬╘ THE STRING "╧╬ ╒ (ACTIVE DRIVE) <╥┼╘╒╥╬>"
11    ╧╨┼╬ / ├╠╧╙┼ 1581 ╙UBDIRECTORY FROM DIRECTORY LISTING
12    ┼XECUTE BATCH (╙┼╤) FILE FROM DIRECTORY LISTING
13    ┬╠╧┴─ FILE FROM DIRECTORY LISTING
14    ├╧╠╠┼├╘ ON ACTIVE DRIVE
15    ─├╠┼┴╥ ON ACTIVE DRIVE
16    ─├╠╧╙┼ ON ACTIVE DRIVE
17    ─╙┴╓┼ WITH REPLACE FROM DIRECTORY LISTING
18    ─╓┼╥╔╞┘ ┬┴╙╔├ ╨╥O╟RAM FROM DIRECTORY LISTING
19    ╓┼╥╔╞┘ BINARY FILE FROM DIRECTORY LISTING
20    ─╙┴╓┼ WITH REPLACE AND ─╓┼╥╔╞┘ FROM DIRECTORY LISTING

╘HE MENU PRESENTED OFFERS THREE CHOICES:  ─EFINE, ╙AVE, OR ╤UIT.
╨RESSING '─' FOR DEFINE WILL PROMPT YOU TO ENTER A NUMBER FROM 1 TO 10
FOR THE KEY TO DEFINE.  ╦EYS 1 THROUGH 8 ARE THE ╞1 THROUGH ╞8
FUNCTION KEYS.  ╦EY 9 IS THE SHIFTED ╥╒╬/╙╘╧╨ KEY, AND ╦EY 10 IS THE
╚┼╠╨ KEY.

┴FTER SELECTING A KEY, YOU WILL BE PROMPTED TO ENTER A DEFINITION.
╙ELECT A DEFINITION FROM 1 TO 20 FROM THE LIST.  ╦EYS THAT ARE
REDEFINED ARE DISPLAYED ALONG WITH THEIR NEW DEFINITIONS ON THE BOTTOM
HALF OF THE SCREEN.

╘HERE IS NO NEED TO DEFINE ALL TEN KEYS.  ╦EYS THAT ARE NOT DEFINED BY
╦EY─╧╙ ├OMPILER WILL RETAIN THE DEFINITIONS THEY HAD BEFORE RUNNING
THE PROGRAM.  ╘HIS ALLOWS YOU TO INCLUDE YOUR OWN KEY DEFINITIONS
ALONG WITH ╦EY─╧╙ KEYS.  ╞OR EXAMPLE, TO RETAIN THE DEFAULT ╞8 KEY
DEFINITION, WHICH IS "═╧╬╔╘╧╥"+├╚╥$(13), SIMPLY DO NOT REDEFINE ╦EY 8
WITH THE ╦EY─╧╙ ├OMPILER.

┴FTER REDEFINING THE KEYS AS DESIRED, YOU CAN EITHER SAVE THE
DEFINITIONS AS A BINARY FILE, OR QUIT TO ┬┴╙╔├.  ╨RESSING '╙' WILL ASK
YOU TO ENTER THE NUMBER OF THE DRIVE ON WHICH TO SAVE YOUR KEY
DEFINITIONS.  ╘HE NEXT PROMPT ASKS FOR A FILE NAME.  ╘HE DEFAULT
FILENAME IS ╦┼┘─╧╙.╦┼┘.  ┘OU CAN PRESS ╥┼╘╒╥╬ TO SAVE THE FILE WITH
THIS NAME, OR EDIT THE NAME TO SOMETHING ELSE.  ╔NSERT A '@' BEFORE
THE NAME IN ORDER TO SAVE THE KEYS TO A FILE WITH THE SAME NAME.

╒SING ╦┼┘─╧╙.╦┼┘ ─EFINITION ╞ILES

╘O RELOAD A ╦┼┘─╧╙.╦┼┘ FILE, ENTER:

┬╠╧┴─ "╦┼┘─╧╙.╦┼┘",╒(DRIVE NUMBER)

╘HE FILE CAN ALSO BE LOADED FROM A CATALOG LISTING USING THE ╦EY─╧╙
┬╠╧┴─ DEFINITION (DEFINITION 13).  ╘HIS OPENS UP THE POSSIBILITY OF
CHANGING FUNCTION KEY DEFINITIONS "ON THE FLY" BY USING THE SAME KEY
FOR DEFINITION 13 IN SEVERAL DIFFERENT ╦┼┘ FILES.  ├HANGING KEY
DEFINITIONS IS AS SIMPLE AS LISTING A DIRECTORY, MOVING THE CURSOR TO
THE LINE WITH THE NAME OF THE ╦┼┘ FILE TO LOAD, AND PRESSING THE ┬╠╧┴─
╞ KEY.  ┬╠╧┴─╔╬╟ ╦┼┘ FILES DOES NOT ALTER ┬┴╙╔├ OR ML PROGRAMS IN MEMORY.

╙TORING ╦┼┘─╧╙.╦┼┘ ╞ILES IN THE ╤UICK ┬ROWN ┬OX

╦┼┘ FILES CAN ALSO BE STORED IN THE ╤UICK ┬ROWN ┬OX BATTERY BACKED ╥┴═
CARTRIDGE.  ┬E SURE TO STORE THEM WITH A '+' AS THE FIRST CHARACTER
FOR THE SIX CHARACTER ╤┬┬ FILE NAME.  ╘HIS PREVENTS THE ╤┬┬ OPERATING
SYSTEM FROM ATTEMPTING TO EXECUTE THE ╦┼┘ FILE WHEN IT IS LOADED.  ╦┼┘
FILES CONTAIN ONLY KEY DATA.  ╘HEY ARE NOT EXECUTABLE.

╘HE MAIN ADVANTAGE TO STORING ╦┼┘ FILES IN THE ╤UICK ┬ROWN ┬OX IS THAT
THEY CAN BE LOADED WITHOUT DISK ACCESS.  ╦┼┘ FILES STORED IN THE ╤┬┬
ARE ALWAYS AVAILABLE AT ANY TIME AND WILL NOT ALTER PROGRAMS IN
MEMORY.

╒PDATE ╔NFORMATION, ╓900217

┬UG FIX:

╘HE ─RIVE SELECTION FUNCTION DID NOT WORK.  ┴FTER SELECTING A DRIVE
NUMBER ON WHICH TO WRITE THE ╦EY─╧╙ FILE, THE FILE WOULD ALWAYS BE
WRITTEN TO DRIVE 8.  ╘HIS FUNCTION NOW WORKS PROPERLY.

╬EW ╞EATURE:

╞UNCTION #10, "PRINT ╧╬ ╒ <ACTIVE DRIVE> + <╥┼╘╒╥╬>" HAS BEEN ENHANCED
SO THAT IT NOW OPERATES ON A FILENAME IN A DIRECTORY LISTING.  ╔T
STILL FUNCTIONS MUCH THE SAME WAY AS THE ORIGINAL DEFINITION, EXCEPT
NOW IT TABS THREE TAB STOPS BEFORE PRINTING.

╒PDATE ╓901112

╘HE ├128'S SCREEN EDITOR'S DEFAULT TAB SETTINGS ARE RESTORED EACH TIME THE
CATALOG IS LISTED WITH ╞3 (DEFINITION 3).  ╘HIS PREVENTS OTHER ╦EY─╧╙ KEYS
FROM MALFUNCTIONING IF THE TAB SETTINGS HAVE SOMEHOW BEEN ALTERED.  ╘HANKS TO
╩OE ┬UCKELY FOR POINTING THIS OUT TO ME.

╘HE OPEN/CLOSE 1581 SUBDIRECTORY KEY (DEFINITION 11) NOW DISPLAYS THE DISK STATUS MESSAGE FOR THE OPEN SUBDIRECTORY.  ╘HIS INFORMATION SHOWS THE
STARTING AND ENDING TRACKS OF THE OPENED PARTITION.

╒PDATE ╓901201 (VERSION 2)

╘HE COMPILER NOW DISPLAYS THE NUMBER OF BYTES USED IN THE FUNCTION KEY
BUFFER.  ╘HE SUM OF ALL TEN FUNCTION KEY DEFINITION CAN NOT EXCEED 246
BYTES.  ╔F THE LENGTH OF THE SELECTED FUNCTION KEY DEFINITION PUTS THE
TOTAL LENGTH OVER 246 BYTES, THE COMPILER WILL REFUSE TO ADD IT TO THE
BUFFER AND DISPLAY A "┬UFFER OVERFLOW" ERROR MESSAGE.  ╘HANKS TO ┼RIC
╘REPANIER FOR SPOTTING THIS BUG AND SUGGESTING THE CORRECTION.

╧THER MAJOR AND MINOR CHANGES WERE MADE.  ─EFINITION 5, FOR TYPING ╙┼╤
FILES, HAS BEEN SIMPLIFIED.  ┴ REDUNDANT ESCAPE CODE SEQUENCE WAS REMOVED
FROM DEFINITION 12.  ╘HE COMPILER HAS BEEN STREAMLINED AND COMPACTED TO
REDUCE ITS SIZE.

╥ANDY ╫INCHESTER
╨.╧. ┬OX 1074
├AMBRIDGE, ═┴  02142