adrdox icon indicating copy to clipboard operation
adrdox copied to clipboard

'Note:' does not become a section in docs

Open FreeSlave opened this issue 7 years ago • 3 comments

/**
 * Some doc comments.
 * Note:
 *  Some note.
 * Throws:
 *  Exception
 */
void someFunc()
{

}

screenshot from 2018-05-30 17-22-43

'Note:' should be made into a section like 'Throws:'.

FreeSlave avatar May 30 '18 14:05 FreeSlave

So I actually didn't do this one because I frequently wrote Note: and want it to just be a note instead of a big section.

How often do you actually use this as a section? Would you be ok if it only accepted "Notes:", with the s?

adamdruppe avatar Jun 02 '18 16:06 adamdruppe

I often use 'Note:'. I know it's nonstandard though, but ddox consider it as section. It's actually not a big deal whether it's section or not, I just used to not write empty comment line between main description and Note. But without empty line and without Note being a section all Note text goes to the main description that appears in overview. I can just add empty lines to my docs to separate Note from the rest.

FreeSlave avatar Jun 02 '18 17:06 FreeSlave