Re: [Dtddoc-develop] Correct form of doc comments?

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

Hi Andrew,

I personnaly don't know af another tool named DTDDoc.

I had a look at CVS's history : it was so at the initial revision, on May 2=
5=20
2002 :
http://dtddoc.cvs.sourceforge.net/dtddoc/DTDDoc/example/common_figure.dtd?h=
ideattic=3D0&revision=3D1.1&view=3Dmarkup

I think the idea was that even before DTDDoc existed, people were smart eno=
ugh=20
to comment their DTDs : raw information was here, waiting for DTDDoc to=20
publish it ! :)
That's only later that @xxx conventions "=E0 la javadoc" were added : askin=
g for=20
an extra "-" like the extra "*" from javadoc would have lead to loose all=20
these free comments.


To me, "<!---" is a bug in Netbeans.
Now, if you think it would be useful to distinguish normal DTD comment from=
=20
DTDDoc comments (just like javadoc doesn't render basic comments), perhaps =
we=20
can add it to DTDDoc's feature list, as an Ant task option (name to find : =
if=20
you have an idea of a meaningful name...).

Herv=E9

Le Vendredi 14 Juillet 2006 11:56, Andrew Stevens a =E9crit :
> I stumbled across DTDDoc because a DTD I generated in Netbeans (from an
> existing XML document) contained a whole load of comments which read
> <!--- Put your DTDDoc comment here. -->
> by each element or attribute declaration.  Nice tool :-)
>
> However, I noticed that the generated docs all have a leading "-", which I
> assume is because the comments Netbeans generated use "<!---" (in the same
> way that javadoc comments use "/**" rather than just "/*") and DTDDoc is
> expecting just "<!--".  So I'm wondering whether this has always been the
> case, or the Netbeans module is simply doing it wrong, or if I've found t=
he
> wrong tool and there's another DTDDoc that expects the other form?
>
>
> Andrew.
>
>
>
>
> -------------------------------------------------------------------------
> Using Tomcat but need to do more? Need to support web services, security?
> Get stuff done quickly with pre-integrated technology to make your job
> easier Download IBM WebSphere Application Server v.1.0.1 based on Apache
> Geronimo
> http://sel.as-us.falkag.net/sel?cmd=3Dlnk&kid=3D120709&bid=3D263057&dat=
=3D121642
> _______________________________________________
> Dtddoc-develop mailing list
> Dtd...@li...
> https://lists.sourceforge.net/lists/listinfo/dtddoc-develop