From: Tomek Mrugalski <tomasz@isc.org>
Date: Tue, 2 Oct 2018 13:31:18 +0000 (+0200)
Subject: [#10,!3] Generated API is now an appendix
X-Git-Tag: 176-update-to-sysrepo-0-7-6-release_base~166
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=3bfa961c4595075a6e943565ebaef088c06ba8cf;p=thirdparty%2Fkea.git

[#10,!3] Generated API is now an appendix
---

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 2b21e409c4..611e12f14b 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -92,4 +92,4 @@ docgen:
 # That's a bit of a hack, but we are making sure that devel target
 # is always valid. The alternative is to make devel depend on all
 # *.cc *.h files in the whole tree.
-.PHONY: devel guide
+.PHONY: devel guide docgen
diff --git a/doc/docgen/kea_docgen.cc b/doc/docgen/kea_docgen.cc
index 88386c7c1b..28b2ebb52d 100644
--- a/doc/docgen/kea_docgen.cc
+++ b/doc/docgen/kea_docgen.cc
@@ -177,8 +177,8 @@ public:
         for (auto cmd : cmds_) {
             if (!first) {
                 f << ", ";
-                generateCmdLink(f, cmd.first);
             }
+            generateCmdLink(f, cmd.first);
 
             first = false;
         }
@@ -215,7 +215,6 @@ public:
             bool first = true;
             for (auto cmd : cmds_) {
 
-                first = true;
                 auto daemons = cmd.second->get("support");
                 for (auto d : daemons->listValue()) {
                     if (d->stringValue() == daemon) {
@@ -239,7 +238,6 @@ public:
             bool first = true;
             for (auto cmd : cmds_) {
 
-                first = true;
                 auto daemon_hook = cmd.second->get("hook");
                 if (!daemon_hook || daemon_hook->stringValue() != hook) {
                     continue;
@@ -263,7 +261,7 @@ public:
 
         generateCopyright(f);
 
-        f << "<chapter xmlns=\"http://docbook.org/ns/docbook\" version=\"5.0\" xml:id=\"api\">"
+        f << "<appendix xmlns=\"http://docbook.org/ns/docbook\" version=\"5.0\" xml:id=\"api\">"
           << endl;
         f << "  <title>API Reference</title>" << endl;
 
@@ -273,7 +271,7 @@ public:
         // Generate actual commands references.
         generateCommands(f);
 
-        f << "</chapter>" << endl;
+        f << "</appendix>" << endl;
 
         ofstream file(OUTPUT.c_str(), ofstream::trunc);
         file << f.str();
diff --git a/doc/guide/kea-guide.xml b/doc/guide/kea-guide.xml
index fb07d213f5..2424beaa9a 100644
--- a/doc/guide/kea-guide.xml
+++ b/doc/guide/kea-guide.xml
@@ -92,9 +92,12 @@
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="netconf.xml"/>
 
-  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="faq.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+              href="faq.xml"/>
 
-  <chapter xml:id="acknowledgments">
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="api.xml"/>
+
+  <appendix xml:id="acknowledgments">
       <title>Acknowledgments</title>
 
       <para>Kea is an open source project designed, developed, and maintained by Internet Systems
@@ -133,10 +136,7 @@
       <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.tcinet.ru/">Technical Center of Internet</link>
       .</para>
 
-    </chapter>
-
-
-    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="api.xml"/>
+    </appendix>
 
 <!-- TODO: Add bibliography section (mostly RFCs, probably) -->