Re: Source Code Dokumentation mit DocBook

* 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.


Gruß,
Bernhard

-- 
Wenn Du ein Schiff bauen willst, so trommle nicht Männer zusammen, um Holz zu
beschaffen, Werkzeuge vorzubereiten, Aufgaben zu vergeben, und die Arbeit 
einzuteilen, sondern lehre die Männer die Sehnsucht nach dem weiten endlosen Meer.
	-- Antoine de Saint-Exupery

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (GNU/Linux)

iD8DBQFBe5qPiGU2lt2vZFQRAqIOAKCAmKEkqe5+4QbCCmrAajOgYhhKvwCgrfZo
ZCBqpbtxMwWmBocTzqPBpLM=
=Iads
-----END PGP SIGNATURE-----