[Allegro] Neues Handbuch: Was ist besser?

[Bernhard Eversberg]

Das Handbuch zu V26 ist da und teilweise schon versandt.
Die Anwenderschaft hatte uns im Vorjahr, anlaesslich des
Festschreibungsfestes zu V25, einige Merkposten mit auf den
Weg gegeben 
(http://sun250.biblio.etc.tu-bs.de/pipermail/allegro/2005-May/021921.html)
die wir Punkt fuer Punkt abgearbeitet haben:

"... die Beschreibung,
Kurz und ohne Uebertreibung!"
   Dem Wunsch nach Kuerze kommen wir dadurch entgegen, dass das
   neue Handbuch um keine Seite laenger ist als das alte, obwohl
   V26 definitiv mehr kann als V25.
   Uebertreibungen zu meiden ist selbstverstaendliches Bemuehen
   eines Sachtextes. Anfluege davon, wo immer sie auffielen,
   entkamen nicht ihrer Ausmerzung.

"Finden muss man, was man braucht,
wenn sie wirklich etwas taugt."
   Dazu wurde erstens das Register weiter angereichert,
   zweitens die Querverweise auf Online-Texte vermehrt,
   zumal diese oft noch weiteres Material enthalten und
   aktueller sein koennen als das Handbuch.

"Neue Wege soll sie weisen,
Alleen, keine schmalen Schneisen!"
   Sowohl zum Verstaendnis wie zu den Funktionen wurden die
   Zugaenge verbreitert und Schwellen abgeflacht.
   Nichts hat das Anwendungspotential so verbreitert wie FLEX.
   Ganz neu ist eine fuenfseitige alphabetische Kurzliste
   der FLEX-Befehle, geeignet zum Einstieg und zur Orientierung.

"Was drin steht, sei immer richtig,"
   Alle gemeldeten und selbst entdeckten Unstimmigkeiten
   wurden bereinigt

"alles fehle, was nicht wichtig."
   Alte, nicht mehr relevante Sachen flogen raus, wenig
   genutzte Teile wurden gestrafft, so z.B. Kap. 3.

"Alles soll man gleich verstehen,"
   Hm. Wenn "gleich" soviel wie "ohne Vorkenntnisse" heissen
   soll, geraten wir in Konflikt mit dem ersten Punkt...
   Ein Beispiel einer Verbesserung aber weiter unten.

"was man liest, das muss auch gehen."
   Dies freilich ist etwas ganz anderes! Was nicht funktionierte
   oder anders als das Handbuch es behauptete, wurde bereinigt
   bzw. mit dem Handbuch in Uebereinstimmung gebracht.

"Keine Frage bleibe offen,
wird von Fehlern man betroffen!"
   Einerseits wird im Text auf moegliche Fehler hingewiesen, zum
   andern wurde der Anhang C weiter ergaenzt, wo man die Fehler-
   meldungen nachschlagen und Hinweise zur Behebung finden kann.


Schau'mer mal, was beim nächsten Fest wieder alles gefordert
werden wird ...

--------------------------------------------------------------------
Beispiel zur Verständlichkeit
Am Ende von Kap. 4 steht jetzt:
(und das STAND auch schon im Online-Text  ac4.rtf)

Das Komma wirkt so: Zuerst wird das gesucht, was vor dem Komma steht.
Das dann gefundene Datenfeld wird von der Stelle ab zum Feldende hin
nach der Zeichenfolge durchsucht, die hinter dem Komma steht. Wenn man
also z.B. die Zeichenfolge #3,goethe eingegeben hat, bedeutet das:
Zuerst wird nach #3  gesucht. Damit werden dann Feldnummern wie #30,
#31, ...  gefunden. Jedes dieser Felder wird durchsucht, und zwar exakt
ab dem Zeichen, das hinter der Zeichenfolge #3 steht.  Das Komma kann
somit auch als "Mitteltrunkierung" gelten:
Die Eingabe  atom,energie würde auch das Wort Atomkernenergie oder die 
Phrase "Atom- und Fusionsenergie" finden. Nichts jedoch, wenn "energie"
nicht im selben Feld steht.