[glib/glib-2-40] docs: Remove <!-- --> comment before plural s
- From: Volker Sobek <vsobek src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glib/glib-2-40] docs: Remove <!-- --> comment before plural s
- Date: Thu, 24 Apr 2014 11:53:07 +0000 (UTC)
commit 5dedf6927f5856eecb59db094d3222cd8c8c9f01
Author: Volker Sobek <reklov live com>
Date: Wed Apr 16 23:56:02 2014 +0200
docs: Remove <!-- --> comment before plural s
These did show up in the html. Since symbol names are checked for a
trailing plural s when generating the docs, the links stay functional
after removing these comments.
https://bugzilla.gnome.org/show_bug.cgi?id=728380
gio/gappinfo.h | 2 +-
gio/gfile.h | 6 +++---
gio/gfileattribute.h | 4 ++--
gio/gfileenumerator.c | 2 +-
gio/gicon.h | 2 +-
gio/gioenums.h | 2 +-
gio/giotypes.h | 4 ++--
gio/gunixmounts.h | 2 +-
glib/gvariant-core.c | 2 +-
gobject/gclosure.h | 2 +-
gobject/gtype.h | 2 +-
gobject/gvaluecollector.h | 2 +-
12 files changed, 16 insertions(+), 16 deletions(-)
---
diff --git a/gio/gappinfo.h b/gio/gappinfo.h
index d08885a..713616f 100644
--- a/gio/gappinfo.h
+++ b/gio/gappinfo.h
@@ -55,7 +55,7 @@ typedef struct _GAppLaunchContextPrivate GAppLaunchContextPrivate;
* GAppInfoIface:
* @g_iface: The parent interface.
* @dup: Copies a #GAppInfo.
- * @equal: Checks two #GAppInfo<!-- -->s for equality.
+ * @equal: Checks two #GAppInfos for equality.
* @get_id: Gets a string identifier for a #GAppInfo.
* @get_name: Gets the name of the application for a #GAppInfo.
* @get_description: Gets a short description for the application described by the #GAppInfo.
diff --git a/gio/gfile.h b/gio/gfile.h
index 3b4d154..60a8d70 100644
--- a/gio/gfile.h
+++ b/gio/gfile.h
@@ -52,7 +52,7 @@ typedef struct _GFileIface GFileIface;
* @g_iface: The parent interface.
* @dup: Duplicates a #GFile.
* @hash: Creates a hash of a #GFile.
- * @equal: Checks equality of two given #GFile<!-- -->s.
+ * @equal: Checks equality of two given #GFiles.
* @is_native: Checks to see if a file is native to the system.
* @has_uri_scheme: Checks to see if a #GFile has a given URI scheme.
* @get_uri_scheme: Gets the URI scheme for a #GFile.
@@ -80,8 +80,8 @@ typedef struct _GFileIface GFileIface;
* @set_display_name: Sets the display name for a #GFile.
* @set_display_name_async: Asynchronously sets a #GFile's display name.
* @set_display_name_finish: Finishes asynchronously setting a #GFile's display name.
- * @query_settable_attributes: Returns a list of #GFileAttribute<!-- -->s that can be set.
- * @_query_settable_attributes_async: Asynchronously gets a list of #GFileAttribute<!-- -->s that can be set.
+ * @query_settable_attributes: Returns a list of #GFileAttributes that can be set.
+ * @_query_settable_attributes_async: Asynchronously gets a list of #GFileAttributes that can be set.
* @_query_settable_attributes_finish: Finishes asynchronously querying settable attributes.
* @query_writable_namespaces: Returns a list of #GFileAttribute namespaces that are writable.
* @_query_writable_namespaces_async: Asynchronously gets a list of #GFileAttribute namespaces that are
writable.
diff --git a/gio/gfileattribute.h b/gio/gfileattribute.h
index 3cbdcd1..b0b0916 100644
--- a/gio/gfileattribute.h
+++ b/gio/gfileattribute.h
@@ -46,11 +46,11 @@ struct _GFileAttributeInfo
/**
* GFileAttributeInfoList:
- * @infos: an array of #GFileAttributeInfo<!-- -->s.
+ * @infos: an array of #GFileAttributeInfos.
* @n_infos: the number of values in the array.
*
* Acts as a lightweight registry for possible valid file attributes.
- * The registry stores Key-Value pair formats as #GFileAttributeInfo<!-- -->s.
+ * The registry stores Key-Value pair formats as #GFileAttributeInfos.
**/
struct _GFileAttributeInfoList
{
diff --git a/gio/gfileenumerator.c b/gio/gfileenumerator.c
index ae2965f..597d1ac 100644
--- a/gio/gfileenumerator.c
+++ b/gio/gfileenumerator.c
@@ -395,7 +395,7 @@ g_file_enumerator_next_files_async (GFileEnumerator *enumerator,
*
* Finishes the asynchronous operation started with g_file_enumerator_next_files_async().
*
- * Returns: (transfer full) (element-type Gio.FileInfo): a #GList of #GFileInfo<!---->s. You must free the
list with
+ * Returns: (transfer full) (element-type Gio.FileInfo): a #GList of #GFileInfos. You must free the list
with
* g_list_free() and unref the infos with g_object_unref() when you're
* done with them.
**/
diff --git a/gio/gicon.h b/gio/gicon.h
index 1e3ed9a..5a09864 100644
--- a/gio/gicon.h
+++ b/gio/gicon.h
@@ -45,7 +45,7 @@ typedef struct _GIconIface GIconIface;
* GIconIface:
* @g_iface: The parent interface.
* @hash: A hash for a given #GIcon.
- * @equal: Checks if two #GIcon<!-- -->s are equal.
+ * @equal: Checks if two #GIcons are equal.
* @to_tokens: Serializes a #GIcon into tokens. The tokens must not
* contain any whitespace. Don't implement if the #GIcon can't be
* serialized (Since 2.20).
diff --git a/gio/gioenums.h b/gio/gioenums.h
index 27ba3ce..fb983e3 100644
--- a/gio/gioenums.h
+++ b/gio/gioenums.h
@@ -1336,7 +1336,7 @@ typedef enum /*< flags >*/
* assign a serial number from the #GDBusConnection object when
* sending a message.
*
- * Flags used when sending #GDBusMessage<!-- -->s on a #GDBusConnection.
+ * Flags used when sending #GDBusMessages on a #GDBusConnection.
*
* Since: 2.26
*/
diff --git a/gio/giotypes.h b/gio/giotypes.h
index 9efc54e..28c17d5 100644
--- a/gio/giotypes.h
+++ b/gio/giotypes.h
@@ -393,7 +393,7 @@ typedef gboolean (*GSocketSourceFunc) (GSocket *socket,
* @size: the available size in @buffer.
*
* Structure used for scatter/gather data input.
- * You generally pass in an array of #GInputVector<!-- -->s
+ * You generally pass in an array of #GInputVectors
* and the operation will store the read data starting in the
* first buffer, switching to the next as needed.
*
@@ -412,7 +412,7 @@ struct _GInputVector {
* @size: the size of @buffer.
*
* Structure used for scatter/gather data output.
- * You generally pass in an array of #GOutputVector<!-- -->s
+ * You generally pass in an array of #GOutputVectors
* and the operation will use all the buffers as if they were
* one buffer.
*
diff --git a/gio/gunixmounts.h b/gio/gunixmounts.h
index 6ac06f2..dffdce6 100644
--- a/gio/gunixmounts.h
+++ b/gio/gunixmounts.h
@@ -44,7 +44,7 @@ typedef struct _GUnixMountPoint GUnixMountPoint;
/**
* GUnixMountMonitor:
*
- * Watches #GUnixMount<!-- -->s for changes.
+ * Watches #GUnixMounts for changes.
**/
typedef struct _GUnixMountMonitor GUnixMountMonitor;
typedef struct _GUnixMountMonitorClass GUnixMountMonitorClass;
diff --git a/glib/gvariant-core.c b/glib/gvariant-core.c
index 8b649d9..a9f5d94 100644
--- a/glib/gvariant-core.c
+++ b/glib/gvariant-core.c
@@ -844,7 +844,7 @@ g_variant_get_size (GVariant *value)
* serialised data, you must know the type of the #GVariant, and (if the
* machine might be different) the endianness of the machine that stored
* it. As a result, file formats or network messages that incorporate
- * serialised #GVariant<!---->s must include this information either
+ * serialised #GVariants must include this information either
* implicitly (for instance "the file always contains a
* %G_VARIANT_TYPE_VARIANT and it is always in little-endian order") or
* explicitly (by storing the type and/or endianness in addition to the
diff --git a/gobject/gclosure.h b/gobject/gclosure.h
index 2142bd9..1cc609e 100644
--- a/gobject/gclosure.h
+++ b/gobject/gclosure.h
@@ -102,7 +102,7 @@ typedef void (*GClosureNotify) (gpointer data,
* value.
* @n_param_values: the length of the @param_values array
* @param_values: (array length=n_param_values): an array of
- * #GValue<!-- -->s holding the arguments on which to invoke the
+ * #GValues holding the arguments on which to invoke the
* callback of @closure
* @invocation_hint: (allow-none): the invocation hint given as the
* last argument to g_closure_invoke()
diff --git a/gobject/gtype.h b/gobject/gtype.h
index 330620b..22888b6 100644
--- a/gobject/gtype.h
+++ b/gobject/gtype.h
@@ -926,7 +926,7 @@ typedef void (*GInterfaceFinalizeFunc) (gpointer g_iface,
* whether they actually want to cache the class of this type, since all
* classes are routed through the same #GTypeClassCacheFunc chain.
*
- * Returns: %TRUE to stop further #GTypeClassCacheFunc<!-- -->s from being
+ * Returns: %TRUE to stop further #GTypeClassCacheFuncs from being
* called, %FALSE to continue.
*/
typedef gboolean (*GTypeClassCacheFunc) (gpointer cache_data,
diff --git a/gobject/gvaluecollector.h b/gobject/gvaluecollector.h
index 1e488b4..11a1ad8 100644
--- a/gobject/gvaluecollector.h
+++ b/gobject/gvaluecollector.h
@@ -244,7 +244,7 @@ G_STMT_START {
\
/**
* G_VALUE_COLLECT_FORMAT_MAX_LENGTH:
*
- * The maximal number of #GTypeCValue<!-- -->s which can be collected for a
+ * The maximal number of #GTypeCValues which can be collected for a
* single #GValue.
*/
#define G_VALUE_COLLECT_FORMAT_MAX_LENGTH (8)
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]