Dopo alcune indagini, ho deciso questa sembra tratta di un problema, ma solo perché è un po 'contro-intuitivo .
Si consideri il seguente:
The Main Section {#the_main_section}
================
Subsection One {#first}
--------------
Something highly interesting...
Il documento inizia con un colpo di testa di livello 1 (come descritto here) e così Doxygen analizza "La sezione principale", come il nome e il titolo della pagina. L'intestazione e l'etichetta {#the_main_section} sembrano non essere rispettate una volta che l'intestazione è stata convertita in un nome di pagina.
L'elaborazione passa quindi al resto del documento e quando raggiunge "Sottosezione 1", ritiene che non vi sia alcuna "sezione" genitore per la "sottosezione" (poiché la "Sezione" è stata convertita in una pagina nome) e questo è dove soffoca.
In particolare, ignora la sottosezione (intestazione) poiché ritiene che non vi sia alcuna "sezione" genitore. Tutto il resto del testo rimane, ma viene trattato come parte della "pagina" (senza parentela di sezione).
La "correzione" consiste nell'aggiungere un'altra "intestazione di livello 1" dopo l'iniziale "intestazione di livello 1", ad es.
My Great Documentation (Which Becomes the Page Name)
====================================================
The First Section
=================
Q. What? I already created a level 1 heading?
A. Yup, but that was converted to a page name/title and discarded, so now
we have to create another level 1 heading for my first section. Don't
be fooled into thinking that the opening heading in this document is
still treated as an opening heading by Doxygen - it's not!
fonte
2012-12-19 13:36:34
non sono riuscito a riprodurre questo comportamento in un semplice caso di test con un file di configurazione di default generato per Doxygen 1.8.2. Vedi questo comportamento in un caso di test indipendente o come parte di un set di documenti più grande? Potrebbe essere necessario pubblicare il contenuto esatto dei file con cui si sta lavorando, incluso il file di configurazione. – DRH
Lo stesso "problema" con 1.8.8. Ho avuto un README.md che ha fatto la stessa identica cosa, ma senza l'etichetta per l'intestazione più in alto. –