GNOME Bugzilla – Bug 608014
Incomplete description of \internal
Last modified: 2018-07-30 10:17:06 UTC
"This command writes the message `For internal use only' to the output" The description does not say if it always does this or only if INTERNAL_DOCS=YES. "all text after an \internal command until the end of the comment block or the end of the section (whichever comes first) is marked as "internal"" This does say which, but only for the text following \internal. After reviewing some bugs about internal it appears to me that there is some confusion about the purpose of \internal. I might be slightly confused myself. * Does \internal mean that the documented entity is "Only for internal use"? * Does \internal mean that the part of the documentation following \internal until the end of the documentation block is "Only for internal use"?
As discussed in https://github.com/doxygen/doxygen/pull/734 , Doxygen has moved its issue tracking to https://github.com/doxygen/doxygen/issues All Doxygen tickets in GNOME Bugzilla have been migrated to Github. You can subscribe and participate in the new ticket in Github. You can find the corresponding Github ticket by searching for its Bugzilla ID (number) in Github. Hence I am closing this GNOME Bugzilla ticket. Please use the corresponding ticket in Github instead. Thanks a lot!