It would be kool to take a look at it... But bear in mind that part of the OM for the flow is written in JavaScript (system.js), and part in Java (o.a.c.c.flow and o.a.c.c.flow.javascript packages)... The _best_ thing would be to have an "IDL" javadoc...
Pier
Try these, they both work.
http://www.stack.nl/~dimitri/doxygen/
http://openorb.sourceforge.net (http://www.osm.net/doc/orb/org/openorb/compiler/doc/IdlDoc.html)