doc: *_list: fix xmllint errors and TOC

- fix xmllint erros
- use a 0-level TOC (such that the main TOC will list only the
  chapters and not also the sections)

doc/cfg_list/Makefile

@@ -197,18 +197,22 @@ $(docbook_output_dir)/cfg_var_list.xml: Makefile \
 		$(foreach f,$(flist),$(docbook_output_dir)/$(call get_target,$f).xml)
 	@echo '<?xml version="1.0" encoding="UTF-8"?>' >$@
 	@echo '<!-- this file is autogenerated, do not edit! -->' >>$@
-	@echo '<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"' >>$@
-	@echo '	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">' >>$@
+	@echo '<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"' >>$@
+	@echo '	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"' >>$@
+	@echo '	[ <!ENTITY % local.common.attrib' >>$@
+	@echo "	 \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2001/XInclude'\">]">>$@
+	@echo '>' >>$@
 	@echo '<book id="cfg_var_list"'\
 		'xmlns:xi="http://www.w3.org/2001/XInclude">' >>$@
 	@echo '	<title>Runtime Configuration Variables List</title>' >>$@
-	@echo '	<info><revhistory><revision>' >>$@
+	@echo '	<bookinfo><revhistory><revision>' >>$@
 	@echo '		<revnumber>'$(repo_ver)'</revnumber>' >>$@
+	@echo '		<date>'`date -R`'</date>' >>$@
 	@echo '		<revremark>' >>$@
 	@echo "			Automatically generated by:">>$@
 	@echo "			$(MAKE) -C doc/cfg_list $(MAKECMDGOALS)" >>$@
 	@echo '		</revremark>' >>$@
-	@echo '	</revision></revhistory></info>' >>$@
+	@echo '	</revision></revhistory></bookinfo>' >>$@
 	@$(foreach f,$(flist),\
 		echo '		<xi:include'\
 			'href="'$(call get_target,$f).xml'"/>' \

doc/cfg_list/docbook/Makefile

@@ -1,5 +1,7 @@
 
 docs = cfg_var_list.xml
 docbook_dir = ../../../docbook
+# no subsection listed in the main TOC
+xsltproc_flags+=--stringparam  toc.section.depth 0
 
 include $(docbook_dir)/Makefile

doc/rpc_list/Makefile

@@ -213,18 +213,22 @@ $(docbook_output_dir)/rpc_list.xml: Makefile \
 		$(foreach f,$(flist),$(docbook_output_dir)/$(call get_target,$f).xml)
 	@echo '<?xml version="1.0" encoding="UTF-8"?>' >$@
 	@echo '<!-- this file is autogenerated, do not edit! -->' >>$@
-	@echo '<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"' >>$@
-	@echo '	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">' >>$@
+	@echo '<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"' >>$@
+	@echo '	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"' >>$@
+	@echo '	[ <!ENTITY % local.common.attrib' >>$@
+	@echo "	 \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2001/XInclude'\">]">>$@
+	@echo '>' >>$@
 	@echo '<book id="rpc_list"'\
 		'xmlns:xi="http://www.w3.org/2001/XInclude">' >>$@
 	@echo '	<title>RPC Exports List</title>' >>$@
-	@echo '	<info><revhistory><revision>' >>$@
+	@echo '	<bookinfo><revhistory><revision>' >>$@
 	@echo '		<revnumber>'$(repo_ver)'</revnumber>' >>$@
+	@echo '		<date>'`date -R`'</date>' >>$@
 	@echo '		<revremark>' >>$@
 	@echo "			Automatically generated by:">>$@
 	@echo "			$(MAKE) -C doc/rpc_list $(MAKECMDGOALS)" >>$@
 	@echo '		</revremark>' >>$@
-	@echo '	</revision></revhistory></info>' >>$@
+	@echo '	</revision></revhistory></bookinfo>' >>$@
 	@$(foreach f,$(flist),\
 		echo '		<xi:include'\
 			'href="'$(call get_target,$f).xml'"/>' \

doc/rpc_list/docbook/Makefile

@@ -1,5 +1,7 @@
 
 docs = rpc_list.xml
 docbook_dir = ../../../docbook
+# no subsection listed in the main TOC
+xsltproc_flags+=--stringparam  toc.section.depth 0
 
 include $(docbook_dir)/Makefile

doc/select_list/Makefile

@@ -212,18 +212,22 @@ $(docbook_output_dir)/select_list.xml: Makefile \
 		$(foreach f,$(flist),$(docbook_output_dir)/$(call get_target,$f).xml)
 	@echo '<?xml version="1.0" encoding="UTF-8"?>' >$@
 	@echo '<!-- this file is autogenerated, do not edit! -->' >>$@
-	@echo '<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"' >>$@
-	@echo '	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">' >>$@
+	@echo '<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"' >>$@
+	@echo '	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"' >>$@
+	@echo '	[ <!ENTITY % local.common.attrib' >>$@
+	@echo "	 \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2001/XInclude'\">]">>$@
+	@echo '>' >>$@
 	@echo '<book id="select_list"'\
 		'xmlns:xi="http://www.w3.org/2001/XInclude">' >>$@
 	@echo '	<title>Select List</title>' >>$@
-	@echo '	<info><revhistory><revision>' >>$@
+	@echo '	<bookinfo><revhistory><revision>' >>$@
 	@echo '		<revnumber>'$(repo_ver)'</revnumber>' >>$@
+	@echo '		<date>'`date -R`'</date>' >>$@
 	@echo '		<revremark>' >>$@
 	@echo "			Automatically generated by:">>$@
 	@echo "			$(MAKE) -C doc/select_list $(MAKECMDGOALS)" >>$@
 	@echo '		</revremark>' >>$@
-	@echo '	</revision></revhistory></info>' >>$@
+	@echo '	</revision></revhistory></bookinfo>' >>$@
 	@echo '		<xi:include href="intro.xml"/>' >>$@
 	@$(foreach f,$(flist),\
 		echo '		<xi:include'\

doc/select_list/docbook/Makefile

@@ -1,5 +1,7 @@
 
 docs = select_list.xml
 docbook_dir = ../../../docbook
+# no subsection listed in the main TOC
+xsltproc_flags+=--stringparam  toc.section.depth 0
 
 include $(docbook_dir)/Makefile

doc/select_list/docbook/intro.xml

@@ -21,21 +21,21 @@
 	<title>Notations</title>
 	<para>The following notations are used:
 	<orderedlist>
-	<listitem>@  - all selects always start with '@'. </listitem>
-	<listitem>&quot;string&quot; - string type.</listitem>
-	<listitem>integer - integer type.</listitem>
-	<listitem>[] - Parameter markers. Can be either [integer] or
+	<listitem><para>@  - all selects always start with '@'.</para></listitem>
+	<listitem><para>&quot;string&quot; - string type.</para></listitem>
+	<listitem><para>integer - integer type.</para></listitem>
+	<listitem><para>[] - Parameter markers. Can be either [integer] or
 		[&quot;string&quot;].
 		Note that instead of [&quot;string&quot;] one could write .string,
 		e.g.:
 		@foo.bar[&quot;string&quot;] is equivalent to @foo.bar.string.
-	</listitem>
-	<listitem>{} - denotes an optional parameter.
+	</para></listitem>
+	<listitem><para>{} - denotes an optional parameter.
 		E.g.: @ruri.params{[&quot;string&quot;]} means you could use
 		@ruri.params by itself or you could specify an extra parameter:
 		@ruri.params[&quot;trasnport&quot;] or @ruri.params.transport.
-	</listitem>
-	<listitem>&lt;string&gt; - means the next member is not fixed and can
+	</para></listitem>
+	<listitem><para>&lt;string&gt; - means the next member is not fixed and can
 		take any string value (it is a string parameter).
 		It is equivalent with [&quot;string&quot;], e.g.:
 		@msg.header.&lt;string&gt; is the same as
@@ -43,18 +43,18 @@
 		It is used only to expose an internal implementation detail
 		(SEL_PARAM_* vs. CONSUME_NEXT_*), but from the script writer point
 		of view it is the same thing.
-	</listitem>
-	<listitem>.* - means the select can be followed by a variable number of
-		string parameters.
+	</para></listitem>
+	<listitem><para>.* - means the select can be followed by a variable number
+		of string parameters.
 		E.g.: @cfg_get.*  means that @cfg_get.core.version is a valid usage.
-	</listitem>
-	<listitem>* (without a &apos;.&apos; in front) - it means the last member
-		might be a class that might expand further (but the
+	</para></listitem>
+	<listitem><para>* (without a &apos;.&apos; in front) - it means the
+		last member might be a class that might expand further (but the
 		&quot;expansion&quot; is not defined in the same module).
 		E.g. @foo.nameaddr* means that nameaddr is most likely
 		a class that expands further
 		(for example into @foo.nameaddr.uri a.s.o).
-	</listitem>
+	</para></listitem>
 	</orderedlist>
 	</para>
 	</section>