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,