Am Sonntag, 24. Oktober 2004 14:05 schrieb Bernhard Walle:
* Stefan Lang
[2004-10-24 12:06]: Meinen Lehrern ist das leider nicht ausreichend. Was noch fehlt wäre eine Gesamtübersicht, Klassenhierarchie und allgemeine Beschreibungen, wie ein bestimmtes Problem gelöst wurde und warum. Außerdem Beispiele an welchen Stellen man die Quellen verändern muss um das Programm um bestimmte Funktionalitäten zu erweitern usw.
Achso. Kann man schon auch mit Doxygen machen. Beispielsweise wurde die Doku http://www.nongnu.org/avr-libc/user-manual/index.html komplett mit Doxygen realisiert.
Mit Docbook geht's auch, ich würde wahrscheinlich direkt LaTeX nehmen, mit listings.sty für Quellcodebeispiele. Aber das ist alles eine Frage des persönlichen Geschmacks.
Habe ein Buch über DocBook auftreiben können und damit begonnen. Das konvertieren nach HTML funktioniert einwandfrei, nur mit fop nach PDF mit den Stylesheets von Norman Walsh, die bei SUSE dabei sind, gibt fop zuerst einige Fehlermeldungen aus und wird dann mit einer java.lang.NullPointerException beendet. Mfg, Stefan