Hallo,
die letzte Snapshot.DQ (CVS Verzeichnis /doc im v3.40-branch)
wurde jetzt von mir mit den Kurzeintr�gen komplettiert.
Diese Eintr�ge erscheinen nicht in Snapshot.Txt, wenn es mit
DocForm formatiert wird.
Um diese einfach zu extrahieren und damit eine Kurzfassung
- in der Art der Version.Txt - zu gewinnen, habe ich ein
kleines Programm Snapx.Exe in das Verzeichnis /Trial geladen.
Mit Snapx ?/-?/-h zeigt es ein Usage: an, ebenso auch
wenn es ohne Parameter aufgerufen wird und keine Snapshot.DQ
(Default-Infile) im Verzeichnis findet. Das Default-outfile
ist Extrakt.Txt. Die Extraktion ist ebenso einfach mit
g�ngigen Textools der Kommandozeile unter DOS m�glich:
Bsp: xgrep "^%" snapshot.dq | sed s/%// > Extrakt.Txt
Daher habe ich darauf verzichtet, DocForm damit zu befrachten.
Zum Stand der allgemeinen Dokumentation ist der derzeitige
Stand der XPoint.DQ/Txt durchaus ansehbar inzwischen.
Ebenso wie auch die Snapshot.Txt, die jetzt mit Seitenzahlen
und einem ordentlichen Inhaltsverzeichnis ausgestattet ist.
Zur inhaltlichen Qualit�t der letzteren w�re deutlich hervorzu-
heben, da� es Michael Heydekamp damit tats�chlich geschafft hat,
nicht nur detailliert, sondern nachvollziehbar zu dokumentieren.
Ich war angenehm �berrascht, wie einfach es war, die Angaben
auf das Wesentliche zu verk�rzen.
Vielleicht ist eine solche Light-Version auch wieder f�r die
FreeXP-Homepage als einfacherer �berblick �ber den gesamten
Entwicklungsgang des 16-Bit-XP ab der OpenSource-�ra zu gebrauchen.
Hinweise auf etwaige M�ngel oder Verbesserungsvorschl�ge zur
Dokumentation werden gern von allen FreeXP-Entwicklern beachtet.
Insofern habe ich keinen Zweifel, da� auch die Dokumentations-
m�ngel in absehbarer Zeit abgestellt werden k�nnen.
Dann k�nnen ja die Spezialisten f�r XML wieder ran und :)
Gru�,
Joachim
------------------------------------------------------------------------
FreeXP Entwickler-Mailingliste
[EMAIL PROTECTED]
http://www.freexp.de/cgi-bin/mailman/listinfo/dev-list
