Medoosa

News

2003-08-20: version 1.2 released, in RPMs and tar.gz, fixing compilation with GCC 3.

What is it?

Medoosa is a documentation tool for C++ that can produce UML class diagrams including generalizations and associations. Corrections can be made interactively in a diagram editor (Dia) and are fed back into the source as Javadoc-style comments. At this time, the layout must still be done by hand. Some code is already present to produce the layout with Graphviz.

Medoosa is released under the terms of the GNU General Public License.

I wrote Medoosa for my master's thesis at the Charles University (Faculty of Mathematics and Physics, Department of Software Engineering). The text of the thesis and attached diagrams can be downloaded in PostScript:

• The thesis.
• A diagram of Medoosa 1.0, produced by itself.
• A diagram of Nachos, an instructional operating system.

The Graphviz experiments produce examples like this.

Download

You will need both Medoosa and CcDoc from the project file area.

CcDoc is a Javadoc-like documentation tool by Joe Linoff. Medoosa uses its older version, 0.7a, enhanced to output in XML, as a parser.

Other requirements

• Linux and X Windows.
• Dia, a diagram editor with UML support. Version  0.88.1 or later is required. (Earlier versions did not use the declared XML namespace in saved files.)
• The Gnome XML and XSLT libraries, preferably the latest versions. Tested with libxml2 2.4.17 and libxslt 1.0.13.

(4XSLT is no longer required.)

Installation

Simply install the RPMs, the tedious process described in Appendix A.2 of the thesis is no longer necessary.

Examples

As a demonstration, the Nachos sources were processed with Medoosa. You can compare:

• The original distribution.
• An annotated distribution, used to generate this diagram.

Contacts

There is a mailing list about Medoosa. See also the standard SourceForge project summary.

Martin Vidner, $Date: 2003/08/20 15:58:37 $

Hosted at SourceForge.