From acfb76afe2c7dab67f87878c2a3f5f3aa2d8dbfd Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Thu, 30 Jan 2014 23:52:58 -0500 Subject: [PATCH] Docs: don't use It basically does not work in the HTML output. --- gio/gdbusconnection.c | 12 ++++-------- glib/gdate.c | 10 +++++----- glib/gslice.c | 7 +++---- gobject/gsignal.c | 10 ++++------ 4 files changed, 16 insertions(+), 23 deletions(-) diff --git a/gio/gdbusconnection.c b/gio/gdbusconnection.c index 43f7c93..f454693 100644 --- a/gio/gdbusconnection.c +++ b/gio/gdbusconnection.c @@ -144,14 +144,10 @@ * an D-Bus client, it is often easier to use the g_bus_own_name(), * g_bus_watch_name() or g_dbus_proxy_new_for_bus() APIs. * - * As an exception to the usual GLib rule that a particular object must not be - * used by two threads at the same time, #GDBusConnection's methods may be - * called from any thread - * - * This is so that g_bus_get() and g_bus_get_sync() can safely return the - * same #GDBusConnection when called from any thread. - * - * . + * As an exception to the usual GLib rule that a particular object must not + * be used by two threads at the same time, #GDBusConnection's methods may be + * called from any thread. This is so that g_bus_get() and g_bus_get_sync() + * can safely return the same #GDBusConnection when called from any thread. * * Most of the ways to obtain a #GDBusConnection automatically initialize it * (i.e. connect to D-Bus): for instance, g_dbus_connection_new() and diff --git a/glib/gdate.c b/glib/gdate.c index 1978cf7..410e00a 100644 --- a/glib/gdate.c +++ b/glib/gdate.c @@ -1761,11 +1761,11 @@ g_date_subtract_years (GDate *d, * @year: year to check * * Returns %TRUE if the year is a leap year. - * For the purposes of this function, - * leap year is every year divisible by 4 unless that year - * is divisible by 100. If it is divisible by 100 it would - * be a leap year only if that year is also divisible - * by 400. + * + * For the purposes of this function, leap year is every year + * divisible by 4 unless that year is divisible by 100. If it + * is divisible by 100 it would be a leap year only if that year + * is also divisible by 400. * * Returns: %TRUE if the year is a leap year */ diff --git a/glib/gslice.c b/glib/gslice.c index 5f545fc..8b541cc 100644 --- a/glib/gslice.c +++ b/glib/gslice.c @@ -68,12 +68,11 @@ * * To achieve these goals, the slice allocator uses a sophisticated, * layered design that has been inspired by Bonwick's slab allocator - * - * [Bonwick94] Jeff Bonwick, The slab allocator: An object-caching kernel + * ([Bonwick94] Jeff Bonwick, The slab allocator: An object-caching kernel * memory allocator. USENIX 1994, and * [Bonwick01] Bonwick and Jonathan Adams, Magazines and vmem: Extending the - * slab allocator to many cpu's and arbitrary resources. USENIX 2001 - * . + * slab allocator to many cpu's and arbitrary resources. USENIX 2001) + * * It uses posix_memalign() to optimize allocations of many equally-sized * chunks, and has per-thread free lists (the so-called magazine layer) * to quickly satisfy allocation requests of already known structure sizes. diff --git a/gobject/gsignal.c b/gobject/gsignal.c index 8c67bdd..3d881f8 100644 --- a/gobject/gsignal.c +++ b/gobject/gsignal.c @@ -52,12 +52,10 @@ * basically they are a per-type facility that is inherited. A signal * emission mainly involves invocation of a certain set of callbacks * in precisely defined manner. There are two main categories of such - * callbacks, per-object - * Although signals can deal with any kind of instantiatable - * type, i'm referring to those types as "object types" in the following, - * simply because that is the context most users will encounter signals in. - * - * ones and user provided ones. + * callbacks, per-object ones and user provided ones. + * (Although signals can deal with any kind of instantiatable type, I'm + * referring to those types as "object types" in the following, simply + * because that is the context most users will encounter signals in.) * The per-object callbacks are most often referred to as "object method * handler" or "default (signal) handler", while user provided callbacks are * usually just called "signal handler". -- 2.7.4