Re: Source Code Dokumentation mit DocBook
Bernhard Walle <[email protected]>
| Newsgroups | gmane.linux.suse.programming |
|---|---|
| Message-ID | <[email protected]> |
* Stefan Lang <[email protected]> [2004-10-25 12:48]: > 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. Ich persönlich verwende db2pdf. Gruß, Bernhard -- "Unix is the most user friendly system I know, the point is the it is really selective about who is indeed its friend." -- Luigi Genoni
signature.asc
(application/pgp-signature, 189 B)
-----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (GNU/Linux) iD8DBQFBfN66iGU2lt2vZFQRAg9dAKCnaepIpTyhFm06/dECDlhv1naucwCeLNKk J/tZ8P2n4f/1Mj7IDG7ZbQ4= =fVpw -----END PGP SIGNATURE-----