X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=glib%2Fghook.c;h=44a2665e5ac1a59c5827fc532c8a0e2ccfb99013;hb=9da85c7262325478e8730ae9f3e76bd0528a9a8c;hp=65b9421bb4ca1dbe7d130482ceaf675bdf8f4d72;hpb=c8b0617a2b9b71ca89b9fdd0e6f3b6afdd255a49;p=platform%2Fupstream%2Fglib.git
diff --git a/glib/ghook.c b/glib/ghook.c
index 65b9421..44a2665 100644
--- a/glib/ghook.c
+++ b/glib/ghook.c
@@ -15,9 +15,7 @@
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * License along with this library; if not, see .
*/
/*
@@ -59,8 +57,7 @@
* The default behaviour is to call the hooks @destroy function
* @dummy: unused
*
- * The GHookList struct represents a
- * list of hook functions.
+ * The #GHookList struct represents a list of hook functions.
*/
/**
@@ -77,7 +74,7 @@
* @G_HOOK_FLAG_ACTIVE: set if the hook has not been destroyed
* @G_HOOK_FLAG_IN_CALL: set if the hook is currently being run
* @G_HOOK_FLAG_MASK: A mask covering all bits reserved for
- * hook flags; see #G_HOOK_FLAGS_USER_SHIFT
+ * hook flags; see %G_HOOK_FLAG_USER_SHIFT
*
* Flags used internally in the #GHook implementation.
*/
@@ -86,7 +83,7 @@
* G_HOOK_FLAGS:
* @hook: a #GHook
*
- * Returns the flags of a hook.
+ * Gets the flags of a hook.
*/
/**
@@ -94,7 +91,7 @@
*
* The position of the first bit which is not reserved for internal
* use be the #GHook implementation, i.e.
- * 1 << G_HOOK_FLAG_USER_SHIFT is the first
+ * `1 << G_HOOK_FLAG_USER_SHIFT` is the first
* bit which can be used for application-defined flags.
*/
@@ -102,7 +99,7 @@
* G_HOOK:
* @hook: a pointer
*
- * Casts a pointer to a GHook*.
+ * Casts a pointer to a `GHook*`.
*/
/**
@@ -157,8 +154,7 @@
* @destroy: the default @finalize_hook function of a #GHookList calls
* this member of the hook that is being finalized
*
- * The GHook struct represents a single hook
- * function in a #GHookList.
+ * The #GHook struct represents a single hook function in a #GHookList.
*/
/**
@@ -197,7 +193,7 @@ default_finalize_hook (GHookList *hook_list,
* g_hook_list_init:
* @hook_list: a #GHookList
* @hook_size: the size of each element in the #GHookList,
- * typically sizeof (GHook)
+ * typically `sizeof (GHook)`.
*
* Initializes a #GHookList.
* This must be called before the #GHookList is used.
@@ -977,7 +973,7 @@ g_hook_find_func_data (GHookList *hook_list,
* Defines the type of function used to compare #GHook elements in
* g_hook_insert_sorted().
*
- * Returns: a value <= 0 if @new_hook should be before @sibling
+ * Returns: a value <= 0 if @new_hook should be before @sibling
*/
/**
@@ -1039,7 +1035,7 @@ g_hook_insert_sorted (GHookList *hook_list,
* Compares the ids of two #GHook elements, returning a negative value
* if the second id is greater than the first.
*
- * Returns: a value <= 0 if the id of @sibling is >= the id of @new_hook
+ * Returns: a value <= 0 if the id of @sibling is >= the id of @new_hook
*/
gint
g_hook_compare_ids (GHook *new_hook,