Re: Documentation and UML diagrams

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Jesus M. Castagnetto, el jueves 29 de mayo a las 19:38 me escribiste: > I've been playing on my home Linux box with Dia > (http://www.lysator.liu.se/~alla/dia/) and Autodia > (http://droogs.org/autodia/index.html), to create UML diagrams from my PHP code > and my SQL dbs. > > Autodia looks like a nice tool to generate Dia diagrams, see for example a > (cleaned up) diagram generated by running Autodia on PEAR::Math_Vector at: > > http://www.scripps.edu/~jesusmc/stuff/Math_Vector.dia > > and as a PNG at: > > http://www.scripps.edu/~jesusmc/stuff/Math_Vector.png > > I was wondering, given that the XML for Dia is not altogether dreadful, and > that phpDocumentor (my favorite documentation tool for PHP code), already groks > the structure of the code, maybe it will be a nice idea to generate a Dia > output, basically a similar idea of generating DocBook output, just in this > case the 'documentation' is an UML diagram. Doxygen[1] (and many other programs that generates diagrams) uses GraphViz[2] to make UML diagrams. Even when the PHP support it's not the best it's a good tool. If you'r looking for the reverse process (generate code from UML diagrams) you can try dia2code[3] (I've made a patch for generating PEAR Coding Standars compatible code that it's now on dia2code) or Umbrello[4] UML Modeler (that it's much more complete than DIA for UML). Umbrello can generate PHP code but not PEAR compatible, but there's a tool similar to dia2code to generate code from an XMI[5] diagram (XMI is a OMG[6] open XML standard for UML diagrams), the format used by Umbrello (and ArgoUML, I think). The tool is xmi2code[7] and it's roundtrip code generator that can update the code too, and it can generate PEAR compatible code. [1] http://www.stack.nl/~dimitri/doxygen/ [2] http://www.research.att.com/sw/tools/graphviz/ [3] http://dia2code.sourceforge.net/ [4] http://uml.sourceforge.net/ [5] http://www.omg.org/technology/documents/formal/xmi.htm [6] http://www.omg.org/ [7] http://xmi2code.sourceforge.net/ - -- LUCA - Leandro Lucarella - Usando Debian GNU/Linux Sid - GNU Generation - ------------------------------------------------------------------------ E-Mail / JID: luca@lugmen.org.ar GPG Fingerprint: D9E1 4545 0F4B 7928 E82C 375D 4B02 0FE0 B08B 4FB2 GPG Key: gpg --keyserver pks.lugli.org.ar --recv-keys B08B4FB2 - ------------------------------------------------------------------------ Women who want to be equal to men lack imagination. -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (GNU/Linux) iD8DBQE+1uSWSwIP4LCLT7IRAqRuAKCIhKZygoQskbhGAjqQmhMoEZDh7wCfWyqN yr4PC7b7uYF7xUNbLK7Xi6Q= =9GWj -----END PGP SIGNATURE-----