[glib] kqueue: Don't use doc comments



commit 07506f6c579c309724abe20dd843eb60716c94cc
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat Feb 1 09:50:23 2014 -0500

    kqueue: Don't use doc comments
    
    This is not public API, so no need to confuse gtk-doc by
    documentation that it needs to ignore. Also, no need for
    markup in here.

 gio/kqueue/kqueue-thread.c |   34 ++++++++++++++--------------------
 1 files changed, 14 insertions(+), 20 deletions(-)
---
diff --git a/gio/kqueue/kqueue-thread.c b/gio/kqueue/kqueue-thread.c
index de9acd3..231aac2 100644
--- a/gio/kqueue/kqueue-thread.c
+++ b/gio/kqueue/kqueue-thread.c
@@ -48,7 +48,7 @@ const uint32_t KQUEUE_VNODE_FLAGS =
 
 extern int get_kqueue_descriptor(void);
 
-/**
+/*
  * _kqueue_thread_collect_fds:
  * @events: a #kevents - the list of events to monitor. Will be extended
  *     with new items.
@@ -56,7 +56,7 @@ extern int get_kqueue_descriptor(void);
  * Picks up new file descriptors for monitoring from a global queue.
  *
  * To add new items to the list, use _kqueue_thread_push_fd().
- **/
+ */
 static void
 _kqueue_thread_collect_fds (kevents *events)
 {
@@ -85,7 +85,7 @@ _kqueue_thread_collect_fds (kevents *events)
 }
 
 
-/**
+/*
  * _kqueue_thread_cleanup_fds:
  * @events: a #kevents -- list of events to monitor. Cancelled
  *     subscriptions will be removed from it, and its size
@@ -97,7 +97,7 @@ _kqueue_thread_collect_fds (kevents *events)
  * to cancel monitoring on them. The list will be freed then.
  *
  * To add new items to the list, use _kqueue_thread_remove_fd().
- **/
+ */
 static void
 _kqueue_thread_cleanup_fds (kevents *events)
 {
@@ -133,14 +133,14 @@ _kqueue_thread_cleanup_fds (kevents *events)
 }
 
 
-/**
+/*
  * _kqueue_thread_drop_fd:
  * @events: a #kevents -- list of events to monitor. Cancelled
  *     subscriptions will be removed from it, and its size
  *     probably will be reduced.
  *
  * Removes a concrete file descriptor from monitoring.
- **/
+ */
 static void
 _kqueue_thread_drop_fd (kevents *events, int fd)
 {
@@ -160,7 +160,7 @@ _kqueue_thread_drop_fd (kevents *events, int fd)
     } 
 }
 
-/**
+/*
  * _kqueue_thread_func:
  * @arg: a pointer to int -- control file descriptor.
  *
@@ -169,14 +169,8 @@ _kqueue_thread_drop_fd (kevents *events, int fd)
  * and writes the notifications into it.
  *
  * Control commands are single-byte characters:
- * <itemizedlist>
- * <listitem>
- *   'A' - pick up new file descriptors to monitor
- * </listitem>
- * <listitem>
- *   'R' - remove some descriptors from monitoring.
- * </listitem>
- * </itemizedlist>
+ * - 'A' - pick up new file descriptors to monitor
+ * - 'R' - remove some descriptors from monitoring.
  *
  * For details, see _kqueue_thread_collect_fds() and
  * _kqueue_thread_cleanup_fds().
@@ -185,7 +179,7 @@ _kqueue_thread_drop_fd (kevents *events, int fd)
  * are represented with #kqueue_notification objects.
  *
  * Returns: %NULL
- **/
+ */
 void*
 _kqueue_thread_func (void *arg)
 {
@@ -271,7 +265,7 @@ _kqueue_thread_func (void *arg)
 }
 
 
-/**
+/*
  * _kqueue_thread_push_fd:
  * @fd: a file descriptor
  *
@@ -280,7 +274,7 @@ _kqueue_thread_func (void *arg)
  * The kqueue thread will not start monitoring on it immediately, it
  * should be bumped via its command file descriptor manually.
  * See kqueue_thread() and _kqueue_thread_collect_fds() for details.
- **/
+ */
 void
 _kqueue_thread_push_fd (int fd)
 {
@@ -290,7 +284,7 @@ _kqueue_thread_push_fd (int fd)
 }
 
 
-/**
+/*
  * _kqueue_thread_remove_fd:
  * @fd: a file descriptor
  *
@@ -300,7 +294,7 @@ _kqueue_thread_push_fd (int fd)
  * The kqueue thread will not stop monitoring on it immediately, it
  * should be bumped via its command file descriptor manually.
  * See kqueue_thread() and _kqueue_thread_collect_fds() for details.
- **/
+ */
 void
 _kqueue_thread_remove_fd (int fd)
 {


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