diff options
-rw-r--r-- | src/qdoc/docbookgenerator.cpp | 10 | ||||
-rw-r--r-- | tests/auto/qdoc/generatedoutput/expected_output/headerfile-docbook/testheader.xml | 70 |
2 files changed, 75 insertions, 5 deletions
diff --git a/src/qdoc/docbookgenerator.cpp b/src/qdoc/docbookgenerator.cpp index cdf0fc7f9..325344ff0 100644 --- a/src/qdoc/docbookgenerator.cpp +++ b/src/qdoc/docbookgenerator.cpp @@ -2477,12 +2477,10 @@ void DocBookGenerator::generateCppReferencePage(Node *node) QString title; QString rawTitle; QString fullTitle; - const NamespaceNode *ns = nullptr; if (aggregate->isNamespace()) { rawTitle = aggregate->plainName(); fullTitle = aggregate->plainFullName(); title = rawTitle + " Namespace"; - ns = static_cast<const NamespaceNode *>(aggregate); } else if (aggregate->isClass()) { rawTitle = aggregate->plainName(); QString templateDecl = node->templateDecl(); @@ -2490,6 +2488,8 @@ void DocBookGenerator::generateCppReferencePage(Node *node) fullTitle = QString("%1 %2 ").arg(templateDecl, aggregate->typeWord(false)); fullTitle += aggregate->plainFullName(); title = rawTitle + QLatin1Char(' ') + aggregate->typeWord(true); + } else if (aggregate->isHeader()) { + title = fullTitle = rawTitle = aggregate->fullTitle(); } QString subtitleText; @@ -2520,8 +2520,10 @@ void DocBookGenerator::generateCppReferencePage(Node *node) } Sections sections(const_cast<Aggregate *>(aggregate)); - SectionVector *sectionVector = - ns ? §ions.stdDetailsSections() : §ions.stdCppClassDetailsSections(); + auto *sectionVector = + (aggregate->isNamespace() || aggregate->isHeader()) ? + §ions.stdDetailsSections() : + §ions.stdCppClassDetailsSections(); SectionVector::ConstIterator section = sectionVector->constBegin(); while (section != sectionVector->constEnd()) { bool headerGenerated = false; diff --git a/tests/auto/qdoc/generatedoutput/expected_output/headerfile-docbook/testheader.xml b/tests/auto/qdoc/generatedoutput/expected_output/headerfile-docbook/testheader.xml index f3461fb1a..afa0b20a3 100644 --- a/tests/auto/qdoc/generatedoutput/expected_output/headerfile-docbook/testheader.xml +++ b/tests/auto/qdoc/generatedoutput/expected_output/headerfile-docbook/testheader.xml @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8"?> <db:article xmlns:db="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.2" xml:lang="en"> <db:info> -<db:title></db:title> +<db:title><TestHeader> - Test Header</db:title> <db:productname>HeaderFile</db:productname> <db:titleabbrev>HeaderFile Reference Documentation</db:titleabbrev> <db:abstract> @@ -19,4 +19,72 @@ <db:section xml:id="details"> <db:title>Detailed Description</db:title> </db:section> +<db:section xml:id="type-documentation"> +<db:title>Type Documentation</db:title> +<db:section xml:id="Globals-enum"> +<db:title>enum Globals</db:title> +<db:enumsynopsis> +<db:enumname>Globals</db:enumname> +<db:synopsisinfo db:role="access">public</db:synopsisinfo> +<db:synopsisinfo db:role="status">active</db:synopsisinfo> +<db:synopsisinfo db:role="threadsafeness">unspecified</db:synopsisinfo> +<db:synopsisinfo db:role="module">HeaderFile</db:synopsisinfo> +<db:enumitem db:enumidentifier="Glo" db:enumvalue="0"/> +<db:enumitem db:enumidentifier="Bal" db:enumvalue="1"/> +</db:enumsynopsis> +<db:informaltable> +<db:thead> +<db:tr> +<db:th>Constant</db:th> +<db:th>Description</db:th> +</db:tr> +</db:thead> +<db:tr> +<db:td> +<db:para><db:code>Glo</db:code></db:para> +</db:td> +<db:td><db:code>0</db:code></db:td> +</db:tr> +<db:tr> +<db:td> +<db:para><db:code>Bal</db:code></db:para> +</db:td> +<db:td><db:code>1</db:code></db:td> +</db:tr> +</db:informaltable> +</db:section> +</db:section> +<db:section xml:id="variable-documentation"> +<db:title>Variable Documentation</db:title> +<db:section xml:id="globalVar-var"> +<db:title>const int globalVar</db:title> +<db:fieldsynopsis> +<db:type>const int</db:type> +<db:varname>globalVar</db:varname> +<db:synopsisinfo db:role="access">public</db:synopsisinfo> +<db:synopsisinfo db:role="status">active</db:synopsisinfo> +<db:synopsisinfo db:role="threadsafeness">unspecified</db:synopsisinfo> +<db:synopsisinfo db:role="module">HeaderFile</db:synopsisinfo> +</db:fieldsynopsis> +<db:para>Global variable.</db:para> +</db:section> +</db:section> +<db:section xml:id="function-documentation"> +<db:title>Function Documentation</db:title> +<db:section xml:id="globalFunc"> +<db:title>void globalFunc()</db:title> +<db:methodsynopsis> +<db:void/> +<db:methodname>globalFunc</db:methodname> +<db:void/> +<db:synopsisinfo db:role="meta">plain</db:synopsisinfo> +<db:synopsisinfo db:role="signature">void globalFunc()</db:synopsisinfo> +<db:synopsisinfo db:role="access">public</db:synopsisinfo> +<db:synopsisinfo db:role="status">active</db:synopsisinfo> +<db:synopsisinfo db:role="threadsafeness">unspecified</db:synopsisinfo> +<db:synopsisinfo db:role="module">HeaderFile</db:synopsisinfo> +</db:methodsynopsis> +<db:para>Global function.</db:para> +</db:section> +</db:section> </db:article> |