[Doxygen-users] Nested groups not respected for LaTeX output

[Leonardo P. S. <Leo...@on...>]

Hello All!

I’m organizing my source files under different groups, some of which have subgroups. I’ve noticed that nested groups work in the HTML output, but get flattened in the LaTeX output.

HTML output:


Modules<modules.html>
Nested Groups<index.html>
·            ▼<javascript:void(0)>Modules<modules.html>
o              ▼<javascript:void(0)>Some big group<group___b_i_g_g_r_o_u_p.html>
§                     ▼<javascript:void(0)>A small group<group___s_m_a_l_l_g_r_o_u_p.html>
§                               some_yet_another_c_function<group___s_m_a_l_l_g_r_o_u_p.html#ga324420a3ea1c330055df10ae4974ca4b>


Modules
Here is a list of all modules:
[detail level 12]
 ▼Some big group<group___b_i_g_g_r_o_u_p.html>

          A small group<group___s_m_a_l_l_g_r_o_u_p.html>







LaTeX output:


3 Module Documentation 5
3.1 Some big group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.1.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.2 A small group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.2.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.2.2 Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.2.2.1 some_yet_another_c_function() . . . . . . . . . . . . . . . . . . . . . . . . . . . 6


Small Group should be under Some Big Group as 3.1.1, instead it get a section of it’s own.

Should I file this as a bug?

Thanks!!


Doxyfile:

# General options
PROJECT_NAME           = "Nested Groups"

INPUT                 = include/nested.h

#You should not need to change the rest of the file
OUTPUT_DIRECTORY       = output_doc
GENERATE_HTML          = YES
GENERATE_TREEVIEW      = YES
GENERATE_LATEX         = YES
OPTIMIZE_OUTPUT_FOR_C  = YES


nested.h

/**
* @file nested.h
* @brief Nested groups example
*/

#ifndef SRC_NESTED_H_
#define SRC_NESTED_H_

/** @defgroup BIGGROUP Some big group
  *  @{
  */
/** @defgroup SMALLGROUP A small group
  *  @{
  */

/**
* \brief We should have a real explanation here.
*
* This function **WILL BE** included as the key `DO_NOT_INCLUDE_THIS` is not
* present in the [ENABLED_SECTIONS](http://www.doxygen.nl/manual/config.html#cfg_enabled_sections) option.
*
* \return Just 0
*/
int some_yet_another_c_function(void);

/** @} */
/** @} */

#endif /* SRC_NESTED_H_ */

____________________________________________________________
Leonardo Pereira Santos | ON Semiconductor
Design Engineer

200-611 Kumpf Dr        | Waterloo, Ontario, Canada, N2N 1A8
519-884-9696 x2269 (O)  | Leo...@on...<mailto:Leo...@on...>