KeyMapEd
========

Questo programma serve per modificare i file di configurazione della
tastiera (KeyMaps) distribuiti dalla Commodore insieme ad AmigaDOS.

Ad un tasto possono essere associati diversi codici: uno per quando viene
premuto da solo, uno con shift, alt, control o qualunque combinazione di
questi tasti di controllo, per un totale di otto diversi codici associabili
ad ogni tasto. Inoltre, la funzionalita` del tasto Caps Lock puo` essere
abilitata separatamente per ogni tasto, cosi` come la ripetizione
automatica. Infine, "KeyMapEd" consente di programmare "deadkeys"
(combinazioni di tasti che modificano il valore del tasto premuto
successivamente).

AVVERTENZE: Una volta salvata una keymap, non rinominate il file!
            I file keymap vengono letti una volta soltanto. Per questa
            ragione, se impartite i comandi    SetMap i
                                               SetMap usa0
                                               SetMap i

            il file "i" non verrebbe letto la seconda volta, anche se voi lo
            aveste nel frattempo modificato.

Se al posto del nome della keymap da modificare indicate 'ROM', accederete
alla mappa di default, quella attiva prima di qualsiasi comando KeyMap.
Potete poi modificarla e riscriverla con qualsiasi nome.

I tipi di tasto definibili in una mappa sono quattro:

NOP
---
Un tasto NOP non fa assolutamente nulla, e non possiede un valore.

Normal (NoQual)
---------------
Ad un tasto di tipo "Normal" potete attribuire fino a quattro codici,
corrispondenti a: tasto, shift+tasto, alt+tasto, alt+shift+tasto. Inoltre,
se contrassegnate il tasto come "Vanilla", la pressione contemporaneamente
a Ctrl dara` origine ai medesimi valori, ma con i bit 5 e 6 azzerati.
Ad esempio, al tasto 'T' sono normalmente associati i valori 't','T','þ'
($FE), 'Þ' ($DE), e ctrl-t ($14). Quest'ultimo e` attribuito
automaticamente a partire dal primo, e non puo` essere modificato.

String
------
Un tasto di questo tipo puo` essere programmato per tutte le 8
combinazioni, ed a ciascuna viene associata una stringa di caratteri (max
32). I tasti 'dead' e 'deadable' non possono essere ridefiniti come 'string'.

Dead & Deadable
---------------

Un 'Dead Key' modifica il valore del tasto successivo, se quest'ultimo e`
marchiato come 'Deadable'. Per un tasto 'dead', inserite il codice
dell'accento che dovra` generare; per un tasto 'deadable', inserite i
valori corrispondenti ai differenti accenti. Ne sono previsti cinque: acuto
(´), grave (`), circonflesso (^), tilde (~) e dieresi (¨).


All'avvio, il programma richiedera` il nome della mappa da modificare.
"KeyMapEd" assume che le Keymap si trovino in "devs:keymaps". Se sono
collocate altrove, sara` necessario introdurre il path completo.

Il grafico che compare mostra tutti i caratteri associati ai vari tasti:
per vedere quelli associati ai tasti shiftati premete shift, e cosi` via.
Per riprogrammare la tastiera, premete il tasto che vi interessa, o
selezionatelo sullo schermo con il mouse.

I codici del tasto devono essere riportati secondo la notazione standard C:
se si tratta di un carattere visibile lo si puo` inserire direttamente,
altrimenti occorrera` digitare il valore esadecimale nella forma '\x##'.
Inoltre sono definite le seguenti sequenze:

\r   return
\n   newline
\f   formfeed
\\   \

Quando siete soddisfatti del risultato, tornate alla schermata iniziale con
'Use' e potrete passare alla definizione di un altro tasto.

Per salvare la keymap cosi` ottenuta, usate 'Save' nel menu 'Project'.