Re: [Dtddoc-develop] Where are we ?

[<her...@fr...>]

Le Samedi 5 Ao=FBt 2006 03:51, Wendy Smoak a =E9crit :
> A few questions/comments:
>
> How significantly will we have to change the dtds?  I need to go look
> at your docs again, but I was under the impression we would need to
> change the dtd comments to be more Javadoc-like.
My test was here only to show you that you'd get a first result without=20
changing *anything* to the DTDs : it's like javadoc, at the first level, yo=
u=20
give it your sources without knowing that this tool exists, and it gives yo=
u=20
an intersting first result.
Now, if you want to take advantage of DTDDoc's enhancements to documentatio=
n,=20
yes : just add "@attr" tags for evey attribute in existing comments. Other=
=20
less important tags are there : see http://dtddoc.sf.net/documentation.html.

>
> I think the sourceDirectory should default to src/main/resources and
> find any DTD anywhere under it.  For example, taglib-maven-plugin [1]
> (which generates TLDDoc) defaults to src/main/resources/META-INF and
> any subdirectory.
yes, thanks for the suggestiion : I'll do that.

> Wish: It should support aggregation, so that if there are dtds
> scattered across different modules in the build, it can create one
> dtddoc set at the top level of the website.
for this one, I'll need more time : Maven's multi-module is a strange beast=
 to=20
me. I think I'll add it to a TODO list instead of waiting its resolution=20
before getting a 0.1 version.

>
> Wish: It should also support the notion of <includes>/<excludes> in
> case there are some dtds present in the filesystem that we do not want
> to build dtddoc for.
for this one, it's the major point I knew I had to include before releasing=
=20
0.1.

>
> The default font seems very small, is it easy to change?
Yes, it's in the CSS : for the moment, it is 11px. Perhaps we should just=20
remove the entry... If you have any suggestion, don't hesitate.

>
> Thanks again!  I'm going to add the config to the Tiles 2 project
> which is in the Struts Sandbox.  That gives us a bit more freedom to
> play without affecting a release.
great

>
> [1] http://maven-taglib.sourceforge.net/m2/taglibdoc-mojo.html

regards,

Herv=E9