On Sun, Jun 22, 2025 at 10:59:07PM +0200, Patrice Dumas wrote: > On Sun, Jun 22, 2025 at 06:53:42PM +0100, Gavin Smith wrote: > > @c Getopt and argp start at the @section level so that there's > > @c enough room for their internal hierarchy (mostly a problem with > > @c argp). -Miles > > > > As the comment says, "Getopt" is a @section although its superior node > > is a @subsection. > > > > This could be an example of incorrect sectioning levels being the problem, > > rather than an issue with menus. At the moment the only idea I have is > > to also warn about the node up pointer mismatch at the same time. > > I do not really understand the comment explaining why Getopt and argp > start at the @section level, I do not get what "enough room for their > internal hierarchy" means, so it is not clear to me why the Glibc people > want that structure.
Getopt is listed in the menu for "Parsing Program Arguments" which is a @subsection. This means that Getopt should be a @subsubsection. Getopt itself has inferior nodes, like "Using Getopt". However, there is no sectioning command below @subsubsection (no "@subsubsubsection", etc.). That's what they mean with "not enough room."
