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

Text File | 1995-08-09 | 20KB | 446 lines

╦EY─╧╙ ─OCUMENTATION
├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

╦EY─╧╙ IS A NEW ─╧╙ INTERFACE FOR THE ├OMMODORE 128.  ╔T WAS DESIGNED
FOR EASE OF USE AND MAXIMUM COMPATIBILITY WITH ALL ├128 SOFTWARE.
╦EY─╧╙ REPROGRAMS THE FUNCTION KEYS TO PROVIDE A QUICK AND SIMPLE
METHOD TO ACCESS ALL DISK DRIVES ON A SYSTEM.

╘HE INSPIRATION FOR ╦EY─╧╙ CAME FROM USING THE ├128'S ├╨/═ MODE.  ╔
GOT USED TO LOGGING ONTO A DRIVE, THEN HAVE ALL FOLLOWING COMMANDS WORK
ON THAT DRIVE AS WELL.  ═OST ├╨/═ APPLICATIONS MAKE GOOD USE OF
MULTIPLE DISK DRIVES.

╘HAT'S NOT THE CASE WITH ├128 MODE.  ╘O GET A DIRECTORY LISTING OF A
DISK IN DRIVE 8, TYPE ├┴╘┴╠╧╟.  ╘O GET A DIRECTORY OF A DISK IN ANY
OTHER DRIVE, THE COMMAND IS DIFFERENT.  ╞OR DRIVE 9 IT IS ├┴╘┴╠╧╟ ╧╬
╒9.  ╘HIS SEEMS LIKE A LOT OF EXTRA TYPING.  ╫HAT ╔ FOUND EVEN LESS
APPEALING IS THAT THE POWER-UP FUNCTION KEY DEFINITIONS ARE ONLY
MINIMUMALLY USEFUL ON A MULTI-DRIVE SYSTEM.  ╘HE STRING '─╔╥┼├╘╧╥┘' IS
ASSIGNED TO THE ╞3 KEY.  ╘HE ONLY THING THAT KEY IS GOOD FOR IS
LISTING THE DIRECTORY ON DRIVE 8.

╧NE OF THE ├128'S NICEST FEATURES IS IT'S SCREEN EDITOR.  ╔T MAKES IT
POSSIBLE TO THE CURSOR OVER A COMMAND ON ANY LINE OF THE SCREEN, HIT
RETURN, AND SEND THE COMMAND TO ┬ASIC.  ╔T SEEMS LIKE A BIT OF POOR
PLANNING THAT ─╧╙ COMMANDS SUCH AS ─╠╧┴─, ╥╒╬, AND ╙├╥┴╘├╚ WON'T WORK
ON THE LISTING GENERATED BY THE ├┴╘┴╠╧╟ COMMAND.

╦EY─╧╙ PROVIDES A SIMPLE TO SOLUTION TO MANY OF THESE PROBLEMS.  ╬OW
YOU CAN EASILY LOG ONTO ANY DRIVE, SCRATCH FILES, LOAD AND SAVE
PROGRAMS, AND MORE, ALL WITH THE FUNCTION KEYS.  ╘HE SAME COMMANDS
WORK THE SAME WAY WITH ALL DRIVES IN A SYSTEM.  ┴DDITIONALLY, ╦EY─╧╙
COMMANDS WORK WITH THE STANDARD ├┴╘┴╠╧╟ COMMAND FOR FAST SELECTION OF
FILENAMES WITH A MINIMUM OF TYPING.

┴ SET OF ╦EY─╧╙ UTILITIES IS PROVIDED.  ╘HESE SHORT PROGRAMS ARE
EXTENSIONS OF THE ╦EY─╧╙ FUNCTION KEYS.  ╘HEY ALLOW MULTIPLE FILES
SELECTED FROM DIRECTORY LISTINGS TO BE COPIED FROM ANY DRIVE TO ANY
OTHER DRIVE, OR SELECT MULTIPLE FILES TO PRINT, RENAME, OR SCRATCH.

╦EY─╧╙ WAS DEVELOPED FOR SYSTEMS WITH MULTIPLE DRIVES, BUT WILL BE
USEFUL ON SYSTEMS WITH ONLY ONE DRIVE.  ╦EY─╧╙ IS FULLY ├OMMDORE
╥┴═─╧╙ AND 1581 COMPATIBLE.  ╦EY─╧╙ IS THE PERFECT ADDITION TO THE
╤UICK ┬ROWN ┬OX BATTERY BACKED ╥┴═ CARTRIDGE.  ╔NCLUDED IS A VERSION
OF ╦EY─╧╙ WITH SPECIAL ╤┬┬ FUNCTIONS.

╫ARNING:

╨RACTICE USING THIS PROGRAM WITH SOME DISKS YOU DON'T CARE ABOUT.  ╟ET
FAMILIAR WITH THIS PROGRAM BEFORE USING IT REGULARLY.  ╠IKE MANY
THINGS IN THE COMPUTER WORLD, YOU SHOULD READ THE DOCUMENTATION AND
PRACTICE.  ╔ WILL NOT BE HELD RESPONSIBLE FOR ANY DAMAGE THIS PROGRAM
MIGHT CAUSE.

╥UNNING ╦EY─╧╙

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

   ╥╒╬ "╦┼┘─╧╙"   (RUNS ╦EY─╧╙ FROM DRIVE 8)

╔T'S PROBABLY MORE CONVENIENT TO PUT ╦EY─╧╙ ON AN AUTOBOOT DISK.  ╔T
WILL THEN START UP AUTOMATICALLY IF THE DISK IS IN DRIVE 8 WHEN THE
COMPUTER'S POWER IS TURNED ON.

╦EY─╧╙ WILL ALSO AUTO-BOOT FROM THE ╤UICK ┬ROWN ┬OX DURING POWER-UP OR
FOLLOWING A RESET.

╦EY─╧╙ ├OMMANDS AT A ╟LANCE

╦EY   ╞UNCTION
----  --------
╞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
╥╒╬   ┬╧╧╘ DISK IN THE ACTIVE DRIVE / FILE FROM A DIRECTORY LISTING
╚┼╠╨  ╨╥╔╬╘ THE STRING "╧╬ ╒ (ACTIVE DRIVE) <╥┼╘╒╥╬>"

╒SING ╦EY─╧╙

┴FTER RUNNING ╦EY─╧╙, PRESS THE ╞3 FUNCTION KEY.  ╬ORMALLY, THIS KEY
PRINTS THE COMMAND "─╔╥┼├╘╧╥┘," AND GIVE A DIRECTORY LISTING OF THE
DISK IN DRIVE 8.  ┘OU'LL NOTICE THAT ╦EY─╧╙'S ╞3 KEY PRINTS
"C┴U(PE┼(186))" AND ALSO PRODUCES THE EXACT SAME DIRECTORY LISTING.
┬IG DEAL . . .

╚ERE'S WHERE THE FUN BEGINS.  ╔F YOU HAVE MORE THAN ONE DISK DRIVE,
MAKE SURE IT IS TURNED ON AND HAS A DISK IN IT.  ╬OW PRESS ╞7 AND
ENTER THE NUMBER OF THE DRIVE YOU WISH TO WORK FROM AND PRESS ╥┼╘╒╥╬.
╨RESS ╞3 AGAIN.  ╘HE DIRECTORY LISTING IS NOW FROM THE NEWLY SELECTED
DRIVE.  ╨RESS ╞3 AGAIN.  ┴LL ╦EY─╧╙ COMMANDS WILL CONTINUE TO USE THE
LAST DRIVE SELECTED OR USED.  ╧NCE YOU USE A DRIVE, ╦EY─╧╙ WILL USE
THAT DRIVE UNTIL YOU SELECT OR USE A NEW DRIVE.

╨LACE A DISK CONTAINING A ╙┼╤ TEXT FILE IN ONE OF YOUR DISK DRIVES.
╨RESS ╞3 TO GET A DIRECTORY LISTING OF THE DISK.  ╬OW USE THE ├╥╙╥ UP
KEY TO MOVE THE CURSOR TO THE SCREEN LINE LISTING THE TEXT FILE.
╨RESS THE ╞5 KEY, AND THE TEXT FILE WILL BE PRINTED TO THE SCREEN.
╒SE THE ├OMMODORE KEY TO SLOW THE LISTING OR THE ╬╧ ╙├╥╧╠╠ KEY TO PAUSE
THE LISTING.  ╔N THIS EXAMPLE, THE TEXT FILE COULD BE ON ANY DISK DRIVE
IN YOUR SYSTEM.  ╘HE ╞5 KEY PRINTS A TEXT FILE FROM A DIRECTORY LISTING
OF THE LAST USED OR THE SELECTED DRIVE.

╧THER ╦EY─╧╙ COMMANDS FUNCTION IN A SIMILAR WAY.  ═AKE SOME EXTRA
COPIES OF THIS DISK, AND PRACTICE USING THE OTHER ╦EY─╧╙ FUNCTION
KEYS.  ╒SE ╞1 TO ─╠╧┴─ A ┬ASIC PROGRAM.  ┴GAIN, MOVE THE CURSOR KEY TO
THE LINE IN A DIRECTORY LISTING (╞3) CONTAINING THE NAME OF THE FILE
TO LOAD AND PRESS ╞1.  ╒SE ╞2 TO ╥╒╬ A ┬ASIC PROGRAM.  ╒SE ╞6 TO
╙├╥┴╘├╚ FILES YOU NO LONGER WANT.  ╘HE COMPUTER WILL PRINT THE PROMPT
"┴RE YOU SURE?"  ╨RESS "Y" AND ╥┼╘╒╥╬ TO SCRATCH THE FILE.  ╘HE ╞8 KEY
SIMULATES THE ╙┴╓┼@ OR ╙┴╓┼ WITH ╥┼╨╠┴├┼ COMMAND.  ╘O TEST IT, FIRST
─╠╧┴─ A ┬ASIC PROGRAM WITH THE ╞1 KEY.  ╔F YOU MAKE CHANGES TO THE
PROGRAM AND WISH TO SAVE IT WITH THE SAME FILE NAME, MOVE THE CURSOR
TO THE LINE IN A DIRECTORY LISTING CONTAINING THE NAME AND PRESS ╞8.
╦EY─╧╙ WILL FIRST SCRATCH THE ORIGINAL FILE, THEN SAVE THE NEW FILE
WITH THE SAME NAME.  ┬E VERY CAREFUL WITH THIS KEY.  ╔T'S POSSIBLE TO
PRESS IT OVER THE WRONG FILE NAME AND UNINTENTIONALLY REPLACE A FILE
WITH A DIFFERENT ONE FROM MEMORY.  ╔F THIS IDEA FRIGHTENS YOU, PLEASE
DISABLE THIS KEY BY SUBSTITUTING SOMETHING ELSE FOR IT, OR REMOVE THE
╞8 KEY DEFINITION FROM THE ╦EY─╧╙ PROGRAM LISTING.  1581 USERS MIGHT
WANT TO SUBSTITUTE THE KEY FROM ╙╒┬─╔╥ ╦┼┘ IN THIS ARCHIVE.

╘HE ╞4 KEY IS USED TO RUN A ├64 ┬ASIC PROGRAM FROM A DIRECTORY
LISTING.  ╔T DOES THIS BY FIRST LOADING AND RUNNING A MODIFIED VERSION
THE PUBLIC DOMAIN ╥╒╬64.  ┬Y DEFAULT, ╦EY─╧╙ EXPECTS TO FIND ╥╒╬64 AS
"64" ON DRIVE 8.  ╔F YOU PREFER TO USE ANOTHER DRIVE OR FILE NAME,
LIST ╦EY─╧╙ AND ALTER THE DEFINITION FOR THE ╞4 KEY.  ╘HE AMOUNT OF
TIME IT TAKES TO LOAD AND RUN ╥╒╬64 IS MINIMAL COMPARED WITH THE
AMOUNT OF TIME YOU'LL SAVE LOADING ├64 PROGRAMS WITH A 1571 OR 1581
DISK DRIVE IN ├128 MODE.

╦EY─╧╙ ALSO REPROGRAMS THE ╥╒╬ AND ╚┼╠╨ KEYS.  ╘HE ╥╒╬ KEY, SELECTED
BY PRESSING ╙╚╔╞╘-╥╒╬/╙╘╧╨, IS A DUAL PURPOSE KEY.  ╔F PRESSED ON A
BLANK SCREEN LINE, IT WILL ┬╧╧╘ A DISK CONTAINING