Ichthyostega
c39c49b998
BoUML was close sourced by its author and consequently dropped from Debian. We use UML as a drawing and documentation tool, and thus we'll just start over with the /obvious/ choice, which is the Umbrello tool.
76 lines
3.6 KiB
Text
76 lines
3.6 KiB
Text
Some Hints regarding UML usage
|
|
==============================
|
|
|
|
For perspective, we have no high stakes in our UML model, since we use UML mostly as a drafting and design tool.
|
|
We never put much effort into creating a consistent model -- just keeping the leftovers from some attempts at
|
|
documentation around can be handy at times. Incidentally, we did the very first code bootstraping of Lumiera with
|
|
the help of Bouml, but did not use any code generation tools since then.
|
|
|
|
UML software
|
|
------------
|
|
|
|
The choices for alternatives seem to be rather limited. Since UML used as a higher level programming environment
|
|
can be considered a failure, UML tooling environments are largely a playground for commercial offerings. You know:
|
|
that kind of silver bullet your boss always nags you to use in order to improve your productivity. Thus, what remains
|
|
are more or less self contained UML drawing solutions. Most of which, no surprise, are Java applications.
|
|
Including the Eclipse plugin, and ArgoUML, the dinosaur.
|
|
|
|
Talking about obvious choices, we get
|
|
|
|
ArgoUML:: quite capable but also somewhat crappy and hard to use.
|
|
Gnome DIA:: ...which is really just a drawing tool
|
|
Umbrello:: from the KDE Software Collection.
|
|
|
|
|
|
Umbrello
|
|
~~~~~~~~
|
|
As of 11/2016, we abandon our existing BoUML model and start over from scratch, +
|
|
using the version of Umbrello available from Debian/stable (`umbrello-4:4.14.2-1`)
|
|
|
|
|
|
BoUML
|
|
~~~~~
|
|
When the Lumiera project started, BoUML was a widely known alternative: it was a native application,
|
|
fast, reliable, with even some round trip capabilities. The generated code was highly configurable,
|
|
we were able to produce valid GNU style on our initial code generation round.
|
|
|
|
http://www.bouml.fr/[Bouml] was written by Bruno Pages (bouml@free.fr).
|
|
It used to be OpenSource, released under GPL up to
|
|
http://www.bouml.fr/historic_old.html[Version 4.21].
|
|
Some years ago, there was a somewhat confusing move of the original author,
|
|
who blamed ``Wikipedia editors and copyright violation'' to destroy his work.
|
|
Seemingly the point of contention was the licensing of Bouml logo images on
|
|
wikimedia. See the http://en.wikipedia.org/wiki/Talk:BOUML[Wikipedia page]
|
|
for some indirect hints. Judging from further indirect mentions, there must
|
|
have been a flame war somewhere. Anyway, the author went closed source.
|
|
As a consequence, Bouml was dropped from Debian, since it relies on qt3.
|
|
|
|
- bouml usesd a custom, text based session format for its UML-``Projects''
|
|
- we tracked all these bouml session files in our Git tree
|
|
- *minor problems*
|
|
|
|
* the actual format is slightly dependent on the actual bouml version in use footnote:[as of
|
|
1/2015, we still use Version *`4.21`* of bouml, which is the Version found in Debian/Squeeze. It runs
|
|
without modification on Debian/Wheezy, but can no longer be used on Debian/Jessie]
|
|
* and the layout of the rendered diagrams is unfortunatly _highly dependent on the installed fonts_.
|
|
* for that reason, we checked any _relevant_ diagram images also into Git. See `doc/devel/uml`
|
|
Here, ``relevant'' means all diagram images, which are linked into the website or the TiddlyWiki
|
|
|
|
|
|
Housekeeping
|
|
^^^^^^^^^^^^
|
|
some practical hints
|
|
|
|
- you can find out which images are used in the TiddlyWiki: just grep for the link to an png:
|
|
|
|
egrep 'fig.+\.png' renderengine.html
|
|
|
|
- you can grep over the bouml project files, to find out about the numbers and titels of the diagrams:
|
|
|
|
for D in *.diagram; do D=${D%.diagram}; echo ===$D===; egrep "diagram $D" *; done
|
|
|
|
- by a variation of this techique, you can find obsoleted diagrams left back by bouml:
|
|
|
|
for D in *.diagram; do D=${D%.diagram}; if ( ! egrep -q "diagram $D" *) ;then echo Orphaned Diagram $D;fi; done
|
|
|
|
|