EOModelDoc
Overview
EOModelDoc is a command line tool to generate HTML documentation of a set of EOModels. It is a replacement for EOReporter (which will not work on Leopard and newer releases of OS X). EOModelDoc was funded by the Apple iTunes Store and released to the community.
On the WOLips side, from version 3.3.x, Entity Modeler has a Documentation tab on all of the elements of a model that lets you record HTML documentation for your model, entities, attributes, etc. There is even an HTML preview. You can then run eomodeldoc to produce documentation much like javadoc for your model.
Future Plans
From Mike Schrag: There's not a nice build process for this one either, yet, because it includes all of the eclipse dependencies in the single jar. Eventually I'll make this nicer and include it actually inside of Eclipse. There are also modifications to the ERNeutralLook coming soon that will display popup help for you models based on the model documentation.
Download and Example Output
This is an example of the current state of eomodeldoc (the default templates are not done, but it will give you an idea of what it can do). The templates are all Velocity-based, and you can override them with custom versions. This was run in the BugTracker project folder. This model does not have documentation added to it with the new Entity Modeler yet, so it looks a little more bare than it would if it was documented properly. I'll probably document it just to have a full example to show.
View Example Output
Usage
Still working on all the model loaders, but you should be able to do
java jar eomodeldoc.jar model /path/to/model.eomodeld output /tmp/ jar eomodeldoc.jar
eomodeldoc
(will load all the models in the modelgroup based on your eclipse or
IDEA project files ..... allegedly ... still working the kinks out on
this)
or
java modelgroup /path/to/project output /tmp/
eomodeldoc
(i haven't tried that one yet)
or
java jar eomodeldoc.jar output /tmp/eomodeldoc
from inside your project
Tthe usage syntax of the eomodeldoc.jar:
mbp:~ th% java jar eomodeldoc.jar output /path/to/output/folder eomodeld -modelgroup pathtoworkingdir -templates pathtotemplates
eomodeldoc