***************************************************************************
*                                                                         *
*  COMPOSE !                                                              *
*  ---------                                                              *
*    ein erweiterter flexibler Tastaturtreiber fr Atari-Computer         *
*    von:    Pascal Fellerich                                             *
*            45, rue des Gents                                           *
*            L-3482 Dudelange                                             *
*                                                                         *
*  > Dieses Programm ist _Freeware_. Die Dateien                          *
*            COMPOSE.PRG      (residentes Teil, TSR)                      *
*            COMPOSE.CPX      (Konfigurationsmodul, CPX)                  *
*            COMPOSE.TXT      (Diese Anleitung)                           *
*    gehren zusammen und drfen nicht verndert werden.                  *
*                                                                         *
*                                                                         *
*                                                                         *
*  TSR v1.0, 10.2.1992                                                    *
*  CPX x0.8,  8.2.1992                                                    *
***************************************************************************




Vorwort:
--------

  Man kennt das Problem: ein franzsischer Text soll auf einer
deutschen Tastatur eingegeben werden. Die entsprechende
Tastaturbelegung nachladen? Ein Hochgenu! Wer schon einmal
die Vorzge einer AZERTY-Tastatur ausgekostet hat, wei wovon ich
schreibe!

  Hier kommt COMPOSE ins Spiel. Mit diesem Programm ist es mglich,
alle im Zeichensatz vorhandenen Sonderzeichen mit logischen
Tastenkombinationen zu erreichen.

  COMPOSE ist aber auch konfigurierbar, so da die ausgefallensten
Systemzeichenstze auch kein Hindernis darstellen.

  COMPOSE ist Freeware. Das bedeutet, da die vorliegende Software
    * gebhrenfrei benutzt werden darf
    * nicht verkauft werden kann
    * als 'Zugabe' mit kommerzieller Software verteilt werden darf
  Fehlermeldungen, Anregungen und neue CKB-Tabellen knnen wie immer an
meine Adresse geschickt werden (siehe oben).


  Die vorliegende Anleitung besteht aus vier Teilen:
1. USERMANUAL (kurz & einfach) mit BugList
2. PROGRAMMERS MANUAL (etwas lnglich :-)
3. A1: Richtig Programmieren...
4. A2: STANDARD-COMPOSE-TABELLE.


  AN ALLE PROGRAMMIERER: BITTE ANHANG 1 LESEN!!!!
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~




USERMANUAL
=======================================================================

Installation:
-------------
  COMPOSE.PRG kommt am besten in den AUTO-Ordner. Es verankert sich
resident im System und kann spter umkonfiguriert werden.

  COMPOSE.CPX ist ein CPX-Modul fr das Modulare Kontrollfeld
'XCONTROL.ACC' von Atari. Es gehrt in den 'CPX'-Ordner auf der
Festplatte. Dieses CPX ermglicht es, das eigentliche residente
Programm zu beliebigen Zeitpunkten umzukonfigurieren. Auerdem kann
standardmig eine andere Tastaturbelegung geladen werden (beide
Formate!)

  Es gibt auch die Mglichkeit, eine Tastatur-Tabellen-Datei namens
'AUTOLOAD.CKB' in das Wurzelverzeichnis zu kopieren. Die wird von
COMPOSE.PRG automatisch nachgeladen und installiert. Das ist
interessant fr jene, die XCONTROL nicht haben...



Benutzung des Programmes:
-------------------------
  COMPOSE bietet drei verschiedene Mglichkeiten zur Zusammensetzung
von Sonderzeichen:

  1. ExtKey: Das vom 'Original-Extkey' (von Alex Esser) und JAMES.ACC
     bekannte Verfahren. Die Idee: ein Sonderzeichen setzt sich
     zusammen aus einem Haupt und einem Nebenzeichen. Beispielsweise
     kann ein '' aus einem 'o' und einem '^' zusammengesetzt werden.
     Dabei tippt man zuerst das Hauptzeichen ('o'), dann das
     Nebenzeichen mit gedrckter Control-Taste! - also CONTROL-'^'.
     Dann verschwindet das 'o' und es wird durch ein '' ersetzt.
     Die Reihenfolge Primar, Sekundrzeichen ist einzuhalten.


  2. Composed Characters: Dieses Verfahren basiert auf der gleichen
     Idee und es stammt von der Firma DEC (Digital Equipment
     Corporation), die fr ihre VAX-Rechner bekannt sein drfte.
     Dort wo der Atari seine 'ALTERNATE'-Taste hat, befindet sich bei
     den Terminals der VT2xx-Serie die sogenannte Compose-Taste. Um
     hier ein Sonderzeichen zusammenzusetzten mu zuerst 'Compose'
     bettigt werden, dann die zwei Zeichen. Also:
        Compose, 'i', 'j'  ergibt ''.
     Beim Atari gilt analog:
        ALTERNATE kurz drcken, 'i', 'j'  ergibt dann ''.
     WICHTIG ist, da die Alternate Taste kurz bettigt wird, ohne
     dabei eine sonstige Taste zu bettigen (shift, control, etc.).
     Denn eine Tastenkombination wie ALT-Q darf nicht gestrt werden!

     Wenn eine Compose-Sequenz erfolgreich begonnen wurde, dann ertnt
     ein Tastaturklick (auch wenn der 'normale' Tastaturklick
     abgeschaltet wurde).

     Wenn eine Compose-Sequenz ungltig war ('z' und 'x' ergibt nichts
     sinvolles), dann ertnt die 'Glocke' (Bell), ungeachtet ob sie
     abgeschaltet war oder nicht.

     Eine begonnene Compose-Sequenz wird abgebrochen durch ESC,
     BackSpace oder eine beliebige andere Taste, die keinen ASCII-Code
     besitzt (F-taste, Cursortaste etc).

     Die Reihenfolge der beiden Primrzeichen spielt keine Rolle. ber
     das CPX kann diese Verhalten gendert werden.


  3. ALT-NNN: Die Lieblingsmethode fr Bithacker und MS-DOS-Freaks.
     Alternate drcken und den enstprechenden ASCII-Code dezimal auf
     dem Zehnerblock eingeben. Diese Funktion ist eher der
     Vollstndigkeit halber mit implementiert; ab TOS 2.06 / 3.06 ist
     sie schon im TOS drin.



Benutzung des CPX:
------------------
  In der Infozeile erscheint die CPX-Version, das Erstellungsdatum
sowie der name des Autors (meiner also.... wow....)

  In der linken Hlfte befinden sich vier Knpfe, die mit
        Compose
        Extkey
        ALT-nnn
        neue Keytab
  bezeichnet sind. Damit werden die einzelnen Funktionen des residenten
Programms aktiviert. Die ersten drei entsprechen den drei oben
erklrten Verfahren zur Erzeugung von Sonderzeichen; der vierte
Schalter hat nur Sinn, wenn auch eine andere Tastaturbelegung geladen
ist.

  Auf gleicher Hhe in der linken Hlfte, unter der berschrift
'Compose Modus' sind zwei Popup-Mens versteckt. Damit wird das
'Benehmen' der Compose-Funktion eingestellt. Der ersten Knopf schaltet
zwischen
        > DEC (VT2xx) Mode              und
        > MultiChar Mode                um.
  DEC Mode: Die Compose-Funktion erwartet nach Auslsen einer Compose
Sequenz zwei Buchstaben. Die werden 'verschluckt', und nur das
eventuell erzeugte Sonderzeichen erscheint auf dem Bildschirm. Dieses
Verfahren ist sehr vertrglich mit kritischen Programmen (-> siehe
Liste)
  MultiChar Mode: Nun werden die eingegebenen Zeichen nicht mehr
unterdrckt, dafr wird genau wie bei Extkey zuerst ein Backspace und
dann das neue Zeichen geschickt. In diesem Modus ist eine
Compose-Sequenz nach zwei Zeichen nicht zwingend abgeschlossen. Die
Tabelle 'VIETNAM' benutzt diese Besonderheit - sie enthlt 3-fach
zusammengesetzte Zeichen!


  Das zweite Popup-Men schaltet zwischen
        > Order indifferent             und
        > Order sensitive               um.
Order sensitive bedeutet, da Compose genau wie Extkey nun die richtige
Reihenfolge bei den Eingabezeichen erwartet. Die Sequenz ALT/^/o wird
nicht erkannt, es mu schon ALT/o/^ lauten. Normal ist aber der Modus
'order indifferent'.


  In der dritten Zelle ist der Name der aktuell geladenen Datei
angegeben. Falls keine geladen ist, steht hier die Angabe
'---system---'. Nur wenn eine andere Datei geladen ist, ist der oben
erwhnte Schalter 'Neue Keytab' gltig.

  Schlielich ist unter dem Knopf 'exec' noch ein drittes Popup-Men
eingebaut, das die Punkte
        1> Lade *.KBD
        2> Lade Compose-Tab
        3> Systemtabelle!
enthlt.
1) ldt eine 384-byte groe Tastatur-Umbelegungstabelle nach. Beispiele
fr solche Dateien des alten Formats (wie von JAMES.ACC benutzt) liegen
im Ordner CKB_KBD.
2) ldt die neuen CKB-Dateien. Diese enthalten neben einer
(optionalen!) Umbelegungstabelle auch andere Compose-Tabellen.
3) Wenn alles schiefgeht - oder wenn das CPX beim Booten _keine_ Datei
mehr nachladen soll, kann hiermit die geladene Datei entfernt und
unschdlich gemacht werden.



  Die restlichen Bedienelemente sind CPX-Standard, sollten bekannt
sein.




Hinweise:
---------
  Utilities, die hnliche Funktionen haben, sollten besser
entfernt/abgeschaltet werden. Bei JAMES.ACC also 'Extkey' ausschalten.

  Leider gibt es immer noch Programme, die zusammengesetzte Zeichen
nicht akzeptierten oder sogar fehlerhaft darauf reagieren! Das ist dann
eher die Schuld des Hauptprogramms als die von COMPOSE.

  Das CPX-Modul luft erst ab TOS 1.4. Sorry, aber:
    WER XCONTROL MIT TOS 1.0 ODER TOS 1.2 BENUTZT WIRD MIT
    BOMBEN NICHT UNTER 5 STCK BESTRAFT!!

  Kleiner Trost: COMPOSE.PRG selbst luft auf allen TOS Versionen. Da
die Schnittstelle zu Compose.prg genau festgelegt ist, drfte es ein
Leichtes sein, ein eigenes Steuer-ACC zu basteln (mir fehlt dafr die
Zeit)!




Problemkinder:
--------------
  Proggie:                      Problemchen:

  TURBO C / PURE C Editor       Extkey-modus geht nicht)
  1.10 < TEMPUS < 2.10          Nix geht. Tempus mu erst gepatcht
                                werden
  TEMPUS 2.10                  Extkey erst nach Umbelegung von
                                       CONTROL-Backspace in Tempus!)
  EDISON                        Extkey geht nicht.
  7UP (shareware editor)        id.
  CYPRESS                       id.
  WORDFLAIR 1                   id.
  MAXON PASCAL Editor           Compose und ALT-nnn geht nicht, dafr
                                Extkey!
  NKCC-Routinen                 ALT-nnn mit nnn<32 ergibt Falschmeldung,
                                bei Compose wird die ALT-Taste als
                                gedrckt gemeldet.



Bekannte Fehler:
----------------
CPX:
    v0.8:   -keine-
    v0.7:   Fileselector gibt falsche Pfade an
    v0.1:   Testversion

TSR:
    v1.0    -keine-
    v0.9:   unter TOS 1.0 .. 1.4 strzte das System beim Bettigen der
            ALT-Taste manchmal ab. Ursache: die (nicht genug bekannte)
            Schlamperei im XBIOS-Dispatcher des TOS. Mit KAOS 1.4.2
            sowie mit TOS >1.6 klappte es.
    v0.8:   Zeiger wurden falsch gesetzt -> beseitigt
    v0.7:   erste ffentliche Version

=======================================================================


PROGRAMMERS MANUAL
=======================================================================

Achtung: Aus Platzgrnden - und weil sicherlich 99% aller Anwender das
PROGRAMMERS MANUAL nicht bentigen - haben wir hier den Text gekrzt. 
Alle, die das PROGRAMMERS MANUAL bentigen, mgen dies bitte bei ihrem
nchsten papyrus update Wunsch mitteilen und bekommen dann die hier 
fehlenden Textpassagen mitgeliefert. Wir bitten um Verstndnis.

Ihr R.O.M. Software Team

ANHANG 2:
STANDARD-COMPOSE-TABELLEN
=======================================================================

#  + +
^  ^ ^
|  | `-- zweites Tastaturzeichen
|  `---- erstes Tastaturzeichen
`------- ergibt dieses (Compose) Zeichen!

Wenn weitere Kombinationen exisitieren, sind diese durch Kommata
abgetrennt.


----------------
#  + +
@  a a , A A
[  ( (
\  / /
]  ) )
{  ( -
|  / ^
}  ) -
  C ,
  u "
  e '
  a ^
  a "
  a `
  a .
  c ,
  e ^
  e "
  e `
  i "
  i ^
  i `
  A "
  A .
  E '
  a e
  A e
  A E
  o ^
  o "
  o `
  u ^
  u `
  y "
  O "
  U "
  c / , C / , c | , C |
  L - , l - , L _ , l _
  y - , y = , Y - , Y =
  P t , p t    (Peseta)
  f -
  a '
  i '
  o '
  u '
  n ~
  N ~
  a - , a _
  o - , o _
  ? ?
  1 2
  1 4
  ! !
  < <
  > >
  a ~
  o ~
  O / , O |
  o / , o |
  o e
  O E , O e
  A `
  A ~
  O ~
    "
    '
    +
  P P , P | , P /
  p p , p | , p /
  c o , C O
  r o , R O
  t m , T M
  i j
  I J , I j

  S O , s o
    ^
  O O , o o
  s s    (BETA, EsZet)
  P I , p i
  S S
  u / , u |
  O -
  = -
  + -
  > - , > _ , > =
  < - , < _ , < =
  : -
  = ~
    o  (SPACE + o)
    *  (SPACE + *)
    .  ( id...)
    v
    n
    2
    3
    _

----------------

=======================================================================
- text written 920202 by @pf68030 -------------------------------------
=======================================================================

