From: Yong Bakos <[email protected]>

The Wayland docbook and the doxygen html docs had been presenting
wl_display_get_additional_shm_formats as part of the public API, but the
prototype for this function is in wayland-private.h.

Add a \private annotation to the doc comment, preventing doxygen from
publishing this function as public.
Add logic to the publican xsl to only transform elements with a "prot"
attribute value of "public".

Signed-off-by: Yong Bakos <[email protected]>
---
 doc/publican/doxygen-to-publican.xsl | 2 +-
 src/wayland-server.c                 | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/publican/doxygen-to-publican.xsl 
b/doc/publican/doxygen-to-publican.xsl
index 7c3b507..e13dcd7 100644
--- a/doc/publican/doxygen-to-publican.xsl
+++ b/doc/publican/doxygen-to-publican.xsl
@@ -101,7 +101,7 @@
 
 <!-- methods -->
 <xsl:template match="memberdef" >
-  <xsl:if test="@kind = 'function' and @static = 'no' or
+  <xsl:if test="@kind = 'function' and @static = 'no' and @prot = 'public' or
                 @kind !='function' and normalize-space(briefdescription) != 
''">
     <varlistentry id="{$which}-{@id}">
         <term>
diff --git a/src/wayland-server.c b/src/wayland-server.c
index f745e62..ad82bc2 100644
--- a/src/wayland-server.c
+++ b/src/wayland-server.c
@@ -1470,6 +1470,8 @@ wl_display_add_shm_format(struct wl_display *display, 
uint32_t format)
  *
  * \sa wl_display_add_shm_format()
  *
+ * \private
+ *
  * \memberof wl_display
  */
 struct wl_array *
-- 
2.7.2

_______________________________________________
wayland-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/wayland-devel

Reply via email to