Re: Source Code Dokumentation mit DocBook

Am Sonntag, 24. Oktober 2004 14:05 schrieb Bernhard Walle:
> * Stefan Lang <[email protected]> [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

-- 
Um die Liste abzubestellen, schicken Sie eine Mail an:
    [email protected]
Um eine Liste aller verfügbaren Kommandos zu bekommen, schicken
Sie eine Mail an: [email protected]