Generering av Python-dokumentasjon

[A_N_K]

Kan noen gi meg en kjapp innføring i generering av Python-dokumentasjon? Jeg er fra før av vant til Doxygen, men det kunne virke som prosessen for å dokumentere Python var noe mer kronglete (inntrykket er kanskje farget av sløvhet fra min side). Ville det forresten være mulig å utvide settet av støttede dokumentasjonstags uten å endre selve verktøyet, dvs. skrive en LaTeX-makro f.eks? Det jeg tenker på er å dokumentere såkalte aspekter i koden, hvor jeg samler referanser til aspekter spredt utover i koden, men dette er kanskje mulig ved kreativ bruk av eksisterende tags.

[zeitgeist]

Har ikke noe spesielt greie på det, men tror det er grei skuring. Har du kikket på pydoc?

<http://docs.python.org/lib/module-doctest.html>

[Gronz]

Har ikke noe spesielt greie på det, men tror det er grei skuring. Har du kikket på pydoc?

<http://docs.python.org/lib/module-doctest.html>

Bruker Epydoc for alle Python-prosjektene mine. Er en "forbedret" versjon av Pydoc.

http://epydoc.sourceforge.net/

[A_N_K]

Ok, takk skal dere ha. Kikker nå på happydoc og epydoc.

 

Edit: Ser ut som jeg lander på epydoc, det virker ennå noe fattig i forhold til doxygen, men brukandes like fullt :]

Endret 17. april 2005 av A_N_K