index.html ignores brief documentation for enumerations about cldoc HOT 5 OPEN

Actually, what happens is that Specifies a bright red color. is set as the brief doc, and This has the value #FF0000 is the full doc. This is no different than any other element. For the rendering, the full doc is shown if present, otherwise it is the brief doc. You should always write the full doc self-contained (i.e. should not depend on the brief doc being presented).

from cldoc.

I have modified the defect to reflect that it is with rendering index.html -- you ninja'd your comment :).

Doxygen places the brief description before the detailed documentation for the full documentation sections so you don't have to repeat the brief description.

from cldoc.

cldoc != doxygen

from cldoc.

Fair enough. I was pointing it out as it is something that will trip people up when converting documentation from doxygen to cldoc. It will also likely lead to duplicated lines in the documentation.

Part of the problem I am having in this respect is the lack of detailed documentation on the way cldoc documentation comments are formatted and interpreted.

from cldoc.

For 1) cldoc was not really intended for conversion of doxygen, more for new projects. I don't think keeping the brief and full doc independent leads to much duplication. Brief documents are, well, brief. A single sentence without details. Making them independent leads to more readable documentation, since the full doc does not need to flow with the brief doc.

2. Sure, although I think you're mostly just biased by Doxygen, and cldoc follows different conventions. That said it's a valid point, since most people will know Doxygen and have the same bias.

from cldoc.