luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-26 15:36:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

docs: Fix some DocBook usage in a few gtk-doc comments

Browse Source 
<emphasis> and <ulink> tags. Replace them with Markdown.

Signed-off-by: Philip Withnall <withnall@endlessm.com>
This commit is contained in:
Philip Withnall 2017-03-16 13:50:19 +00:00
parent 3a1e98cca8
commit 2411b76c5e
5 changed files with 8 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
gio/gappinfo.h
View File

@ -66,8 +66,7 @@ typedef struct _GAppLaunchContextPrivate GAppLaunchContextPrivate;
* @supports_files: Indicates whether the application specified accepts filename arguments. * @supports_files: Indicates whether the application specified accepts filename arguments.
* @launch_uris: Launches an application with a list of URIs. * @launch_uris: Launches an application with a list of URIs.
* @should_show: Returns whether an application should be shown (e.g. when getting a list of installed applications). * @should_show: Returns whether an application should be shown (e.g. when getting a list of installed applications).
* <ulink url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt"> * [FreeDesktop.Org Startup Notification Specification](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt).
* <citetitle>FreeDesktop.Org Startup Notification Specification</citetitle></ulink>.
* @set_as_default_for_type: Sets an application as default for a given content type. * @set_as_default_for_type: Sets an application as default for a given content type.
* @set_as_default_for_extension: Sets an application as default for a given file extension. * @set_as_default_for_extension: Sets an application as default for a given file extension.
* @add_supports_type: Adds to the #GAppInfo information about supported file types. * @add_supports_type: Adds to the #GAppInfo information about supported file types.

2
gio/gdbusconnection.h
View File

@ -648,7 +648,7 @@ void g_dbus_connection_signal_unsubscribe (GDBusConnection
* If the returned #GDBusMessage is different from @message and cannot * If the returned #GDBusMessage is different from @message and cannot
* be sent on @connection (it could use features, such as file * be sent on @connection (it could use features, such as file
* descriptors, not compatible with @connection), then a warning is * descriptors, not compatible with @connection), then a warning is
* logged to <emphasis>standard error</emphasis>. Applications can * logged to standard error. Applications can
* check this ahead of time using g_dbus_message_to_blob() passing a * check this ahead of time using g_dbus_message_to_blob() passing a
* #GDBusCapabilityFlags value obtained from @connection. * #GDBusCapabilityFlags value obtained from @connection.
* *

2
gio/gioenums.h
View File

@ -989,7 +989,7 @@ typedef enum
* @G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START: If the proxy is for a well-known name, * @G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START: If the proxy is for a well-known name,
* do not ask the bus to launch an owner during proxy initialization or a method call. * do not ask the bus to launch an owner during proxy initialization or a method call.
* This flag is only meaningful in proxies for well-known names. * This flag is only meaningful in proxies for well-known names.
* @G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES: If set, the property value for any <emphasis>invalidated property</emphasis> will be (asynchronously) retrieved upon receiving the <ulink url="http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties">PropertiesChanged</ulink> D-Bus signal and the property will not cause emission of the #GDBusProxy::g-properties-changed signal. When the value is received the #GDBusProxy::g-properties-changed signal is emitted for the property along with the retrieved value. Since 2.32. * @G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES: If set, the property value for any __invalidated property__ will be (asynchronously) retrieved upon receiving the [`PropertiesChanged`](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties) D-Bus signal and the property will not cause emission of the #GDBusProxy::g-properties-changed signal. When the value is received the #GDBusProxy::g-properties-changed signal is emitted for the property along with the retrieved value. Since 2.32.
* @G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION: If the proxy is for a well-known name, * @G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION: If the proxy is for a well-known name,
* do not ask the bus to launch an owner during proxy initialization, but allow it to be * do not ask the bus to launch an owner during proxy initialization, but allow it to be
* autostarted by a method call. This flag is only meaningful in proxies for well-known names, * autostarted by a method call. This flag is only meaningful in proxies for well-known names,

4
glib/deprecated/gcache.c
View File

@ -154,12 +154,12 @@ g_cache_node_destroy (GCacheNode *node)
/** /**
* GCacheDupFunc: * GCacheDupFunc:
* @value: the #GCache key to destroy (<emphasis>not</emphasis> a * @value: the #GCache key to destroy (__not__ a
* #GCache value as it seems) * #GCache value as it seems)
* *
* Specifies the type of the @key_dup_func function passed to * Specifies the type of the @key_dup_func function passed to
* g_cache_new(). The function is passed a key * g_cache_new(). The function is passed a key
* (<emphasis>not</emphasis> a value as the prototype implies) and * (__not__ a value as the prototype implies) and
* should return a duplicate of the key. * should return a duplicate of the key.
* *
* Returns: a copy of the #GCache key * Returns: a copy of the #GCache key

8
glib/gunicode.h
View File

@ -111,7 +111,7 @@ typedef guint16 gunichar2;
* *
* These are the possible character classifications from the * These are the possible character classifications from the
* Unicode specification. * Unicode specification.
* See <ulink url="http://www.unicode.org/reports/tr44/#General_Category_Values">Unicode Character Database</unlink>. * See [Unicode Character Database](http://www.unicode.org/reports/tr44/#General_Category_Values).
*/ */
typedef enum typedef enum
{ {
@ -209,7 +209,7 @@ typedef enum
* Since new unicode versions may add new types here, applications should be ready * Since new unicode versions may add new types here, applications should be ready
* to handle unknown values. They may be regarded as %G_UNICODE_BREAK_UNKNOWN. * to handle unknown values. They may be regarded as %G_UNICODE_BREAK_UNKNOWN.
* *
* See <ulink url="http://www.unicode.org/unicode/reports/tr14/">http://www.unicode.org/unicode/reports/tr14/</ulink>. * See [Unicode Line Breaking Algorithm](http://www.unicode.org/unicode/reports/tr14/).
*/ */
typedef enum typedef enum
{ {
@ -419,9 +419,7 @@ typedef enum
* *
* Note that new types may be added in the future. Applications * Note that new types may be added in the future. Applications
* should be ready to handle unknown values. * should be ready to handle unknown values.
* See <ulink * See [Unicode Standard Annex #24: Script names](http://www.unicode.org/reports/tr24/).
* url="http://www.unicode.org/reports/tr24/">Unicode Standard Annex
* #24: Script names</ulink>.
*/ */
typedef enum typedef enum
{ /* ISO 15924 code */ { /* ISO 15924 code */