[Xfce4-commits] [xfce/libxfce4util] 03/04: Fix some gtk-doc warnings

noreply at xfce.org noreply at xfce.org
Sun Dec 10 13:47:02 CET 2017


This is an automated email from the git hooks/post-receive script.

s   k   u   n   n   y   k       p   u   s   h   e   d       a       c   o   m   m   i   t       t   o       b   r   a   n   c   h       m   a   s   t   e   r   
   in repository xfce/libxfce4util.

commit 441d69e324c0a24a16b07c0fca86905b5e8e6537
Author: Romain B <skunnyk at alteroot.org>
Date:   Sat Dec 9 19:08:59 2017 +0100

    Fix some gtk-doc warnings
---
 docs/libxfce4util-sections.txt | 1 +
 libxfce4util/xfce-generics.h   | 4 ++++
 libxfce4util/xfce-i18n.c       | 9 ++++-----
 libxfce4util/xfce-resource.h   | 4 ++--
 4 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/docs/libxfce4util-sections.txt b/docs/libxfce4util-sections.txt
index 053668a..cc35c65 100644
--- a/docs/libxfce4util-sections.txt
+++ b/docs/libxfce4util-sections.txt
@@ -90,6 +90,7 @@ xfce_rc_read_entry_untranslated
 xfce_rc_read_bool_entry
 xfce_rc_read_int_entry
 xfce_rc_read_list_entry
+xfce_rc_rollback
 xfce_rc_write_entry
 xfce_rc_write_bool_entry
 xfce_rc_write_int_entry
diff --git a/libxfce4util/xfce-generics.h b/libxfce4util/xfce-generics.h
index 4732899..1fe1bb2 100644
--- a/libxfce4util/xfce-generics.h
+++ b/libxfce4util/xfce-generics.h
@@ -141,6 +141,7 @@ xfce_stack_alloc (gsize element_size)
 
 /**
  * xfce_stack_top:
+ * @stack: A stack object.
  *
  * Removes the top element from @stack.
  */
@@ -157,6 +158,7 @@ xfce_stack_alloc (gsize element_size)
 
 /**
  * xfce_stack_pop:
+ * @stack: A stack object.
  *
  *  Removes the top element from @stack.
  */
@@ -171,6 +173,8 @@ xfce_stack_alloc (gsize element_size)
 
 /**
  * xfce_stack_push:
+ * @stack: A stack object.
+ * @value: the value to push
  *
  * Pushes a new @value on top of @stack.
  */
diff --git a/libxfce4util/xfce-i18n.c b/libxfce4util/xfce-i18n.c
index e79b726..55cb326 100644
--- a/libxfce4util/xfce-i18n.c
+++ b/libxfce4util/xfce-i18n.c
@@ -272,9 +272,9 @@ xfce_get_dir_localized_r (gchar *buffer, gsize length, const gchar *directory)
  * xfce_get_path_localized:
  * @dst      : destination buffer.
  * @size     : size of @dst in bytes.
- * @paths    :
- * @filename :
- * @test     :
+ * @paths    : the path
+ * @filename : the filename
+ * @test     : test
  *
  * @paths is a ':'-separated list of pathnames.
  *
@@ -288,8 +288,7 @@ xfce_get_dir_localized_r (gchar *buffer, gsize length, const gchar *directory)
  *
  *  /usr/local/lib/%L/%F:/usr/local/share/%N/%l/%F
  *
- * Return value:
- **/
+ */
 gchar*
 xfce_get_path_localized (gchar       *dst,
                          gsize        size,
diff --git a/libxfce4util/xfce-resource.h b/libxfce4util/xfce-resource.h
index 37f2c87..d913e15 100644
--- a/libxfce4util/xfce-resource.h
+++ b/libxfce4util/xfce-resource.h
@@ -47,8 +47,8 @@ typedef enum /*< prefix=XFCE_RESOURCE_ >*/
 
 /**
  * XfceMatchFunc:
- * @basedir   :
- * @relpath   :
+ * @basedir   : basedir
+ * @relpath   : relpath
  * @user_data : additional user data passed to xfce_resource_match_custom().
  *
  * Return value :

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.


More information about the Xfce4-commits mailing list