readme

------------------------------
. * ÅÌÅÖÅÎ V0.4.6 -- ÒÅÁÄÍÅ *
------------------------------

(ÎOTE: THIS DOCUMENT WAS OPTIMIZED FOR VIEWING WITH THE ÅÅ EDITOR. ÉF YOU'RE
READING THIS USING ÅÅ, YOU CAN PRESS 'F7' FOR THE TABLE OF CONTENTS. ÙOU MAY
THEN USE THE CURSOR KEYS TO JUMP TO INDIVIDUAL SECTIONS DIRECTLY)


. 1. ÉÎÔÒÏÄÕÃÔÉÏÎ

. 1.1. ×HAT IS ÅÌÅÖÅÎ?

ÅÌÅÖÅÎ IS A COMBINED EDITOR AND PREPROCESSOR PACKAGE WHICH ENHANCES ÂÁÓÉÃ65 
BY ADDING THE FOLLOWING FEATURES:

- NO MORE LINE NUMBERS
- NAMED LABELS
- VARIABLE DECLARATION
- VARIABLE NAMES OF ARBITRARY LENGTH
- $ AND % PREFIXES FOR HEXADECIMAL AND BINARY INTEGERS
- EASY TO READ COMMENTS
- EASY TO USE 'ÅÅ' FULL SCREEN TEXT EDITOR WITH PREPROCESSOR INTEGRATION
- AUTOMATIC BACKUP FACILITY  

ÅÌÅÖÅÎ CONSISTS OF TWO MAIN PARTS: ÔHE EDITOR AND THE PREPROCESSOR ITSELF. 
ÂOTH ARE WORKING HAND IN HAND IN ORDER TO PROVIDE A SIMPLE AND INTEGRATED
DEVELOPMENT WORKFLOW.


. 1.2. ÉNSTALLATION / ÑUICK START

ÔO USE ÅÌÅÖÅÎ, SIMPLY MAKE A COPY OF THE ÅÌÅÖÅÎ DISC IMAGE AND BOOT FROM IT
(EITHER BY RESETTING YOUR ÍÅÇÁ65 OR BY TYPING 'ÂÏÏÔ' AT THE ÒÅÁÄÙ PROMPT). 
ÂOOTING LAUNCHES ÅÅ, ÅÌÅÖÅÎ'S SOURCE CODE EDITOR, ALONG WITH THE CURRENT
FILE.

ÙOU MAY PRESS 'P' DURING THE BOOT PROCESS TO ACCESS THE PREFERENCES PROGRAM
(SEE "4. ÐÒÅÆÅÒÅÎÃÅÓ" FOR MORE INFO).

ÏNCE IN THE EDITOR, BY PRESSING THE 'F1' KEY YOU CAN LOAD ONE OF THE
VARIOUS EXAMPLES. ÙOU CAN COMPILE AND RUN THEM BY HITTING THE 'F5' KEY. ÏR,
WHEN YOU'VE SEEN ENOUGH, YOU CAN PRESS 'F2' TO BEGIN YOUR VERY OWN ADVENTURES
IN ÅÌÅÖÅÎ.


. 1.3. ÅXAMPLES

ÔHERE ARE SOME EXAMPLE PROGRAMS ON THE ÅÌÅÖÅÎ DISC SHOWING HOW TO PUT THE
PRECOMPILER FEATURES TO GOOD USE. ÔHESE ARE:

"HELLO.EL"
Á SLIGHTLY ADVANCED HELLO WORLD

"BASEÄEMO.EL"
ÓIMPLE BASE CONVERSION DEMO

"HOPALONG.EL"
ÈOPALONG FRACTAL

"FFIRE.EL"
ÆOREST FIRE SIMULATION

"FIENI"
ÓNAKE GAME

"DIZZY"
ÐALETTE SHIFT DEMO


. 2. ÔÈÅ ÅÄÉÔÏÒ

. 2.1. ÏVERVIEW

ÅÌÅÖÅÎ COMES WITH ÅÅ, AN EASY TO USE TEXT EDITOR WITH A FEW TRICKS UP ITS
SLEEVE TO MAKE EDITING ÂÁÓÉÃ SOURCES FOR ÅÌÅÖÅÎ EASY AND UNCOMPLICATED.


. 2.2. ÔHE STATUS BAR

ÅÅ DISPLAYS A STATUS BAR WITH THE FOLLOWING INFORMATION:
- THE FILE NAME (PREFIXED WITH '*' IF THE FILE HAS UNSAVED CHANGES)
- THE CURRENT CURSOR POSITION (IN COLUMNS:ROW FORMAT)
- THE MOST IMPORTANT FUNCTION KEYS
- THE CURRENT CONTROL CHARACTER MODE (FLASHING 'CTRL' WHEN IN CTRL MODE)

ÁFTER FILE OPERATIONS, THE STATUS BAR DISPLAYS THE RESULT OF THE LAST FILE
OPERATION. ÉT THEN CHANGES TO ITS NORMAL APPEARANCE AFTER THE NEXT KEYPRESS.
 

. 2.3. ÅDITOR FUNCTIONS

<F1>   ÌÏÁÄ      LOAD A FILE FROM THE DEFAULT DRIVE
<F2>   ÎÅ×       ERASE THE CURRENT TEXT IN MEMORY AND START OVER

<F3>   ÓÁÖÅ      SAVE THE CURRENT TEXT (WITH THE CURRENT FILENAME)
<F4>   ÓÁÖÅ ÁÓ   SAVE THE CURRENT TEXT UNDER A NEW NAME ('SAVE AS')

<F5>   ÃÏÍÐÉÌÅ   COMPILE THE CURRENT FILE (SEE BELOW)

<F7>   ÌÁÂÅÌÓ    DISPLAY LABEL CHOOSER (SEE BELOW)

<F9>   ÇÏÔÏ      JUMP TO LINE NUMBER (SEE BELOW)

<F11>  ÃÍÏÄÅ     TOGGLE CONTROL CHARACTER MODE ON/OFF (SEE BELOW)

<F14>  ÓÖÃÏÎÆ    SAVE CURRENT CONFIGURATION AS DEFAULT (SEE BELOW)

<ALT+F>     SEARCH
<ALT+R>     SEARCH & REPLACE

<ALT+DEL>   DELETE CURRENT LINE
<HOME>      JUMP TO BEGINNING OF TEXT
<ALT+HOME>  JUMP TO END OF TEXT
<ALT+UP>    PAGE UP
<ALT+DOWN>  PAGE DOWN
<ALT+LEFT>  SCROLL LINE LEFT (ONLY WITH LINES>80 COLUMNS)
<ALT+RIGHT> SCROLL LINE RIGHT (ONLY WITH LINES>80 COLUMNS)
<HELP>      SHOW COMMAND HELP

<SHIFT+RUN/STOP> EXIT EDITOR


. 2.4. ÔHE LABEL CHOOSER (F7)

ÏNE OF THE MAIN FEATURES OF THE PRECOMPILER IS ITS USAGE OF LABELS INSTEAD
OF LINE NUMBERS. Á LABEL IS DEFINED WITH A "DOT" PREFIX (SEE "3.2 ÌABELS")

ÔO MAKE WORKING WITH LABELS EASIER, ÅÅ KEEPS TRACK OF THE LABELS IN YOUR
PROGRAM AND LETS YOU NAVIGATE DIRECTLY TO LABEL POSITIONS. ÔO BRING UP THE
LABEL CHOOSER, PRESS 'F7' AND THEN CHOOSE THE DESIRED LABEL WITH THE 
CURSOR KEYS.

ÎOTE: ÙOU CAN ALSO USE THIS FEATURE TO MARK CERTAIN POINTS IN YOUR SOURCE
CODE WITHOUT ACTUALLY USING THEM AS LABELS. ÙOU MAY DEFINE AS MANY LABELS
AS YOU LIKE.

(ÉF YOU ARE READING THIS DOCUMENT WITH ÅÅ, YOU CAN TRY THIS FEATURE BY
PRESSING 'F7' NOW. ÁLL SECTIONS ARE DEFINED AS LABELS, SO THAT YOU CAN
EASILIY JUMP SECTIONS) 


. 2.5. ÇOTO LINE (F9)

ÐRESS 'F9' TO DIRECTLY SPECIFY A LINE NUMBER TO JUMP TO.


. 2.6. ÃOMPILE (F5)

ÐRESS 'F5' TO DIRECTLY INVOKE THE PRECOMPILER FROM INSIDE THE EDITOR. ÉF THE
COMPILER ENCOUNTERS AN ERROR WHILE COMPILING, YOU ARE AUTOMATICALLY RETURNED
TO THE EDITOR, AND (IF POSSIBLE) THE LINE WHERE THE ERROR OCCURED.


. 2.7. ÃONTROL ÃHARACTER ÍODE (F11)

ÔO INCLUDE CONTROL CHARACTERS (LIKE ÃÕÒÓÏÒ ÕÐ, ÈÏÍÅ, ETC.) IN YOUR SOURCE CODE,
YOU CAN ENTER "ÃONTROL ÃHARACTER ÍODE" BY PRESSING 'F11'. 
×HILE IN ÃONTROL ÃHRACTER ÍODE, "CTRL" FLASHES AT THE LOWER RIGHT CORNER
OF THE SCREEN, AND ALL CHARACER CODES GENERATED BY CURSOR AND SCREEN EDITING 
KEYS ARE DIRECTLY INSERTED INTO THE SOURCE CODE RATHER THAN INTERPRETED BY ÅÅ, 
JUST LIKE "QUOTE MODE" IN ÃOMMODORE ÂASIC.
ÔO EXIT ÃONTROL ÃHARACTER ÍODE, SIMPLY PRESS 'F11' AGAIN.


. 2.8. ÓAVING THE CURRENT CONFIGURATION (F14)

×HEN BOOTING ÅÌÅÖÅÎ, CERTAIN OPTIONS ARE LOADED FROM THE CONFIGURATION FILE IF
PRESENT. ÔHESE OPTIONS ARE:

- THE SCREEN COLOURS
- WHETHER TO AUTOMATICALLY BACKUP FILES WHEN SAVING
- THE CURRENT FILE NAME

ÔHAT WAY, YOU CAN AUTOMATICALLY HAVE YOUR CURRENT FILE LOADED WHEN STARTING 
A NEW SESSION WITH ÅÌÅÖÅÎ.

ÔO STORE THE CURRENT CONFIGURATION (AND THE CURRENT FILENAME ALONG WITH IT),
PRESS 'F14'. 

ÔO EDIT OTHER ASPECTS OF THE CONFIGURATION, YOU MAY USE THE 'PREFERENCES'
PROGRAM BY PRESSING 'P' WHILE BOOTING ÅÌÅÖÅÎ.


. 2.9. ÁUTOMATIC BACKUPS

ÅÅ AUTOMATICALLY CREATES BACKUPS OF THE CURRENT FILE EACH TIME YOU SAVE
SOMETHING TO DISC. ÔHIS BEHAVIOUR CAN BE CHANGED IN THE PREFS APPLICATION.
ÐLEASE NOTE THAT DISABLING BACKUPS IS HIGHLY DISCOURAGED, BECAUSE THE Ã65'S
ÄÏÓ IS HIGHLY UNSTABLE AND YOU CAN'T DO TOO MUCH BACKUPS!



. 3. ÔÈÅ ÐÒÅÃÏÍÐÉÌÅÒ

ÔHE PRECOMPILER IS WHAT IS AT THE HEART OF ÅÌÅÖÅÎ. ÉT TRANSFORMS BLAND OLD
ÂÁÓÉÃ10 INTO A REASONABLY READABLE AND COMFORTABLE PROGRAMMING LANGUAGE BY
ADDING THE FOLLOWING NEW FEATURES.


. 3.1. ÃOMMENTS

ÃOMMENTS ARE DEFINED WITH THE SINGLE QUOTE ("'") SIGN. ÅVERYTING AFTER THE
SINGLE QUOTE SIGN IS IGNORED IN THE FINAL PROGRAM.
(YOU CAN STILL USE THE ÒÅÍ COMMAND FOR COMMENTS, BUT ITS USE IS DISCOURAGED
BECAUSE THE QUOTE SIGN PROVIDES MUCH MORE READABLE PROGRAM CODE)

ÅXAMPLE:

PRINT "HELLO, ";USERÎAME$         ' GREET USER

ÏF COURSE, YOU MAY CONTINUE USING THE "'" SIGN IN STRING CONSTANTS:

MYÓTRING$="MAY É 'QUOTE' THIS?"   ' YES, YOU MAY



. 3.2. ÌABELS

ÉNSTEAD OF LINE NUMBERS, ÅÌÅÖÅÎ-ENABLED PROGRAMS USE NAMED LABELS AS JUMP 
DESTINATIONS. ÌABELS CONTAIN NUMBERS, LETTERS AND GRAPHICS CHARACTERS. ×HEN
LABELS ARE DEFINED, A DOT CHARACTER IMMEDIATELY PRECEDES THE LABEL:

   .INITÐROGRAM
   .ERRORÈANDLER
   
×HEN THEY'RE REFERENCED BY A ÔÒÁÐ, ÇÏÔÏ OR ÇÏÓÕÂ, THE DOT IS OMITTED:

TRAP ERRORÈANDLER
GOSUB INITÐROGRAM

ÅLEVEN'S EDITOR HAS A NICE FEATURE WHICH LISTS ALL THE LABELS IN A PROGRAM
WHEN PRESSING THE 'F7' (LBLS) KEY.  ÙOU CAN THEN SELECT WHICH LABEL TO JUMP 
TO BY USING THE CURSOR KEYS (OR ESCAPE TO RETURN FROM THE LABEL LIST). 



. 3.3. ÔHE #DECLARE DIRECTIVE

ÌIKE LABELS, ÅÌÅÖÅÎ SUPPORTS DESCRIPTIVE VARIABLE NAMES. ÖARIABLES START
WITH A LETTER AND MAY CONTAIN NUMBERS. ÁS IN ÂÁÓÉÃ10, STRING VARIABLES END
WITH $ AND INTEGER VARIABLES END WITH %.

×ITH #DECLARE, YOU DECLARE A VARIABLE FOR USAGE ON YOUR PROGRAM. ÙOU CAN ONLY
USE VARIABLES YOU HAVE DECLARED BEFOREHAND. ÕNLIKE ÂÁÓÉÃ10, VARIABLE NAMES 
CAN BE OF ARBITRARY LENGTH.

ÅXAMPLES:
#DECLARE FLOATINGÐOINTÖARIABLE
#DECLARE STRINGÖARIABLE$
#DECLARE INTEGERÖARIABLE%

FLOATINGÐOINTÖARIABLE=5.3
INTEGERÖARIABLE=42
STRINGÖARIABLE$="VALUE IS "+STR$(FLOATINGÐOINTÖARIABLE)

ÙOUR PROGRAM CAN USE AS MANY #DECLARE DIRECTIVES AS IS NECCESSARY TO DECLARE
ALL THE VARIABLES USED.

ÆOR ARRAY VARIABLES, YOU MAY EITHER #DECLARE AND ÄÉÍ THE ARRAY IN ONE GO:

#DECLARE ANÁRRAY(100)

OR DECLARE ONLY THE ARRAY'S BASE NAME AND ÄÉÍENSION IT LATER ON:

#DECLARE ANÁRRAY
DIM ANÁRRAY(100)

ÌAST BUT NOT LEAST, IT'S ALSO POSSIBLE TO ASSIGN AN INITIAL VALUE TO 
A VARIABLE WHEN DECLARING IT:

#DECLARE ELEVEN=11

ÎOTE: ÁLTHOUGH ÅÌÅÖÅÎ MAKES PROGRAMMING ÂÁÓÉÃ10 MUCH MORE CONCISE AND 
COPREHENSIVE, NOTHING IS CHANGED IN ÂÁÓÉÃ10 ITSELF. ÆOR EXAMPLE, ALL 
CALCULATIONS ARE STILL PERFORMED IN SLOW FLOATING POINT ARITHMETIC, 
INTEGERS ARE CONVERTED INTERNALLY BEFORE ANY CALCULATIONS ARE DONE. 


. 3.4. ÔHE #OUTPUT DIRECTIVE

ÔHE #OUTPUT DIRECTIVE LETS YOU DEFINE THE NAME OF THE FINISHED PROGRAM.

ÅXAMPLE:
#OUTPUT "MYÐROG.PRG"



. 3.5. ÂASE CONVERSIONS

ÙOU CAN USE THE "%" AND "$" PREFIXES TO WRITE INTEGERS IN BINARY OR 
HEXADECIMAL NOTATION, RESPECTIVELY.

ÅXAMPLES:

#DECLARE MYÂINARYÎUMBER = %10110
#DECLARE ANOTHERÎUMBER
ANOTHERÎUMBER = $BA12
PRINT "ÙOUR LUCKY NUMBER IS ",ANOTHERÎUMBER+%101011


. 4. ÔÈÅ ÐÒÅÆÅÒÅÎÃÅÓ ÐÒÏÇÒÁÍ

(DESCRIPTION FORTHCOMING)



. 5. ÖÁÒÉÏÕÓ ÔÉÐÓ & ÔÒÉÃËÓ


. 5.1. ÁUTO INDENT

ÅÅ AUTOMATICALLY INDENTS NEW LINES WHEN ÒÅÔÕÒÎ IS PRESSED INSIDE AN INDENTED 
LINE, THUS MAKING IT MUCH EASIER WRITING PRETTY FORMATTED CODE.


. 5.2. ÌONG LINES

ÌINES WITH MORE THAN 80 CHARACTERS ARE DISPLAYED TRUNCATED WITH AN "$" AT THE
RIGHT SCREEN BORDER. ÙOU CAN SCROLL THOSE LINES BY PRESSING ÁÌÔ AND THE
ÃÕÒÓÏÒ ÌÅÆÔ/ÒÉÇÈÔ KEYS.


. 5.3. ÂACK TO ÅÅ

ÁFTER RUNNING YOUR COMPILED PROGRAM YOU CAN ENTER THE EDITOR AGAIN BY SIMPLY
PRESSING THE 'Æ1' KEY (THAT IS, UNLESS YOUR PROGRAM REDEFINES THE FUNCTION
KEYS).
 
 


. 6. ÅÌÅÖÅÎ ÓÁÑ (ÓELDOM ÁSKED ÑUESTIONS)

>> "ÏK, SO TELL US: ×HY DID YOU DO IT?"

ÁFTER HOLDING THE FIRST PROTOTYPE ÍÅÇÁ65 IN MY HANDS AND USING THAT WONDERFUL
KEYBOARD, THE FIRST THING COMING TO MY MIND WAS: "É WANT TO WRITE PROGRAMS
ON THIS THING!!"

ÙEP, THAT'S RIGHT. *ÏN* THIS THING. ÎOT CROSS-DEVELOPING ON SOME SHINY ÐÃ IN
SOME SHINY ÉÄÅ BUT *ON* THE ÍÅÇÁ65 DIRECTLY. ÁFTER ALL, WHY BUILD SUCH A 
GORGEOUS KEYBOARD IF NO ONE'S PROGRAMMING ON IT?

ÕNFORTUNATELY, ONE OF THE MOST SEVERE PROBLEMS OF THE ÍÅÇÁ65 PLATFORM IS ITS 
BUNDLED PROGRAMMING ENVIRONMENT. ÂÁÓÉÃ10 WAS ALREADY HOPELESSLY ANTIQUATED IN 
1991 (THERE'S A QUITE EXTENSIVE INTERNAL DOCUMENT FROM ÃOMMODORE LISTING
ITS MANY SHORTCOMINGS), AND IT CERTAINLY HASN'T AGED WELL. 
ÂÁÓÉÃ10 IS AN INHERENTLY SLOW AND OVERCOME IMPLEMENTATION OF THE ÂÁÓÉÃ LANGUAGE,
AND ITS RELIANCE ON ARCHAIC CONCEPTS LIKE TWO-LETTER VARIABLE NAMES AND LINE 
NUMBERS MAKE IT A POSITIVELY HAZARDOUS PROGRAMMING ENVIRONMENT WHICH IS 
ENGAGING ONLY FROM AN ARCHAEOLOGICAL POINT OF VIEW OR TO PEOPLE WITH A 
DISTINCT FONDNESS FOR MASOCHISM. 

ÂUT, ALAS, IT'S THE ONLY ONE WE HAVE, AND IT'S BUNDLED WITH EACH ÍÅÇÁ65.


>> "ÈEY, BUT THERE HAVE BEEN MADE BIG ENHANCEMENTS TO ÂÁÓÉÃ10. ×E CAN EVEN DO
ÔÅÔÒÉÓ WITH IT NOW! ÆINALLY, WE HAVE A REALLY GOOD ÂÁÓÉÃ!"

ÓORRY TO BURST YOUR BUBBLE BUT NO, WE DON'T. ÎOT EVEN A LITTLE.  

ÉT'S TRUE THAT ÂITÓHIFTER HAS MADE TREMENDOUS IMPROVEMENTS TO ÂÁÓÉÃ10, AND HE 
DESERVES HEAPS OF RESPECT AND PRAISE FOR IT (MATTER OF FACT, THE NEWER VERSIONS
OF ÅÌÅÖÅÎ WOULD NOT EXIST WITHOUT HIS EFFORTS!)

ÂUT A GOOD IMPLEMENTATION OF ÂÁÓÉÃ IT IS NOT. ÉT LACKS SUCH A FRUSTRATINGLY
LARGE NUMBER OF THINGS THAT WERE ALREADY PERFECTLY NATURAL IN 1991 (NAMED 
PROCEDURES AND FUNCTIONS, FAST INTEGER ARITHMETIC, INLINE ASSEMBLY, 
INDIRECTION OPERATORS, STRUCTURES...) THAT IT'S ALMOST PAINFUL TO ARGUE ABOUT 
IT AGAIN AND AGAIN IN ONLINE FORUMS IN THE YEAR 2021. 


>> "ÏK, FAIR ENOUGH. ÂUT WHY JUST A PREPROCESSOR THEN? ×HY NOT A BEAUTIFUL 
NEW IMPLEMENTATION OF ÂÁÓÉÃ WITH ALL THE LITTLE AND BIG THINGS THAT ÂÁÓÉÃ10 
LACKS?" 

É WOULD HAVE LIKED THAT VERY MUCH. ÒEGRETTABLY É LACK BOTH THE SKILLS
AND THE TIME FOR SUCH AN UNDERTAKING. 

É'M STILL HOPEFUL THAT SUCH A LANGUAGE MIGHT EVENTUALLY SEE THE LIGHT OF DAY. 
ÂUT COUNTLESS DISCUSSIONS ON FORUM64 AND THE ÍÅÇÁ65 DISCORD HAVE SHOWN THAT
IT'S STILL A LONG, LONG, LONG WAY TO GO. ÁS OF EARLY 2021, THERE ARE MANY 
DIFFERENT OPINIONS ABOUT WHAT SUCH A LANGUAGE SHOULD BE -- AND EVEN WHETHER IT
IS NEEDED AT ALL.

ÁND THAT'S HOW ÅÌÅÖÅÎ CAME INTO EXISTENCE: ÒATHER THAN WAITING FOR FOLKS TO 
COME TO THEIR SENSES, É DECIDED TO TACKLE THE PROBLEM BY WRITING AN EDITOR 
AND PREPROCESSOR IN ORDER TO ALLEVIATE AT LEAST SOME OF THE MOST GLARING 
MALADIES INHERENT IN ÂÁÓÉÃ10.


>> "ÎAMED MULTILINE PROCEDURES AND FUNCTIONS WOULD BE NICE. ÏH AND PLEASE,
WE WANT ÌÏÃÁÌ VARIABLES!"

ÉNDEED THEY WOULD. ÁS A MATTER OF FACT, THIS FEATURE WAS IMPLEMENTED IN A
VERY EARLY VERSION OF ÅÌÅÖÅÎ ALREADY. ÂUT THERE ARE TWO PROBLEMS: 
A) THE AMOUNT OF PARSING NEEDED SLOWS DOWN PREPROCESSING TO A CRAWL AND 
B) IN ORDER TO SUPPORT RECURSION, WE'D NEED A WRAPPER AROUND PARAMETER 
PASSING, WHICH WOULD MAKE THE RESULTING PROGRAM MUCH SLOWER. ÔHERE'S ONLY 
SO MUCH YOU CAN DO WITHOUT RESORTING TO MACHINE LANGUAGE... AND ONCE YOU 
START CODING IN ÍÌ, YOU MIGHT AS WELL IMPLEMENT A SANE PROGRAMMING LANGUAGE 
FOR THE Í65 ALTOGEHTER (SEE ABOVE ;-))


>> "ÙO. ×HAT GIVES? ×E DON'T NEED YOUR SHINY 'MODERN' CONCEPTS ON THE ÍÅÇÁ65! 
×E LIKE THIS HERE ÂÁÓÉÃ10 WITH THEM PRETTY OL' LINE NUMBERS AND SPAGHETTI CODE 
AND THEM TWO LETTER VARIABLE NAMES AND THE QUIRKINESS AND THE BUGSES! ÍATTER
OF FACT, EVEN ÂÁÓÉÃ2.0 WOULD BE ENOUGH! ÂÒÉÎÇ ÂÁÃË ÔÈÅ ÐÏËÅÓ! ÓPARE US YOUR 
MODERN BIG CITY HOCUS POCUS AND ÍÁËÅ ÍÅÇÁ65 ÇÒÅÁÔ ÁÇÁÉÎ!11!"

ÕH... RELAX. ÙOU'RE WELCOME TO USE YOUR ÍÅÇÁ65 IN ANY WAY YOU WANT, AS LONG 
AS YOU LEAVE ME OUT OF IT.


>> "×HAT'S NEXT FOR ÅÌÅÖÅÎ?"  

ÁS OF ÍAY 2022, DEVELOPMENT OF ÅÌÅÖÅÎ HAS HALTED. ÅÌÅÖÅÎ WAS INTENDED AS A
STOPGAP MEASURE TO GIVE PEOPLE SOMETHING TO CODE WITH UNTIL A BETTER ÂÁÓÉÃ
IS ON THE HORIZON. ÉT'S HIGH TIME TO IMPLEMENT THAT BETTER ÂÁÓÉÃ. ÔHE DEAD 
HORSE WHICH IS ÂÁÓÉÃ65 HAS BEEN FLOGGED LONG ENOUGH. 


>> "×HY CALL IT ÅÌÅÖÅÎ?"

ÔHE INSPIRATION FOR THE NAME OF COURSE COMES FROM ÓPINAL ÔAP... IF YOU DON'T 
KNOW THE FILM, É HEARTILY RECOMMEND IT :)


. 7. ÔECHNICAL INFORMATION

. 7.1 ÏVERLAY MAILBOX ÒÁÍ

ÉN ORDER TO COMMUNICATE WITH EACH OTHER, EDITOR AND PRECOPILER USE
A SPECIALLY DESIGNATED AREA IN ÒÁÍ BANK 4. ÔO THIS END, LOCATIONS 
$04FF00-$04FF79 ARE USED AS FOLLOWS:

$04,FF00 'S'    ELEVEN ID; EACH MODULE CHECKS FOR THE EXISTENCE OF THESE
$04,FF01 'K'    IDENTIFIER BYTES. 

$04,FF02        BORDER COLOUR
$04,FF03        BACKGROUND COLOUR
$04,FF04        FOREGROUND COLOUR
$04,FF05        HIGHLIGHT COLOUR
$04,FF06        STATUS BAR COLOUR

$04,FF07        MISC. FLAGS
               BIT 0  : AUTOLOAD SOURCE ENABLE FLAG
               BIT 1  : AUTOJUMP TO LINE FLAG
               BIT 2  : AUTOBACKUP FLAG
               BIT 3  : VERBOSE FLAG
               BIT 4-7: RESERVED

$04,FF08        ERROR NUMBER TO BE DISPLAYED (>128 ARE PREPROCESSOR ERRORS)

$04,FF09/0A     LINE NUMBER FOR AUTOJUMP

$04,FF10-
$04,FF1F        CURRENT FILE NAME

$04,FF20-
$04,FF2F        OUTPUT FILE NAME

$04,FF30-        
$04,FF7F        RESERVED


. 7.2 ÁTTIC ÒÁÍ CACHE USAGE

ÅLEVEN USES SOME PARTS OF ATTIC ÒÁÍ TO CACHE ITS VARIOUS MODULES.

É BELIEVE ÕBIK'S INTENT BY THIS IS SO THAT ELEVEN CAN RE-LOAD ITS MODULES
STRAIGHT FROM THE CACHE (AND NOT NEED TO ALWAYS ACCESS THE DRIVE).

ÁS SOME OF THESE MODULES HAVE GROWN OVER TIME, THE AMOUNT OF ATTIC ÒÁÍ
ALLOCATED TO THEM HAS INCREMENTALLY GROWN.

ÔHE DIAGRAM BELOW REPRESENTS CURRENT ATTIC RAM USAGE:


$800,0000 +---------------+
          ! 11.ÅÄÉÔ       ! (MAX 53KB)
$801,0000 +---------------+
          ! 11.ÐÁÒÓÅ      ! (MAX 53KB)
$802,0000 +---------------+
          ! 11.ÓÅÔÔÉÎÇÓ   ! (8KB)
$802,2000 +---------------+
          ! 11.ÔÏËÅÎÉÚÅ   ! (8KB)
$802,4000 +---------------+
          ! 11.ÐÏÓÔ       ! (8KB)
$802,6000 +---------------+

$803,0000 +---------------+
          ! ÅÌÅÖÅÎ ÓÏÕÒÃÅ !
      ... +---------------+