[Allegro] FLEX-Doku-Ueberarbeitung

Bernhard Eversberg ev at biblio.tu-bs.de
Do Jul 21 09:23:29 CEST 2011


Die Überarbeitung der FLEX-Doku hat einen gewissen Abschluß erreicht:
Alle Dateien x*.rtf wurden inhaltlich aktualisiert und hinsichtlich
Verständlichkeit überarbeitet und verbessert.
Im SVN liegen sie alle bereit.

Eine letztens mal vorgeschlagene formale Überarbeitung mit einer
einheitlichen Strukturierung etc. konnte in diesem Durchgang noch nicht
geleistet werden. Wir müssen einfach der inhaltlichen Stimmigkeit
Priorität geben vor Formalien, wie sehr diese auch dem Verständnis
dienen mögen. (Solcherlei Aufgaben müßten überdies, im Sinne von 
OpenSource,
nicht unbedingt von uns zu erledigen sein, vielleicht können das andere
sogar besser...)
Übersichtlicher strukturiert wurden die umfangreichen Texte zu den
Befehlen "if" und "set".

Die Überarbeitung wurde auch deshalb jetzt notwendig, weil die Freigabe
der Quellen für  acon  bevorsteht. Und zentraler Teil von acon ist der
(avanti-spezifische) Befehlsinterpreter für FLEX.

Sicher wird, wie das immer so ist, der eine oder andere Experte gleich
beim ersten Zugriff über neue/alte Unstimmig-, -erfreulich- oder
-begreiflichkeiten stolpern, das ist wohl unvermeidlich. Mitteilungen
sind willkommen.

Noch nicht überarbeitet ist die Version auf dem Webserver! Diese mag
wohl ein Desiderat sein, würde aber viel zusätzliche Arbeit machen,
die ebenfalls noch nicht geleistet werden konnte. Vielleicht sollten wir
insgesamt alles auf HTML umstellen und dann in a99 per JanaS benutzbar
machen statt wie bisher im Anzeigefeld mit RTF?

B.E.




Mehr Informationen über die Mailingliste Allegro