luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-03-15 04:05:11 +01:00
Code Issues Packages Projects Releases Wiki Activity

Docs: replace <literal> by `

Browse Source
This commit is contained in:
Matthias Clasen 2014-02-06 08:04:52 -05:00
parent a35d8a4c77
commit 3232425785
62 changed files with 369 additions and 404 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
gio/gappinfo.c
View File

@ -40,15 +40,13 @@
* As of GLib 2.20, URIs will always be converted to POSIX paths * As of GLib 2.20, URIs will always be converted to POSIX paths
* (using g_file_get_path()) when using g_app_info_launch() even if * (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 * the application requested an URI and not a POSIX path. For example
* for an desktop-file based application with Exec key <literal>totem * for an desktop-file based application with Exec key `totem
* &percnt;U</literal> and a single URI, * &percnt;U` and a single URI, `sftp://foo/file.avi`, then
* <literal>sftp://foo/file.avi</literal>, then * `/home/user/.gvfs/sftp on foo/file.avi` will be passed. This will
* <literal>/home/user/.gvfs/sftp on foo/file.avi</literal> will be * only work if a set of suitable GIO extensions (such as gvfs 2.26
* passed. This will only work if a set of suitable GIO extensions * compiled with FUSE support), is available and operational; if this
* (such as gvfs 2.26 compiled with FUSE support), is available and * is not the case, the URI will be passed unmodified to the application.
* operational; if this is not the case, the URI will be passed * Some URIs, such as `mailto:`, of course cannot be mapped to a POSIX
* unmodified to the application. Some URIs, such as
* <literal>mailto:</literal>, of course cannot be mapped to a POSIX
* path (in gvfs there's no FUSE mount for it); such URIs will be * path (in gvfs there's no FUSE mount for it); such URIs will be
* passed unmodified to the application. * passed unmodified to the application.
* *
@ -61,31 +59,30 @@
* equal to the result of g_file_get_uri(). The following snippet * equal to the result of g_file_get_uri(). The following snippet
* illustrates this: * illustrates this:
* *
* <programlisting> * |[
* GFile *f; * GFile *f;
* char *uri; * char *uri;
* *
* file = g_file_new_for_commandline_arg (uri_from_commandline); * file = g_file_new_for_commandline_arg (uri_from_commandline);
* *
* uri = g_file_get_uri (file); * uri = g_file_get_uri (file);
* strcmp (uri, uri_from_commandline) == 0; // FALSE * strcmp (uri, uri_from_commandline) == 0;
* g_free (uri); * g_free (uri);
* *
* if (g_file_has_uri_scheme (file, "cdda")) * if (g_file_has_uri_scheme (file, "cdda"))
* { * {
* // do something special with uri * /&ast; do something special with uri &ast;/
* } * }
* g_object_unref (file); * g_object_unref (file);
* </programlisting> * ]|
* *
* This code will work when both <literal>cdda://sr0/Track * This code will work when both `cdda://sr0/Track 1.wav` and
* 1.wav</literal> and <literal>/home/user/.gvfs/cdda on sr0/Track * `/home/user/.gvfs/cdda on sr0/Track 1.wav` is passed to the
* 1.wav</literal> is passed to the application. It should be noted * application. It should be noted that it's generally not safe
* that it's generally not safe for applications to rely on the format * for applications to rely on the format of a particular URIs.
* of a particular URIs. Different launcher applications (e.g. file * Different launcher applications (e.g. file managers) may have
* managers) may have different ideas of what a given URI means. * different ideas of what a given URI means.
* */
**/
typedef GAppInfoIface GAppInfoInterface; typedef GAppInfoIface GAppInfoInterface;
G_DEFINE_INTERFACE (GAppInfo, g_app_info, G_TYPE_OBJECT) G_DEFINE_INTERFACE (GAppInfo, g_app_info, G_TYPE_OBJECT)
@ -926,7 +923,7 @@ g_app_launch_context_unsetenv (GAppLaunchContext *context,
* Gets the complete environment variable list to be passed to * Gets the complete environment variable list to be passed to
* the child process when @context is used to launch an application. * the child process when @context is used to launch an application.
* This is a %NULL-terminated array of strings, where each string has * This is a %NULL-terminated array of strings, where each string has
* the form <literal>KEY=VALUE</literal>. * the form `KEY=VALUE`.
* *
* Return value: (array zero-terminated=1) (transfer full): the * Return value: (array zero-terminated=1) (transfer full): the
* child's environment * child's environment

6
gio/gapplicationcommandline.c
View File

@ -149,9 +149,9 @@
* } * }
* ]| * ]|
* In this example of split commandline handling, options that start * In this example of split commandline handling, options that start
* with <literal>--local-</literal> are handled locally, all other * with `--local-` are handled locally, all other options are passed
* options are passed to the #GApplication::command-line handler * to the #GApplication::command-line handler which runs in the primary
* which runs in the primary instance. * instance.
* *
* The complete example can be found here: * The complete example can be found here:
* [gapplication-example-cmdline2.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-cmdline2.c) * [gapplication-example-cmdline2.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-cmdline2.c)

13
gio/gasyncresult.c
View File

@ -170,13 +170,12 @@ g_async_result_get_source_object (GAsyncResult *res)
* g_simple_async_result_propagate_error(). Otherwise it returns * g_simple_async_result_propagate_error(). Otherwise it returns
* %FALSE. * %FALSE.
* *
* This can be used for legacy error handling in async * This can be used for legacy error handling in async *_finish()
* <literal>_finish ()</literal> wrapper functions that traditionally * wrapper functions that traditionally handled #GSimpleAsyncResult
* handled #GSimpleAsyncResult error returns themselves rather than * error returns themselves rather than calling into the virtual method.
* calling into the virtual method. This should not be used in new * This should not be used in new code; #GAsyncResult errors that are
* code; #GAsyncResult errors that are set by virtual methods should * set by virtual methods should also be extracted by virtual methods,
* also be extracted by virtual methods, to enable subclasses to chain * to enable subclasses to chain up correctly.
* up correctly.
* *
* Returns: %TRUE if @error is has been filled in with an error from * Returns: %TRUE if @error is has been filled in with an error from
* @res, %FALSE if not. * @res, %FALSE if not.

4
gio/gdbusauthobserver.c
View File

@ -178,7 +178,7 @@ g_dbus_auth_observer_class_init (GDBusAuthObserverClass *klass)
/** /**
* GDBusAuthObserver::allow-mechanism: * GDBusAuthObserver::allow-mechanism:
* @observer: The #GDBusAuthObserver emitting the signal. * @observer: The #GDBusAuthObserver emitting the signal.
* @mechanism: The name of the mechanism, e.g. <literal>DBUS_COOKIE_SHA1</literal>. * @mechanism: The name of the mechanism, e.g. `DBUS_COOKIE_SHA1`.
* *
* Emitted to check if @mechanism is allowed to be used. * Emitted to check if @mechanism is allowed to be used.
* *
@ -253,7 +253,7 @@ g_dbus_auth_observer_authorize_authenticated_peer (GDBusAuthObserver *observer,
/** /**
* g_dbus_auth_observer_allow_mechanism: * g_dbus_auth_observer_allow_mechanism:
* @observer: A #GDBusAuthObserver. * @observer: A #GDBusAuthObserver.
* @mechanism: The name of the mechanism, e.g. <literal>DBUS_COOKIE_SHA1</literal>. * @mechanism: The name of the mechanism, e.g. `DBUS_COOKIE_SHA1`.
* *
* Emits the #GDBusAuthObserver::allow-mechanism signal on @observer. * Emits the #GDBusAuthObserver::allow-mechanism signal on @observer.
* *

14
gio/gdbusconnection.c
View File

@ -960,11 +960,11 @@ g_dbus_connection_class_init (GDBusConnectionClass *klass)
* GDBusConnection:exit-on-close: * GDBusConnection:exit-on-close:
* *
* A boolean specifying whether the process will be terminated (by * A boolean specifying whether the process will be terminated (by
* calling <literal>raise(SIGTERM)</literal>) if the connection * calling `raise(SIGTERM)`) if the connection is closed by the
* is closed by the remote peer. * remote peer.
* *
* Note that #GDBusConnection objects returned by g_bus_get_finish() and * Note that #GDBusConnection objects returned by g_bus_get_finish()
* g_bus_get_sync() will (usually) have this property set to %TRUE. * and g_bus_get_sync() will (usually) have this property set to %TRUE.
* *
* Since: 2.26 * Since: 2.26
*/ */
@ -5097,13 +5097,13 @@ obj_message_func (GDBusConnection *connection,
* *
* Note that all #GVariant values passed to functions in @vtable will match * Note that all #GVariant values passed to functions in @vtable will match
* the signature given in @interface_info - if a remote caller passes * the signature given in @interface_info - if a remote caller passes
* incorrect values, the <literal>org.freedesktop.DBus.Error.InvalidArgs</literal> * incorrect values, the `org.freedesktop.DBus.Error.InvalidArgs`
* is returned to the remote caller. * is returned to the remote caller.
* *
* Additionally, if the remote caller attempts to invoke methods or * Additionally, if the remote caller attempts to invoke methods or
* access properties not mentioned in @interface_info the * access properties not mentioned in @interface_info the
* <literal>org.freedesktop.DBus.Error.UnknownMethod</literal> resp. * `org.freedesktop.DBus.Error.UnknownMethod` resp.
* <literal>org.freedesktop.DBus.Error.InvalidArgs</literal> errors * `org.freedesktop.DBus.Error.InvalidArgs` errors
* are returned to the caller. * are returned to the caller.
* *
* It is considered a programming error if the * It is considered a programming error if the

2
gio/gdbuserror.c
View File

@ -790,7 +790,7 @@ g_dbus_error_strip_remote_error (GError *error)
* D-Bus error name will be returned. * D-Bus error name will be returned.
* *
* Otherwise the a name of the form * Otherwise the a name of the form
* <literal>org.gtk.GDBus.UnmappedGError.Quark._ESCAPED_QUARK_NAME.Code_ERROR_CODE</literal> * `org.gtk.GDBus.UnmappedGError.Quark._ESCAPED_QUARK_NAME.Code_ERROR_CODE`
* will be used. This allows other GDBus applications to map the error * will be used. This allows other GDBus applications to map the error
* on the wire back to a #GError using g_dbus_error_new_for_dbus_error(). * on the wire back to a #GError using g_dbus_error_new_for_dbus_error().
* *

2
gio/gdbusinterfaceskeleton.c
View File

@ -379,7 +379,7 @@ g_dbus_interface_skeleton_get_properties (GDBusInterfaceSkeleton *interface_)
* *
* For example, an exported D-Bus interface may queue up property * For example, an exported D-Bus interface may queue up property
* changes and emit the * changes and emit the
* <literal>org.freedesktop.DBus.Properties::PropertiesChanged</literal> * `org.freedesktop.DBus.Properties::Propert``
* signal later (e.g. in an idle handler). This technique is useful * signal later (e.g. in an idle handler). This technique is useful
* for collapsing multiple property changes into one. * for collapsing multiple property changes into one.
* *

4
gio/gdbusintrospection.c
View File

@ -780,7 +780,7 @@ g_dbus_property_info_generate_xml (GDBusPropertyInfo *info,
* *
* This function is typically used for generating introspection XML * This function is typically used for generating introspection XML
* documents at run-time for handling the * documents at run-time for handling the
* <literal>org.freedesktop.DBus.Introspectable.Introspect</literal> * `org.freedesktop.DBus.Introspectable.Introspect`
* method. * method.
* *
* Since: 2.26 * Since: 2.26
@ -828,7 +828,7 @@ g_dbus_interface_info_generate_xml (GDBusInterfaceInfo *info,
* Appends an XML representation of @info (and its children) to @string_builder. * Appends an XML representation of @info (and its children) to @string_builder.
* *
* This function is typically used for generating introspection XML documents at run-time for * This function is typically used for generating introspection XML documents at run-time for
* handling the <literal>org.freedesktop.DBus.Introspectable.Introspect</literal> method. * handling the `org.freedesktop.DBus.Introspectable.Introspect` method.
* *
* Since: 2.26 * Since: 2.26
*/ */

5
gio/gdbusmethodinvocation.c
View File

@ -575,9 +575,8 @@ g_dbus_method_invocation_return_value_with_unix_fd_list (GDBusMethodInvocation *
* will be returned on the wire. In a nutshell, if the given error is * will be returned on the wire. In a nutshell, if the given error is
* registered using g_dbus_error_register_error() the name given * registered using g_dbus_error_register_error() the name given
* during registration is used. Otherwise, a name of the form * during registration is used. Otherwise, a name of the form
* <literal>org.gtk.GDBus.UnmappedGError.Quark...</literal> is * `org.gtk.GDBus.UnmappedGError.Quark...` is used. This provides
* used. This provides transparent mapping of #GError between * transparent mapping of #GError between applications using GDBus.
* applications using GDBus.
* *
* If you are writing an application intended to be portable, * If you are writing an application intended to be portable,
* always register errors with g_dbus_error_register_error() * always register errors with g_dbus_error_register_error()

2
gio/gdbusobjectmanagerclient.c
View File

@ -86,7 +86,7 @@
* is set to the new name owner (this includes emission of the * is set to the new name owner (this includes emission of the
* #GObject::notify signal). Furthermore, you are guaranteed that * #GObject::notify signal). Furthermore, you are guaranteed that
* #GDBusObjectManagerClient:name-owner will alternate between a name owner * #GDBusObjectManagerClient:name-owner will alternate between a name owner
* (e.g. <literal>:1.42</literal>) and %NULL even in the case where * (e.g. `:1.42`) and %NULL even in the case where
* the name of interest is atomically replaced * the name of interest is atomically replaced
* *
* Ultimately, #GDBusObjectManagerClient is used to obtain #GDBusProxy * Ultimately, #GDBusObjectManagerClient is used to obtain #GDBusProxy

8
gio/gdbusproxy.c
View File

@ -370,8 +370,8 @@ g_dbus_proxy_class_init (GDBusProxyClass *klass)
* - Received signals that have a type signature mismatch are dropped and * - Received signals that have a type signature mismatch are dropped and
* a warning is logged via g_warning(). * a warning is logged via g_warning().
* *
* - Properties received via the initial <literal>GetAll()</literal> call * - Properties received via the initial `GetAll()` call or via the
* or via the <literal>::PropertiesChanged</literal> signal (on the * `::PropertiesChanged` signal (on the
* [org.freedesktop.DBus.Properties](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties) * [org.freedesktop.DBus.Properties](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties)
* interface) or set using g_dbus_proxy_set_cached_property() * interface) or set using g_dbus_proxy_set_cached_property()
* with a type signature mismatch are ignored and a warning is * with a type signature mismatch are ignored and a warning is
@ -585,8 +585,8 @@ g_dbus_proxy_class_init (GDBusProxyClass *klass)
* @invalidated_properties will always be empty. * @invalidated_properties will always be empty.
* *
* This signal corresponds to the * This signal corresponds to the
* <literal>PropertiesChanged</literal> D-Bus signal on the * `PropertiesChanged` D-Bus signal on the
* <literal>org.freedesktop.DBus.Properties</literal> interface. * `org.freedesktop.DBus.Properties` interface.
* *
* Since: 2.26 * Since: 2.26
*/ */

31
gio/gdesktopappinfo.c
View File

@ -1564,7 +1564,7 @@ g_desktop_app_info_get_nodisplay (GDesktopAppInfo *info)
* *
* Checks if the application info should be shown in menus that list available * Checks if the application info should be shown in menus that list available
* applications for a specific name of the desktop, based on the * applications for a specific name of the desktop, based on the
* <literal>OnlyShowIn</literal> and <literal>NotShowIn</literal> keys. * `OnlyShowIn` and `NotShowIn` keys.
* *
* If @desktop_env is %NULL, then the name of the desktop set with * If @desktop_env is %NULL, then the name of the desktop set with
* g_desktop_app_info_set_desktop_env() is used. * g_desktop_app_info_set_desktop_env() is used.
@ -1573,7 +1573,7 @@ g_desktop_app_info_get_nodisplay (GDesktopAppInfo *info)
* %NULL for @desktop_env) as well as additional checks. * %NULL for @desktop_env) as well as additional checks.
* *
* Returns: %TRUE if the @info should be shown in @desktop_env according to the * Returns: %TRUE if the @info should be shown in @desktop_env according to the
* <literal>OnlyShowIn</literal> and <literal>NotShowIn</literal> keys, %FALSE * `OnlyShowIn` and `NotShowIn` keys, %FALSE
* otherwise. * otherwise.
* *
* Since: 2.30 * Since: 2.30
@ -2473,21 +2473,19 @@ g_desktop_app_info_launch_uris_as_manager (GDesktopAppInfo *appinfo,
* Sets the name of the desktop that the application is running in. * Sets the name of the desktop that the application is running in.
* This is used by g_app_info_should_show() and * This is used by g_app_info_should_show() and
* g_desktop_app_info_get_show_in() to evaluate the * g_desktop_app_info_get_show_in() to evaluate the
* <literal>OnlyShowIn</literal> and <literal>NotShowIn</literal> * `OnlyShowIn` and `NotShowIn`
* desktop entry fields. * desktop entry fields.
* *
* The * The
* [Desktop Menu specification](http://standards.freedesktop.org/menu-spec/latest/) * [Desktop Menu specification](http://standards.freedesktop.org/menu-spec/latest/)
* recognizes the following: * recognizes the following:
* <simplelist> * - GNOME
* <member>GNOME</member> * - KDE
* <member>KDE</member> * - ROX
* <member>ROX</member> * - XFCE
* <member>XFCE</member> * - LXDE
* <member>LXDE</member> * - Unity
* <member>Unity</member> * - Old
* <member>Old</member>
* </simplelist>
* *
* Should be called only once; subsequent calls are ignored. * Should be called only once; subsequent calls are ignored.
*/ */
@ -3587,13 +3585,12 @@ g_desktop_app_info_search (const gchar *search_string)
* on this system. * on this system.
* *
* For desktop files, this includes applications that have * For desktop files, this includes applications that have
* <literal>NoDisplay=true</literal> set or are excluded from * `NoDisplay=true` set or are excluded from display by means
* display by means of <literal>OnlyShowIn</literal> or * of `OnlyShowIn` or `NotShowIn`. See g_app_info_should_show().
* <literal>NotShowIn</literal>. See g_app_info_should_show().
* The returned list does not include applications which have * The returned list does not include applications which have
* the <literal>Hidden</literal> key set. * the `Hidden` key set.
* *
* Returns: (element-type GAppInfo) (transfer full): a newly allocated #GList of references to #GAppInfo<!---->s. * Returns: (element-type GAppInfo) (transfer full): a newly allocated #GList of references to #GAppInfos.
**/ **/
GList * GList *
g_app_info_get_all (void) g_app_info_get_all (void)

6
gio/gfile.c
View File

@ -7609,9 +7609,9 @@ g_file_real_measure_disk_usage_finish (GFile *file,
* *
* Recursively measures the disk usage of @file. * Recursively measures the disk usage of @file.
* *
* This is essentially an analog of the '<literal>du</literal>' command, * This is essentially an analog of the 'du' command, but it also
* but it also reports the number of directories and non-directory files * reports the number of directories and non-directory files encountered
* encountered (including things like symbolic links). * (including things like symbolic links).
* *
* By default, errors are only reported against the toplevel file * By default, errors are only reported against the toplevel file
* itself. Errors found while recursing are silently ignored, unless * itself. Errors found while recursing are silently ignored, unless

6
gio/gicon.c
View File

@ -194,13 +194,13 @@ g_icon_to_string_tokenized (GIcon *icon, GString *s)
* in the following two cases * in the following two cases
* *
* - If @icon is a #GFileIcon, the returned string is a native path * - If @icon is a #GFileIcon, the returned string is a native path
* (such as <literal>/path/to/my icon.png</literal>) without escaping * (such as `/path/to/my icon.png`) without escaping
* if the #GFile for @icon is a native file. If the file is not * 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() * native, the returned string is the result of g_file_get_uri()
* (such as <literal>sftp://path/to/my&percnt;20icon.png</literal>). * (such as `sftp://path/to/my&percnt;20icon.png`).
* *
* - If @icon is a #GThemedIcon with exactly one name, the encoding is * - If @icon is a #GThemedIcon with exactly one name, the encoding is
* simply the name (such as <literal>network-server</literal>). * simply the name (such as `network-server`).
* *
* Virtual: to_tokens * Virtual: to_tokens
* Returns: An allocated NUL-terminated UTF8 string or %NULL if @icon can't * Returns: An allocated NUL-terminated UTF8 string or %NULL if @icon can't

2
gio/ginetsocketaddress.c
View File

@ -267,7 +267,7 @@ g_inet_socket_address_class_init (GInetSocketAddressClass *klass)
/** /**
* GInetSocketAddress:flowinfo: * GInetSocketAddress:flowinfo:
* *
* The <literal>sin6_flowinfo</literal> field, for IPv6 addresses. * The `sin6_flowinfo` field, for IPv6 addresses.
* *
* Since: 2.32 * Since: 2.32
*/ */

6
gio/gmount.c
View File

@ -946,10 +946,10 @@ get_private (GMount *mount)
* situation, a #GVolumeMonitor implementation would create two * situation, a #GVolumeMonitor implementation would create two
* #GVolume objects (for example, one for the camera functionality of * #GVolume objects (for example, one for the camera functionality of
* the device and one for a SD card reader on the device) with * the device and one for a SD card reader on the device) with
* activation URIs <literal>gphoto2://[usb:001,002]/store1/</literal> * activation URIs `gphoto2://[usb:001,002]/store1/`
* and <literal>gphoto2://[usb:001,002]/store2/</literal>. When the * and `gphoto2://[usb:001,002]/store2/`. When the
* underlying mount (with root * underlying mount (with root
* <literal>gphoto2://[usb:001,002]/</literal>) is mounted, said * `gphoto2://[usb:001,002]/`) is mounted, said
* #GVolumeMonitor implementation would create two #GMount objects * #GVolumeMonitor implementation would create two #GMount objects
* (each with their root matching the corresponding volume activation * (each with their root matching the corresponding volume activation
* root) that would shadow the original mount. * root) that would shadow the original mount.

2
gio/gnetworking.c
View File

@ -28,7 +28,7 @@
* @short_description: System networking includes * @short_description: System networking includes
* @include: gio/gnetworking.h * @include: gio/gnetworking.h
* *
* The <literal>gnetworking.h</literal> header can be included to get * The `&lt;gio/gnetworking.h&gt;` header can be included to get
* various low-level networking-related system headers, automatically * various low-level networking-related system headers, automatically
* taking care of certain portability issues for you. * taking care of certain portability issues for you.
* *

12
gio/gproxyresolver.c
View File

@ -97,18 +97,18 @@ g_proxy_resolver_is_supported (GProxyResolver *resolver)
* @error: return location for a #GError, or %NULL * @error: return location for a #GError, or %NULL
* *
* Looks into the system proxy configuration to determine what proxy, * 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 * if any, to use to connect to @uri. The returned proxy URIs are of
* form <literal>&lt;protocol&gt;://[user[:password]@]host:port</literal> * the form `&lt;protocol&gt;://[user[:password]@]host:port` or
* or <literal>direct://</literal>, where &lt;protocol&gt; could be * `direct://`, where &lt;protocol&gt; could be http, rtsp, socks
* http, rtsp, socks or other proxying protocol. * or other proxying protocol.
* *
* If you don't know what network protocol is being used on the * If you don't know what network protocol is being used on the
* socket, you should use <literal>none</literal> as the URI protocol. * socket, you should use `none` as the URI protocol.
* In this case, the resolver might still return a generic proxy type * In this case, the resolver might still return a generic proxy type
* (such as SOCKS), but would not return protocol-specific proxy types * (such as SOCKS), but would not return protocol-specific proxy types
* (such as http). * (such as http).
* *
* <literal>direct://</literal> is used when no proxy is needed. * `direct://` is used when no proxy is needed.
* Direct connection should not be attempted unless it is part of the * Direct connection should not be attempted unless it is part of the
* returned array of proxies. * returned array of proxies.
* *

4
gio/gremoteactiongroup.c
View File

@ -35,7 +35,7 @@
* or receive action invocations in the local process from other * or receive action invocations in the local process from other
* processes. * processes.
* *
* The interface has <literal>_full</literal> variants of the two * The interface has `_full` variants of the two
* methods on #GActionGroup used to activate actions: * methods on #GActionGroup used to activate actions:
* g_action_group_activate_action() and * g_action_group_activate_action() and
* g_action_group_change_action_state(). These variants allow a * g_action_group_change_action_state(). These variants allow a
@ -48,7 +48,7 @@
* *
* Additionally, g_dbus_connection_export_action_group() will check if * Additionally, g_dbus_connection_export_action_group() will check if
* the exported #GActionGroup implements #GRemoteActionGroup and use the * the exported #GActionGroup implements #GRemoteActionGroup and use the
* <literal>_full</literal> variants of the calls if available. This * `_full` variants of the calls if available. This
* provides a mechanism by which to receive platform data for action * provides a mechanism by which to receive platform data for action
* invocations that arrive by way of D-Bus. * invocations that arrive by way of D-Bus.
* *

6
gio/gresource.c
View File

@ -64,16 +64,16 @@ G_DEFINE_BOXED_TYPE (GResource, g_resource, g_resource_ref, g_resource_unref)
* is very useful e.g. for larger text files that are parsed once (or rarely) and then thrown away. * is very useful e.g. for larger text files that are parsed once (or rarely) and then thrown away.
* *
* Resource files can also be marked to be preprocessed, by setting the value of the * Resource files can also be marked to be preprocessed, by setting the value of the
* <literal>preprocess</literal> attribute to a comma-separated list of preprocessing options. * `preprocess` attribute to a comma-separated list of preprocessing options.
* The only options currently supported are: * The only options currently supported are:
* *
* <literal>xml-stripblanks</literal> which will use the xmllint command * `xml-stripblanks` which will use the xmllint command
* to strip ignorable whitespace from the xml file. For this to work, * to strip ignorable whitespace from the xml file. For this to work,
* the `XMLLINT` environment variable must be set to the full path to * the `XMLLINT` environment variable must be set to the full path to
* the xmllint executable, or xmllint must be in the `PATH`; otherwise * the xmllint executable, or xmllint must be in the `PATH`; otherwise
* the preprocessing step is skipped. * the preprocessing step is skipped.
* *
* <literal>to-pixdata</literal> which will use the gdk-pixbuf-pixdata command to convert * `to-pixdata` which will use the gdk-pixbuf-pixdata command to convert
* images to the GdkPixdata format, which allows you to create pixbufs directly using the data inside * images to the GdkPixdata format, which allows you to create pixbufs directly using the data inside
* the resource file, rather than an (uncompressed) copy if it. For this, the gdk-pixbuf-pixdata * the resource file, rather than an (uncompressed) copy if it. For this, the gdk-pixbuf-pixdata
* program must be in the PATH, or the `GDK_PIXBUF_PIXDATA` environment variable must be * program must be in the PATH, or the `GDK_PIXBUF_PIXDATA` environment variable must be

41
gio/gsettingsschema.c
View File

@ -267,8 +267,8 @@ g_settings_schema_source_unref (GSettingsSchemaSource *source)
* source, the lookup will recurse to the parent. * source, the lookup will recurse to the parent.
* *
* Second, any references to other schemas specified within this * Second, any references to other schemas specified within this
* source (ie: <literal>child</literal> or <literal>extends</literal>) * source (ie: `child` or `extends`) references may be resolved
* references may be resolved from the @parent. * from the @parent.
* *
* For this second reason, except in very unusual situations, the * For this second reason, except in very unusual situations, the
* @parent should probably be given as the default schema source, as * @parent should probably be given as the default schema source, as
@ -1592,31 +1592,28 @@ g_settings_schema_key_get_default_value (GSettingsSchemaKey *key)
* This function will return a #GVariant that fully describes the range * This function will return a #GVariant that fully describes the range
* of values that are valid for @key. * of values that are valid for @key.
* *
* The type of #GVariant returned is <literal>(sv)</literal>. The * The type of #GVariant returned is `(sv)`. The string describes
* string describes the type of range restriction in effect. The type * the type of range restriction in effect. The type and meaning of
* and meaning of the value contained in the variant depends on the * the value contained in the variant depends on the string.
* string.
* *
* If the string is <literal>'type'</literal> then the variant contains * If the string is `'type'` then the variant contains an empty array.
* an empty array. The element type of that empty array is the expected * The element type of that empty array is the expected type of value
* type of value and all values of that type are valid. * and all values of that type are valid.
* *
* If the string is <literal>'enum'</literal> then the variant contains * If the string is `'enum'` then the variant contains an array
* an array enumerating the possible values. Each item in the array is * enumerating the possible values. Each item in the array is
* a possible valid value and no other values are valid. * a possible valid value and no other values are valid.
* *
* If the string is <literal>'flags'</literal> then the variant contains * If the string is `'flags'` then the variant contains an array. Each
* an array. Each item in the array is a value that may appear zero or * item in the array is a value that may appear zero or one times in an
* one times in an array to be used as the value for this key. For * array to be used as the value for this key. For example, if the
* example, if the variant contained the array <literal>['x', * variant contained the array `['x', 'y']` then the valid values for
* 'y']</literal> then the valid values for the key would be * the key would be `[]`, `['x']`, `['y']`, `['x', 'y']` and
* <literal>[]</literal>, <literal>['x']</literal>, * `['y', 'x']`.
* <literal>['y']</literal>, <literal>['x', 'y']</literal> and
* <literal>['y', 'x']</literal>.
* *
* Finally, if the string is <literal>'range'</literal> then the variant * Finally, if the string is `'range'` then the variant contains a pair
* contains a pair of like-typed values -- the minimum and maximum * of like-typed values -- the minimum and maximum permissible values
* permissible values for this key. * for this key.
* *
* This information should not be used by normal programs. It is * This information should not be used by normal programs. It is
* considered to be a hint for introspection purposes. Normal programs * considered to be a hint for introspection purposes. Normal programs

44
gio/gsocket.c
View File

@ -1856,12 +1856,12 @@ g_socket_listen (GSocket *socket,
* used to initiate connections, though this is not normally required. * used to initiate connections, though this is not normally required.
* *
* If @socket is a TCP socket, then @allow_reuse controls the setting * If @socket is a TCP socket, then @allow_reuse controls the setting
* of the <literal>SO_REUSEADDR</literal> socket option; normally it * of the `SO_REUSEADDR` socket option; normally it should be %TRUE for
* should be %TRUE for server sockets (sockets that you will * server sockets (sockets that you will eventually call
* eventually call g_socket_accept() on), and %FALSE for client * g_socket_accept() on), and %FALSE for client sockets. (Failing to
* sockets. (Failing to set this flag on a server socket may cause * set this flag on a server socket may cause g_socket_bind() to return
* g_socket_bind() to return %G_IO_ERROR_ADDRESS_IN_USE if the server * %G_IO_ERROR_ADDRESS_IN_USE if the server program is stopped and then
* program is stopped and then immediately restarted.) * immediately restarted.)
* *
* If @socket is a UDP socket, then @allow_reuse determines whether or * If @socket is a UDP socket, then @allow_reuse determines whether or
* not other UDP sockets can be bound to the same address at the same * not other UDP sockets can be bound to the same address at the same
@ -4507,17 +4507,16 @@ g_socket_get_credentials (GSocket *socket,
/** /**
* g_socket_get_option: * g_socket_get_option:
* @socket: a #GSocket * @socket: a #GSocket
* @level: the "API level" of the option (eg, <literal>SOL_SOCKET</literal>) * @level: the "API level" of the option (eg, `SOL_SOCKET`)
* @optname: the "name" of the option (eg, <literal>SO_BROADCAST</literal>) * @optname: the "name" of the option (eg, `SO_BROADCAST`)
* @value: (out): return location for the option value * @value: (out): return location for the option value
* @error: #GError for error reporting, or %NULL to ignore. * @error: #GError for error reporting, or %NULL to ignore.
* *
* Gets the value of an integer-valued option on @socket, as with * Gets the value of an integer-valued option on @socket, as with
* <literal>getsockopt ()</literal>. (If you need to fetch a * getsockopt(). (If you need to fetch a non-integer-valued option,
* non-integer-valued option, you will need to call * you will need to call getsockopt() directly.)
* <literal>getsockopt ()</literal> directly.)
* *
* The <link linkend="gio-gnetworking.h"><literal>&lt;gio/gnetworking.h&gt;</literal></link> * The <link linkend="gio-gnetworking.h">`&lt;gio/gnetworking.h&gt;`</link>
* header pulls in system headers that will define most of the * header pulls in system headers that will define most of the
* standard/portable socket options. For unusual socket protocols or * standard/portable socket options. For unusual socket protocols or
* platform-dependent options, you may need to include additional * platform-dependent options, you may need to include additional
@ -4528,9 +4527,8 @@ g_socket_get_credentials (GSocket *socket,
* g_socket_get_option() will handle the conversion internally. * g_socket_get_option() will handle the conversion internally.
* *
* Returns: success or failure. On failure, @error will be set, and * Returns: success or failure. On failure, @error will be set, and
* the system error value (<literal>errno</literal> or * the system error value (`errno` or WSAGetLastError()) will still
* <literal>WSAGetLastError ()</literal>) will still be set to the * be set to the result of the getsockopt() call.
* result of the <literal>getsockopt ()</literal> call.
* *
* Since: 2.36 * Since: 2.36
*/ */
@ -4576,26 +4574,24 @@ g_socket_get_option (GSocket *socket,
/** /**
* g_socket_set_option: * g_socket_set_option:
* @socket: a #GSocket * @socket: a #GSocket
* @level: the "API level" of the option (eg, <literal>SOL_SOCKET</literal>) * @level: the "API level" of the option (eg, `SOL_SOCKET`)
* @optname: the "name" of the option (eg, <literal>SO_BROADCAST</literal>) * @optname: the "name" of the option (eg, `SO_BROADCAST`)
* @value: the value to set the option to * @value: the value to set the option to
* @error: #GError for error reporting, or %NULL to ignore. * @error: #GError for error reporting, or %NULL to ignore.
* *
* Sets the value of an integer-valued option on @socket, as with * Sets the value of an integer-valued option on @socket, as with
* <literal>setsockopt ()</literal>. (If you need to set a * setsockopt(). (If you need to set a non-integer-valued option,
* non-integer-valued option, you will need to call * you will need to call setsockopt() directly.)
* <literal>setsockopt ()</literal> directly.)
* *
* The <link linkend="gio-gnetworking.h"><literal>&lt;gio/gnetworking.h&gt;</literal></link> * The <link linkend="gio-gnetworking.h">`&lt;gio/gnetworking.h&gt;`</link>
* header pulls in system headers that will define most of the * header pulls in system headers that will define most of the
* standard/portable socket options. For unusual socket protocols or * standard/portable socket options. For unusual socket protocols or
* platform-dependent options, you may need to include additional * platform-dependent options, you may need to include additional
* headers. * headers.
* *
* Returns: success or failure. On failure, @error will be set, and * Returns: success or failure. On failure, @error will be set, and
* the system error value (<literal>errno</literal> or * the system error value (`errno` or WSAGetLastError()) will still
* <literal>WSAGetLastError ()</literal>) will still be set to the * be set to the result of the setsockopt() call.
* result of the <literal>setsockopt ()</literal> call.
* *
* Since: 2.36 * Since: 2.36
*/ */

7
gio/gsubprocess.c
View File

@ -36,16 +36,15 @@
* comprehensive API for asynchronous I/O, such * comprehensive API for asynchronous I/O, such
* g_output_stream_splice_async(). This makes GSubprocess * g_output_stream_splice_async(). This makes GSubprocess
* significantly more powerful and flexible than equivalent APIs in * significantly more powerful and flexible than equivalent APIs in
* some other languages such as the <literal>subprocess.py</literal> * some other languages such as the `subprocess.py`
* included with Python. For example, using #GSubprocess one could * included with Python. For example, using #GSubprocess one could
* create two child processes, reading standard output from the first, * create two child processes, reading standard output from the first,
* processing it, and writing to the input stream of the second, all * processing it, and writing to the input stream of the second, all
* without blocking the main loop. * without blocking the main loop.
* *
* A powerful g_subprocess_communicate() API is provided similar to the * A powerful g_subprocess_communicate() API is provided similar to the
* <literal>communicate()</literal> method of * `communicate()` method of `subprocess.py`. This enables very easy
* <literal>subprocess.py</literal>. This enables very easy interaction * interaction with a subprocess that has been opened with pipes.
* with a subprocess that has been opened with pipes.
* *
* #GSubprocess defaults to tight control over the file descriptors open * #GSubprocess defaults to tight control over the file descriptors open
* in the child process, avoiding dangling-fd issues that are caused by * in the child process, avoiding dangling-fd issues that are caused by

21
gio/gtask.c
View File

@ -489,9 +489,9 @@
* (You can use g_task_set_check_cancellable() to turn off that * (You can use g_task_set_check_cancellable() to turn off that
* behavior.) On the other hand, g_task_run_in_thread() * behavior.) On the other hand, g_task_run_in_thread()
* guarantees that it will always run your * guarantees that it will always run your
* <literal>task_func</literal>, even if the task's #GCancellable * `task_func`, even if the task's #GCancellable
* is already cancelled before the task gets a chance to run; * is already cancelled before the task gets a chance to run;
* you can start your <literal>task_func</literal> with a * you can start your `task_func` with a
* g_task_return_error_if_cancelled() check if you need the * g_task_return_error_if_cancelled() check if you need the
* old behavior. * old behavior.
* - The "return" methods (eg, g_task_return_pointer()) * - The "return" methods (eg, g_task_return_pointer())
@ -509,18 +509,18 @@
* prevent it from being freed twice. * prevent it from being freed twice.
* - With #GSimpleAsyncResult, it was common to call * - With #GSimpleAsyncResult, it was common to call
* g_simple_async_result_propagate_error() from the * g_simple_async_result_propagate_error() from the
* <literal>_finish()</literal> wrapper function, and have * `_finish()` wrapper function, and have
* virtual method implementations only deal with successful * virtual method implementations only deal with successful
* returns. This behavior is deprecated, because it makes it * returns. This behavior is deprecated, because it makes it
* difficult for a subclass to chain to a parent class's async * difficult for a subclass to chain to a parent class's async
* methods. Instead, the wrapper function should just be a * methods. Instead, the wrapper function should just be a
* simple wrapper, and the virtual method should call an * simple wrapper, and the virtual method should call an
* appropriate <literal>g_task_propagate_</literal> function. * appropriate `g_task_propagate_` function.
* Note that wrapper methods can now use * Note that wrapper methods can now use
* g_async_result_legacy_propagate_error() to do old-style * g_async_result_legacy_propagate_error() to do old-style
* #GSimpleAsyncResult error-returning behavior, and * #GSimpleAsyncResult error-returning behavior, and
* g_async_result_is_tagged() to check if a result is tagged as * g_async_result_is_tagged() to check if a result is tagged as
* having come from the <literal>_async()</literal> wrapper * having come from the `_async()` wrapper
* function (for "short-circuit" results, such as when passing * function (for "short-circuit" results, such as when passing
* 0 to g_input_stream_read_async()). * 0 to g_input_stream_read_async()).
*/ */
@ -961,9 +961,9 @@ g_task_ref_source_object (GAsyncResult *res)
* g_task_get_task_data: * g_task_get_task_data:
* @task: a #GTask * @task: a #GTask
* *
* Gets @task's <literal>task_data</literal>. * Gets @task's `task_data`.
* *
* Returns: (transfer none): @task's <literal>task_data</literal>. * Returns: (transfer none): @task's `task_data`.
* *
* Since: 2.36 * Since: 2.36
*/ */
@ -1165,7 +1165,7 @@ g_task_return (GTask *task,
* *
* Other than in that case, @task will be completed when the * Other than in that case, @task will be completed when the
* #GTaskThreadFunc returns, not when it calls a * #GTaskThreadFunc returns, not when it calls a
* <literal>g_task_return_</literal> function. * `g_task_return_` function.
* *
* Since: 2.36 * Since: 2.36
*/ */
@ -1349,7 +1349,7 @@ g_task_run_in_thread (GTask *task,
* See #GTaskThreadFunc for more details about how @task_func is handled. * See #GTaskThreadFunc for more details about how @task_func is handled.
* *
* Normally this is used with tasks created with a %NULL * Normally this is used with tasks created with a %NULL
* <literal>callback</literal>, but note that even if the task does * `callback`, but note that even if the task does
* have a callback, it will not be invoked when @task_func returns. * have a callback, it will not be invoked when @task_func returns.
* *
* Since: 2.36 * Since: 2.36
@ -1382,8 +1382,7 @@ g_task_run_in_thread_sync (GTask *task,
* to wait for a #GSource to trigger. Attaches @source to @task's * to wait for a #GSource to trigger. Attaches @source to @task's
* #GMainContext with @task's <link * #GMainContext with @task's <link
* linkend="io-priority">priority</link>, and sets @source's callback * linkend="io-priority">priority</link>, and sets @source's callback
* to @callback, with @task as the callback's * to @callback, with @task as the callback's `user_data`.
* <literal>user_data</literal>.
* *
* This takes a reference on @task until @source is destroyed. * This takes a reference on @task until @source is destroyed.
* *

10
gio/gtlscertificate.c
View File

@ -138,7 +138,7 @@ g_tls_certificate_class_init (GTlsCertificateClass *class)
* but cannot be read. * but cannot be read.
* *
* PKCS#8 format is supported since 2.32; earlier releases only * PKCS#8 format is supported since 2.32; earlier releases only
* support PKCS#1. You can use the <literal>openssl rsa</literal> * support PKCS#1. You can use the `openssl rsa`
* tool to convert PKCS#8 keys to PKCS#1. * tool to convert PKCS#8 keys to PKCS#1.
* *
* Since: 2.28 * Since: 2.28
@ -155,14 +155,14 @@ g_tls_certificate_class_init (GTlsCertificateClass *class)
* GTlsCertificate:private-key-pem: * GTlsCertificate:private-key-pem:
* *
* The PEM (ASCII) encoded representation of the certificate's * The PEM (ASCII) encoded representation of the certificate's
* private key in either PKCS#1 format ("<literal>BEGIN RSA PRIVATE * private key in either PKCS#1 format ("`BEGIN RSA PRIVATE
* KEY</literal>") or unencrypted PKCS#8 format ("<literal>BEGIN * KEY`") or unencrypted PKCS#8 format ("`BEGIN
* PRIVATE KEY</literal>"). This property (or the * PRIVATE KEY`"). This property (or the
* #GTlsCertificate:private-key property) can be set when * #GTlsCertificate:private-key property) can be set when
* constructing a key (eg, from a file), but cannot be read. * constructing a key (eg, from a file), but cannot be read.
* *
* PKCS#8 format is supported since 2.32; earlier releases only * PKCS#8 format is supported since 2.32; earlier releases only
* support PKCS#1. You can use the <literal>openssl rsa</literal> * support PKCS#1. You can use the `openssl rsa`
* tool to convert PKCS#8 keys to PKCS#1. * tool to convert PKCS#8 keys to PKCS#1.
* *
* Since: 2.28 * Since: 2.28

16
gio/gtlsconnection.c
View File

@ -677,16 +677,16 @@ g_tls_connection_get_require_close_notify (GTlsConnection *conn)
* *
* %G_TLS_REHANDSHAKE_SAFELY means that the connection will allow a * %G_TLS_REHANDSHAKE_SAFELY means that the connection will allow a
* rehandshake only if the other end of the connection supports the * rehandshake only if the other end of the connection supports the
* TLS <literal>renegotiation_info</literal> extension. This is the * TLS `renegotiation_info` extension. This is the default behavior,
* default behavior, but means that rehandshaking will not work * but means that rehandshaking will not work against older
* against older implementations that do not support that extension. * implementations that do not support that extension.
* *
* %G_TLS_REHANDSHAKE_UNSAFELY means that the connection will allow * %G_TLS_REHANDSHAKE_UNSAFELY means that the connection will allow
* rehandshaking even without the * rehandshaking even without the `renegotiation_info` extension. On
* <literal>renegotiation_info</literal> extension. On the server side * the server side in particular, this is not recommended, since it
* in particular, this is not recommended, since it leaves the server * leaves the server open to certain attacks. However, this mode is
* open to certain attacks. However, this mode is necessary if you * necessary if you need to allow renegotiation with older client
* need to allow renegotiation with older client software. * software.
* *
* Since: 2.28 * Since: 2.28
*/ */

2
gio/gunixsocketaddress.c
View File

@ -376,7 +376,7 @@ g_unix_socket_address_new_abstract (const gchar *path,
* zero-padded buffer will be considered the name. (As above, if * zero-padded buffer will be considered the name. (As above, if
* @path_len is -1, then @path is assumed to be NUL-terminated.) In * @path_len is -1, then @path is assumed to be NUL-terminated.) In
* this case, g_socket_address_get_native_size() will always return * this case, g_socket_address_get_native_size() will always return
* the full size of a <literal>struct sockaddr_un</literal>, although * the full size of a `struct sockaddr_un`, although
* g_unix_socket_address_get_path_len() will still return just the * g_unix_socket_address_get_path_len() will still return just the
* length of @path. * length of @path.
* *

4
glib/docs.c
View File

@ -1990,8 +1990,8 @@
* regression tests for deprecated functions. * regression tests for deprecated functions.
* *
* Use %G_GNUC_END_IGNORE_DEPRECATIONS to begin warning again. (If you * Use %G_GNUC_END_IGNORE_DEPRECATIONS to begin warning again. (If you
* are not compiling with <literal>-Wdeprecated-declarations</literal> * are not compiling with `-Wdeprecated-declarations` then neither macro
* then neither macro has any effect.) * has any effect.)
* *
* This macro can be used either inside or outside of a function body, * This macro can be used either inside or outside of a function body,
* but must appear on a line by itself. * but must appear on a line by itself.

28
glib/gatomic.c
View File

@ -58,8 +58,7 @@
* fall outside of simple reference counting patterns are prone to * fall outside of simple reference counting patterns are prone to
* subtle bugs and occasionally undefined behaviour. It is also worth * subtle bugs and occasionally undefined behaviour. It is also worth
* noting that since all of these operations require global * noting that since all of these operations require global
* synchronisation of the entire machine, they can be quite slow. In * synchronisation of the entire machine, they can be quite slow. In * the case of performing multiple atomic operations it can often be
* the case of performing multiple atomic operations it can often be
* faster to simply acquire a mutex lock around the critical area, * faster to simply acquire a mutex lock around the critical area,
* perform the operations normally and then release the lock. * perform the operations normally and then release the lock.
**/ **/
@ -139,8 +138,7 @@ void
* *
* Increments the value of @atomic by 1. * Increments the value of @atomic by 1.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of `{ *@atomic += 1; }`.
* <literal>{ *@atomic += 1; }</literal>
* *
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *
@ -159,7 +157,7 @@ void
* Decrements the value of @atomic by 1. * Decrements the value of @atomic by 1.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of
* <literal>{ *@atomic -= 1; return (*@atomic == 0); }</literal> * `{ *@atomic -= 1; return (*@atomic == 0); }`.
* *
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *
@ -185,7 +183,7 @@ gboolean
* This compare and exchange is done atomically. * This compare and exchange is done atomically.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of
* <literal>{ if (*@atomic == @oldval) { *@atomic = @newval; return TRUE; } else return FALSE; }</literal> * `{ if (*@atomic == @oldval) { *@atomic = @newval; return TRUE; } else return FALSE; }`.
* *
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *
@ -209,7 +207,7 @@ gboolean
* Atomically adds @val to the value of @atomic. * Atomically adds @val to the value of @atomic.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of
* <literal>{ tmp = *atomic; *@atomic += @val; return tmp; }</literal> * `{ tmp = *atomic; *@atomic += @val; return tmp; }`.
* *
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *
@ -238,7 +236,7 @@ gint
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of
* <literal>{ tmp = *atomic; *@atomic &= @val; return tmp; }</literal> * `{ tmp = *atomic; *@atomic &= @val; return tmp; }`.
* *
* Returns: the value of @atomic before the operation, unsigned * Returns: the value of @atomic before the operation, unsigned
* *
@ -260,7 +258,7 @@ guint
* storing the result back in @atomic. * storing the result back in @atomic.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of
* <literal>{ tmp = *atomic; *@atomic |= @val; return tmp; }</literal> * `{ tmp = *atomic; *@atomic |= @val; return tmp; }`.
* *
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *
@ -284,7 +282,7 @@ guint
* storing the result back in @atomic. * storing the result back in @atomic.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of
* <literal>{ tmp = *atomic; *@atomic ^= @val; return tmp; }</literal> * `{ tmp = *atomic; *@atomic ^= @val; return tmp; }`.
* *
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *
@ -350,7 +348,7 @@ void
* This compare and exchange is done atomically. * This compare and exchange is done atomically.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of
* <literal>{ if (*@atomic == @oldval) { *@atomic = @newval; return TRUE; } else return FALSE; }</literal> * `{ if (*@atomic == @oldval) { *@atomic = @newval; return TRUE; } else return FALSE; }`.
* *
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *
@ -375,7 +373,7 @@ gboolean
* Atomically adds @val to the value of @atomic. * Atomically adds @val to the value of @atomic.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of
* <literal>{ tmp = *atomic; *@atomic += @val; return tmp; }</literal> * `{ tmp = *atomic; *@atomic += @val; return tmp; }`.
* *
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *
@ -399,7 +397,7 @@ gssize
* storing the result back in @atomic. * storing the result back in @atomic.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of
* <literal>{ tmp = *atomic; *@atomic &= @val; return tmp; }</literal> * `{ tmp = *atomic; *@atomic &= @val; return tmp; }`.
* *
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *
@ -423,7 +421,7 @@ gsize
* storing the result back in @atomic. * storing the result back in @atomic.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of
* <literal>{ tmp = *atomic; *@atomic |= @val; return tmp; }</literal> * `{ tmp = *atomic; *@atomic |= @val; return tmp; }`.
* *
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *
@ -447,7 +445,7 @@ gsize
* storing the result back in @atomic. * storing the result back in @atomic.
* *
* Think of this operation as an atomic version of * Think of this operation as an atomic version of
* <literal>{ tmp = *atomic; *@atomic ^= @val; return tmp; }</literal> * `{ tmp = *atomic; *@atomic ^= @val; return tmp; }`.
* *
* This call acts as a full compiler and hardware memory barrier. * This call acts as a full compiler and hardware memory barrier.
* *

2
glib/gbacktrace.c
View File

@ -96,7 +96,7 @@ volatile gboolean glib_on_error_halt = TRUE;
* gtk_init() has been called) * gtk_init() has been called)
* *
* Prompts the user with * Prompts the user with
* <literal>[E]xit, [H]alt, show [S]tack trace or [P]roceed</literal>. * `[E]xit, [H]alt, show [S]tack trace or [P]roceed`.
* This function is intended to be used for debugging use only. * This function is intended to be used for debugging use only.
* The following example shows how it can be used together with * The following example shows how it can be used together with
* the g_log() functions. * the g_log() functions.

6
glib/gbase64.c
View File

@ -81,9 +81,9 @@ static const char base64_alphabet[] =
* @break_lines is typically used when putting base64-encoded data in emails. * @break_lines is typically used when putting base64-encoded data in emails.
* It breaks the lines at 72 columns instead of putting all of the text on * It breaks the lines at 72 columns instead of putting all of the text on
* the same line. This avoids problems with long lines in the email system. * the same line. This avoids problems with long lines in the email system.
* Note however that it breaks the lines with <literal>LF</literal> * Note however that it breaks the lines with `LF` characters, not
* characters, not <literal>CR LF</literal> sequences, so the result cannot * `CR LF` sequences, so the result cannot be passed directly to SMTP
* be passed directly to SMTP or certain other protocols. * or certain other protocols.
* *
* Return value: The number of bytes of output that was written * Return value: The number of bytes of output that was written
* *

32
glib/gbookmarkfile.c
View File

@ -62,22 +62,22 @@
* using the * using the
* [Desktop Bookmark Specification](http://www.gnome.org/~ebassi/bookmark-spec). * [Desktop Bookmark Specification](http://www.gnome.org/~ebassi/bookmark-spec).
* *
* The syntax of the bookmark files is described in detail inside the Desktop * The syntax of the bookmark files is described in detail inside the
* Bookmark Specification, here is a quick summary: bookmark files use a * Desktop Bookmark Specification, here is a quick summary: bookmark
* sub-class of the XML Bookmark Exchange Language specification, * files use a sub-class of the XML Bookmark Exchange Language
* consisting of valid UTF-8 encoded XML, under the * specification, consisting of valid UTF-8 encoded XML, under the
* <literal>xbel</literal> root element; each bookmark is stored inside a * &lt;xbel&gt; root element; each bookmark is stored inside a
* <literal>bookmark</literal> element, using its URI: no relative paths can * &lt;bookmark&gt; element, using its URI: no relative paths can
* be used inside a bookmark file. The bookmark may have a user defined title * be used inside a bookmark file. The bookmark may have a user defined
* and description, to be used instead of the URI. Under the * title and description, to be used instead of the URI. Under the
* <literal>metadata</literal> element, with its <literal>owner</literal> * &lt;metadata&gt; element, with its owner attribute set to
* attribute set to <literal>http://freedesktop.org</literal>, is stored the * `http://freedesktop.org`, is stored the meta-data about a resource
* meta-data about a resource pointed by its URI. The meta-data consists of * pointed by its URI. The meta-data consists of the resource's MIME
* the resource's MIME type; the applications that have registered a bookmark; * type; the applications that have registered a bookmark; the groups
* the groups to which a bookmark belongs to; a visibility flag, used to set * to which a bookmark belongs to; a visibility flag, used to set the
* the bookmark as "private" to the applications and groups that has it * bookmark as "private" to the applications and groups that has it
* registered; the URI and MIME type of an icon, to be used when displaying * registered; the URI and MIME type of an icon, to be used when
* the bookmark inside a GUI. * displaying the bookmark inside a GUI.
* *
* Here is an example of a bookmark file: * Here is an example of a bookmark file:
* [bookmarks.xbel](https://git.gnome.org/browse/glib/tree/glib/tests/bookmarks.xbel) * [bookmarks.xbel](https://git.gnome.org/browse/glib/tree/glib/tests/bookmarks.xbel)

4
glib/gconvert.c
View File

@ -157,8 +157,8 @@
* the file system by using g_filename_from_utf8(). Pass the converted * the file system by using g_filename_from_utf8(). Pass the converted
* file name to functions like fopen(). If conversion fails, ask the * file name to functions like fopen(). If conversion fails, ask the
* user to enter a different file name. This can happen if the user * user to enter a different file name. This can happen if the user
* types Japanese characters when `G_FILENAME_ENCODING` * types Japanese characters when `G_FILENAME_ENCODING` is set to
* is set to <literal>ISO-8859-1</literal>, for example. * `ISO-8859-1`, for example.
*/ */
/* We try to terminate strings in unknown charsets with this many zero bytes /* We try to terminate strings in unknown charsets with this many zero bytes

11
glib/gdatetime.c
View File

@ -2548,12 +2548,11 @@ g_date_time_format_locale (GDateTime *datetime,
* - \%C: the century number (year/100) as a 2-digit integer (00-99) * - \%C: the century number (year/100) as a 2-digit integer (00-99)
* - \%d: the day of the month as a decimal number (range 01 to 31) * - \%d: the day of the month as a decimal number (range 01 to 31)
* - \%e: the day of the month as a decimal number (range 1 to 31) * - \%e: the day of the month as a decimal number (range 1 to 31)
* - \%F: equivalent to <literal>\%Y-\%m-\%d</literal> (the ISO 8601 date * - \%F: equivalent to `\%Y-\%m-\%d` (the ISO 8601 date format)
* format) * - \%g: the last two digits of the ISO 8601 week-based year as a
* - \%g: the last two digits of the ISO 8601 week-based year as a decimal * decimal number (00-99). This works well with \%V and \%u.
* number (00-99). This works well with \%V and \%u. * - \%G: the ISO 8601 week-based year as a decimal number. This works
* - \%G: the ISO 8601 week-based year as a decimal number. This works well * well with \%V and \%u.
* with \%V and \%u.
* - \%h: equivalent to \%b * - \%h: equivalent to \%b
* - \%H: the hour as a decimal number using a 24-hour clock (range 00 to 23) * - \%H: the hour as a decimal number using a 24-hour clock (range 00 to 23)
* - \%I: the hour as a decimal number using a 12-hour clock (range 01 to 12) * - \%I: the hour as a decimal number using a 12-hour clock (range 01 to 12)

3
glib/gdir.c
View File

@ -233,8 +233,7 @@ g_dir_new_from_dirp (gpointer dirp)
* factors. * factors.
* *
* %NULL may also be returned in case of errors. On Unix, you can * %NULL may also be returned in case of errors. On Unix, you can
* check <literal>errno</literal> to find out if %NULL was returned * check `errno` to find out if %NULL was returned because of an error.
* because of an error.
* *
* On Unix, the '.' and '..' entries are omitted, and the returned * On Unix, the '.' and '..' entries are omitted, and the returned
* name is in the on-disk encoding. * name is in the on-disk encoding.

23
glib/gerror.c
View File

@ -59,9 +59,8 @@
* gsize *length, * gsize *length,
* GError **error); * GError **error);
* ]| * ]|
* If you pass a non-%NULL value for the <literal>error</literal> * If you pass a non-%NULL value for the `error` argument, it should
* argument, it should point to a location where an error can be placed. * point to a location where an error can be placed. For example:
* For example:
* |[<!-- language="C" --> * |[<!-- language="C" -->
* gchar *contents; * gchar *contents;
* GError *err = NULL; * GError *err = NULL;
@ -81,9 +80,9 @@
* g_assert (contents != NULL); * g_assert (contents != NULL);
* } * }
* ]| * ]|
* Note that <literal>err != NULL</literal> in this example is a * Note that `err != NULL` in this example is a reliable indicator
* reliable indicator of whether g_file_get_contents() failed. * of whether g_file_get_contents() failed. Additionally,
* Additionally, g_file_get_contents() returns a boolean which * g_file_get_contents() returns a boolean which
* indicates whether it was successful. * indicates whether it was successful.
* *
* Because g_file_get_contents() returns %FALSE on failure, if you * Because g_file_get_contents() returns %FALSE on failure, if you
@ -236,11 +235,11 @@
* } * }
* ]| * ]|
* *
* Note that passing %NULL for the error location ignores errors; it's * Note that passing %NULL for the error location ignores errors;
* equivalent to * it's equivalent to
* <literal>try { sub_function_that_can_fail (); } catch (...) {}</literal> * `try { sub_function_that_can_fail (); } catch (...) {}`
* in C++. It does not mean to leave errors unhandled; it means to * in C++. It does not mean to leave errors unhandled; it means
* handle them by doing nothing. * to handle them by doing nothing.
* *
* Error domains and codes are conventionally named as follows: * Error domains and codes are conventionally named as follows:
* *
@ -322,7 +321,7 @@
* - When implementing a function that can report errors, you may want * - When implementing a function that can report errors, you may want
* to add a check at the top of your function that the error return * to add a check at the top of your function that the error return
* location is either %NULL or contains a %NULL error (e.g. * location is either %NULL or contains a %NULL error (e.g.
* <literal>g_return_if_fail (error == NULL || *error == NULL);</literal>). * `g_return_if_fail (error == NULL || *error == NULL);`).
*/ */
#include "config.h" #include "config.h"

30
glib/gfileutils.c
View File

@ -270,11 +270,11 @@ g_mkdir_with_parents (const gchar *pathname,
* @test: bitfield of #GFileTest flags * @test: bitfield of #GFileTest flags
* *
* Returns %TRUE if any of the tests in the bitfield @test are * Returns %TRUE if any of the tests in the bitfield @test are
* %TRUE. For example, <literal>(G_FILE_TEST_EXISTS | * %TRUE. For example, `(G_FILE_TEST_EXISTS | G_FILE_TEST_IS_DIR)`
* G_FILE_TEST_IS_DIR)</literal> will return %TRUE if the file exists; * will return %TRUE if the file exists; the check whether it's a
* the check whether it's a directory doesn't matter since the existence * directory doesn't matter since the existence test is %TRUE. With
* test is %TRUE. With the current set of available tests, there's no point * the current set of available tests, there's no point passing in
* passing in more than one test at a time. * more than one test at a time.
* *
* Apart from %G_FILE_TEST_IS_SYMLINK all tests follow symbolic links, * Apart from %G_FILE_TEST_IS_SYMLINK all tests follow symbolic links,
* so for a symbolic link to a regular file g_file_test() will return * so for a symbolic link to a regular file g_file_test() will return
@ -465,8 +465,8 @@ G_DEFINE_QUARK (g-file-error-quark, g_file_error)
* @err_no: an "errno" value * @err_no: an "errno" value
* *
* Gets a #GFileError constant based on the passed-in @err_no. * Gets a #GFileError constant based on the passed-in @err_no.
* For example, if you pass in <literal>EEXIST</literal> this function returns * For example, if you pass in `EEXIST` this function returns
* #G_FILE_ERROR_EXIST. Unlike <literal>errno</literal> values, you can portably * #G_FILE_ERROR_EXIST. Unlike `errno` values, you can portably
* assume that all #GFileError values will exist. * assume that all #GFileError values will exist.
* *
* Normally a #GFileError value goes into a #GError returned * Normally a #GFileError value goes into a #GError returned
@ -1766,8 +1766,7 @@ g_build_pathv (const gchar *separator,
* the same as the number of trailing copies of the separator on * the same as the number of trailing copies of the separator on
* the last non-empty element. (Determination of the number of * the last non-empty element. (Determination of the number of
* trailing copies is done without stripping leading copies, so * trailing copies is done without stripping leading copies, so
* if the separator is <literal>ABA</literal>, <literal>ABABA</literal> * if the separator is `ABA`, then `ABABA` has 1 trailing copy.)
* has 1 trailing copy.)
* *
* However, if there is only a single non-empty element, and there * However, if there is only a single non-empty element, and there
* are no characters in that element not part of the leading or * are no characters in that element not part of the leading or
@ -1947,15 +1946,14 @@ g_build_filenamev (gchar **args)
* Creates a filename from a series of elements using the correct * Creates a filename from a series of elements using the correct
* separator for filenames. * separator for filenames.
* *
* On Unix, this function behaves identically to <literal>g_build_path * On Unix, this function behaves identically to `g_build_path
* (G_DIR_SEPARATOR_S, first_element, ....)</literal>. * (G_DIR_SEPARATOR_S, first_element, ....)`.
* *
* On Windows, it takes into account that either the backslash * On Windows, it takes into account that either the backslash
* (<literal>\</literal> or slash (<literal>/</literal>) can be used * (`\` or slash (`/`) can be used as separator in filenames, but
* as separator in filenames, but otherwise behaves as on Unix. When * otherwise behaves as on UNIX. When file pathname separators need
* file pathname separators need to be inserted, the one that last * to be inserted, the one that last previously occurred in the
* previously occurred in the parameters (reading from left to right) * parameters (reading from left to right) is used.
* is used.
* *
* No attempt is made to force the resulting filename to be an absolute * No attempt is made to force the resulting filename to be an absolute
* path. If the first element is a relative path, the result will * path. If the first element is a relative path, the result will

36
glib/ghash.c
View File

@ -112,7 +112,7 @@
* and #gchar* respectively. * and #gchar* respectively.
* *
* g_direct_hash() is also the appropriate hash function for keys * g_direct_hash() is also the appropriate hash function for keys
* of the form <literal>GINT_TO_POINTER (n)</literal> (or similar macros). * of the form `GINT_TO_POINTER (n)` (or similar macros).
* *
* <!-- FIXME: Need more here. --> A good hash functions should produce * <!-- FIXME: Need more here. --> A good hash functions should produce
* hash values that are evenly distributed over a fairly large range. * hash values that are evenly distributed over a fairly large range.
@ -1773,11 +1773,11 @@ g_str_equal (gconstpointer v1,
* *
* Converts a string to a hash value. * Converts a string to a hash value.
* *
* This function implements the widely used "djb" hash apparently posted * This function implements the widely used "djb" hash apparently
* by Daniel Bernstein to comp.lang.c some time ago. The 32 bit * posted by Daniel Bernstein to comp.lang.c some time ago. The 32
* unsigned hash value starts at 5381 and for each byte 'c' in the * bit unsigned hash value starts at 5381 and for each byte 'c' in
* string, is updated: <literal>hash = hash * 33 + c</literal>. This * the string, is updated: `hash = hash * 33 + c`. This function
* function uses the signed value of each byte. * uses the signed value of each byte.
* *
* It can be passed to g_hash_table_new() as the @hash_func parameter, * It can be passed to g_hash_table_new() as the @hash_func parameter,
* when using non-%NULL strings as keys in a #GHashTable. * when using non-%NULL strings as keys in a #GHashTable.
@ -1805,8 +1805,8 @@ g_str_hash (gconstpointer v)
* when using opaque pointers compared by pointer value as keys in a * when using opaque pointers compared by pointer value as keys in a
* #GHashTable. * #GHashTable.
* *
* This hash function is also appropriate for keys that are integers stored * This hash function is also appropriate for keys that are integers
* in pointers, such as <literal>GINT_TO_POINTER (n)</literal>. * stored in pointers, such as `GINT_TO_POINTER (n)`.
* *
* Returns: a hash value corresponding to the key. * Returns: a hash value corresponding to the key.
*/ */
@ -1823,11 +1823,11 @@ g_direct_hash (gconstpointer v)
* *
* Compares two #gpointer arguments and returns %TRUE if they are equal. * Compares two #gpointer arguments and returns %TRUE if they are equal.
* It can be passed to g_hash_table_new() as the @key_equal_func * It can be passed to g_hash_table_new() as the @key_equal_func
* parameter, when using opaque pointers compared by pointer value as keys * parameter, when using opaque pointers compared by pointer value as
* in a #GHashTable. * keys in a #GHashTable.
* *
* This equality function is also appropriate for keys that are integers stored * This equality function is also appropriate for keys that are integers
* in pointers, such as <literal>GINT_TO_POINTER (n)</literal>. * stored in pointers, such as `GINT_TO_POINTER (n)`.
* *
* Returns: %TRUE if the two keys match. * Returns: %TRUE if the two keys match.
*/ */
@ -1849,9 +1849,9 @@ g_direct_equal (gconstpointer v1,
* parameter, when using non-%NULL pointers to integers as keys in a * parameter, when using non-%NULL pointers to integers as keys in a
* #GHashTable. * #GHashTable.
* *
* Note that this function acts on pointers to #gint, not on #gint directly: * Note that this function acts on pointers to #gint, not on #gint
* if your hash table's keys are of the form * directly: if your hash table's keys are of the form
* <literal>GINT_TO_POINTER (n)</literal>, use g_direct_equal() instead. * `GINT_TO_POINTER (n)`, use g_direct_equal() instead.
* *
* Returns: %TRUE if the two keys match. * Returns: %TRUE if the two keys match.
*/ */
@ -1870,9 +1870,9 @@ g_int_equal (gconstpointer v1,
* It can be passed to g_hash_table_new() as the @hash_func parameter, * It can be passed to g_hash_table_new() as the @hash_func parameter,
* when using non-%NULL pointers to integer values as keys in a #GHashTable. * when using non-%NULL pointers to integer values as keys in a #GHashTable.
* *
* Note that this function acts on pointers to #gint, not on #gint directly: * Note that this function acts on pointers to #gint, not on #gint
* if your hash table's keys are of the form * directly: if your hash table's keys are of the form
* <literal>GINT_TO_POINTER (n)</literal>, use g_direct_hash() instead. * `GINT_TO_POINTER (n)`, use g_direct_hash() instead.
* *
* Returns: a hash value corresponding to the key. * Returns: a hash value corresponding to the key.
*/ */

6
glib/ghook.c
View File

@ -91,7 +91,7 @@
* *
* The position of the first bit which is not reserved for internal * The position of the first bit which is not reserved for internal
* use be the #GHook implementation, i.e. * use be the #GHook implementation, i.e.
* <literal>1 &lt;&lt; G_HOOK_FLAG_USER_SHIFT</literal> is the first * `1 &lt;&lt; G_HOOK_FLAG_USER_SHIFT` is the first
* bit which can be used for application-defined flags. * bit which can be used for application-defined flags.
*/ */
@ -99,7 +99,7 @@
* G_HOOK: * G_HOOK:
* @hook: a pointer * @hook: a pointer
* *
* Casts a pointer to a <literal>GHook*</literal>. * Casts a pointer to a `GHook*`.
*/ */
/** /**
@ -193,7 +193,7 @@ default_finalize_hook (GHookList *hook_list,
* g_hook_list_init: * g_hook_list_init:
* @hook_list: a #GHookList * @hook_list: a #GHookList
* @hook_size: the size of each element in the #GHookList, * @hook_size: the size of each element in the #GHookList,
* typically <literal>sizeof (GHook)</literal> * typically `sizeof (GHook)`.
* *
* Initializes a #GHookList. * Initializes a #GHookList.
* This must be called before the #GHookList is used. * This must be called before the #GHookList is used.

4
glib/giochannel.c
View File

@ -741,9 +741,9 @@ g_io_channel_get_buffer_condition (GIOChannel *channel)
/** /**
* g_io_channel_error_from_errno: * g_io_channel_error_from_errno:
* @en: an <literal>errno</literal> error number, e.g. <literal>EINVAL</literal> * @en: an `errno` error number, e.g. `EINVAL`
* *
* Converts an <literal>errno</literal> error number to a #GIOChannelError. * Converts an `errno` error number to a #GIOChannelError.
* *
* Return value: a #GIOChannelError error number, e.g. * Return value: a #GIOChannelError error number, e.g.
* %G_IO_CHANNEL_ERROR_INVAL. * %G_IO_CHANNEL_ERROR_INVAL.

19
glib/gkeyfile.c
View File

@ -113,11 +113,10 @@
* in '[' and ']', and ended implicitly by the start of the next group or * in '[' and ']', and ended implicitly by the start of the next group or
* the end of the file. Each key-value pair must be contained in a group. * the end of the file. Each key-value pair must be contained in a group.
* *
* Key-value pairs generally have the form <literal>key=value</literal>, * Key-value pairs generally have the form `key=value`, with the
* with the exception of localized strings, which have the form * exception of localized strings, which have the form
* <literal>key[locale]=value</literal>, with a locale identifier of the * `key[locale]=value`, with a locale identifier of the
* form <literal>lang_COUNTRY\@MODIFIER</literal> * form `lang_COUNTRY\@MODIFIER` where `COUNTRY` and `MODIFIER`
* where <literal>COUNTRY</literal> and <literal>MODIFIER</literal>
* are optional. * are optional.
* Space before and after the '=' character are ignored. Newline, tab, * Space before and after the '=' character are ignored. Newline, tab,
* carriage return and backslash characters in value are escaped as \n, * carriage return and backslash characters in value are escaped as \n,
@ -307,7 +306,7 @@
* A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string * A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string
* giving the file name of a binary on disk used to determine if the * giving the file name of a binary on disk used to determine if the
* program is actually installed. It is only valid for desktop entries * program is actually installed. It is only valid for desktop entries
* with the <literal>Application</literal> type. * with the `Application` type.
* *
* Since: 2.14 * Since: 2.14
*/ */
@ -317,7 +316,7 @@
* *
* A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string * A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string
* giving the command line to execute. It is only valid for desktop * giving the command line to execute. It is only valid for desktop
* entries with the <literal>Application</literal> type. * entries with the `Application` type.
* *
* Since: 2.14 * Since: 2.14
*/ */
@ -327,7 +326,7 @@
* *
* A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string * A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string
* containing the working directory to run the program in. It is only * containing the working directory to run the program in. It is only
* valid for desktop entries with the <literal>Application</literal> type. * valid for desktop entries with the `Application` type.
* *
* Since: 2.14 * Since: 2.14
*/ */
@ -338,7 +337,7 @@
* A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean * A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean
* stating whether the program should be run in a terminal window. * stating whether the program should be run in a terminal window.
* It is only valid for desktop entries with the * It is only valid for desktop entries with the
* <literal>Application</literal> type. * `Application` type.
* *
* Since: 2.14 * Since: 2.14
*/ */
@ -388,7 +387,7 @@
* *
* A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string * A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string
* giving the URL to access. It is only valid for desktop entries * giving the URL to access. It is only valid for desktop entries
* with the <literal>Link</literal> type. * with the `Link` type.
* *
* Since: 2.14 * Since: 2.14
*/ */

2
glib/glib-init.c
View File

@ -46,7 +46,7 @@ G_STATIC_ASSERT (_g_alignof (GFunc) == _g_alignof (GCompareDataFunc));
* g_mem_gc_friendly: * g_mem_gc_friendly:
* *
* This variable is %TRUE if the `G_DEBUG` environment variable * This variable is %TRUE if the `G_DEBUG` environment variable
* includes the key <literal>gc-friendly</literal>. * includes the key `gc-friendly`.
*/ */
#ifdef ENABLE_GC_FRIENDLY_DEFAULT #ifdef ENABLE_GC_FRIENDLY_DEFAULT
gboolean g_mem_gc_friendly = TRUE; gboolean g_mem_gc_friendly = TRUE;

10
glib/glib-unix.c
View File

@ -185,17 +185,15 @@ g_unix_set_fd_nonblocking (gint fd,
* @signum: A signal number * @signum: A signal number
* *
* Create a #GSource that will be dispatched upon delivery of the UNIX * Create a #GSource that will be dispatched upon delivery of the UNIX
* signal @signum. In GLib versions before 2.36, only * signal @signum. In GLib versions before 2.36, only `SIGHUP`, `SIGINT`,
* <literal>SIGHUP</literal>, <literal>SIGINT</literal>, * `SIGTERM` can be monitored. In GLib 2.36, `SIGUSR1` and `SIGUSR2`
* <literal>SIGTERM</literal> can be monitored. In GLib 2.36, * were added.
* <literal>SIGUSR1</literal> and <literal>SIGUSR2</literal> were
* added.
* *
* Note that unlike the UNIX default, all sources which have created a * Note that unlike the UNIX default, all sources which have created a
* watch will be dispatched, regardless of which underlying thread * watch will be dispatched, regardless of which underlying thread
* invoked g_unix_signal_source_new(). * invoked g_unix_signal_source_new().
* *
* For example, an effective use of this function is to handle <literal>SIGTERM</literal> * For example, an effective use of this function is to handle `SIGTERM`
* cleanly; flushing any outstanding files, and then calling * cleanly; flushing any outstanding files, and then calling
* g_main_loop_quit (). It is not safe to do any of this a regular * g_main_loop_quit (). It is not safe to do any of this a regular
* UNIX signal handler; your handler may be invoked while malloc() or * UNIX signal handler; your handler may be invoked while malloc() or

15
glib/gmain.c
View File

@ -838,7 +838,7 @@ g_main_context_ref_thread_default (void)
* Creates a new #GSource structure. The size is specified to * Creates a new #GSource structure. The size is specified to
* allow creating structures derived from #GSource that contain * allow creating structures derived from #GSource that contain
* additional data. The size passed in must be at least * additional data. The size passed in must be at least
* <literal>sizeof (GSource)</literal>. * `sizeof (GSource)`.
* *
* The source will not initially be associated with any #GMainContext * The source will not initially be associated with any #GMainContext
* and must be added to one with g_source_attach() before it will be * and must be added to one with g_source_attach() before it will be
@ -2532,12 +2532,12 @@ g_clock_win32_init (void)
* *
* Queries the system monotonic time, if available. * Queries the system monotonic time, if available.
* *
* On POSIX systems with clock_gettime() and <literal>CLOCK_MONOTONIC</literal> this call * On POSIX systems with clock_gettime() and `CLOCK_MONOTONIC` this call
* is a very shallow wrapper for that. Otherwise, we make a best effort * is a very shallow wrapper for that. Otherwise, we make a best effort
* that probably involves returning the wall clock time (with at least * that probably involves returning the wall clock time (with at least
* microsecond accuracy, subject to the limitations of the OS kernel). * microsecond accuracy, subject to the limitations of the OS kernel).
* *
* It's important to note that POSIX <literal>CLOCK_MONOTONIC</literal> does * It's important to note that POSIX `CLOCK_MONOTONIC` does
* not count time spent while the machine is suspended. * not count time spent while the machine is suspended.
* *
* On Windows, "limitations of the OS kernel" is a rather substantial * On Windows, "limitations of the OS kernel" is a rather substantial
@ -5106,8 +5106,7 @@ g_unix_signal_handler (int signum)
* executed. * executed.
* *
* Note that child watch sources can only be used in conjunction with * Note that child watch sources can only be used in conjunction with
* <literal>g_spawn...</literal> when the %G_SPAWN_DO_NOT_REAP_CHILD * `g_spawn...` when the %G_SPAWN_DO_NOT_REAP_CHILD flag is used.
* flag is used.
* *
* Note that on platforms where #GPid must be explicitly closed * Note that on platforms where #GPid must be explicitly closed
* (see g_spawn_close_pid()) @pid must not be closed while the * (see g_spawn_close_pid()) @pid must not be closed while the
@ -5115,9 +5114,9 @@ g_unix_signal_handler (int signum)
* g_spawn_close_pid() in the callback function for the source. * g_spawn_close_pid() in the callback function for the source.
* *
* Note further that using g_child_watch_source_new() is not * Note further that using g_child_watch_source_new() is not
* compatible with calling <literal>waitpid</literal> with a * compatible with calling `waitpid` with a nonpositive first
* nonpositive first argument in the application. Calling waitpid() * argument in the application. Calling waitpid() for individual
* for individual pids will still work fine. * pids will still work fine.
* *
* Return value: the newly-created child watch source * Return value: the newly-created child watch source
* *

12
glib/goption.c
View File

@ -26,7 +26,7 @@
* for the popt library. It supports short and long commandline options, * for the popt library. It supports short and long commandline options,
* as shown in the following example: * as shown in the following example:
* *
* <literal>testtreemodel -r 1 --max-size 20 --rand --display=:1.0 -vb -- file1 file2</literal> * `testtreemodel -r 1 --max-size 20 --rand --display=:1.0 -vb -- file1 file2`
* *
* The example demonstrates a number of features of the GOption * The example demonstrates a number of features of the GOption
* commandline parser: * commandline parser:
@ -327,7 +327,7 @@ G_DEFINE_QUARK (g-option-context-error-quark, g_option_error)
* @parameter_string: (allow-none): a string which is displayed in * @parameter_string: (allow-none): a string which is displayed in
* the first line of `--help` output, after the * the first line of `--help` output, after the
* usage summary * usage summary
* <literal><replaceable>programname</replaceable> [OPTION...]</literal> * `<replaceable>programname</replaceable> [OPTION...]`
* *
* Creates a new option context. * Creates a new option context.
* *
@ -754,11 +754,11 @@ context_has_h_entry (GOptionContext *context)
* *
* Returns a formatted, translated help text for the given context. * Returns a formatted, translated help text for the given context.
* To obtain the text produced by `--help`, call * To obtain the text produced by `--help`, call
* <literal>g_option_context_get_help (context, TRUE, NULL)</literal>. * `g_option_context_get_help (context, TRUE, NULL)`.
* To obtain the text produced by `--help-all`, call * To obtain the text produced by `--help-all`, call
* <literal>g_option_context_get_help (context, FALSE, NULL)</literal>. * `g_option_context_get_help (context, FALSE, NULL)`.
* To obtain the help text for an option group, call * To obtain the help text for an option group, call
* <literal>g_option_context_get_help (context, FALSE, group)</literal>. * `g_option_context_get_help (context, FALSE, group)`.
* *
* Returns: A newly allocated string containing the help text * Returns: A newly allocated string containing the help text
* *
@ -1816,7 +1816,7 @@ platform_get_argv0 (void)
* (see g_option_context_set_help_enabled()), and the * (see g_option_context_set_help_enabled()), and the
* @argv array contains one of the recognized help options, * @argv array contains one of the recognized help options,
* this function will produce help output to stdout and * this function will produce help output to stdout and
* call <literal>exit (0)</literal>. * call `exit (0)`.
* *
* Note that function depends on the * Note that function depends on the
* <link linkend="setlocale">current locale</link> for * <link linkend="setlocale">current locale</link> for

11
glib/grand.c
View File

@ -70,11 +70,10 @@
* generation, nonces, salts or one-time pads. * generation, nonces, salts or one-time pads.
* *
* This PRNG is suitable for non-cryptographic use such as in games * This PRNG is suitable for non-cryptographic use such as in games
* (shuffling a card deck, generating levels), generating data for a * (shuffling a card deck, generating levels), generating data for
* test suite, etc. If you need random data for cryptographic * a test suite, etc. If you need random data for cryptographic
* purposes, it is recommended to use platform-specific APIs such as * purposes, it is recommended to use platform-specific APIs such
* <literal>/dev/random</literal> on Unix, or CryptGenRandom() on * as `/dev/random` on UNIX, or CryptGenRandom() on Windows.
* Windows.
* *
* GRand uses the Mersenne Twister PRNG, which was originally * GRand uses the Mersenne Twister PRNG, which was originally
* developed by Makoto Matsumoto and Takuji Nishimura. Further * developed by Makoto Matsumoto and Takuji Nishimura. Further
@ -93,7 +92,7 @@
* *
* The g_rand*_range functions will return high quality equally * The g_rand*_range functions will return high quality equally
* distributed random numbers, whereas for example the * distributed random numbers, whereas for example the
* <literal>(g_random_int()&percnt;max)</literal> approach often * `(g_random_int()&percnt;max)` approach often
* doesn't yield equally distributed numbers. * doesn't yield equally distributed numbers.
* *
* GLib changed the seeding algorithm for the pseudo-random number * GLib changed the seeding algorithm for the pseudo-random number

6
glib/gscanner.c
View File

@ -254,11 +254,9 @@
* @identifier_2_string: specifies if identifiers are reported as strings * @identifier_2_string: specifies if identifiers are reported as strings
* (the default is %FALSE). * (the default is %FALSE).
* @char_2_token: specifies if characters are reported by setting * @char_2_token: specifies if characters are reported by setting
* <literal>token = ch</literal> or as %G_TOKEN_CHAR (the default * `token = ch` or as %G_TOKEN_CHAR (the default is %TRUE).
* is %TRUE).
* @symbol_2_token: specifies if symbols are reported by setting * @symbol_2_token: specifies if symbols are reported by setting
* <literal>token = v_symbol</literal> or as %G_TOKEN_SYMBOL (the * `token = v_symbol` or as %G_TOKEN_SYMBOL (the default is %FALSE).
* default is %FALSE).
* @scope_0_fallback: specifies if a symbol is searched for in the * @scope_0_fallback: specifies if a symbol is searched for in the
* default scope in addition to the current scope (the default is %FALSE). * default scope in addition to the current scope (the default is %FALSE).
* @store_int64: use value.v_int64 rather than v_int * @store_int64: use value.v_int64 rather than v_int

20
glib/gslice.c
View File

@ -87,7 +87,7 @@
* unlike malloc(), it does not reserve extra space per block. For large block * unlike malloc(), it does not reserve extra space per block. For large block
* sizes, g_slice_new() and g_slice_alloc() will automatically delegate to the * sizes, g_slice_new() and g_slice_alloc() will automatically delegate to the
* system malloc() implementation. For newly written code it is recommended * system malloc() implementation. For newly written code it is recommended
* to use the new <literal>g_slice</literal> API instead of g_malloc() and * to use the new `g_slice` API instead of g_malloc() and
* friends, as long as objects are not resized during their lifetime and the * friends, as long as objects are not resized during their lifetime and the
* object size used at allocation time is still available when freeing. * object size used at allocation time is still available when freeing.
* *
@ -867,11 +867,11 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* A convenience macro to allocate a block of memory from the * A convenience macro to allocate a block of memory from the
* slice allocator. * slice allocator.
* *
* It calls g_slice_alloc() with <literal>sizeof (@type)</literal> * It calls g_slice_alloc() with `sizeof (@type)` and casts the
* and casts the returned pointer to a pointer of the given type, * returned pointer to a pointer of the given type, avoiding a type
* avoiding a type cast in the source code. * cast in the source code. Note that the underlying slice allocation
* Note that the underlying slice allocation mechanism can * mechanism can be changed with the
* be changed with the <link linkend="G_SLICE">G_SLICE=always-malloc</link> * <link linkend="G_SLICE">G_SLICE=always-malloc</link>
* environment variable. * environment variable.
* *
* Returns: a pointer to the allocated block, cast to a pointer to @type * Returns: a pointer to the allocated block, cast to a pointer to @type
@ -886,7 +886,7 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* A convenience macro to allocate a block of memory from the * A convenience macro to allocate a block of memory from the
* slice allocator and set the memory to 0. * slice allocator and set the memory to 0.
* *
* It calls g_slice_alloc0() with <literal>sizeof (@type)</literal> * It calls g_slice_alloc0() with `sizeof (@type)`
* and casts the returned pointer to a pointer of the given type, * and casts the returned pointer to a pointer of the given type,
* avoiding a type cast in the source code. * avoiding a type cast in the source code.
* Note that the underlying slice allocation mechanism can * Note that the underlying slice allocation mechanism can
@ -904,7 +904,7 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* A convenience macro to duplicate a block of memory using * A convenience macro to duplicate a block of memory using
* the slice allocator. * the slice allocator.
* *
* It calls g_slice_copy() with <literal>sizeof (@type)</literal> * It calls g_slice_copy() with `sizeof (@type)`
* and casts the returned pointer to a pointer of the given type, * and casts the returned pointer to a pointer of the given type,
* avoiding a type cast in the source code. * avoiding a type cast in the source code.
* Note that the underlying slice allocation mechanism can * Note that the underlying slice allocation mechanism can
@ -924,7 +924,7 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* A convenience macro to free a block of memory that has * A convenience macro to free a block of memory that has
* been allocated from the slice allocator. * been allocated from the slice allocator.
* *
* It calls g_slice_free1() using <literal>sizeof (type)</literal> * It calls g_slice_free1() using `sizeof (type)`
* as the block size. * as the block size.
* Note that the exact release behaviour can be changed with the * Note that the exact release behaviour can be changed with the
* <link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment * <link linkend="G_DEBUG">G_DEBUG=gc-friendly</link> environment
@ -959,7 +959,7 @@ thread_memory_magazine2_free (ThreadMemory *tmem,
* *
* Allocates a block of memory from the slice allocator. * Allocates a block of memory from the slice allocator.
* The block adress handed out can be expected to be aligned * The block adress handed out can be expected to be aligned
* to at least <literal>1 * sizeof (void*)</literal>, * to at least 1 * sizeof (void*),
* though in general slices are 2 * sizeof (void*) bytes aligned, * though in general slices are 2 * sizeof (void*) bytes aligned,
* if a malloc() fallback implementation is used instead, * if a malloc() fallback implementation is used instead,
* the alignment may be reduced in a libc dependent fashion. * the alignment may be reduced in a libc dependent fashion.

11
glib/gspawn.c
View File

@ -526,9 +526,8 @@ g_spawn_sync (const gchar *working_directory,
* identifiers are different concepts on Windows. * identifiers are different concepts on Windows.
* *
* @envp is a %NULL-terminated array of strings, where each string * @envp is a %NULL-terminated array of strings, where each string
* has the form <literal>KEY=VALUE</literal>. This will become * has the form `KEY=VALUE`. This will become the child's environment.
* the child's environment. If @envp is %NULL, the child inherits its * If @envp is %NULL, the child inherits its parent's environment.
* parent's environment.
* *
* @flags should be the bitwise OR of any flags you want to affect the * @flags should be the bitwise OR of any flags you want to affect the
* function's behaviour. The %G_SPAWN_DO_NOT_REAP_CHILD means that the * function's behaviour. The %G_SPAWN_DO_NOT_REAP_CHILD means that the
@ -609,9 +608,9 @@ g_spawn_sync (const gchar *working_directory,
* @error can be %NULL to ignore errors, or non-%NULL to report errors. * @error can be %NULL to ignore errors, or non-%NULL to report errors.
* If an error is set, the function returns %FALSE. Errors are reported * If an error is set, the function returns %FALSE. Errors are reported
* even if they occur in the child (for example if the executable in * even if they occur in the child (for example if the executable in
* @argv[0] is not found). Typically the <literal>message</literal> field * @argv[0] is not found). Typically the `message` field of returned
* of returned errors should be displayed to users. Possible errors are * errors should be displayed to users. Possible errors are those from
* those from the #G_SPAWN_ERROR domain. * the #G_SPAWN_ERROR domain.
* *
* If an error occurs, @child_pid, @standard_input, @standard_output, * If an error occurs, @child_pid, @standard_input, @standard_output,
* and @standard_error will not be filled with valid values. * and @standard_error will not be filled with valid values.

14
glib/gstrfuncs.c
View File

@ -1136,9 +1136,9 @@ g_parse_long_long (const gchar *nptr,
* locale-sensitive system strtoull() function. * locale-sensitive system strtoull() function.
* *
* If the correct value would cause overflow, %G_MAXUINT64 * If the correct value would cause overflow, %G_MAXUINT64
* is returned, and <literal>ERANGE</literal> is stored in <literal>errno</literal>. * is returned, and `ERANGE` is stored in `errno`.
* If the base is outside the valid range, zero is returned, and * If the base is outside the valid range, zero is returned, and
* <literal>EINVAL</literal> is stored in <literal>errno</literal>. * `EINVAL` is stored in `errno`.
* If the string conversion fails, zero is returned, and @endptr returns * If the string conversion fails, zero is returned, and @endptr returns
* @nptr (if @endptr is non-%NULL). * @nptr (if @endptr is non-%NULL).
* *
@ -1183,9 +1183,9 @@ g_ascii_strtoull (const gchar *nptr,
* locale-sensitive system strtoll() function. * locale-sensitive system strtoll() function.
* *
* If the correct value would cause overflow, %G_MAXINT64 or %G_MININT64 * If the correct value would cause overflow, %G_MAXINT64 or %G_MININT64
* is returned, and <literal>ERANGE</literal> is stored in <literal>errno</literal>. * is returned, and `ERANGE` is stored in `errno`.
* If the base is outside the valid range, zero is returned, and * If the base is outside the valid range, zero is returned, and
* <literal>EINVAL</literal> is stored in <literal>errno</literal>. If the * `EINVAL` is stored in `errno`. If the
* string conversion fails, zero is returned, and @endptr returns @nptr * string conversion fails, zero is returned, and @endptr returns @nptr
* (if @endptr is non-%NULL). * (if @endptr is non-%NULL).
* *
@ -1256,8 +1256,7 @@ g_strerror (gint errnum)
/** /**
* g_strsignal: * g_strsignal:
* @signum: the signal number. See the <literal>signal</literal> * @signum: the signal number. See the `signal` documentation
* documentation
* *
* Returns a string describing the given signal, e.g. "Segmentation fault". * Returns a string describing the given signal, e.g. "Segmentation fault".
* You should use this function in preference to strsignal(), because it * You should use this function in preference to strsignal(), because it
@ -1592,8 +1591,7 @@ g_strup (gchar *string)
* @string: the string to reverse * @string: the string to reverse
* *
* Reverses all of the bytes in a string. For example, * Reverses all of the bytes in a string. For example,
* <literal>g_strreverse ("abcdef")</literal> will result * `g_strreverse ("abcdef")` will result in "fedcba".
* in "fedcba".
* *
* Note that g_strreverse() doesn't work on UTF-8 strings * Note that g_strreverse() doesn't work on UTF-8 strings
* containing multibyte characters. For that purpose, use * containing multibyte characters. For that purpose, use

51
glib/gtestutils.c
View File

@ -406,8 +406,8 @@
* or the testcase marked as failed. * or the testcase marked as failed.
* The strings are compared using g_strcmp0(). * The strings are compared using g_strcmp0().
* *
* The effect of <literal>g_assert_cmpstr (s1, op, s2)</literal> is * The effect of `g_assert_cmpstr (s1, op, s2)` is
* the same as <literal>g_assert_true (g_strcmp0 (s1, s2) op 0)</literal>. * the same as `g_assert_true (g_strcmp0 (s1, s2) op 0)`.
* The advantage of this macro is that it can produce a message that * The advantage of this macro is that it can produce a message that
* includes the actual values of @s1 and @s2. * includes the actual values of @s1 and @s2.
* *
@ -427,8 +427,8 @@
* *
* Debugging macro to compare two integers. * Debugging macro to compare two integers.
* *
* The effect of <literal>g_assert_cmpint (n1, op, n2)</literal> is * The effect of `g_assert_cmpint (n1, op, n2)` is
* the same as <literal>g_assert_true (n1 op n2)</literal>. The advantage * the same as `g_assert_true (n1 op n2)`. The advantage
* of this macro is that it can produce a message that includes the * of this macro is that it can produce a message that includes the
* actual values of @n1 and @n2. * actual values of @n1 and @n2.
* *
@ -444,8 +444,8 @@
* *
* Debugging macro to compare two unsigned integers. * Debugging macro to compare two unsigned integers.
* *
* The effect of <literal>g_assert_cmpuint (n1, op, n2)</literal> is * The effect of `g_assert_cmpuint (n1, op, n2)` is
* the same as <literal>g_assert_true (n1 op n2)</literal>. The advantage * the same as `g_assert_true (n1 op n2)`. The advantage
* of this macro is that it can produce a message that includes the * of this macro is that it can produce a message that includes the
* actual values of @n1 and @n2. * actual values of @n1 and @n2.
* *
@ -476,8 +476,8 @@
* *
* Debugging macro to compare two floating point numbers. * Debugging macro to compare two floating point numbers.
* *
* The effect of <literal>g_assert_cmpfloat (n1, op, n2)</literal> is * The effect of `g_assert_cmpfloat (n1, op, n2)` is
* the same as <literal>g_assert_true (n1 op n2)</literal>. The advantage * the same as `g_assert_true (n1 op n2)`. The advantage
* of this macro is that it can produce a message that includes the * of this macro is that it can produce a message that includes the
* actual values of @n1 and @n2. * actual values of @n1 and @n2.
* *
@ -490,8 +490,8 @@
* *
* Debugging macro to check that a #GError is not set. * Debugging macro to check that a #GError is not set.
* *
* The effect of <literal>g_assert_no_error (err)</literal> is * The effect of `g_assert_no_error (err)` is
* the same as <literal>g_assert_true (err == NULL)</literal>. The advantage * the same as `g_assert_true (err == NULL)`. The advantage
* of this macro is that it can produce a message that includes * of this macro is that it can produce a message that includes
* the error message and code. * the error message and code.
* *
@ -507,15 +507,15 @@
* Debugging macro to check that a method has returned * Debugging macro to check that a method has returned
* the correct #GError. * the correct #GError.
* *
* The effect of <literal>g_assert_error (err, dom, c)</literal> is * The effect of `g_assert_error (err, dom, c)` is
* the same as <literal>g_assert_true (err != NULL &amp;&amp; err->domain * the same as `g_assert_true (err != NULL &amp;&amp; err->domain
* == dom &amp;&amp; err->code == c)</literal>. The advantage of this * == dom &amp;&amp; err->code == c)`. The advantage of this
* macro is that it can produce a message that includes the incorrect * macro is that it can produce a message that includes the incorrect
* error message and code. * error message and code.
* *
* This can only be used to test for a specific error. If you want to * This can only be used to test for a specific error. If you want to
* test that @err is set, but don't care what it's set to, just use * test that @err is set, but don't care what it's set to, just use
* <literal>g_assert (err != NULL)</literal> * `g_assert (err != NULL)`
* *
* Since: 2.20 * Since: 2.20
*/ */
@ -1010,7 +1010,7 @@ parse_args (gint *argc_p,
* @argv: Address of the @argv parameter of main(). * @argv: Address of the @argv parameter of main().
* Any parameters understood by g_test_init() stripped before return. * Any parameters understood by g_test_init() stripped before return.
* @...: %NULL-terminated list of special options. Currently the only * @...: %NULL-terminated list of special options. Currently the only
* defined option is <literal>"no_g_set_prgname"</literal>, which * defined option is `"no_g_set_prgname"`, which
* will cause g_test_init() to not call g_set_prgname(). * will cause g_test_init() to not call g_set_prgname().
* *
* Initialize the GLib testing framework, e.g. by seeding the * Initialize the GLib testing framework, e.g. by seeding the
@ -1461,7 +1461,7 @@ g_test_get_root (void)
* *
* In general, the tests and sub-suites within each suite are run in * In general, the tests and sub-suites within each suite are run in
* the order in which they are defined. However, note that prior to * the order in which they are defined. However, note that prior to
* GLib 2.36, there was a bug in the <literal>g_test_add_*</literal> * GLib 2.36, there was a bug in the `g_test_add_*`
* functions which caused them to create multiple suites with the same * functions which caused them to create multiple suites with the same
* name, meaning that if you created tests "/foo/simple", * name, meaning that if you created tests "/foo/simple",
* "/bar/simple", and "/foo/using-bar" in that order, they would get * "/bar/simple", and "/foo/using-bar" in that order, they would get
@ -2723,12 +2723,11 @@ g_test_trap_fork (guint64 usec_timeout,
* You can use g_test_subprocess() to determine whether the test is in * You can use g_test_subprocess() to determine whether the test is in
* a subprocess or not. * a subprocess or not.
* *
* @test_path can also be the name of the parent * @test_path can also be the name of the parent test, followed by
* test, followed by "<literal>/subprocess/</literal>" and then a name * "`/subprocess/`" and then a name for the specific subtest (or just
* for the specific subtest (or just ending with * ending with "`/subprocess`" if the test only has one child test);
* "<literal>/subprocess</literal>" if the test only has one child * tests with names of this form will automatically be skipped in the
* test); tests with names of this form will automatically be skipped * parent process.
* in the parent process.
* *
* If @usec_timeout is non-0, the test subprocess is aborted and * If @usec_timeout is non-0, the test subprocess is aborted and
* considered failing if its run time exceeds it. * considered failing if its run time exceeds it.
@ -2743,12 +2742,12 @@ g_test_trap_fork (guint64 usec_timeout,
* cannot be used if @test_flags specifies that the child should * cannot be used if @test_flags specifies that the child should
* inherit the parent stdout/stderr.) * inherit the parent stdout/stderr.)
* *
* If your <literal>main ()</literal> needs to behave differently in * If your `main ()` needs to behave differently in
* the subprocess, you can call g_test_subprocess() (after calling * the subprocess, you can call g_test_subprocess() (after calling
* g_test_init()) to see whether you are in a subprocess. * g_test_init()) to see whether you are in a subprocess.
* *
* The following example tests that calling * The following example tests that calling
* <literal>my_object_new(1000000)</literal> will abort with an error * `my_object_new(1000000)` will abort with an error
* message. * message.
* *
* |[<!-- language="C" --> * |[<!-- language="C" -->
@ -3221,9 +3220,9 @@ g_test_build_filename_va (GTestFileType file_type,
* 'built' terminology that automake uses and are explicitly used to * 'built' terminology that automake uses and are explicitly used to
* distinguish between the 'srcdir' and 'builddir' being separate. All * distinguish between the 'srcdir' and 'builddir' being separate. All
* files in your project should either be dist (in the * files in your project should either be dist (in the
* <literal>DIST_EXTRA</literal> or <literal>dist_schema_DATA</literal> * `DIST_EXTRA` or `dist_schema_DATA`
* sense, in which case they will always be in the srcdir) or built (in * sense, in which case they will always be in the srcdir) or built (in
* the <literal>BUILT_SOURCES</literal> sense, in which case they will * the `BUILT_SOURCES` sense, in which case they will
* always be in the builddir). * always be in the builddir).
* *
* Note: as a general rule of automake, files that are generated only as * Note: as a general rule of automake, files that are generated only as

16
glib/gtimezone.c
View File

@ -1310,9 +1310,9 @@ rules_from_identifier (const gchar *identifier,
* In Windows, @identifier can also be the unlocalized name of a time * In Windows, @identifier can also be the unlocalized name of a time
* zone for standard time, for example "Pacific Standard Time". * zone for standard time, for example "Pacific Standard Time".
* *
* Valid RFC3339 time offsets are <literal>"Z"</literal> (for UTC) or * Valid RFC3339 time offsets are `"Z"` (for UTC) or
* <literal>"±hh:mm"</literal>. ISO 8601 additionally specifies * `"±hh:mm"`. ISO 8601 additionally specifies
* <literal>"±hhmm"</literal> and <literal>"±hh"</literal>. Offsets are * `"±hhmm"` and `"±hh"`. Offsets are
* time values to be added to Coordinated Universal Time (UTC) to get * time values to be added to Coordinated Universal Time (UTC) to get
* the local time. * the local time.
* *
@ -1323,10 +1323,10 @@ rules_from_identifier (const gchar *identifier,
* and daylight savings time zone must be three or more alphabetic * and daylight savings time zone must be three or more alphabetic
* characters. Offsets are time values to be added to local time to * characters. Offsets are time values to be added to local time to
* get Coordinated Universal Time (UTC) and should be * get Coordinated Universal Time (UTC) and should be
* <literal>"[±]hh[[:]mm[:ss]]"</literal>. Dates are either * `"[±]hh[[:]mm[:ss]]"`. Dates are either
* <literal>"Jn"</literal> (Julian day with n between 1 and 365, leap * `"Jn"` (Julian day with n between 1 and 365, leap
* years not counted), <literal>"n"</literal> (zero-based Julian day * years not counted), `"n"` (zero-based Julian day
* with n between 0 and 365) or <literal>"Mm.w.d"</literal> (day d * with n between 0 and 365) or `"Mm.w.d"` (day d
* (0 <= d <= 6) of week w (1 <= w <= 5) of month m (1 <= m <= 12), day * (0 <= d <= 6) of week w (1 <= w <= 5) of month m (1 <= m <= 12), day
* 0 is a Sunday). Times are in local wall clock time, the default is * 0 is a Sunday). Times are in local wall clock time, the default is
* 02:00:00. * 02:00:00.
@ -1354,7 +1354,7 @@ rules_from_identifier (const gchar *identifier,
* See * See
* [RFC3339 §5.6](http://tools.ietf.org/html/rfc3339#section-5.6) * [RFC3339 §5.6](http://tools.ietf.org/html/rfc3339#section-5.6)
* for a precise definition of valid RFC3339 time offsets * for a precise definition of valid RFC3339 time offsets
* (the <literal>time-offset</literal> expansion) and ISO 8601 for the * (the `time-offset` expansion) and ISO 8601 for the
* full list of valid time offsets. See * full list of valid time offsets. See
* [The GNU C Library manual](http://www.gnu.org/s/libc/manual/html_node/TZ-Variable.html) * [The GNU C Library manual](http://www.gnu.org/s/libc/manual/html_node/TZ-Variable.html)
* for an explanation of the possible * for an explanation of the possible

2
glib/gtrashstack.c
View File

@ -41,7 +41,7 @@
/** /**
* GTrashStack: * GTrashStack:
* @next: pointer to the previous element of the stack, * @next: pointer to the previous element of the stack,
* gets stored in the first <literal>sizeof (gpointer)</literal> * gets stored in the first `sizeof (gpointer)`
* bytes of the element * bytes of the element
* *
* Each piece of memory that is pushed onto the stack * Each piece of memory that is pushed onto the stack

2
glib/gutils.c
View File

@ -890,7 +890,7 @@ g_get_home_dir (void)
* Gets the directory to use for temporary files. * Gets the directory to use for temporary files.
* *
* On UNIX, this is taken from the `TMPDIR` environment variable. * On UNIX, this is taken from the `TMPDIR` environment variable.
* If the variable is not set, <literal>P_tmpdir</literal> is * If the variable is not set, `P_tmpdir` is
* used, as defined by the system C library. Failing that, a * used, as defined by the system C library. Failing that, a
* hard-coded default of "/tmp" is returned. * hard-coded default of "/tmp" is returned.
* *

2
glib/gvariant-core.c
View File

@ -670,7 +670,7 @@ g_variant_ref (GVariant *value)
* @value: a #GVariant * @value: a #GVariant
* *
* #GVariant uses a floating reference count system. All functions with * #GVariant uses a floating reference count system. All functions with
* names starting with <literal>g_variant_new_</literal> return floating * names starting with `g_variant_new_` return floating
* references. * references.
* *
* Calling g_variant_ref_sink() on a #GVariant with a floating reference * Calling g_variant_ref_sink() on a #GVariant with a floating reference

6
glib/gwin32.c
View File

@ -333,10 +333,10 @@ get_package_directory_from_module (const gchar *module_name)
* *
* The original intended use of @package was for a short identifier of * The original intended use of @package was for a short identifier of
* the package, typically the same identifier as used for * the package, typically the same identifier as used for
* <literal>GETTEXT_PACKAGE</literal> in software configured using GNU * `GETTEXT_PACKAGE` in software configured using GNU
* autotools. The function first looks in the Windows Registry for the * autotools. The function first looks in the Windows Registry for the
* value <literal>&num;InstallationDirectory</literal> in the key * value `&num;InstallationDirectory` in the key
* <literal>&num;HKLM\Software\@package</literal>, and if that value * `&num;HKLM\Software\@package`, and if that value
* exists and is a string, returns that. * exists and is a string, returns that.
* *
* It is strongly recommended that packagers of GLib-using libraries * It is strongly recommended that packagers of GLib-using libraries

4
gmodule/gmodule.c
View File

@ -57,7 +57,7 @@
* well as Windows platforms via DLLs. * well as Windows platforms via DLLs.
* *
* A program which wants to use these functions must be linked to the * A program which wants to use these functions must be linked to the
* libraries output by the command <literal>pkg-config --libs gmodule-2.0</literal>. * libraries output by the command `pkg-config --libs gmodule-2.0`.
* *
* To use them you must first determine whether dynamic loading * To use them you must first determine whether dynamic loading
* is supported on the platform by calling g_module_supported(). * is supported on the platform by calling g_module_supported().
@ -75,7 +75,7 @@
* *
* If your module introduces static data to common subsystems in the running * If your module introduces static data to common subsystems in the running
* program, e.g. through calling * program, e.g. through calling
* <literal>g_quark_from_static_string ("my-module-stuff")</literal>, * `g_quark_from_static_string ("my-module-stuff")`,
* it must ensure that it is never unloaded, by calling g_module_make_resident(). * it must ensure that it is never unloaded, by calling g_module_make_resident().
* *
* Example: Calling a function defined in a GModule * Example: Calling a function defined in a GModule

48
gobject/gclosure.c
View File

@ -144,7 +144,7 @@ enum {
/** /**
* g_closure_new_simple: * g_closure_new_simple:
* @sizeof_closure: the size of the structure to allocate, must be at least * @sizeof_closure: the size of the structure to allocate, must be at least
* <literal>sizeof (GClosure)</literal> * `sizeof (GClosure)`
* @data: data to store in the @data field of the newly allocated #GClosure * @data: data to store in the @data field of the newly allocated #GClosure
* *
* Allocates a struct of the given size and initializes the initial * Allocates a struct of the given size and initializes the initial
@ -848,7 +848,7 @@ _g_closure_invoke_va (GClosure *closure,
* @closure: a #GClosure * @closure: a #GClosure
* @marshal: a #GClosureMarshal function * @marshal: a #GClosureMarshal function
* *
* Sets the marshaller of @closure. The <literal>marshal_data</literal> * Sets the marshaller of @closure. The `marshal_data`
* of @marshal provides a way for a meta marshaller to provide additional * of @marshal provides a way for a meta marshaller to provide additional
* information to the marshaller. (See g_closure_set_meta_marshal().) For * information to the marshaller. (See g_closure_set_meta_marshal().) For
* GObject's C predefined marshallers (the g_cclosure_marshal_*() * GObject's C predefined marshallers (the g_cclosure_marshal_*()
@ -1578,7 +1578,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, gpointer user_data)`.
*/ */
/** /**
@ -1592,7 +1592,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`.
*/ */
/** /**
@ -1606,7 +1606,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, gchar arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`.
*/ */
/** /**
@ -1620,7 +1620,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, guchar arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`.
*/ */
/** /**
@ -1634,7 +1634,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, gint arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, gint arg1, gpointer user_data)`.
*/ */
/** /**
@ -1648,7 +1648,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, guint arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, guint arg1, gpointer user_data)`.
*/ */
/** /**
@ -1662,7 +1662,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, glong arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, glong arg1, gpointer user_data)`.
*/ */
/** /**
@ -1676,7 +1676,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, gulong arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, gulong arg1, gpointer user_data)`.
*/ */
/** /**
@ -1690,7 +1690,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, gint arg1, gpointer user_data)</literal> where the #gint parameter denotes an enumeration type.. * `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes an enumeration type..
*/ */
/** /**
@ -1704,7 +1704,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, gint arg1, gpointer user_data)</literal> where the #gint parameter denotes a flags type. * `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type.
*/ */
/** /**
@ -1718,7 +1718,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`.
*/ */
/** /**
@ -1732,7 +1732,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`.
*/ */
/** /**
@ -1746,7 +1746,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`.
*/ */
/** /**
@ -1760,7 +1760,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`.
*/ */
/** /**
@ -1774,7 +1774,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`.
*/ */
/** /**
@ -1788,7 +1788,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`.
*/ */
/** /**
@ -1802,7 +1802,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`.
*/ */
/** /**
@ -1816,7 +1816,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)`.
* *
* Since: 2.26 * Since: 2.26
*/ */
@ -1832,7 +1832,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)</literal>. * `void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`.
*/ */
/** /**
@ -1846,7 +1846,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)</literal> where the #gint parameter * `gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter
* denotes a flags type. * denotes a flags type.
*/ */
@ -1866,7 +1866,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)</literal>. * `gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)`.
*/ */
/** /**
* g_cclosure_marshal_BOOLEAN__OBJECT_BOXED_BOXED: * g_cclosure_marshal_BOOLEAN__OBJECT_BOXED_BOXED:
@ -1879,7 +1879,7 @@ g_cclosure_marshal_generic_va (GClosure *closure,
* @marshal_data: additional data specified when registering the marshaller * @marshal_data: additional data specified when registering the marshaller
* *
* A marshaller for a #GCClosure with a callback of type * A marshaller for a #GCClosure with a callback of type
* <literal>gboolean (*callback) (gpointer instance, GBoxed *arg1, GBoxed *arg2, gpointer user_data)</literal>. * `gboolean (*callback) (gpointer instance, GBoxed *arg1, GBoxed *arg2, gpointer user_data)`.
* *
* Since: 2.26 * Since: 2.26
*/ */

2
gobject/genums.c
View File

@ -258,7 +258,7 @@ g_flags_register_static (const gchar *name,
* enumeration values. The array is terminated by a struct with all * enumeration values. The array is terminated by a struct with all
* members being 0. * members being 0.
* *
* This function is meant to be called from the <literal>complete_type_info</literal> * This function is meant to be called from the `complete_type_info`
* function of a #GTypePlugin implementation, as in the following * function of a #GTypePlugin implementation, as in the following
* example: * example:
* *

2
gobject/gobject.c
View File

@ -3931,7 +3931,7 @@ g_object_watch_closure (GObject *object,
/** /**
* g_closure_new_object: * g_closure_new_object:
* @sizeof_closure: the size of the structure to allocate, must be at least * @sizeof_closure: the size of the structure to allocate, must be at least
* <literal>sizeof (GClosure)</literal> * `sizeof (GClosure)`
* @object: a #GObject pointer to store in the @data field of the newly * @object: a #GObject pointer to store in the @data field of the newly
* allocated #GClosure * allocated #GClosure
* *

6
gobject/gparam.c
View File

@ -243,8 +243,8 @@ g_param_spec_unref (GParamSpec *pspec)
* The initial reference count of a newly created #GParamSpec is 1, * The initial reference count of a newly created #GParamSpec is 1,
* even though no one has explicitly called g_param_spec_ref() on it * even though no one has explicitly called g_param_spec_ref() on it
* yet. So the initial reference count is flagged as "floating", until * yet. So the initial reference count is flagged as "floating", until
* someone calls <literal>g_param_spec_ref (pspec); g_param_spec_sink * someone calls `g_param_spec_ref (pspec); g_param_spec_sink
* (pspec);</literal> in sequence on it, taking over the initial * (pspec);` in sequence on it, taking over the initial
* reference count (thus ending up with a @pspec that has a reference * reference count (thus ending up with a @pspec that has a reference
* count of 1 still, but is not flagged "floating" anymore). * count of 1 still, but is not flagged "floating" anymore).
*/ */
@ -520,7 +520,7 @@ g_param_spec_set_qdata (GParamSpec *pspec,
* be freed * be freed
* *
* This function works like g_param_spec_set_qdata(), but in addition, * This function works like g_param_spec_set_qdata(), but in addition,
* a <literal>void (*destroy) (gpointer)</literal> function may be * a `void (*destroy) (gpointer)` function may be
* specified which is called with @data as argument when the @pspec is * specified which is called with @data as argument when the @pspec is
* finalized, or the data is being overwritten by a call to * finalized, or the data is being overwritten by a call to
* g_param_spec_set_qdata() with the same @quark. * g_param_spec_set_qdata() with the same @quark.

4
gobject/gsignal.c
View File

@ -2400,8 +2400,8 @@ node_check_deprecated (const SignalNode *node)
* Connects a #GCallback function to a signal for a particular object. Similar * Connects a #GCallback function to a signal for a particular object. Similar
* to g_signal_connect(), but allows to provide a #GClosureNotify for the data * to g_signal_connect(), but allows to provide a #GClosureNotify for the data
* which will be called when the signal handler is disconnected and no longer * which will be called when the signal handler is disconnected and no longer
* used. Specify @connect_flags if you need <literal>..._after()</literal> or * used. Specify @connect_flags if you need `..._after()` or
* <literal>..._swapped()</literal> variants of this function. * `..._swapped()` variants of this function.
* *
* Returns: the handler id (always greater than 0 for successful connections) * Returns: the handler id (always greater than 0 for successful connections)
*/ */