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

[Stefan C. <sch...@sk...>]

Hi Andrew,

> I stumbled across DTDDoc because a DTD I generated in Netbeans =20
> (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 "-", =20
> which I
> assume is because the comments Netbeans generated use "<!---" (in =20
> the same
> way that javadoc comments use "/**" rather than just "/*") and =20
> DTDDoc is
> expecting just "<!--".  So I'm wondering whether this has always =20
> been the
> case, or the Netbeans module is simply doing it wrong, or if I've =20
> found the
> wrong tool and there's another DTDDoc that expects the other form?

I don't think netbeans does it wrong (although I've never used that =20
tool). As far as I'm concerned, when I designed DTDDoc I just decided =20=

to have regular comments used. But now, I do realise that this is an =20
issue. Indeed one cannot mix non DTDDoc comments with DTDDoc comments.

Hmmmm... Well, I'll look into it if I get a chance but this is going =20
to take some time because well, my "real life" is just =20
waaaaaaaaaaaaaaaaay too busy nowadays. And moreover I've now moved to =20=

MacOSX so i have to set up my development environment again. I'll =20
keep you informed.

Now we can think about the correct way of doing that. One could say =20
that DTDDoc should understand only triple "-" or only double "-". =20
That's maybe the best to do as it retains backwards compatibility =20
(with DTDDoc). It wouldn't be much work to do.

And of course, we should make it an Ant option (and a command line =20
option) as Herv=E9 puts it.

Anyway, thank you for passing by.

stF