Re: UML (or any pictural language) diagram of Batik documentation in SVG?

[Vincent Hardy <vh...@eng.sun.com>]

George,

I think the idea of generating SVG based class documentation is 
interesting, but, just to clarify, what we have now is just a couple
class diagrams, manually drawn, that I need to clean up and 
turn into SVG. This is a modest documentation and it is on my todo 
list to make that publicly available (as soon as I am done).

My understanding of your proposal is to work on a tool to automatically
generate a kind of SVG-based javadoc (I would think focusing on the 
class/packages dependencies) and I think it is a great idea. If you'd
like to contribute, please do, I would love to have something like
this.

I would think there may be multiple options that could be interesting.
One would be a UML to SVG transcoder. Another idea would be to create
an SVG doclet for the javadoc engine...

Any thoughts or comments?
V.

r d wrote:
> 
> Hello Vincent (and the rest of the (BOST),
> 
>        I had a chat with you and some others on the
> Batik_open_source_team (BOST) yesterday at the java.sun.com site. "SVG
> and Batik". I went by the moniker "ROBERT". The Batik team did a great
> job:-)  Thank you again!
> 
> I asked a question about a having Batik team offer diagrams of the
> Batik documentation in pictorial form. Some of the team expressed the
> idea of presenting the documentation is SVG form ( that would
> excellent)!
> 
> I would love to see an open-source SVGDOC system for java .....I would
> love to help :-)
> 
> I think that having a "pictorial understanding" of how objects work
> together is essential for building large projects....yet in the
> open-source community, I find the standard "old-school" Johann
> Guttenberg "text based" system for describing documentation.
> But....with a text based Vector graphic language that can be read by
> any device that can read ascii (viewing it is another story!) .
> documentation can be presented in "pictorial form/text form".....just
> a thought.
> 
> end of rant:-)
> 
> I would take great pleasure in seeing the diagrams (if you wish to
> show them to the public) and I would love to help out in making a
> SVG_TO_DOC or DOC_TO_SVGsystem. (my skills:: ruff my passion:: true
> :-)
> 
> Thank you
> Robert A. DiBlasi
> 
> 
> 
> 
> 
> ----------------------------------------------------------------------
> Get your FREE download of MSN Explorer at http://explorer.msn.com
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: batik-dev-unsubscribe@xml.apache.org For
> additional commands, e-mail: batik-dev-help@xml.apache.org

Re: UML (or any pictural language) diagram of Batik documentation in SVG?

[Paul Russell <pa...@luminas.co.uk>]

* Vincent Hardy (vhardy@eng.sun.com) wrote :
> My understanding of your proposal is to work on a tool to automatically
> generate a kind of SVG-based javadoc (I would think focusing on the 
> class/packages dependencies) and I think it is a great idea. If you'd
> like to contribute, please do, I would love to have something like
> this.

Just a thought -- worth talking to the Alexandria guys and gals about
whether they'd like to include this? Alexandria already has the XML
Javadoc doclet and various other things. This might be as simple as an
XSLT stylesheet to translate the javadoc XML to SVG.

> I would think there may be multiple options that could be interesting.
> One would be a UML to SVG transcoder. Another idea would be to create
> an SVG doclet for the javadoc engine...

Again, may not be needed, given the XML doclet.


Paul.

-- 
Paul Russell                                 Email:   paul@luminas.co.uk
Technical Director                             Tel:  +44 (0)20 8553 6622
Luminas Internet Applications                  Fax:  +44 (0)870 28 47489
This is not an official statement or order.    Web:    www.luminas.co.uk

Re: UML (or any pictural language) diagram of Batik documentation in SVG?

[Curt Arnold <Cu...@hyprotech.com>]

There is definitely interest in Batik on the ArgoUML mailing
list, too.  I'm going to be gone skiing over the weekend, but
I'll try to see how far I can go with it next week.

Automatically generating "good" UML diagrams of complex systems
is a pretty daunting task.  I think that there will always need
to be some human involvement to determine which classes should
appear on a particular diagram and their relative arrangement.

We are in a refactoring mode right now in ArgoUML and though
their are dire warnings about using the 0.9 alpha version, it has
fixed some issues that made generating diagrams from imported or
reverse-engineered models a real pain.  Unfortunately, I think
the SVG export option may have temporarily disappeared from the
menus in 0.9.



[ Original message repeated for the benefit of the ArgoUML list ]

----- Original Message -----
From: "Wong Kok Wai" <wo...@pacific.net.sg>
To: <ba...@xml.apache.org>
Sent: Wednesday, January 24, 2001 6:27 PM
Subject: Re: UML (or any pictural language) diagram of Batik
documentation in SVG?


> According to this (http://argouml.tigris.org/features.html),
Argo/UML can
> export to SVG. May worth a consideration.
>
> Vincent Hardy wrote:
>
> > George,
> >
> > I think the idea of generating SVG based class documentation
is
> > interesting, but, just to clarify, what we have now is just a
couple
> > class diagrams, manually drawn, that I need to clean up and
> > turn into SVG. This is a modest documentation and it is on my
todo
> > list to make that publicly available (as soon as I am done).
> >
> > My understanding of your proposal is to work on a tool to
automatically
> > generate a kind of SVG-based javadoc (I would think focusing
on the
> > class/packages dependencies) and I think it is a great idea.
If you'd
> > like to contribute, please do, I would love to have something
like
> > this.
> >
> > I would think there may be multiple options that could be
interesting.
> > One would be a UML to SVG transcoder. Another idea would be
to create
> > an SVG doclet for the javadoc engine...
> >
> > Any thoughts or comments?
> > V.
> >
>
>
> ---------------------------------------------------------------
------
> To unsubscribe, e-mail: batik-dev-unsubscribe@xml.apache.org
> For additional commands, e-mail: batik-dev-help@xml.apache.org

Re: UML (or any pictural language) diagram of Batik documentation in SVG?

[Wong Kok Wai <wo...@pacific.net.sg>]

According to this (http://argouml.tigris.org/features.html), Argo/UML can
export to SVG. May worth a consideration.

Vincent Hardy wrote:

> George,
>
> I think the idea of generating SVG based class documentation is
> interesting, but, just to clarify, what we have now is just a couple
> class diagrams, manually drawn, that I need to clean up and
> turn into SVG. This is a modest documentation and it is on my todo
> list to make that publicly available (as soon as I am done).
>
> My understanding of your proposal is to work on a tool to automatically
> generate a kind of SVG-based javadoc (I would think focusing on the
> class/packages dependencies) and I think it is a great idea. If you'd
> like to contribute, please do, I would love to have something like
> this.
>
> I would think there may be multiple options that could be interesting.
> One would be a UML to SVG transcoder. Another idea would be to create
> an SVG doclet for the javadoc engine...
>
> Any thoughts or comments?
> V.
>