Brotikasten/BROTCD01.iso/c128/c159.d64/ace-r10.doc

Text File | 1995-08-09 | 53KB | 1,084 lines

┴├┼-128/64 ╒╙┼╥'╙ ╟╒╔─┼  FOR ╥ELEASE #10   [═ARCH 14, 1994]
------------------------------------------------------------------------------
1. ╔╬╘╥╧─╒├╘╔╧╬

┴├┼ IS A PROGRAM FOR THE ├OMMODORE 128 AND ├OMMODORE 64 THAT PROVIDES A
╒NIX-LIKE COMMAND SHELL ENVIRONMENT.  ╔T IS STILL IN THE DEVELOPMENT STAGE,
BUT ENOUGH OF IT IS COMPLETE TO BE USEFUL.  ┬╘╫, "┴├┼" MEANS "┴DVANCED
├OMPUTING ┼NVIRONMENT" (WELL, ADVANCED FOR THE 128/64).

╘HIS RELEASE CONTAINS A NUMBER OF IMPROVEMENTS OVER THE PREVIOUS RELEASE.
 - ╞ULL INPUT LINE EDITING FOR KEYBOARD INPUT.
 - ┼VEN FASTER PRINTING TO SCREEN.
 - ╬EW "NULL" DEVICE SUPPORTED (STANDARD DEVICE "N:").
 - ╬EW APPLICATIONS: "WINDOW", "HELLO" (WELL...), "MKDIR", "RMDIR", "MORE",
   AND "UNKAR".
 - 80-COLUMN SCREEN SCREEN SAVER.
 - ═INOR BUG FIXES, INCLUDING ANNOYING 40-COL SCREEN DISABLE LOCKUP BUG.

 - ╞ULL CONFORMANCE TO THE SYSTEM INTERFACE DESCRIBED IN THE ┴├┼ ╨ROGRAMMER'S
   ╥EFERENCE ╟UIDE IN ├= ╚ACKING #7 NET MAGAZINE (BUT IMPROVED A LITTLE IN
   PLACES AND THE "EXEC" SYSTEM CALL IS NOT IMPLEMENTED ("EXECSUB" IS)).
 - ┼ACH AND EVERY SYSTEM CALL REVIEWED AND SPRUCED UP.

╘HIS DISTRIBUTION CONSISTS OF A BOATLOAD OF FILES.  ╙YSTEM FILES:

ACE         - THE KERNEL BOOTSTRAPPER; CAN BE RUN FROM EITHER 64 OR 128 MODE
ACE128      - THE KERNEL FOR THE 128
ACE64       - THE KERNEL FOR THE 64
CONFIG      - THE CONFIGURATION INITIALIZER
SH          - THE COMMAND SHELL
CONFIG.SYS  - THE SYSTEM CONFIGURATION - THIS IS DATA NOT AN EXECUTABLE
CONFIG.EDIT - CONFIGURATION EDITOR PROGRAM (WRITTEN IN ┬┴╙╔├)
ACE-CHARSET - CHARACTER SET - YOU CAN REPLACE IT WITH YOUR OWN ╔┘╫

┴PPLICATION PROGRAMS (EXPLAINED IN ╙ECTION 6.3):

CP          - COPY FILES
RM          - REMOVE FILES (SCRATCH)
MV          - RENAME FILES (NAMED FOR ╒NIX "MV"=="MOVE")
MKDIR       - REMOVE AN EXISTING EMPTY DIRECTORY (FLAT NAME)
RMDIR       - CREATE A NEW DIRECTORY (FLAT NAME)
XLS         - DIRECTORY LISTER, DISPLAYS DATES
UUENCODE    - ENCODE FILES INTO UUENCODED FORMAT
UUDECODE    - DECODE FILES FROM UUENCODED FORMAT
BCODE       - ENCODE FILES INTO ┬├╧─┼ FORMAT
UNBCODE     - DECODE FILES FROM ┬├╧─┼ FORMAT
CRC32       - DISPLAY ├╥├-32 *┬* VALUES FOR FILES (NEW STANDARD)
CRC32A      - DISPLAY ├╥├-32 *┴* VALUES FOR FILES (OLD STANDARD)
WC          - COUNT WORDS, LINES, CHARACTERS OF FILES
GREP        - SEARCH FOR A SUBSTRING IN FILES (FROM ╒NIX "GREP")
TR          - TRANSLATE FROM ONE CHARACTER SET TO ANOTHER
SORT        - SORT FILES
WRAP        - WRAP LINES LONGER THAN 75 CHARACTERS
DATE        - DISPLAY CURRENT DATE AND TIME
FORTY       - SWITCH TO 40-COL SCREEN, SLOW MODE
EIGHTY      - SWITCH TO 80-COL SCREEN, FAST MODE ON 128
READ        - READ FILES
MEM         - DISPLAY AVAILABLE DYNAMIC AND TRANSIENT PROGRAM AREA MEMORY
AS          - ─┼═╧ ASSEMBLER: ONLY TOKENIZER IMPLEMENTED
VI          - ─┼═╧ "┌ED" TEXT EDITOR: DISPLAYS SCREEN, LOADS AND PRINTS FILE
HELLO       - DUMB LITTLE "HELLO WORLD" EXAMPLE PROGRAM
WINDOW      - SET THE CURRENT WINDOW DIMENSIONS
MORE        - FULL-SCREEN FILE DISPLAYER
UNKAR       - ╦┴╥ (╦EVIN'S ┴╥CHIVER) TEXT-ONLY FILE DEARCHIVER

╘HESE BINARY PROGRAMS AVAILABLE IN A UUENCODED ARCHIVE FORMAT.  ╘HE UUDECODE
PROGRAM INCLUDED WILL DECODE THIS FORMAT OF ARCHIVE, BUT THAT IS PROBABLY
OF NO USE TO YOU UNLESS YOU ARE ABLE TO ├ATCH 22.  ┘OU MAY HAVE TO USE THE
UUDECODER ON YOUR ╒NIX SYSTEM OR USE "UUXFER" FOR THE ├64.  ┘OU MAY HAVE TO
SPLIT THE UUARCHIVE UP INTO SEPARATE FILES FOR UUDECODING.

╬OTE THAT THE "ACE128" AND "ACE64" PROGRAMS ARE FUNCTIONALLY IDENTICAL, EXCEPT
THAT ONE IS SET UP FOR THE 128 AND THE OTHER FOR THE 64.  ╘HUS, ALL OF THE
APPICATION BINARY PROGRAMS WILL WORK WITH EITHER "ACE128" OR "ACE64".  ╠╧┴─
AND ╥╒╬ THE "ACE" PROGRAM AND IT WILL LOAD THE CORRECT "KERNEL" FOR YOUR
COMPUTER.

╘HE ┬UDDY ASSEMBLER SOURCE CODE FILES ARE NOT INCLUDED HERE, BUT ╔ WILL E-MAIL
THEM TO ANYONE WHO ASKS FOR THEM.  ╘HEY ARE GETTING A BIT BULKY, ABOUT 347╦ OR
22,900 LINES.  ╞OR PEOPLE WANTING A LITTLE TECHNICAL INFORMATION, HERE IS THE
MEMORY MAP OF ┴├┼; IT IS SUBJECT TO CHANGE AT MY WHIM:

$0002-$007F = APPLICATION ZERO-PAGE STORAGE (0.12╦)
$0080-$00FF = SYSTEM ZERO-PAGE STORAGE (0.13╦)
$0100-$01FF = PROCESSOR STACK (0.25╦)
$0200-$0EFF = SYSTEM STORAGE (3.25╦)
$0F00-$0FFF = KERNEL INTERFACE VARIABLES (0.25╦)
$1000-$12FF = SYSTEM STORAGE (0.75╦)
$1300-$1FFF = SHELL PROGRAM (3.25╦)
$2000-$27FF = CHARACTER SET (2╦)
$2800-$5FFF = ┴├┼ KERNEL AND DEVICE DRIVERS (14╦) - UNUSED SPACE FREE
$6000-$BFFF = APPLICATION AREA & STACK (24╦)
$C000-$FFFF = ╥╧═ AND ╔/╧, ╥┴═ (16╦) - FREE
------------------------------------------------------------------------------
2. ╒╙╔╬╟ ╘╚┼ ╙┘╙╘┼═

╫HEN ┴├┼ STARTS, IT LOADS AND EXECUTES THE COMMAND SHELL (AMONG OTHER THINGS),
GIVES YOU A PROMPT AND WAITS FOR YOU TO GIVE IT A COMMAND.  ┴ COMMAND HAS THE
FOLLOWING FORMAT:

PROGRAMNAME ARG1 ARG2 ... ARG╬

╘HE PROGRAMNAME CAN BE ANY OF THE FOLLOWING BUILT-IN COMMANDS (COVERED IN
╙ECTION 6.1):

ECHO       - PRINT THE GIVEN ARGUMENTS TO STDOUT
CLEAR      - CLEAR THE SCREEN
CLS        - SAME AS "CLEAR"
DIR        - CLEAR THE SCREEN AND GIVE A LONG-FORM DIRECTORY LISTING
D          - SAME AS "DIRECTORY", BUT NO CLEAR SCREEN
LS         - GIVE A MULTI-COLUMN SHORT-FORM DIRECTORY LISTING
CLSL       - COMBINATION OF "CLS" AND "LS"
CD         - CHANGE THE CURRENT DEVICE/DIRECTORY
CAT        - DISPLAY THE NAMED FILES TO STDOUT
EXIT       - EXIT FROM THE COMMAND SHELL BACK TO ┬┴╙╔├
X          - SAME AS "EXIT"
DOS        - GIVE A ├OMMODORE DOS COMMAND TO THE CURRENT DEVICE (╧╨┼╬1,DV,15..)
@          - SAME AS "DOS"
PATH       - SET THE PATH TO SEARCH FOR EXTERNAL PROGRAMS
SH         - INVOKE THE SHELL AGAIN AS A SUB-SHELL

OR PROGRAMNAME CAN BE FOR ANY OF THE EXTERNAL PROGRAMS PROVIDED WITH THIS
DISTRIBUTION.  ┘OU'LL HAVE TO FORGIVE MY PERSONAL TASTE IN COMMAND NAMES AND
ABBREVIATIONS (UNTIL THE "ALIAS" SHELL FEATURE IS IMPLEMENTED).

2.1. ╔╬╨╒╘/╧╒╘╨╒╘ ╥┼─╔╥┼├╘╔╧╬

╘HE THREE ╒NIX STANDARD FILES ARE SUPPORTED:

STDIN    - WHERE THE DEFAULT INPUT COMES FROM (USUALLY THE KEYBOARD)
STDOUT   - WHERE THE DEFAULT OUTPUT GOES TO (USUALLY THE SCREEN)
STDERR   - WHERE ERROR MESSAGES ARE SENT TO (USUALLY THE SCREEN)

╘O TEMPORARALLY REDIRECT THESE STANDARD FILE STREAMS FOR THE EXECUTION OF A
COMMAND, YOU CAN USE THE FOLLOWING INCANTATIONS ON A COMMAND LINE:

<INFILE     - REDIRECT STDIN - INPUT TAKEN FROM "INFILE"
>OUTFILE    - REDIRECT STDOUT - OUTPUT PUT INTO FILE "OUTFILE"
>>OUTFILE   - REDIRECT STDOUT - SAME AS ">" BUT THE OUTPUT IS APPENDED TO FILE
>&ERRFILE   - REDIRECT STDERR - ERROR OUTPUT IS PUT INTO "ERRFILE"
>>&ERRFILE  - REDIRECT STDERR - ERROR OUTPUT IS APPENDED TO FILE "ERRFILE"

─O NOT PUT A SPACE BETWEEN THE REDIRECTION SYMBOL(S) AND THE FILE NAME.

2.2. ╨┴╘╚╬┴═┼╙

╫HENEVER YOU SPECIFY A FILE, YOU USE A "PATHNAME".  ╨ATHNAMES HAVE THE
FOLLOWING OPTIONAL PARTS:

[DEVICE:][RAMLINK-DIRECTORY:][FILENAME]

─EVICE NAMES ARE SET BY THE USER IN THE CONFIGURATION FILE, BUT THE FACTORY
DEFAULTS ARE:

"K:"  - ├USTOM DEVICE DRIVER: THE KEYBOARD
"S:"  - ├USTOM DEVICE DRIVER: THE SCREEN ("K:" AND "S:" ARE EXACTLY SYNONYMOUS)
"P:"  - ├OMMODORE DEVICE #4 - THE PRINTER, WITH ╙EC┴DDR 7 - OUTPUT ONLY
"Q:"  - ├OMMODORE DEVICE #4 - THE PRINTER, WITH ╙EC┴DDR 5 - TRANSPARENT MODE
"N:"  - ├USTOM DEVICE DRIVER: "NULL" DEVICE
"A:"  - ├OMMODORE DEVICE #8 - A DISK DRIVE - INPUT/OUTPUT
"B:"  - ├OMMODORE DEVICE #9 - A DISK DRIVE - IF YOU HAVE >1 DRIVE
...
"J:"  - ├OMMODORE DEVICE #17 - A DISK DRIVE
".:"  - THE "CURRENT" DISK DEVICE

├═─ ╥┴═╠INK (OR ├═─ ╚ARD─RIVE) DIRECTORY NAMES HAVE THE FOLLOWING FORMATS:

"//DIR/:"                - A SUBDIRECTORY OF THE ROOT DIRECTORY
"/DIR/:"                 - A SUBDIRECTORY OF THE CURRENT DIRECTORY
"4//DIR/DIR/ ... /DIR/:" - A SUB-PATH OF THE ROOT DIRECTORY OF PARTITION #4
"/DIR/DIR/ ... /DIR/:"   - A SUB-PATH OF THE CURRENT DIRECTORY

┴ND FILENAMES HAVE THE USUAL ├OMMODORE FORMAT OF 1 TO 16 CHARACTERS.

╘HUS, THE FOLLOWING ARE VALID PATHNAMES FOR FILES:

K:                    - THE KEYBOARD FOR INPUT
P:                    - THE PRINTER FOR OUTPUT
B:FILE1               - "FILE1" ON DISK DEVICE #9
.:FILE1               - "FILE1" ON THE CURRENT DISK DEVICE
FILE1