[PATCH] doc: silent man page generation and fix gtk-doc warnings

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



>From 00c64e67d2abaa722c90f731c143d1dc0ae18dd3 Mon Sep 17 00:00:00 2001
From: Kay Sievers <kay@xxxxxxxx>
Date: Sat, 14 Apr 2012 20:47:47 +0200
Subject: [PATCH] doc: silent man page generation and fix gtk-doc warnings

---
 libkmod/docs/libkmod-docs.xml |   13 ++-----------
 libkmod/libkmod-module.c      |    2 +-
 man/Makefile.am               |    1 +
 3 files changed, 4 insertions(+), 12 deletions(-)

diff --git a/libkmod/docs/libkmod-docs.xml b/libkmod/docs/libkmod-docs.xml
index 8a8f139..fd17506 100644
--- a/libkmod/docs/libkmod-docs.xml
+++ b/libkmod/docs/libkmod-docs.xml
@@ -3,6 +3,7 @@
                "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd";
 [
   <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
+  <!ENTITY version SYSTEM "version.xml">
 ]>
 <book id="index">
   <bookinfo>
@@ -17,20 +18,10 @@
     <xi:include href="xml/libkmod-config.xml"/>
     <xi:include href="xml/libkmod-module.xml"/>
     <xi:include href="xml/libkmod-loaded.xml"/>
-
-  </chapter>
-  <chapter id="object-tree">
-    <title>Object Hierarchy</title>
-     <xi:include href="xml/tree_index.sgml"/>
   </chapter>
+
   <index id="api-index-full">
     <title>API Index</title>
     <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
   </index>
-  <index id="deprecated-api-index" role="deprecated">
-    <title>Index of deprecated API</title>
-    <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
-  </index>
-
-  <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
 </book>
diff --git a/libkmod/libkmod-module.c b/libkmod/libkmod-module.c
index 8cb8603..f5384a7 100644
--- a/libkmod/libkmod-module.c
+++ b/libkmod/libkmod-module.c
@@ -577,7 +577,7 @@ KMOD_EXPORT int kmod_module_unref_list(struct kmod_list *list)
  * @input: list of kmod_module to be filtered with blacklist
  * @output: where to save the new list
  *
- * Deprecated: Use kmod_module_apply_filter instead.
+ * This function should not be used. Use kmod_module_apply_filter instead.
  *
  * Given a list @input, this function filter it out with config's blacklist
  * and save it in @output.
diff --git a/man/Makefile.am b/man/Makefile.am
index 772ff7f..6ab36c1 100644
--- a/man/Makefile.am
+++ b/man/Makefile.am
@@ -11,6 +11,7 @@ EXTRA_DIST = $(MAN5:%.5=%.xml) $(MAN8:%.8=%.xml)
 
 XSLTPROC_FLAGS = \
 	--nonet \
+	--stringparam man.output.quietly 1 \
 	--param funcsynopsis.style "'ansi'"
 
 CLEANFILES = $(dist_man_MANS)
-- 
1.7.9.3


--
To unsubscribe from this list: send the line "unsubscribe linux-modules" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]     [Big List of Linux Books]

  Powered by Linux