X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=glib%2Fgslist.c;h=4fb7e41a685078f0c0228b83f177949cf0fa23a0;hb=037bdb1b7ec89f9ddc0d40cabc78bb194b52fafb;hp=4c6af4696658c2ffd976ea8b1a400e2a558d14c0;hpb=adf892e96af403b8950dff1a370e4270ffaebc62;p=platform%2Fupstream%2Fglib.git
diff --git a/glib/gslist.c b/glib/gslist.c
index 4c6af46..4fb7e41 100644
--- a/glib/gslist.c
+++ b/glib/gslist.c
@@ -44,17 +44,15 @@
* Each element in the list contains a piece of data, together with a
* pointer which links to the next element in the list. Using this
* pointer it is possible to move through the list in one direction
- * only (unlike the Doubly-Linked Lists which
- * allow movement in both directions).
+ * only (unlike the [double-linked lists][glib-Doubly-Linked-Lists],
+ * which allow movement in both directions).
*
* The data contained in each element can be either integer values, by
- * using one of the Type
- * Conversion Macros, or simply pointers to any type of data.
+ * using one of the [Type Conversion Macros][glib-Type-Conversion-Macros],
+ * or simply pointers to any type of data.
*
- * List elements are allocated from the slice allocator, which is more
- * efficient than allocating elements individually.
+ * List elements are allocated from the [slice allocator][glib-Memory-Slices],
+ * which is more efficient than allocating elements individually.
*
* Note that most of the #GSList functions expect to be passed a
* pointer to the first element in the list. The functions which insert
@@ -84,9 +82,8 @@
/**
* GSList:
* @data: holds the element's data, which can be a pointer to any kind
- * of data, or any integer value using the Type Conversion
- * Macros.
+ * of data, or any integer value using the
+ * [Type Conversion Macros][glib-Type-Conversion-Macros]
* @next: contains the link to the next element in the list.
*
* The #GSList struct is used for each element in the singly-linked
@@ -192,14 +189,14 @@ g_slist_free_full (GSList *list,
* the elements and reverse the list when all elements have been added.
*
* |[
- * /* Notice that these are initialized to the empty list. */
+ * // Notice that these are initialized to the empty list.
* GSList *list = NULL, *number_list = NULL;
*
- * /* This is a list of strings. */
+ * // This is a list of strings.
* list = g_slist_append (list, "first");
* list = g_slist_append (list, "second");
*
- * /* This is a list of integers. */
+ * // This is a list of integers.
* number_list = g_slist_append (number_list, GINT_TO_POINTER (27));
* number_list = g_slist_append (number_list, GINT_TO_POINTER (14));
* ]|
@@ -240,7 +237,7 @@ g_slist_append (GSList *list,
* may have changed, so make sure you store the new value.
*
* |[
- * /* Notice that it is initialized to the empty list. */
+ * // Notice that it is initialized to the empty list.
* GSList *list = NULL;
* list = g_slist_prepend (list, "last");
* list = g_slist_prepend (list, "first");