From 35066ed6c6b51317f49069f2564c547aa309f9f1 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sun, 9 Feb 2014 02:07:26 -0500 Subject: [PATCH] Docs: Drop entities, switch away from sgml mode Since all element markup is now gone from the doc comments, we can turn off the gtk-doc sgml mode, which means that from now on, docbook markup is no longer allowed in doc comments. To make this possible, we have to replace all remaining entities in doc comments by their replacement text, & -> & and so on. --- docs/reference/gio/Makefile.am | 2 +- docs/reference/glib/Makefile.am | 2 +- docs/reference/gobject/Makefile.am | 2 +- gio/gappinfo.c | 2 +- gio/gdbusaddress.c | 2 +- gio/gdbusintrospection.c | 2 +- gio/gdesktopappinfo.c | 2 +- gio/gfileattribute.c | 2 +- gio/gfiledescriptorbased.c | 2 +- gio/gicon.c | 2 +- gio/gmenumodel.c | 2 +- gio/gnetworking.c | 2 +- gio/gproxyresolver.c | 4 ++-- gio/gsettings.c | 12 ++++++------ gio/gsocket.c | 6 +++--- gio/gunixconnection.c | 2 +- gio/gunixfdlist.c | 2 +- gio/gunixfdmessage.c | 2 +- gio/gunixinputstream.c | 2 +- gio/gunixmounts.c | 2 +- gio/gunixoutputstream.c | 2 +- gio/gunixsocketaddress.c | 2 +- gio/gwin32inputstream.c | 2 +- gio/gwin32outputstream.c | 2 +- glib/docs.c | 4 ++-- glib/gbookmarkfile.c | 6 +++--- glib/gerror.c | 12 ++++++------ glib/ggettext.c | 4 ++-- glib/ghook.c | 6 +++--- glib/glist.c | 4 ++-- glib/gmarkup.c | 10 +++++----- glib/grand.c | 2 +- glib/gregex.c | 25 +++++++++++++------------ glib/gstrfuncs.c | 30 +++++++++++++++--------------- glib/gtestutils.c | 14 +++++++------- glib/gunicollate.c | 4 ++-- glib/gvariant.c | 16 ++++++++-------- glib/gwin32.c | 4 ++-- gobject/gvaluearray.c | 2 +- 39 files changed, 104 insertions(+), 103 deletions(-) diff --git a/docs/reference/gio/Makefile.am b/docs/reference/gio/Makefile.am index b2dcce842..47fdd3851 100644 --- a/docs/reference/gio/Makefile.am +++ b/docs/reference/gio/Makefile.am @@ -99,7 +99,7 @@ GTKDOC_LIBS = \ $(NULL) # Extra options to supply to gtkdoc-mkdb -MKDB_OPTIONS = --output-format=xml --sgml-mode --name-space=g \ +MKDB_OPTIONS = --output-format=xml --name-space=g \ --ignore-files='libasyncns tests' # Images to copy into HTML directory diff --git a/docs/reference/glib/Makefile.am b/docs/reference/glib/Makefile.am index a0cc57b52..a25a7c89b 100644 --- a/docs/reference/glib/Makefile.am +++ b/docs/reference/glib/Makefile.am @@ -15,7 +15,7 @@ DOC_SOURCE_DIR=$(top_srcdir)/glib $(top_srcdir)/gmodule SCAN_OPTIONS=--deprecated-guards="G_DISABLE_DEPRECATED" --ignore-decorators="GLIB_VAR|G_GNUC_WARN_UNUSED_RESULT" # Extra options to supply to gtkdoc-mkdb -MKDB_OPTIONS=--sgml-mode --output-format=xml --name-space=g +MKDB_OPTIONS=--output-format=xml --name-space=g # Used for dependencies HFILE_GLOB=$(top_srcdir)/glib/*.h $(top_srcdir)/gmodule/*.h diff --git a/docs/reference/gobject/Makefile.am b/docs/reference/gobject/Makefile.am index b3423f3c6..beff782d3 100644 --- a/docs/reference/gobject/Makefile.am +++ b/docs/reference/gobject/Makefile.am @@ -16,7 +16,7 @@ SCAN_OPTIONS=--deprecated-guards="G_DISABLE_DEPRECATED" \ --ignore-decorators="G_GNUC_INTERNAL|G_GNUC_WARN_UNUSED_RESULT" # Extra options to supply to gtkdoc-mkdb -MKDB_OPTIONS=--sgml-mode --output-format=xml --name-space=g +MKDB_OPTIONS=--output-format=xml --name-space=g # Used for dependencies HFILE_GLOB=$(top_srcdir)/gobject/*.h diff --git a/gio/gappinfo.c b/gio/gappinfo.c index 9c20125d4..08ffaa667 100644 --- a/gio/gappinfo.c +++ b/gio/gappinfo.c @@ -41,7 +41,7 @@ * (using g_file_get_path()) when using g_app_info_launch() even if * the application requested an URI and not a POSIX path. For example * for an desktop-file based application with Exec key `totem - * %U` and a single URI, `sftp://foo/file.avi`, then + * \%U` and a single URI, `sftp://foo/file.avi`, then * `/home/user/.gvfs/sftp on foo/file.avi` will be passed. This will * only work if a set of suitable GIO extensions (such as gvfs 2.26 * compiled with FUSE support), is available and operational; if this diff --git a/gio/gdbusaddress.c b/gio/gdbusaddress.c index aaab165c0..6d17b7c81 100644 --- a/gio/gdbusaddress.c +++ b/gio/gdbusaddress.c @@ -60,7 +60,7 @@ * * Routines for working with D-Bus addresses. A D-Bus address is a string * like "unix:tmpdir=/tmp/my-app-name". The exact format of addresses - * is explained in detail in the [D-Bus specification](http://dbus.freedesktop.org/doc/dbus-specification.html#addresses). + * is explained in detail in the [D-Bus specification](http://dbus.freedesktop.org/doc/dbus-specification.html\#addresses). */ static gchar *get_session_address_platform_specific (GError **error); diff --git a/gio/gdbusintrospection.c b/gio/gdbusintrospection.c index 06234612b..0c501c41c 100644 --- a/gio/gdbusintrospection.c +++ b/gio/gdbusintrospection.c @@ -1757,7 +1757,7 @@ parser_error (GMarkupParseContext *context, * Parses @xml_data and returns a #GDBusNodeInfo representing the data. * * The introspection XML must contain exactly one top-level - * <node> element. + * element. * * Note that this routine is using a * [GMarkup][glib-Simple-XML-Subset-Parser.description]-based diff --git a/gio/gdesktopappinfo.c b/gio/gdesktopappinfo.c index 42fb61e3d..365d9bae2 100644 --- a/gio/gdesktopappinfo.c +++ b/gio/gdesktopappinfo.c @@ -58,7 +58,7 @@ * #GDesktopAppInfo is an implementation of #GAppInfo based on * desktop files. * - * Note that `<gio/gdesktopappinfo.h>` belongs to the UNIX-specific + * Note that `` belongs to the UNIX-specific * GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config * file when using it. */ diff --git a/gio/gfileattribute.c b/gio/gfileattribute.c index 08cf3aff7..98e11fed6 100644 --- a/gio/gfileattribute.c +++ b/gio/gfileattribute.c @@ -321,7 +321,7 @@ escape_byte_string (const char *str) * Converts a #GFileAttributeValue to a string for display. * The returned string should be freed when no longer needed. * - * Returns: a string from the @attr, %NULL on error, or "<invalid>" + * Returns: a string from the @attr, %NULL on error, or "" * if @attr is of type %G_FILE_ATTRIBUTE_TYPE_INVALID. */ char * diff --git a/gio/gfiledescriptorbased.c b/gio/gfiledescriptorbased.c index 130d10705..a0ae22241 100644 --- a/gio/gfiledescriptorbased.c +++ b/gio/gfiledescriptorbased.c @@ -32,7 +32,7 @@ * #GFileDescriptorBased is implemented by streams (implementations of * #GInputStream or #GOutputStream) that are based on file descriptors. * - * Note that `<gio/gfiledescriptorbased.h>` belongs to the UNIX-specific + * Note that `` belongs to the UNIX-specific * GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config * file when using it. * diff --git a/gio/gicon.c b/gio/gicon.c index abc5749af..03735d602 100644 --- a/gio/gicon.c +++ b/gio/gicon.c @@ -197,7 +197,7 @@ g_icon_to_string_tokenized (GIcon *icon, GString *s) * (such as `/path/to/my icon.png`) without escaping * if the #GFile for @icon is a native file. If the file is not * native, the returned string is the result of g_file_get_uri() - * (such as `sftp://path/to/my%20icon.png`). + * (such as `sftp://path/to/my\%20icon.png`). * * - If @icon is a #GThemedIcon with exactly one name, the encoding is * simply the name (such as `network-server`). diff --git a/gio/gmenumodel.c b/gio/gmenumodel.c index a20f60b64..612f8e7ae 100644 --- a/gio/gmenumodel.c +++ b/gio/gmenumodel.c @@ -571,7 +571,7 @@ g_menu_model_get_item_attribute_value (GMenuModel *model, * g_variant_get(), followed by a g_variant_unref(). As such, * @format_string must make a complete copy of the data (since the * #GVariant may go away after the call to g_variant_unref()). In - * particular, no '&' characters are allowed in @format_string. + * particular, no '&' characters are allowed in @format_string. * * Returns: %TRUE if the named attribute was found with the expected * type diff --git a/gio/gnetworking.c b/gio/gnetworking.c index 5709e2048..30f4d18fa 100644 --- a/gio/gnetworking.c +++ b/gio/gnetworking.c @@ -28,7 +28,7 @@ * @short_description: System networking includes * @include: gio/gnetworking.h * - * The `<gio/gnetworking.h>` header can be included to get + * The `` header can be included to get * various low-level networking-related system headers, automatically * taking care of certain portability issues for you. * diff --git a/gio/gproxyresolver.c b/gio/gproxyresolver.c index a15cbb493..7f7e1bc1e 100644 --- a/gio/gproxyresolver.c +++ b/gio/gproxyresolver.c @@ -98,8 +98,8 @@ g_proxy_resolver_is_supported (GProxyResolver *resolver) * * Looks into the system proxy configuration to determine what proxy, * if any, to use to connect to @uri. The returned proxy URIs are of - * the form `<protocol>://[user[:password]@]host:port` or - * `direct://`, where <protocol> could be http, rtsp, socks + * the form `://[user[:password]@]host:port` or + * `direct://`, where could be http, rtsp, socks * or other proxying protocol. * * If you don't know what network protocol is being used on the diff --git a/gio/gsettings.c b/gio/gsettings.c index 5e94e6927..66effae25 100644 --- a/gio/gsettings.c +++ b/gio/gsettings.c @@ -86,9 +86,9 @@ * Similar to GConf, the default values in GSettings schemas can be * localized, but the localized values are stored in gettext catalogs * and looked up with the domain that is specified in the - * gettext-domain attribute of the <schemalist> or <schema> + * gettext-domain attribute of the or * elements and the category that is specified in the l10n attribute of - * the <key> element. + * the element. * * GSettings uses schemas in a compact binary form that is created * by the [glib-compile-schemas][glib-compile-schemas] @@ -101,7 +101,7 @@ * files to have the extension `.gschema.xml`. * * At runtime, schemas are identified by their id (as specified in the - * id attribute of the <schema> element). The convention for schema + * id attribute of the element). The convention for schema * ids is to use a dotted name, similar in style to a D-Bus bus name, * e.g. "org.gnome.SessionManager". In particular, if the settings are * for a specific service that owns a D-Bus bus name, the D-Bus bus name @@ -110,8 +110,8 @@ * StudlyCaps, e.g. "org.gnome.font-rendering". * * In addition to #GVariant types, keys can have types that have - * enumerated types. These can be described by a <choice>, - * <enum> or <flags> element, as seen in the + * enumerated types. These can be described by a , + * or element, as seen in the * [example][schema-enumerated]. The underlying type of such a key * is string, but you can use g_settings_get_enum(), g_settings_set_enum(), * g_settings_get_flags(), g_settings_set_flags() access the numeric values @@ -2178,7 +2178,7 @@ g_settings_is_writable (GSettings *settings, * @settings. * * The schema for the child settings object must have been declared - * in the schema of @settings using a <child> element. + * in the schema of @settings using a element. * * Returns: (transfer full): a 'child' settings object * diff --git a/gio/gsocket.c b/gio/gsocket.c index 6c0bcc853..fb3bf9640 100644 --- a/gio/gsocket.c +++ b/gio/gsocket.c @@ -68,7 +68,7 @@ * SECTION:gsocket * @short_description: Low-level socket object * @include: gio/gio.h - * @see_also: #GInitable, [<gnetworking.h>][gio-gnetworking.h] + * @see_also: #GInitable, [][gio-gnetworking.h] * * A #GSocket is a low-level networking primitive. It is a more or less * direct mapping of the BSD socket API in a portable GObject based API. @@ -4516,7 +4516,7 @@ g_socket_get_credentials (GSocket *socket, * getsockopt(). (If you need to fetch a non-integer-valued option, * you will need to call getsockopt() directly.) * - * The [<gio/gnetworking.h>][gio-gnetworking.h] + * The [][gio-gnetworking.h] * header pulls in system headers that will define most of the * standard/portable socket options. For unusual socket protocols or * platform-dependent options, you may need to include additional @@ -4583,7 +4583,7 @@ g_socket_get_option (GSocket *socket, * setsockopt(). (If you need to set a non-integer-valued option, * you will need to call setsockopt() directly.) * - * The [<gio/gnetworking.h>][gio-gnetworking.h] + * The [][gio-gnetworking.h] * header pulls in system headers that will define most of the * standard/portable socket options. For unusual socket protocols or * platform-dependent options, you may need to include additional diff --git a/gio/gunixconnection.c b/gio/gunixconnection.c index f2269c70e..b5da60a4e 100644 --- a/gio/gunixconnection.c +++ b/gio/gunixconnection.c @@ -39,7 +39,7 @@ * It contains functions to do some of the UNIX socket specific * functionality like passing file descriptors. * - * Note that `<gio/gunixconnection.h>` belongs to the UNIX-specific + * Note that `` belongs to the UNIX-specific * GIO interfaces, thus you have to use the `gio-unix-2.0.pc` * pkg-config file when using it. * diff --git a/gio/gunixfdlist.c b/gio/gunixfdlist.c index b42362cc5..5808e40cd 100644 --- a/gio/gunixfdlist.c +++ b/gio/gunixfdlist.c @@ -26,7 +26,7 @@ * the %G_SOCKET_ADDRESS_UNIX family by using g_socket_send_message() * and received using g_socket_receive_message(). * - * Note that `<gio/gunixfdlist.h>` belongs to the UNIX-specific GIO + * Note that `` belongs to the UNIX-specific GIO * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config * file when using it. */ diff --git a/gio/gunixfdmessage.c b/gio/gunixfdmessage.c index 3b9e73a0d..12e62c53f 100644 --- a/gio/gunixfdmessage.c +++ b/gio/gunixfdmessage.c @@ -29,7 +29,7 @@ * stream-oriented UNIX sockets, see g_unix_connection_send_fd() and * g_unix_connection_receive_fd(). * - * Note that `<gio/gunixfdmessage.h>` belongs to the UNIX-specific GIO + * Note that `` belongs to the UNIX-specific GIO * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config * file when using it. */ diff --git a/gio/gunixinputstream.c b/gio/gunixinputstream.c index 388cc8093..1d7d88d30 100644 --- a/gio/gunixinputstream.c +++ b/gio/gunixinputstream.c @@ -51,7 +51,7 @@ * asynchronous I/O. If it refers to a regular file, it will fall back * to doing asynchronous I/O in another thread.) * - * Note that `<gio/gunixinputstream.h>` belongs to the UNIX-specific GIO + * Note that `` belongs to the UNIX-specific GIO * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config * file when using it. */ diff --git a/gio/gunixmounts.c b/gio/gunixmounts.c index 63dbe2341..4999354c6 100644 --- a/gio/gunixmounts.c +++ b/gio/gunixmounts.c @@ -79,7 +79,7 @@ static const char *_resolve_dev_root (void); * * Routines for managing mounted UNIX mount points and paths. * - * Note that `<gio/gunixmounts.h>` belongs to the UNIX-specific GIO + * Note that `` belongs to the UNIX-specific GIO * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config * file when using it. */ diff --git a/gio/gunixoutputstream.c b/gio/gunixoutputstream.c index b748a95a5..353be07d0 100644 --- a/gio/gunixoutputstream.c +++ b/gio/gunixoutputstream.c @@ -51,7 +51,7 @@ * asynchronous I/O. If it refers to a regular file, it will fall back * to doing asynchronous I/O in another thread.) * - * Note that `<gio/gunixoutputstream.h>` belongs to the UNIX-specific GIO + * Note that `` belongs to the UNIX-specific GIO * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file * when using it. */ diff --git a/gio/gunixsocketaddress.c b/gio/gunixsocketaddress.c index 93cbe57e6..70973b8eb 100644 --- a/gio/gunixsocketaddress.c +++ b/gio/gunixsocketaddress.c @@ -44,7 +44,7 @@ * errors. You can use g_unix_socket_address_abstract_names_supported() * to see if abstract names are supported. * - * Note that `<gio/gunixsocketaddress.h>` belongs to the UNIX-specific GIO + * Note that `` belongs to the UNIX-specific GIO * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file * when using it. */ diff --git a/gio/gwin32inputstream.c b/gio/gwin32inputstream.c index bf142d6ec..685ecb0dd 100644 --- a/gio/gwin32inputstream.c +++ b/gio/gwin32inputstream.c @@ -44,7 +44,7 @@ * #GWin32InputStream implements #GInputStream for reading from a * Windows file handle. * - * Note that `<gio/gwin32inputstream.h>` belongs to the Windows-specific GIO + * Note that `` belongs to the Windows-specific GIO * interfaces, thus you have to use the `gio-windows-2.0.pc` pkg-config file * when using it. */ diff --git a/gio/gwin32outputstream.c b/gio/gwin32outputstream.c index 5040ac45b..13476c02a 100644 --- a/gio/gwin32outputstream.c +++ b/gio/gwin32outputstream.c @@ -45,7 +45,7 @@ * #GWin32OutputStream implements #GOutputStream for writing to a * Windows file handle. * - * Note that `<gio/gwin32outputstream.h>` belongs to the Windows-specific GIO + * Note that `` belongs to the Windows-specific GIO * interfaces, thus you have to use the `gio-windows-2.0.pc` pkg-config file * when using it. */ diff --git a/glib/docs.c b/glib/docs.c index b212ce1df..025491b7a 100644 --- a/glib/docs.c +++ b/glib/docs.c @@ -1526,14 +1526,14 @@ * G_OS_WIN32: * * This macro is defined only on Windows. So you can bracket - * Windows-specific code in "#ifdef G_OS_WIN32". + * Windows-specific code in "\#ifdef G_OS_WIN32". */ /** * G_OS_UNIX: * * This macro is defined only on UNIX. So you can bracket - * UNIX-specific code in "#ifdef G_OS_UNIX". + * UNIX-specific code in "\#ifdef G_OS_UNIX". */ /** diff --git a/glib/gbookmarkfile.c b/glib/gbookmarkfile.c index bd63d86d0..9f94d7102 100644 --- a/glib/gbookmarkfile.c +++ b/glib/gbookmarkfile.c @@ -66,11 +66,11 @@ * Desktop Bookmark Specification, here is a quick summary: bookmark * files use a sub-class of the XML Bookmark Exchange Language * specification, consisting of valid UTF-8 encoded XML, under the - * <xbel> root element; each bookmark is stored inside a - * <bookmark> element, using its URI: no relative paths can + * root element; each bookmark is stored inside a + * element, using its URI: no relative paths can * be used inside a bookmark file. The bookmark may have a user defined * title and description, to be used instead of the URI. Under the - * <metadata> element, with its owner attribute set to + * element, with its owner attribute set to * `http://freedesktop.org`, is stored the meta-data about a resource * pointed by its URI. The meta-data consists of the resource's MIME * type; the applications that have registered a bookmark; the groups diff --git a/glib/gerror.c b/glib/gerror.c index 7358844f6..304320773 100644 --- a/glib/gerror.c +++ b/glib/gerror.c @@ -243,7 +243,7 @@ * * Error domains and codes are conventionally named as follows: * - * - The error domain is called <NAMESPACE>_<MODULE>_ERROR, + * - The error domain is called __ERROR, * for example %G_SPAWN_ERROR or %G_THREAD_ERROR: * |[ * #define G_SPAWN_ERROR g_spawn_error_quark () @@ -256,20 +256,20 @@ * ]| * * - The quark function for the error domain is called - * <namespace>_<module>_error_quark, + * __error_quark, * for example g_spawn_error_quark() or g_thread_error_quark(). * * - The error codes are in an enumeration called - * <Namespace><Module>Error; - * for example,#GThreadError or #GSpawnError. + * Error; + * for example, #GThreadError or #GSpawnError. * * - Members of the error code enumeration are called - * <NAMESPACE>_<MODULE>_ERROR_<CODE>, + * __ERROR_, * for example %G_SPAWN_ERROR_FORK or %G_THREAD_ERROR_AGAIN. * * - If there's a "generic" or "unknown" error code for unrecoverable * errors it doesn't make sense to distinguish with specific codes, - * it should be called <NAMESPACE>_<MODULE>_ERROR_FAILED, + * it should be called __ERROR_FAILED, * for example %G_SPAWN_ERROR_FAILED. * * Summary of rules for use of #GError: diff --git a/glib/ggettext.c b/glib/ggettext.c index a24e88583..daadf7c08 100644 --- a/glib/ggettext.c +++ b/glib/ggettext.c @@ -473,8 +473,8 @@ g_dngettext (const gchar *domain, * easy-to-use form. * * In order to use these macros in an application, you must include - * `<glib/gi18n.h>`. For use in a library, you must include - * `<glib/gi18n-lib.h>` + * ``. For use in a library, you must include + * `` * after defining the %GETTEXT_PACKAGE macro suitably for your library: * |[ * #define GETTEXT_PACKAGE "gtk20" diff --git a/glib/ghook.c b/glib/ghook.c index 0ea69845f..44a2665e5 100644 --- a/glib/ghook.c +++ b/glib/ghook.c @@ -91,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. */ @@ -973,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 */ /** @@ -1035,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, diff --git a/glib/glist.c b/glib/glist.c index 85d1e1844..5a39b5f68 100644 --- a/glib/glist.c +++ b/glib/glist.c @@ -1195,7 +1195,7 @@ g_list_sort_real (GList *list, * value comes before the second, 0 if they are equal, or a positive * integer if the first value comes after the second. * - * Returns: negative value if @a < @b; zero if @a = @b; positive + * Returns: negative value if @a < @b; zero if @a = @b; positive * value if @a > @b */ GList * @@ -1227,7 +1227,7 @@ g_list_sort (GList *list, * value comes before the second, 0 if they are equal, or a positive * integer if the first value comes after the second. * - * Returns: negative value if @a < @b; zero if @a = @b; positive + * Returns: negative value if @a < @b; zero if @a = @b; positive * value if @a > @b */ GList * diff --git a/glib/gmarkup.c b/glib/gmarkup.c index d7fde2e26..4c1fcb00b 100644 --- a/glib/gmarkup.c +++ b/glib/gmarkup.c @@ -77,7 +77,7 @@ * * - Attributes * - * - 5 standard entities: &amp; &lt; &gt; &quot; &apos; + * - 5 standard entities: & < > " ' * * - Character references * @@ -631,7 +631,7 @@ unescape_gstring_inplace (GMarkupParseContext *context, normalize_attribute = FALSE; /* - * Meeks' theorum: unescaping can only shrink text. + * Meeks' theorem: unescaping can only shrink text. * for < etc. this is obvious, for ￿ more * thought is required, but this is patently so. */ @@ -2215,7 +2215,7 @@ append_escaped_text (GString *str, * of line endings and attribute values. * * Note also that this function will produce character references in - * the range of &#x1; ... &#x1f; for all control sequences + * the range of  ...  for all control sequences * except for tabstop, newline and carriage return. The character * references in this range are not valid XML 1.0, but they are * valid XML 1.1 and will be accepted by the GMarkup parser. @@ -2417,9 +2417,9 @@ g_markup_vprintf_escaped (const gchar *format, * To find the span of the first argument, we find the first position * where the two arguments differ, which tells us that the first * argument formatted to "Susan & Fred". We then escape that - * to "Susan & Fred" and join up with the intermediate portions + * to "Susan & Fred" and join up with the intermediate portions * of the format string and the second argument to get - * "Susan & Fred ate 5 apples". + * "Susan & Fred ate 5 apples". */ /* Create the two modified format strings diff --git a/glib/grand.c b/glib/grand.c index bfc938da5..f2a44d040 100644 --- a/glib/grand.c +++ b/glib/grand.c @@ -92,7 +92,7 @@ * * The g_rand*_range functions will return high quality equally * distributed random numbers, whereas for example the - * `(g_random_int()%max)` approach often + * `(g_random_int()\%max)` approach often * doesn't yield equally distributed numbers. * * GLib changed the seeding algorithm for the pseudo-random number diff --git a/glib/gregex.c b/glib/gregex.c index 45d3c52b9..c3740c47d 100644 --- a/glib/gregex.c +++ b/glib/gregex.c @@ -1103,7 +1103,7 @@ get_matched_substring_number (const GMatchInfo *match_info, * Retrieves the text matching the capturing parentheses named @name. * * If @name is a valid sub pattern name but it didn't match anything - * (e.g. sub pattern "X", matching "b" against "(?P<X>a)?b") + * (e.g. sub pattern "X", matching "b" against "(?Pa)?b") * then an empty string is returned. * * The string is fetched from the string passed to the match function, @@ -1144,7 +1144,7 @@ g_match_info_fetch_named (const GMatchInfo *match_info, * Retrieves the position in bytes of the capturing parentheses named @name. * * If @name is a valid sub pattern name but it didn't match anything - * (e.g. sub pattern "X", matching "b" against "(?P<X>a)?b") + * (e.g. sub pattern "X", matching "b" against "(?Pa)?b") * then @start_pos and @end_pos are set to -1 and %TRUE is returned. * * Returns: %TRUE if the position was fetched, %FALSE otherwise. @@ -1824,15 +1824,15 @@ g_regex_match_all (const GRegex *regex, * Using the standard algorithm for regular expression matching only * the longest match in the string is retrieved, it is not possible * to obtain all the available matches. For instance matching - * "<a> <b> <c>" against the pattern "<.*>" - * you get "<a> <b> <c>". + * " " against the pattern "<.*>" + * you get " ". * * This function uses a different algorithm (called DFA, i.e. deterministic * finite automaton), so it can retrieve all the possible matches, all * starting at the same point in the string. For instance matching - * "<a> <b> <c>" against the pattern "<.*>" - * you would obtain three matches: "<a> <b> <c>", - * "<a> <b>" and "<a>". + * " " against the pattern "<.*>;" + * you would obtain three matches: " ", + * " " and "". * * The number of matched strings is retrieved using * g_match_info_get_match_count(). To obtain the matched strings and @@ -2694,11 +2694,12 @@ interpolation_list_needs_match (GList *list) * * Replaces all occurrences of the pattern in @regex with the * replacement text. Backreferences of the form '\number' or - * '\g<number>' in the replacement text are interpolated by the - * number-th captured subexpression of the match, '\g<name>' refers - * to the captured subexpression with the given name. '\0' refers to the - * complete match, but '\0' followed by a number is the octal representation - * of a character. To include a literal '\' in the replacement, write '\\'. + * '\g' in the replacement text are interpolated by the + * number-th captured subexpression of the match, '\g' refers + * to the captured subexpression with the given name. '\0' refers + * to the complete match, but '\0' followed by a number is the octal + * representation of a character. To include a literal '\' in the + * replacement, write '\\'. * * There are also escapes that changes the case of the following text: * diff --git a/glib/gstrfuncs.c b/glib/gstrfuncs.c index f4f6d5e36..ab36b45db 100644 --- a/glib/gstrfuncs.c +++ b/glib/gstrfuncs.c @@ -67,21 +67,21 @@ * g_snprintf(), g_vprintf(), g_vfprintf(), g_vsprintf() and g_vsnprintf() * are declared in the header `gprintf.h` which is not included in `glib.h` * (otherwise using `glib.h` would drag in `stdio.h`), so you'll have to - * explicitly include `<glib/gprintf.h>` in order to use the GLib + * explicitly include `` in order to use the GLib * printf() functions. * * ## String precision pitfalls # {#string-precision} * * While you may use the printf() functions to format UTF-8 strings, - * notice that the precision of a %Ns parameter is interpreted + * notice that the precision of a \%Ns parameter is interpreted * as the number of bytes, not characters to print. On top of that, * the GNU libc implementation of the printf() functions has the - * "feature" that it checks that the string given for the %Ns + * "feature" that it checks that the string given for the \%Ns * parameter consists of a whole number of characters in the current * encoding. So, unless you are sure you are always going to be in an * UTF-8 locale or your know your text is restricted to ASCII, avoid - * using %Ns. If your intention is to format strings for a - * certain number of columns, then %Ns is not a correct solution + * using \%Ns. If your intention is to format strings for a + * certain number of columns, then \%Ns is not a correct solution * anyway, since it fails to take wide characters (see g_unichar_iswide()) * into account. */ @@ -1234,7 +1234,7 @@ g_ascii_strtoll (const gchar *nptr, * not all platforms support the strerror() function. * * Returns: a UTF-8 string describing the error code. If the error code - * is unknown, it returns "unknown error (<code>)". + * is unknown, it returns "unknown error ()". */ const gchar * g_strerror (gint errnum) @@ -1264,7 +1264,7 @@ g_strerror (gint errnum) * the strsignal() function. * * Returns: a UTF-8 string describing the signal. If the signal is unknown, - * it returns "unknown signal (<signum>)". + * it returns "unknown signal ()". */ const gchar * g_strsignal (gint signum) @@ -1734,8 +1734,8 @@ g_ascii_xdigit_value (gchar c) * * Both @s1 and @s2 must be non-%NULL. * - * Return value: 0 if the strings match, a negative value if @s1 < @s2, - * or a positive value if @s1 > @s2. + * Return value: 0 if the strings match, a negative value if @s1 < @s2, + * or a positive value if @s1 > @s2. */ gint g_ascii_strcasecmp (const gchar *s1, @@ -1775,8 +1775,8 @@ g_ascii_strcasecmp (const gchar *s1, * function only on strings known to be in encodings where bytes * corresponding to ASCII letters always represent themselves. * - * Return value: 0 if the strings match, a negative value if @s1 < @s2, - * or a positive value if @s1 > @s2. + * Return value: 0 if the strings match, a negative value if @s1 < @s2, + * or a positive value if @s1 > @s2. */ gint g_ascii_strncasecmp (const gchar *s1, @@ -1812,8 +1812,8 @@ g_ascii_strncasecmp (const gchar *s1, * A case-insensitive string comparison, corresponding to the standard * strcasecmp() function on platforms which support it. * - * Return value: 0 if the strings match, a negative value if @s1 < @s2, - * or a positive value if @s1 > @s2. + * Return value: 0 if the strings match, a negative value if @s1 < @s2, + * or a positive value if @s1 > @s2. * * Deprecated:2.2: See g_strncasecmp() for a discussion of why this * function is deprecated and how to replace it. @@ -1860,8 +1860,8 @@ g_strcasecmp (const gchar *s1, * to g_strcasecmp() except it only compares the first @n characters of * the strings. * - * Return value: 0 if the strings match, a negative value if @s1 < @s2, - * or a positive value if @s1 > @s2. + * Return value: 0 if the strings match, a negative value if @s1 < @s2, + * or a positive value if @s1 > @s2. * * Deprecated:2.2: The problem with g_strncasecmp() is that it does * the comparison by calling toupper()/tolower(). These functions diff --git a/glib/gtestutils.c b/glib/gtestutils.c index 92a40d737..09f3adc6a 100644 --- a/glib/gtestutils.c +++ b/glib/gtestutils.c @@ -393,7 +393,7 @@ * g_assert_cmpstr: * @s1: a string (may be %NULL) * @cmp: The comparison operator to use. - * One of ==, !=, <, >, <=, >=. + * One of ==, !=, <, >, <=, >=. * @s2: another string (may be %NULL) * * Debugging macro to compare two strings. If the comparison fails, @@ -417,7 +417,7 @@ * g_assert_cmpint: * @n1: an integer * @cmp: The comparison operator to use. - * One of ==, !=, <, >, <=, >=. + * One of ==, !=, <, >, <=, >=. * @n2: another integer * * Debugging macro to compare two integers. @@ -434,7 +434,7 @@ * g_assert_cmpuint: * @n1: an unsigned integer * @cmp: The comparison operator to use. - * One of ==, !=, <, >, <=, >=. + * One of ==, !=, <, >, <=, >=. * @n2: another unsigned integer * * Debugging macro to compare two unsigned integers. @@ -451,7 +451,7 @@ * g_assert_cmphex: * @n1: an unsigned integer * @cmp: The comparison operator to use. - * One of ==, !=, <, >, <=, >=. + * One of ==, !=, <, >, <=, >=. * @n2: another unsigned integer * * Debugging macro to compare to unsigned integers. @@ -466,7 +466,7 @@ * g_assert_cmpfloat: * @n1: an floating point number * @cmp: The comparison operator to use. - * One of ==, !=, <, >, <=, >=. + * One of ==, !=, <, >, <=, >=. * @n2: another floating point number * * Debugging macro to compare two floating point numbers. @@ -503,8 +503,8 @@ * the correct #GError. * * The effect of `g_assert_error (err, dom, c)` is - * the same as `g_assert_true (err != NULL && err->domain - * == dom && err->code == c)`. The advantage of this + * the same as `g_assert_true (err != NULL && err->domain + * == dom && err->code == c)`. The advantage of this * macro is that it can produce a message that includes the incorrect * error message and code. * diff --git a/glib/gunicollate.c b/glib/gunicollate.c index 6440dd228..3aa94ffca 100644 --- a/glib/gunicollate.c +++ b/glib/gunicollate.c @@ -71,8 +71,8 @@ msc_strxfrm_wrapper (char *string1, * compare the keys with strcmp() when sorting instead of sorting * the original strings. * - * Return value: < 0 if @str1 compares before @str2, - * 0 if they compare equal, > 0 if @str1 compares after @str2. + * Return value: < 0 if @str1 compares before @str2, + * 0 if they compare equal, > 0 if @str1 compares after @str2. **/ gint g_utf8_collate (const gchar *str1, diff --git a/glib/gvariant.c b/glib/gvariant.c index be871eb28..7995220fd 100644 --- a/glib/gvariant.c +++ b/glib/gvariant.c @@ -2762,9 +2762,9 @@ g_variant_equal (gconstpointer one, * If you only require an equality comparison, g_variant_equal() is more * general. * - * Returns: negative value if a < b; + * Returns: negative value if a < b; * zero if a = b; - * positive value if a > b. + * positive value if a > b. * * Since: 2.26 **/ @@ -3672,17 +3672,17 @@ g_variant_builder_end (GVariantBuilder *builder) * GVariantDict dict; * guint32 count; * - * g_variant_dict_init (&dict, orig); - * if (!g_variant_dict_lookup (&dict, "count", "u", &count)) + * g_variant_dict_init (&dict, orig); + * if (!g_variant_dict_lookup (&dict, "count", "u", &count)) * { * g_set_error (...); - * g_variant_dict_clear (&dict); + * g_variant_dict_clear (&dict); * return NULL; * } * - * g_variant_dict_insert (&dict, "count", "u", count + 1); + * g_variant_dict_insert (&dict, "count", "u", count + 1); * - * return g_variant_dict_end (&dict); + * return g_variant_dict_end (&dict); * } * ]| * @@ -3699,7 +3699,7 @@ g_variant_builder_end (GVariantBuilder *builder) * * dict = g_variant_dict_new (orig); * - * if (g_variant_dict_lookup (dict, "count", "u", &count)) + * if (g_variant_dict_lookup (dict, "count", "u", &count)) * { * g_variant_dict_insert (dict, "count", "u", count + 1); * result = g_variant_dict_end (dict); diff --git a/glib/gwin32.c b/glib/gwin32.c index 14579e22f..fa2ba3e28 100644 --- a/glib/gwin32.c +++ b/glib/gwin32.c @@ -335,8 +335,8 @@ get_package_directory_from_module (const gchar *module_name) * the package, typically the same identifier as used for * `GETTEXT_PACKAGE` in software configured using GNU * autotools. The function first looks in the Windows Registry for the - * value `#InstallationDirectory` in the key - * `#HKLM\Software\@package`, and if that value + * value `#InstallationDirectory` in the key + * `#HKLM\Software\@package`, and if that value * exists and is a string, returns that. * * It is strongly recommended that packagers of GLib-using libraries diff --git a/gobject/gvaluearray.c b/gobject/gvaluearray.c index 2ab84361a..fb92ba854 100644 --- a/gobject/gvaluearray.c +++ b/gobject/gvaluearray.c @@ -257,7 +257,7 @@ g_value_array_append (GValueArray *value_array, /** * g_value_array_insert: * @value_array: #GValueArray to add an element to - * @index_: insertion position, must be <= value_array->n_values + * @index_: insertion position, must be <= value_array->n_values * @value: (allow-none): #GValue to copy into #GValueArray, or %NULL * * Insert a copy of @value at specified position into @value_array. If @value