GNOME Bugzilla – Bug 624575
Request \endinternal or \ipar
Last modified: 2010-10-09 08:20:07 UTC
Hello, Continuing to write on our document (formatted using doxygen and generated in a number of editions with slightly different options), we're feeling slightly limited by \internal. Thus we'd like to suggest adding e.g.: - \endinternal to optionally start including content again before the page structure would do it. - \ipar A single internal paragraph. I.e. some way to make a limited portion of the text internal. Typically we'd use it to: Some text about a feature. \internal \test Details about testing that part of the feature. \test ... \endinternal Some more text about a different aspect of the feature. \internal \test Details about testing that aspect of the feature. \test ... \endinternal Obviously we could create subsubsections, but there are instances when that would feel strange (especially if the internal documentation is excluded). Best regards, Micke
I'll add an \endinternal command for completeness. Note that you can already define your own \internal and \endinternal commands using aliases as follows: ALIASES = internal="\if INTERNAL\n" \ endinternal="\n\endif" and then enable them using ENABLED_SECTIONS = INTERNAL and disable them using ENABLED_SECTIONS =
This bug was previously marked ASSIGNED, which means it should be fixed in doxygen version 1.7.2. Please verify if this is indeed the case. Reopen the bug if you think it is not fixed and please include any additional information that you think can be relevant.