luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-10-31 08:22:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

docs: mark macros, flags, enums with percent sign

Browse Source
This commit is contained in:
Gabor Karsay
2022-03-04 16:21:55 +00:00
committed by Philip Withnall
parent 887f73d34e
commit 7e64004db0
55 changed files with 253 additions and 253 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
gio/gdbusconnection.c
View File

@@ -5268,7 +5268,7 @@ obj_message_func (GDBusConnection *connection,
* #GVariant of incorrect type. * #GVariant of incorrect type.
* *
* If an existing callback is already registered at @object_path and * If an existing callback is already registered at @object_path and
* @interface_name, then @error is set to #G_IO_ERROR_EXISTS. * @interface_name, then @error is set to %G_IO_ERROR_EXISTS.
* *
* GDBus automatically implements the standard D-Bus interfaces * GDBus automatically implements the standard D-Bus interfaces
* org.freedesktop.DBus.Properties, org.freedesktop.DBus.Introspectable * org.freedesktop.DBus.Properties, org.freedesktop.DBus.Introspectable
@@ -6930,7 +6930,7 @@ subtree_message_func (GDBusConnection *connection,
* *
* When handling remote calls into any node in the subtree, first the * When handling remote calls into any node in the subtree, first the
* @enumerate function is used to check if the node exists. If the node exists * @enumerate function is used to check if the node exists. If the node exists
* or the #G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is set * or the %G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is set
* the @introspection function is used to check if the node supports the * the @introspection function is used to check if the node supports the
* requested method. If so, the @dispatch function is used to determine * requested method. If so, the @dispatch function is used to determine
* where to dispatch the call. The collected #GDBusInterfaceVTable and * where to dispatch the call. The collected #GDBusInterfaceVTable and
@@ -6942,7 +6942,7 @@ subtree_message_func (GDBusConnection *connection,
* of the thread you are calling this method from. * of the thread you are calling this method from.
* *
* If an existing subtree is already registered at @object_path or * If an existing subtree is already registered at @object_path or
* then @error is set to #G_IO_ERROR_EXISTS. * then @error is set to %G_IO_ERROR_EXISTS.
* *
* Note that it is valid to register regular objects (using * Note that it is valid to register regular objects (using
* g_dbus_connection_register_object()) in a subtree registered with * g_dbus_connection_register_object()) in a subtree registered with

2
gio/gdbuserror.c
View File

@@ -588,7 +588,7 @@ g_dbus_error_get_remote_error (const GError *error)
* such that it can be recovered with g_dbus_error_get_remote_error(). * such that it can be recovered with g_dbus_error_get_remote_error().
* *
* Otherwise, a #GError with the error code %G_IO_ERROR_DBUS_ERROR * Otherwise, a #GError with the error code %G_IO_ERROR_DBUS_ERROR
* in the #G_IO_ERROR error domain is returned. Also, @dbus_error_name is * in the %G_IO_ERROR error domain is returned. Also, @dbus_error_name is
* added to the error message such that it can be recovered with * added to the error message such that it can be recovered with
* g_dbus_error_get_remote_error(). * g_dbus_error_get_remote_error().
* *

8
gio/gdbusutils.c
View File

@@ -548,12 +548,12 @@ g_dbus_gvariant_to_gvalue (GVariant *value,
* - `G_TYPE_DOUBLE`: 'd' * - `G_TYPE_DOUBLE`: 'd'
* - `G_TYPE_VARIANT`: Any #GVariantType * - `G_TYPE_VARIANT`: Any #GVariantType
* *
* This can fail if e.g. @gvalue is of type #G_TYPE_STRING and @type * This can fail if e.g. @gvalue is of type %G_TYPE_STRING and @type
* is 'i', i.e. #G_VARIANT_TYPE_INT32. It will also fail for any #GType * is 'i', i.e. %G_VARIANT_TYPE_INT32. It will also fail for any #GType
* (including e.g. #G_TYPE_OBJECT and #G_TYPE_BOXED derived-types) not * (including e.g. %G_TYPE_OBJECT and %G_TYPE_BOXED derived-types) not
* in the table above. * in the table above.
* *
* Note that if @gvalue is of type #G_TYPE_VARIANT and its value is * Note that if @gvalue is of type %G_TYPE_VARIANT and its value is
* %NULL, the empty #GVariant instance (never %NULL) for @type is * %NULL, the empty #GVariant instance (never %NULL) for @type is
* returned (e.g. 0 for scalar types, the empty string for string types, * returned (e.g. 0 for scalar types, the empty string for string types,
* '/' for object path types, the empty array for any array type and so on). * '/' for object path types, the empty array for any array type and so on).

2
gio/gdesktopappinfo.c
View File

@@ -2305,7 +2305,7 @@ g_desktop_app_info_get_generic_name (GDesktopAppInfo *info)
* *
* Gets the value of the NoDisplay key, which helps determine if the * Gets the value of the NoDisplay key, which helps determine if the
* application info should be shown in menus. See * application info should be shown in menus. See
* #G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY and g_app_info_should_show(). * %G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY and g_app_info_should_show().
* *
* Returns: The value of the NoDisplay key * Returns: The value of the NoDisplay key
* *

2
gio/gdrive.c
View File

@@ -613,7 +613,7 @@ g_drive_poll_for_media_finish (GDrive *drive,
* *
* Gets the identifier of the given kind for @drive. The only * Gets the identifier of the given kind for @drive. The only
* identifier currently available is * identifier currently available is
* #G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE. * %G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE.
* *
* Returns: (nullable) (transfer full): a newly allocated string containing the * Returns: (nullable) (transfer full): a newly allocated string containing the
* requested identifier, or %NULL if the #GDrive * requested identifier, or %NULL if the #GDrive

50
gio/gfile.c
View File

@@ -1041,7 +1041,7 @@ g_file_resolve_relative_path (GFile *file,
* "standard::*" means all attributes in the standard namespace. * "standard::*" means all attributes in the standard namespace.
* An example attribute query be "standard::*,owner::user". * An example attribute query be "standard::*,owner::user".
* The standard attributes are available as defines, like * The standard attributes are available as defines, like
* #G_FILE_ATTRIBUTE_STANDARD_NAME. #G_FILE_ATTRIBUTE_STANDARD_NAME should * %G_FILE_ATTRIBUTE_STANDARD_NAME. %G_FILE_ATTRIBUTE_STANDARD_NAME should
* always be specified if you plan to call g_file_enumerator_get_child() or * always be specified if you plan to call g_file_enumerator_get_child() or
* g_file_enumerator_iterate() on the returned enumerator. * g_file_enumerator_iterate() on the returned enumerator.
* *
@@ -1225,7 +1225,7 @@ g_file_query_exists (GFile *file,
* The primary use case of this method is to check if a file is * The primary use case of this method is to check if a file is
* a regular file, directory, or symlink. * a regular file, directory, or symlink.
* *
* Returns: The #GFileType of the file and #G_FILE_TYPE_UNKNOWN * Returns: The #GFileType of the file and %G_FILE_TYPE_UNKNOWN
* if the file does not exist * if the file does not exist
* *
* Since: 2.18 * Since: 2.18
@@ -1274,7 +1274,7 @@ g_file_query_file_type (GFile *file,
* "standard::*" means all attributes in the standard namespace. * "standard::*" means all attributes in the standard namespace.
* An example attribute query be "standard::*,owner::user". * An example attribute query be "standard::*,owner::user".
* The standard attributes are available as defines, like * The standard attributes are available as defines, like
* #G_FILE_ATTRIBUTE_STANDARD_NAME. * %G_FILE_ATTRIBUTE_STANDARD_NAME.
* *
* If @cancellable is not %NULL, then the operation can be cancelled * If @cancellable is not %NULL, then the operation can be cancelled
* by triggering the cancellable object from another thread. If the * by triggering the cancellable object from another thread. If the
@@ -1283,7 +1283,7 @@ g_file_query_file_type (GFile *file,
* *
* For symlinks, normally the information about the target of the * For symlinks, normally the information about the target of the
* symlink is returned, rather than information about the symlink * symlink is returned, rather than information about the symlink
* itself. However if you pass #G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS * itself. However if you pass %G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS
* in @flags the information about the symlink itself will be returned. * in @flags the information about the symlink itself will be returned.
* Also, for symlinks that point to non-existing files the information * Also, for symlinks that point to non-existing files the information
* about the symlink itself will be returned. * about the symlink itself will be returned.
@@ -1418,9 +1418,9 @@ g_file_query_info_finish (GFile *file,
* attributes, and a wildcard like "filesystem::*" means all attributes * attributes, and a wildcard like "filesystem::*" means all attributes
* in the filesystem namespace. The standard namespace for filesystem * in the filesystem namespace. The standard namespace for filesystem
* attributes is "filesystem". Common attributes of interest are * attributes is "filesystem". Common attributes of interest are
* #G_FILE_ATTRIBUTE_FILESYSTEM_SIZE (the total size of the filesystem * %G_FILE_ATTRIBUTE_FILESYSTEM_SIZE (the total size of the filesystem
* in bytes), #G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of bytes available), * in bytes), %G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of bytes available),
* and #G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem). * and %G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).
* *
* If @cancellable is not %NULL, then the operation can be cancelled * If @cancellable is not %NULL, then the operation can be cancelled
* by triggering the cancellable object from another thread. If the * by triggering the cancellable object from another thread. If the
@@ -1710,7 +1710,7 @@ g_file_read (GFile *file,
* If the file doesn't already exist it is created. * If the file doesn't already exist it is created.
* *
* By default files created are generally readable by everyone, * By default files created are generally readable by everyone,
* but if you pass #G_FILE_CREATE_PRIVATE in @flags the file * but if you pass %G_FILE_CREATE_PRIVATE in @flags the file
* will be made readable only to the current user, to the level that * will be made readable only to the current user, to the level that
* is supported on the target filesystem. * is supported on the target filesystem.
* *
@@ -1765,7 +1765,7 @@ g_file_append_to (GFile *file,
* The file must not already exist. * The file must not already exist.
* *
* By default files created are generally readable by everyone, * By default files created are generally readable by everyone,
* but if you pass #G_FILE_CREATE_PRIVATE in @flags the file * but if you pass %G_FILE_CREATE_PRIVATE in @flags the file
* will be made readable only to the current user, to the level * will be made readable only to the current user, to the level
* that is supported on the target filesystem. * that is supported on the target filesystem.
* *
@@ -1833,7 +1833,7 @@ g_file_create (GFile *file,
* the destination when the stream is closed. * the destination when the stream is closed.
* *
* By default files created are generally readable by everyone, * By default files created are generally readable by everyone,
* but if you pass #G_FILE_CREATE_PRIVATE in @flags the file * but if you pass %G_FILE_CREATE_PRIVATE in @flags the file
* will be made readable only to the current user, to the level that * will be made readable only to the current user, to the level that
* is supported on the target filesystem. * is supported on the target filesystem.
* *
@@ -1964,7 +1964,7 @@ g_file_open_readwrite (GFile *file,
* writing to it. The file must not already exist. * writing to it. The file must not already exist.
* *
* By default files created are generally readable by everyone, * By default files created are generally readable by everyone,
* but if you pass #G_FILE_CREATE_PRIVATE in @flags the file * but if you pass %G_FILE_CREATE_PRIVATE in @flags the file
* will be made readable only to the current user, to the level * will be made readable only to the current user, to the level
* that is supported on the target filesystem. * that is supported on the target filesystem.
* *
@@ -2852,7 +2852,7 @@ g_file_build_attribute_list_for_copy (GFile *file,
* Normally only a subset of the file attributes are copied, * Normally only a subset of the file attributes are copied,
* those that are copies in a normal file copy operation * those that are copies in a normal file copy operation
* (which for instance does not include e.g. owner). However * (which for instance does not include e.g. owner). However
* if #G_FILE_COPY_ALL_METADATA is specified in @flags, then * if %G_FILE_COPY_ALL_METADATA is specified in @flags, then
* all the metadata that is possible to copy is copied. This * all the metadata that is possible to copy is copied. This
* is useful when implementing move by copy + delete source. * is useful when implementing move by copy + delete source.
* *
@@ -3455,14 +3455,14 @@ file_copy_fallback (GFile *source,
* Copies the file @source to the location specified by @destination. * Copies the file @source to the location specified by @destination.
* Can not handle recursive copies of directories. * Can not handle recursive copies of directories.
* *
* If the flag #G_FILE_COPY_OVERWRITE is specified an already * If the flag %G_FILE_COPY_OVERWRITE is specified an already
* existing @destination file is overwritten. * existing @destination file is overwritten.
* *
* If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks * If the flag %G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
* will be copied as symlinks, otherwise the target of the * will be copied as symlinks, otherwise the target of the
* @source symlink will be copied. * @source symlink will be copied.
* *
* If the flag #G_FILE_COPY_ALL_METADATA is specified then all the metadata * If the flag %G_FILE_COPY_ALL_METADATA is specified then all the metadata
* that is possible to copy is copied, not just the default subset (which, * that is possible to copy is copied, not just the default subset (which,
* for instance, does not include the owner, see #GFileInfo). * for instance, does not include the owner, see #GFileInfo).
* *
@@ -3479,7 +3479,7 @@ file_copy_fallback (GFile *source,
* If the @source file does not exist, then the %G_IO_ERROR_NOT_FOUND error * If the @source file does not exist, then the %G_IO_ERROR_NOT_FOUND error
* is returned, independent on the status of the @destination. * is returned, independent on the status of the @destination.
* *
* If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then * If %G_FILE_COPY_OVERWRITE is not specified and the target exists, then
* the error %G_IO_ERROR_EXISTS is returned. * the error %G_IO_ERROR_EXISTS is returned.
* *
* If trying to overwrite a file over a directory, the %G_IO_ERROR_IS_DIRECTORY * If trying to overwrite a file over a directory, the %G_IO_ERROR_IS_DIRECTORY
@@ -3487,7 +3487,7 @@ file_copy_fallback (GFile *source,
* %G_IO_ERROR_WOULD_MERGE error is returned. * %G_IO_ERROR_WOULD_MERGE error is returned.
* *
* If the source is a directory and the target does not exist, or * If the source is a directory and the target does not exist, or
* #G_FILE_COPY_OVERWRITE is specified and the target is a file, then the * %G_FILE_COPY_OVERWRITE is specified and the target is a file, then the
* %G_IO_ERROR_WOULD_RECURSE error is returned. * %G_IO_ERROR_WOULD_RECURSE error is returned.
* *
* If you are interested in copying the #GFile object itself (not the on-disk * If you are interested in copying the #GFile object itself (not the on-disk
@@ -3667,7 +3667,7 @@ g_file_copy_finish (GFile *file,
* implementation may support moving directories (for instance on moves * implementation may support moving directories (for instance on moves
* inside the same filesystem), but the fallback code does not. * inside the same filesystem), but the fallback code does not.
* *
* If the flag #G_FILE_COPY_OVERWRITE is specified an already * If the flag %G_FILE_COPY_OVERWRITE is specified an already
* existing @destination file is overwritten. * existing @destination file is overwritten.
* *
* If @cancellable is not %NULL, then the operation can be cancelled by * If @cancellable is not %NULL, then the operation can be cancelled by
@@ -3683,7 +3683,7 @@ g_file_copy_finish (GFile *file,
* If the @source file does not exist, then the %G_IO_ERROR_NOT_FOUND * If the @source file does not exist, then the %G_IO_ERROR_NOT_FOUND
* error is returned, independent on the status of the @destination. * error is returned, independent on the status of the @destination.
* *
* If #G_FILE_COPY_OVERWRITE is not specified and the target exists, * If %G_FILE_COPY_OVERWRITE is not specified and the target exists,
* then the error %G_IO_ERROR_EXISTS is returned. * then the error %G_IO_ERROR_EXISTS is returned.
* *
* If trying to overwrite a file over a directory, the %G_IO_ERROR_IS_DIRECTORY * If trying to overwrite a file over a directory, the %G_IO_ERROR_IS_DIRECTORY
@@ -3691,7 +3691,7 @@ g_file_copy_finish (GFile *file,
* %G_IO_ERROR_WOULD_MERGE error is returned. * %G_IO_ERROR_WOULD_MERGE error is returned.
* *
* If the source is a directory and the target does not exist, or * If the source is a directory and the target does not exist, or
* #G_FILE_COPY_OVERWRITE is specified and the target is a file, then * %G_FILE_COPY_OVERWRITE is specified and the target is a file, then
* the %G_IO_ERROR_WOULD_RECURSE error may be returned (if the native * the %G_IO_ERROR_WOULD_RECURSE error may be returned (if the native
* move operation isn't available). * move operation isn't available).
* *
@@ -4395,7 +4395,7 @@ g_file_trash_finish (GFile *file,
* for the target filesystem if possible and the @file is renamed to this. * for the target filesystem if possible and the @file is renamed to this.
* *
* If you want to implement a rename operation in the user interface the * If you want to implement a rename operation in the user interface the
* edit name (#G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the * edit name (%G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the
* initial value in the rename widget, and then the result after editing * initial value in the rename widget, and then the result after editing
* should be passed to g_file_set_display_name(). * should be passed to g_file_set_display_name().
* *
@@ -5227,7 +5227,7 @@ g_file_unmount_mountable_finish (GFile *file,
* when the request is satisfied, or %NULL * when the request is satisfied, or %NULL
* @user_data: (closure): the data to pass to callback function * @user_data: (closure): the data to pass to callback function
* *
* Unmounts a file of type #G_FILE_TYPE_MOUNTABLE. * Unmounts a file of type %G_FILE_TYPE_MOUNTABLE.
* *
* If @cancellable is not %NULL, then the operation can be cancelled by * If @cancellable is not %NULL, then the operation can be cancelled by
* triggering the cancellable object from another thread. If the operation * triggering the cancellable object from another thread. If the operation
@@ -8339,7 +8339,7 @@ g_file_measure_disk_usage_finish (GFile *file,
* @callback: (nullable): a #GAsyncReadyCallback to call when the request is satisfied, or %NULL * @callback: (nullable): a #GAsyncReadyCallback to call when the request is satisfied, or %NULL
* @user_data: the data to pass to callback function * @user_data: the data to pass to callback function
* *
* Starts a file of type #G_FILE_TYPE_MOUNTABLE. * Starts a file of type %G_FILE_TYPE_MOUNTABLE.
* Using @start_operation, you can request callbacks when, for instance, * Using @start_operation, you can request callbacks when, for instance,
* passwords are needed during authentication. * passwords are needed during authentication.
* *
@@ -8431,7 +8431,7 @@ g_file_start_mountable_finish (GFile *file,
* when the request is satisfied, or %NULL * when the request is satisfied, or %NULL
* @user_data: the data to pass to callback function * @user_data: the data to pass to callback function
* *
* Stops a file of type #G_FILE_TYPE_MOUNTABLE. * Stops a file of type %G_FILE_TYPE_MOUNTABLE.
* *
* If @cancellable is not %NULL, then the operation can be cancelled by * If @cancellable is not %NULL, then the operation can be cancelled by
* triggering the cancellable object from another thread. If the operation * triggering the cancellable object from another thread. If the operation
@@ -8517,7 +8517,7 @@ g_file_stop_mountable_finish (GFile *file,
* when the request is satisfied, or %NULL * when the request is satisfied, or %NULL
* @user_data: the data to pass to callback function * @user_data: the data to pass to callback function
* *
* Polls a file of type #G_FILE_TYPE_MOUNTABLE. * Polls a file of type %G_FILE_TYPE_MOUNTABLE.
* *
* If @cancellable is not %NULL, then the operation can be cancelled by * If @cancellable is not %NULL, then the operation can be cancelled by
* triggering the cancellable object from another thread. If the operation * triggering the cancellable object from another thread. If the operation

2
gio/gfileenumerator.c
View File

@@ -721,7 +721,7 @@ g_file_enumerator_get_container (GFileEnumerator *enumerator)
* directory of @enumerator. This function is primarily intended to be used * directory of @enumerator. This function is primarily intended to be used
* inside loops with g_file_enumerator_next_file(). * inside loops with g_file_enumerator_next_file().
* *
* To use this, #G_FILE_ATTRIBUTE_STANDARD_NAME must have been listed in the * To use this, %G_FILE_ATTRIBUTE_STANDARD_NAME must have been listed in the
* attributes list used when creating the #GFileEnumerator. * attributes list used when creating the #GFileEnumerator.
* *
* This is a convenience method that's equivalent to: * This is a convenience method that's equivalent to:

2
gio/gfilemonitor.c
View File

@@ -172,7 +172,7 @@ g_file_monitor_class_init (GFileMonitorClass *klass)
* that the %G_FILE_MONITOR_WATCH_MOVES flag is not in use. * that the %G_FILE_MONITOR_WATCH_MOVES flag is not in use.
* *
* If using the deprecated flag %G_FILE_MONITOR_SEND_MOVED flag and @event_type is * If using the deprecated flag %G_FILE_MONITOR_SEND_MOVED flag and @event_type is
* #G_FILE_MONITOR_EVENT_MOVED, @file will be set to a #GFile containing the * %G_FILE_MONITOR_EVENT_MOVED, @file will be set to a #GFile containing the
* old path, and @other_file will be set to a #GFile containing the new path. * old path, and @other_file will be set to a #GFile containing the new path.
* *
* In all the other cases, @other_file will be set to #NULL. * In all the other cases, @other_file will be set to #NULL.

6
gio/gioenums.h
View File

@@ -392,7 +392,7 @@ typedef enum {
* *
* Indicates a hint from the file system whether files should be * Indicates a hint from the file system whether files should be
* previewed in a file manager. Returned as the value of the key * previewed in a file manager. Returned as the value of the key
* #G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW. * %G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW.
**/ **/
typedef enum { typedef enum {
G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS = 0, G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS = 0,
@@ -522,7 +522,7 @@ typedef enum {
* } * }
* ]| * ]|
* but should instead treat all unrecognized error codes the same as * but should instead treat all unrecognized error codes the same as
* #G_IO_ERROR_FAILED. * %G_IO_ERROR_FAILED.
* *
* See also #GPollableReturn for a cheaper way of returning * See also #GPollableReturn for a cheaper way of returning
* %G_IO_ERROR_WOULD_BLOCK to callers without allocating a #GError. * %G_IO_ERROR_WOULD_BLOCK to callers without allocating a #GError.
@@ -973,7 +973,7 @@ typedef enum
* @G_BUS_NAME_OWNER_FLAGS_NONE: No flags set. * @G_BUS_NAME_OWNER_FLAGS_NONE: No flags set.
* @G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT: Allow another message bus connection to claim the name. * @G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT: Allow another message bus connection to claim the name.
* @G_BUS_NAME_OWNER_FLAGS_REPLACE: If another message bus connection owns the name and have * @G_BUS_NAME_OWNER_FLAGS_REPLACE: If another message bus connection owns the name and have
* specified #G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT, then take the name from the other connection. * specified %G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT, then take the name from the other connection.
* @G_BUS_NAME_OWNER_FLAGS_DO_NOT_QUEUE: If another message bus connection owns the name, immediately * @G_BUS_NAME_OWNER_FLAGS_DO_NOT_QUEUE: If another message bus connection owns the name, immediately
* return an error from g_bus_own_name() rather than entering the waiting queue for that name. (Since 2.54) * return an error from g_bus_own_name() rather than entering the waiting queue for that name. (Since 2.54)
* *

2
gio/giomodule.c
View File

@@ -1474,7 +1474,7 @@ g_io_extension_point_set_required_type (GIOExtensionPoint *extension_point,
* Gets the required type for @extension_point. * Gets the required type for @extension_point.
* *
* Returns: the #GType that all implementations must have, * Returns: the #GType that all implementations must have,
* or #G_TYPE_INVALID if the extension point has no required type * or %G_TYPE_INVALID if the extension point has no required type
*/ */
GType GType
g_io_extension_point_get_required_type (GIOExtensionPoint *extension_point) g_io_extension_point_get_required_type (GIOExtensionPoint *extension_point)

2
gio/gresolver.c
View File

@@ -545,7 +545,7 @@ g_resolver_lookup_by_name (GResolver *resolver,
* *
* This differs from g_resolver_lookup_by_name() in that you can modify * This differs from g_resolver_lookup_by_name() in that you can modify
* the lookup behavior with @flags. For example this can be used to limit * the lookup behavior with @flags. For example this can be used to limit
* results with #G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY. * results with %G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY.
* *
* Returns: (element-type GInetAddress) (transfer full): a non-empty #GList * Returns: (element-type GInetAddress) (transfer full): a non-empty #GList
* of #GInetAddress, or %NULL on error. You * of #GInetAddress, or %NULL on error. You

2
gio/gsettings.c
View File

@@ -248,7 +248,7 @@
* looks for a boolean property with the name "sensitivity" and * looks for a boolean property with the name "sensitivity" and
* automatically binds it to the writability of the bound setting. * automatically binds it to the writability of the bound setting.
* If this 'magic' gets in the way, it can be suppressed with the * If this 'magic' gets in the way, it can be suppressed with the
* #G_SETTINGS_BIND_NO_SENSITIVITY flag. * %G_SETTINGS_BIND_NO_SENSITIVITY flag.
* *
* ## Relocatable schemas # {#gsettings-relocatable} * ## Relocatable schemas # {#gsettings-relocatable}
* *

2
gio/gsettings.h
View File

@@ -284,7 +284,7 @@ typedef gboolean (*GSettingsGetMapping) (GVarian
* @G_SETTINGS_BIND_SET: Update the setting when the #GObject property changes. * @G_SETTINGS_BIND_SET: Update the setting when the #GObject property changes.
* It is an error to use this flag if the property is not readable. * It is an error to use this flag if the property is not readable.
* @G_SETTINGS_BIND_NO_SENSITIVITY: Do not try to bind a "sensitivity" property to the writability of the setting * @G_SETTINGS_BIND_NO_SENSITIVITY: Do not try to bind a "sensitivity" property to the writability of the setting
* @G_SETTINGS_BIND_GET_NO_CHANGES: When set in addition to #G_SETTINGS_BIND_GET, set the #GObject property * @G_SETTINGS_BIND_GET_NO_CHANGES: When set in addition to %G_SETTINGS_BIND_GET, set the #GObject property
* value initially from the setting, but do not listen for changes of the setting * value initially from the setting, but do not listen for changes of the setting
* @G_SETTINGS_BIND_INVERT_BOOLEAN: When passed to g_settings_bind(), uses a pair of mapping functions that invert * @G_SETTINGS_BIND_INVERT_BOOLEAN: When passed to g_settings_bind(), uses a pair of mapping functions that invert
* the boolean value when mapping between the setting and the property. The setting and property must both * the boolean value when mapping between the setting and the property. The setting and property must both

2
gio/gsettingsbackend.c
View File

@@ -60,7 +60,7 @@ static gboolean g_settings_has_backend;
* non-strictly-typed data that is stored in a hierarchy. To implement * non-strictly-typed data that is stored in a hierarchy. To implement
* an alternative storage backend for #GSettings, you need to implement * an alternative storage backend for #GSettings, you need to implement
* the #GSettingsBackend interface and then make it implement the * the #GSettingsBackend interface and then make it implement the
* extension point #G_SETTINGS_BACKEND_EXTENSION_POINT_NAME. * extension point %G_SETTINGS_BACKEND_EXTENSION_POINT_NAME.
* *
* The interface defines methods for reading and writing values, a * The interface defines methods for reading and writing values, a
* method for determining if writing of certain values will fail * method for determining if writing of certain values will fail

6
gio/gsimpleasyncresult.c
View File

@@ -705,7 +705,7 @@ g_simple_async_result_take_error (GSimpleAsyncResult *simple,
/** /**
* g_simple_async_result_set_error_va: (skip) * g_simple_async_result_set_error_va: (skip)
* @simple: a #GSimpleAsyncResult. * @simple: a #GSimpleAsyncResult.
* @domain: a #GQuark (usually #G_IO_ERROR). * @domain: a #GQuark (usually %G_IO_ERROR).
* @code: an error code. * @code: an error code.
* @format: a formatted error reporting string. * @format: a formatted error reporting string.
* @args: va_list of arguments. * @args: va_list of arguments.
@@ -735,7 +735,7 @@ g_simple_async_result_set_error_va (GSimpleAsyncResult *simple,
/** /**
* g_simple_async_result_set_error: (skip) * g_simple_async_result_set_error: (skip)
* @simple: a #GSimpleAsyncResult. * @simple: a #GSimpleAsyncResult.
* @domain: a #GQuark (usually #G_IO_ERROR). * @domain: a #GQuark (usually %G_IO_ERROR).
* @code: an error code. * @code: an error code.
* @format: a formatted error reporting string. * @format: a formatted error reporting string.
* @...: a list of variables to fill in @format. * @...: a list of variables to fill in @format.
@@ -1007,7 +1007,7 @@ g_simple_async_result_is_valid (GAsyncResult *result,
* @object: (nullable): a #GObject, or %NULL. * @object: (nullable): a #GObject, or %NULL.
* @callback: a #GAsyncReadyCallback. * @callback: a #GAsyncReadyCallback.
* @user_data: user data passed to @callback. * @user_data: user data passed to @callback.
* @domain: a #GQuark containing the error domain (usually #G_IO_ERROR). * @domain: a #GQuark containing the error domain (usually %G_IO_ERROR).
* @code: a specific error code. * @code: a specific error code.
* @format: a formatted error reporting string. * @format: a formatted error reporting string.
* @...: a list of variables to fill in @format. * @...: a list of variables to fill in @format.

2
gio/gtask.c
View File

@@ -2005,7 +2005,7 @@ value_free (gpointer value)
* *
* Sets @task's result to @result (by copying it) and completes the task. * Sets @task's result to @result (by copying it) and completes the task.
* *
* If @result is %NULL then a #GValue of type #G_TYPE_POINTER * If @result is %NULL then a #GValue of type %G_TYPE_POINTER
* with a value of %NULL will be used for the result. * with a value of %NULL will be used for the result.
* *
* This is a very generic low-level method intended primarily for use * This is a very generic low-level method intended primarily for use

2
gio/gtlsdatabase.c
View File

@@ -469,7 +469,7 @@ g_tls_database_class_init (GTlsDatabaseClass *klass)
* certificate in the chain by its #GTlsCertificate:issuer property. * certificate in the chain by its #GTlsCertificate:issuer property.
* *
* @purpose describes the purpose (or usage) for which the certificate * @purpose describes the purpose (or usage) for which the certificate
* is being used. Typically @purpose will be set to #G_TLS_DATABASE_PURPOSE_AUTHENTICATE_SERVER * is being used. Typically @purpose will be set to %G_TLS_DATABASE_PURPOSE_AUTHENTICATE_SERVER
* which means that the certificate is being used to authenticate a server * which means that the certificate is being used to authenticate a server
* (and we are acting as the client). * (and we are acting as the client).
* *

6
gio/gvolume.c
View File

@@ -66,13 +66,13 @@
* different kinds of identifiers, such as Hal UDIs, filesystem labels, * different kinds of identifiers, such as Hal UDIs, filesystem labels,
* traditional Unix devices (e.g. `/dev/sda2`), UUIDs. GIO uses predefined * traditional Unix devices (e.g. `/dev/sda2`), UUIDs. GIO uses predefined
* strings as names for the different kinds of identifiers: * strings as names for the different kinds of identifiers:
* #G_VOLUME_IDENTIFIER_KIND_UUID, #G_VOLUME_IDENTIFIER_KIND_LABEL, etc. * %G_VOLUME_IDENTIFIER_KIND_UUID, %G_VOLUME_IDENTIFIER_KIND_LABEL, etc.
* Use g_volume_get_identifier() to obtain an identifier for a volume. * Use g_volume_get_identifier() to obtain an identifier for a volume.
* *
* *
* Note that #G_VOLUME_IDENTIFIER_KIND_HAL_UDI will only be available * Note that %G_VOLUME_IDENTIFIER_KIND_HAL_UDI will only be available
* when the gvfs hal volume monitor is in use. Other volume monitors * when the gvfs hal volume monitor is in use. Other volume monitors
* will generally be able to provide the #G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE * will generally be able to provide the %G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE
* identifier, which can be used to obtain a hal device by means of * identifier, which can be used to obtain a hal device by means of
* libhal_manager_find_device_string_match(). * libhal_manager_find_device_string_match().
*/ */

2
gio/tests/gdbus-connection.c
View File

@@ -416,7 +416,7 @@ test_connection_send (void)
/* /*
* Check that we never actually send a message if the GCancellable * Check that we never actually send a message if the GCancellable
* is already cancelled - i.e. we should get #G_IO_ERROR_CANCELLED * is already cancelled - i.e. we should get G_IO_ERROR_CANCELLED
* when the actual connection is not up. * when the actual connection is not up.
*/ */
ca = g_cancellable_new (); ca = g_cancellable_new ();

2
gio/tests/gdbus-threading.c
View File

@@ -176,7 +176,7 @@ test_delivery_in_thread_func (gpointer _data)
/* /*
* Check that we never actually send a message if the GCancellable * Check that we never actually send a message if the GCancellable
* is already cancelled - i.e. we should get #G_IO_ERROR_CANCELLED * is already cancelled - i.e. we should get G_IO_ERROR_CANCELLED
* when the actual connection is not up. * when the actual connection is not up.
*/ */
ca = g_cancellable_new (); ca = g_cancellable_new ();

12
glib/deprecated/gthread-deprecated.c
View File

@@ -97,7 +97,7 @@
* This macro is defined if POSIX style threads are used. * This macro is defined if POSIX style threads are used.
* *
* Deprecated:2.32:POSIX threads are in use on all non-Windows systems. * Deprecated:2.32:POSIX threads are in use on all non-Windows systems.
* Use G_OS_WIN32 to detect Windows. * Use %G_OS_WIN32 to detect Windows.
*/ */
/** /**
@@ -105,7 +105,7 @@
* *
* This macro is defined if Windows style threads are used. * This macro is defined if Windows style threads are used.
* *
* Deprecated:2.32:Use G_OS_WIN32 to detect Windows. * Deprecated:2.32:Use %G_OS_WIN32 to detect Windows.
*/ */
@@ -463,7 +463,7 @@ g_once_init_enter_impl (volatile gsize *location)
* @mutex: a #GStaticMutex to be initialized. * @mutex: a #GStaticMutex to be initialized.
* *
* Initializes @mutex. * Initializes @mutex.
* Alternatively you can initialize it with #G_STATIC_MUTEX_INIT. * Alternatively you can initialize it with %G_STATIC_MUTEX_INIT.
* *
* Deprecated: 2.32: Use g_mutex_init() * Deprecated: 2.32: Use g_mutex_init()
*/ */
@@ -649,7 +649,7 @@ g_static_mutex_free (GStaticMutex* mutex)
* *
* A #GStaticRecMutex must be initialized with this function before it * A #GStaticRecMutex must be initialized with this function before it
* can be used. Alternatively you can initialize it with * can be used. Alternatively you can initialize it with
* #G_STATIC_REC_MUTEX_INIT. * %G_STATIC_REC_MUTEX_INIT.
* *
* Deprecated: 2.32: Use g_rec_mutex_init() * Deprecated: 2.32: Use g_rec_mutex_init()
*/ */
@@ -949,7 +949,7 @@ g_static_rec_mutex_free (GStaticRecMutex *mutex)
* *
* A #GStaticRWLock must be initialized with this function before it * A #GStaticRWLock must be initialized with this function before it
* can be used. Alternatively you can initialize it with * can be used. Alternatively you can initialize it with
* #G_STATIC_RW_LOCK_INIT. * %G_STATIC_RW_LOCK_INIT.
* *
* Deprecated: 2.32: Use g_rw_lock_init() instead * Deprecated: 2.32: Use g_rw_lock_init() instead
*/ */
@@ -1295,7 +1295,7 @@ GPrivate static_private_private = G_PRIVATE_INIT (g_static_private_cleanup);
* @private_key: a #GStaticPrivate to be initialized * @private_key: a #GStaticPrivate to be initialized
* *
* Initializes @private_key. Alternatively you can initialize it with * Initializes @private_key. Alternatively you can initialize it with
* #G_STATIC_PRIVATE_INIT. * %G_STATIC_PRIVATE_INIT.
*/ */
void void
g_static_private_init (GStaticPrivate *private_key) g_static_private_init (GStaticPrivate *private_key)

88
glib/docs.c
View File

@@ -108,7 +108,7 @@
* gint: * gint:
* *
* Corresponds to the standard C int type. * Corresponds to the standard C int type.
* Values of this type can range from #G_MININT to #G_MAXINT. * Values of this type can range from %G_MININT to %G_MAXINT.
*/ */
/** /**
@@ -127,7 +127,7 @@
* guint: * guint:
* *
* Corresponds to the standard C unsigned int type. * Corresponds to the standard C unsigned int type.
* Values of this type can range from 0 to #G_MAXUINT. * Values of this type can range from 0 to %G_MAXUINT.
*/ */
/** /**
@@ -140,7 +140,7 @@
* gshort: * gshort:
* *
* Corresponds to the standard C short type. * Corresponds to the standard C short type.
* Values of this type can range from #G_MINSHORT to #G_MAXSHORT. * Values of this type can range from %G_MINSHORT to %G_MAXSHORT.
*/ */
/** /**
@@ -159,7 +159,7 @@
* gushort: * gushort:
* *
* Corresponds to the standard C unsigned short type. * Corresponds to the standard C unsigned short type.
* Values of this type can range from 0 to #G_MAXUSHORT. * Values of this type can range from 0 to %G_MAXUSHORT.
*/ */
/** /**
@@ -172,7 +172,7 @@
* glong: * glong:
* *
* Corresponds to the standard C long type. * Corresponds to the standard C long type.
* Values of this type can range from #G_MINLONG to #G_MAXLONG. * Values of this type can range from %G_MINLONG to %G_MAXLONG.
*/ */
/** /**
@@ -191,7 +191,7 @@
* gulong: * gulong:
* *
* Corresponds to the standard C unsigned long type. * Corresponds to the standard C unsigned long type.
* Values of this type can range from 0 to #G_MAXULONG. * Values of this type can range from 0 to %G_MAXULONG.
*/ */
/** /**
@@ -204,8 +204,8 @@
* gint8: * gint8:
* *
* A signed integer guaranteed to be 8 bits on all platforms. * A signed integer guaranteed to be 8 bits on all platforms.
* Values of this type can range from #G_MININT8 (= -128) to * Values of this type can range from %G_MININT8 (= -128) to
* #G_MAXINT8 (= 127). * %G_MAXINT8 (= 127).
*/ */
/** /**
@@ -220,7 +220,7 @@
* guint8: * guint8:
* *
* An unsigned integer guaranteed to be 8 bits on all platforms. * An unsigned integer guaranteed to be 8 bits on all platforms.
* Values of this type can range from 0 to #G_MAXUINT8 (= 255). * Values of this type can range from 0 to %G_MAXUINT8 (= 255).
*/ */
/** /**
@@ -235,8 +235,8 @@
* gint16: * gint16:
* *
* A signed integer guaranteed to be 16 bits on all platforms. * A signed integer guaranteed to be 16 bits on all platforms.
* Values of this type can range from #G_MININT16 (= -32,768) to * Values of this type can range from %G_MININT16 (= -32,768) to
* #G_MAXINT16 (= 32,767). * %G_MAXINT16 (= 32,767).
* *
* To print or scan values of this type, use * To print or scan values of this type, use
* %G_GINT16_MODIFIER and/or %G_GINT16_FORMAT. * %G_GINT16_MODIFIER and/or %G_GINT16_FORMAT.
@@ -289,7 +289,7 @@
* guint16: * guint16:
* *
* An unsigned integer guaranteed to be 16 bits on all platforms. * An unsigned integer guaranteed to be 16 bits on all platforms.
* Values of this type can range from 0 to #G_MAXUINT16 (= 65,535). * Values of this type can range from 0 to %G_MAXUINT16 (= 65,535).
* *
* To print or scan values of this type, use * To print or scan values of this type, use
* %G_GINT16_MODIFIER and/or %G_GUINT16_FORMAT. * %G_GINT16_MODIFIER and/or %G_GUINT16_FORMAT.
@@ -307,15 +307,15 @@
* G_GUINT16_FORMAT: * G_GUINT16_FORMAT:
* *
* This is the platform dependent conversion specifier for scanning * This is the platform dependent conversion specifier for scanning
* and printing values of type #guint16. See also #G_GINT16_FORMAT * and printing values of type #guint16. See also %G_GINT16_FORMAT
*/ */
/** /**
* gint32: * gint32:
* *
* A signed integer guaranteed to be 32 bits on all platforms. * A signed integer guaranteed to be 32 bits on all platforms.
* Values of this type can range from #G_MININT32 (= -2,147,483,648) * Values of this type can range from %G_MININT32 (= -2,147,483,648)
* to #G_MAXINT32 (= 2,147,483,647). * to %G_MAXINT32 (= 2,147,483,647).
* *
* To print or scan values of this type, use * To print or scan values of this type, use
* %G_GINT32_MODIFIER and/or %G_GINT32_FORMAT. * %G_GINT32_MODIFIER and/or %G_GINT32_FORMAT.
@@ -334,7 +334,7 @@
* *
* The platform dependent length modifier for conversion specifiers * The platform dependent length modifier for conversion specifiers
* for scanning and printing values of type #gint32 or #guint32. It * for scanning and printing values of type #gint32 or #guint32. It
* is a string literal. See also #G_GINT16_MODIFIER. * is a string literal. See also %G_GINT16_MODIFIER.
* *
* Since: 2.4 * Since: 2.4
*/ */
@@ -343,14 +343,14 @@
* G_GINT32_FORMAT: * G_GINT32_FORMAT:
* *
* This is the platform dependent conversion specifier for scanning * This is the platform dependent conversion specifier for scanning
* and printing values of type #gint32. See also #G_GINT16_FORMAT. * and printing values of type #gint32. See also %G_GINT16_FORMAT.
*/ */
/** /**
* guint32: * guint32:
* *
* An unsigned integer guaranteed to be 32 bits on all platforms. * An unsigned integer guaranteed to be 32 bits on all platforms.
* Values of this type can range from 0 to #G_MAXUINT32 (= 4,294,967,295). * Values of this type can range from 0 to %G_MAXUINT32 (= 4,294,967,295).
* *
* To print or scan values of this type, use * To print or scan values of this type, use
* %G_GINT32_MODIFIER and/or %G_GUINT32_FORMAT. * %G_GINT32_MODIFIER and/or %G_GUINT32_FORMAT.
@@ -368,15 +368,15 @@
* G_GUINT32_FORMAT: * G_GUINT32_FORMAT:
* *
* This is the platform dependent conversion specifier for scanning * This is the platform dependent conversion specifier for scanning
* and printing values of type #guint32. See also #G_GINT16_FORMAT. * and printing values of type #guint32. See also %G_GINT16_FORMAT.
*/ */
/** /**
* gint64: * gint64:
* *
* A signed integer guaranteed to be 64 bits on all platforms. * A signed integer guaranteed to be 64 bits on all platforms.
* Values of this type can range from #G_MININT64 * Values of this type can range from %G_MININT64
* (= -9,223,372,036,854,775,808) to #G_MAXINT64 * (= -9,223,372,036,854,775,808) to %G_MAXINT64
* (= 9,223,372,036,854,775,807). * (= 9,223,372,036,854,775,807).
* *
* To print or scan values of this type, use * To print or scan values of this type, use
@@ -407,7 +407,7 @@
* G_GINT64_FORMAT: * G_GINT64_FORMAT:
* *
* This is the platform dependent conversion specifier for scanning * This is the platform dependent conversion specifier for scanning
* and printing values of type #gint64. See also #G_GINT16_FORMAT. * and printing values of type #gint64. See also %G_GINT16_FORMAT.
* *
* Some platforms do not support scanning and printing 64-bit integers, * Some platforms do not support scanning and printing 64-bit integers,
* even though the types are supported. On such platforms %G_GINT64_FORMAT * even though the types are supported. On such platforms %G_GINT64_FORMAT
@@ -421,7 +421,7 @@
* guint64: * guint64:
* *
* An unsigned integer guaranteed to be 64-bits on all platforms. * An unsigned integer guaranteed to be 64-bits on all platforms.
* Values of this type can range from 0 to #G_MAXUINT64 * Values of this type can range from 0 to %G_MAXUINT64
* (= 18,446,744,073,709,551,615). * (= 18,446,744,073,709,551,615).
* *
* To print or scan values of this type, use * To print or scan values of this type, use
@@ -438,7 +438,7 @@
* G_GUINT64_FORMAT: * G_GUINT64_FORMAT:
* *
* This is the platform dependent conversion specifier for scanning * This is the platform dependent conversion specifier for scanning
* and printing values of type #guint64. See also #G_GINT16_FORMAT. * and printing values of type #guint64. See also %G_GINT16_FORMAT.
* *
* Some platforms do not support scanning and printing 64-bit integers, * Some platforms do not support scanning and printing 64-bit integers,
* even though the types are supported. On such platforms %G_GUINT64_FORMAT * even though the types are supported. On such platforms %G_GUINT64_FORMAT
@@ -470,7 +470,7 @@
* gfloat: * gfloat:
* *
* Corresponds to the standard C float type. * Corresponds to the standard C float type.
* Values of this type can range from -#G_MAXFLOAT to #G_MAXFLOAT. * Values of this type can range from -%G_MAXFLOAT to %G_MAXFLOAT.
*/ */
/** /**
@@ -492,7 +492,7 @@
* gdouble: * gdouble:
* *
* Corresponds to the standard C double type. * Corresponds to the standard C double type.
* Values of this type can range from -#G_MAXDOUBLE to #G_MAXDOUBLE. * Values of this type can range from -%G_MAXDOUBLE to %G_MAXDOUBLE.
*/ */
/** /**
@@ -518,7 +518,7 @@
* This type is wide enough to hold the numeric value of a pointer, * This type is wide enough to hold the numeric value of a pointer,
* so it is usually 32 bit wide on a 32-bit platform and 64 bit wide * so it is usually 32 bit wide on a 32-bit platform and 64 bit wide
* on a 64-bit platform. Values of this type can range from 0 to * on a 64-bit platform. Values of this type can range from 0 to
* #G_MAXSIZE. * %G_MAXSIZE.
* *
* To print or scan values of this type, use * To print or scan values of this type, use
* %G_GSIZE_MODIFIER and/or %G_GSIZE_FORMAT. * %G_GSIZE_MODIFIER and/or %G_GSIZE_FORMAT.
@@ -546,7 +546,7 @@
* G_GSIZE_FORMAT: * G_GSIZE_FORMAT:
* *
* This is the platform dependent conversion specifier for scanning * This is the platform dependent conversion specifier for scanning
* and printing values of type #gsize. See also #G_GINT16_FORMAT. * and printing values of type #gsize. See also %G_GINT16_FORMAT.
* *
* Since: 2.6 * Since: 2.6
*/ */
@@ -556,8 +556,8 @@
* *
* A signed variant of #gsize, corresponding to the * A signed variant of #gsize, corresponding to the
* ssize_t defined on most platforms. * ssize_t defined on most platforms.
* Values of this type can range from #G_MINSSIZE * Values of this type can range from %G_MINSSIZE
* to #G_MAXSSIZE. * to %G_MAXSSIZE.
* *
* To print or scan values of this type, use * To print or scan values of this type, use
* %G_GSSIZE_MODIFIER and/or %G_GSSIZE_FORMAT. * %G_GSSIZE_MODIFIER and/or %G_GSSIZE_FORMAT.
@@ -583,7 +583,7 @@
* G_GSSIZE_FORMAT: * G_GSSIZE_FORMAT:
* *
* This is the platform dependent conversion specifier for scanning * This is the platform dependent conversion specifier for scanning
* and printing values of type #gssize. See also #G_GINT16_FORMAT. * and printing values of type #gssize. See also %G_GINT16_FORMAT.
* *
* Since: 2.6 * Since: 2.6
*/ */
@@ -605,8 +605,8 @@
* corresponding to the POSIX type `off_t` as if compiling with * corresponding to the POSIX type `off_t` as if compiling with
* `_FILE_OFFSET_BITS` set to 64. #goffset is always 64 bits wide, even on * `_FILE_OFFSET_BITS` set to 64. #goffset is always 64 bits wide, even on
* 32-bit architectures. * 32-bit architectures.
* Values of this type can range from #G_MINOFFSET to * Values of this type can range from %G_MINOFFSET to
* #G_MAXOFFSET. * %G_MAXOFFSET.
* *
* To print or scan values of this type, use * To print or scan values of this type, use
* %G_GOFFSET_MODIFIER and/or %G_GOFFSET_FORMAT. * %G_GOFFSET_MODIFIER and/or %G_GOFFSET_FORMAT.
@@ -631,7 +631,7 @@
* *
* The platform dependent length modifier for conversion specifiers * The platform dependent length modifier for conversion specifiers
* for scanning and printing values of type #goffset. It is a string * for scanning and printing values of type #goffset. It is a string
* literal. See also #G_GINT64_MODIFIER. * literal. See also %G_GINT64_MODIFIER.
* *
* Since: 2.20 * Since: 2.20
*/ */
@@ -640,7 +640,7 @@
* G_GOFFSET_FORMAT: * G_GOFFSET_FORMAT:
* *
* This is the platform dependent conversion specifier for scanning * This is the platform dependent conversion specifier for scanning
* and printing values of type #goffset. See also #G_GINT64_FORMAT. * and printing values of type #goffset. See also %G_GINT64_FORMAT.
* *
* Since: 2.20 * Since: 2.20
*/ */
@@ -652,7 +652,7 @@
* This macro is used to insert #goffset 64-bit integer literals * This macro is used to insert #goffset 64-bit integer literals
* into the source code. * into the source code.
* *
* See also #G_GINT64_CONSTANT. * See also G_GINT64_CONSTANT().
* *
* Since: 2.20 * Since: 2.20
*/ */
@@ -849,29 +849,29 @@
* G_BYTE_ORDER: * G_BYTE_ORDER:
* *
* The host byte order. * The host byte order.
* This can be either #G_LITTLE_ENDIAN or #G_BIG_ENDIAN (support for * This can be either %G_LITTLE_ENDIAN or %G_BIG_ENDIAN (support for
* #G_PDP_ENDIAN may be added in future.) * %G_PDP_ENDIAN may be added in future.)
*/ */
/** /**
* G_LITTLE_ENDIAN: * G_LITTLE_ENDIAN:
* *
* Specifies one of the possible types of byte order. * Specifies one of the possible types of byte order.
* See #G_BYTE_ORDER. * See %G_BYTE_ORDER.
*/ */
/** /**
* G_BIG_ENDIAN: * G_BIG_ENDIAN:
* *
* Specifies one of the possible types of byte order. * Specifies one of the possible types of byte order.
* See #G_BYTE_ORDER. * See %G_BYTE_ORDER.
*/ */
/** /**
* G_PDP_ENDIAN: * G_PDP_ENDIAN:
* *
* Specifies one of the possible types of byte order * Specifies one of the possible types of byte order
* (currently unused). See #G_BYTE_ORDER. * (currently unused). See %G_BYTE_ORDER.
*/ */
/** /**
@@ -1543,7 +1543,7 @@
* @title: Numerical Definitions * @title: Numerical Definitions
* @short_description: mathematical constants, and floating point decomposition * @short_description: mathematical constants, and floating point decomposition
* *
* GLib offers mathematical constants such as #G_PI for the value of pi; * GLib offers mathematical constants such as %G_PI for the value of pi;
* many platforms have these in the C library, but some don't, the GLib * many platforms have these in the C library, but some don't, the GLib
* versions always exist. * versions always exist.
* *
@@ -1857,7 +1857,7 @@
/** /**
* G_BEGIN_DECLS: * G_BEGIN_DECLS:
* *
* Used (along with #G_END_DECLS) to bracket header files. If the * Used (along with %G_END_DECLS) to bracket header files. If the
* compiler in use is a C++ compiler, adds extern "C" * compiler in use is a C++ compiler, adds extern "C"
* around the header. * around the header.
*/ */
@@ -1865,7 +1865,7 @@
/** /**
* G_END_DECLS: * G_END_DECLS:
* *
* Used (along with #G_BEGIN_DECLS) to bracket header files. If the * Used (along with %G_BEGIN_DECLS) to bracket header files. If the
* compiler in use is a C++ compiler, adds extern "C" * compiler in use is a C++ compiler, adds extern "C"
* around the header. * around the header.
*/ */

64
glib/gbookmarkfile.c
View File

@@ -2217,7 +2217,7 @@ g_bookmark_file_set_title (GBookmarkFile *bookmark,
* If @uri is %NULL, the title of @bookmark is returned. * If @uri is %NULL, the title of @bookmark is returned.
* *
* In the event the URI cannot be found, %NULL is returned and * In the event the URI cannot be found, %NULL is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: (transfer full): a newly allocated string or %NULL if the specified * Returns: (transfer full): a newly allocated string or %NULL if the specified
* URI cannot be found. * URI cannot be found.
@@ -2302,7 +2302,7 @@ g_bookmark_file_set_description (GBookmarkFile *bookmark,
* Retrieves the description of the bookmark for @uri. * Retrieves the description of the bookmark for @uri.
* *
* In the event the URI cannot be found, %NULL is returned and * In the event the URI cannot be found, %NULL is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: (transfer full): a newly allocated string or %NULL if the specified * Returns: (transfer full): a newly allocated string or %NULL if the specified
* URI cannot be found. * URI cannot be found.
@@ -2382,9 +2382,9 @@ g_bookmark_file_set_mime_type (GBookmarkFile *bookmark,
* Retrieves the MIME type of the resource pointed by @uri. * Retrieves the MIME type of the resource pointed by @uri.
* *
* In the event the URI cannot be found, %NULL is returned and * In the event the URI cannot be found, %NULL is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the
* event that the MIME type cannot be found, %NULL is returned and * event that the MIME type cannot be found, %NULL is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_INVALID_VALUE. * @error is set to %G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
* *
* Returns: (transfer full): a newly allocated string or %NULL if the specified * Returns: (transfer full): a newly allocated string or %NULL if the specified
* URI cannot be found. * URI cannot be found.
@@ -2468,9 +2468,9 @@ g_bookmark_file_set_is_private (GBookmarkFile *bookmark,
* Gets whether the private flag of the bookmark for @uri is set. * Gets whether the private flag of the bookmark for @uri is set.
* *
* In the event the URI cannot be found, %FALSE is returned and * In the event the URI cannot be found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the
* event that the private flag cannot be found, %FALSE is returned and * event that the private flag cannot be found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_INVALID_VALUE. * @error is set to %G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
* *
* Returns: %TRUE if the private flag is set, %FALSE otherwise. * Returns: %TRUE if the private flag is set, %FALSE otherwise.
* *
@@ -2577,7 +2577,7 @@ g_bookmark_file_set_added_date_time (GBookmarkFile *bookmark,
* Gets the time the bookmark for @uri was added to @bookmark * Gets the time the bookmark for @uri was added to @bookmark
* *
* In the event the URI cannot be found, -1 is returned and * In the event the URI cannot be found, -1 is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: a timestamp * Returns: a timestamp
* *
@@ -2603,7 +2603,7 @@ g_bookmark_file_get_added (GBookmarkFile *bookmark,
* Gets the time the bookmark for @uri was added to @bookmark * Gets the time the bookmark for @uri was added to @bookmark
* *
* In the event the URI cannot be found, %NULL is returned and * In the event the URI cannot be found, %NULL is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: (transfer none): a #GDateTime * Returns: (transfer none): a #GDateTime
* *
@@ -2710,7 +2710,7 @@ g_bookmark_file_set_modified_date_time (GBookmarkFile *bookmark,
* Gets the time when the bookmark for @uri was last modified. * Gets the time when the bookmark for @uri was last modified.
* *
* In the event the URI cannot be found, -1 is returned and * In the event the URI cannot be found, -1 is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: a timestamp * Returns: a timestamp
* *
@@ -2736,7 +2736,7 @@ g_bookmark_file_get_modified (GBookmarkFile *bookmark,
* Gets the time when the bookmark for @uri was last modified. * Gets the time when the bookmark for @uri was last modified.
* *
* In the event the URI cannot be found, %NULL is returned and * In the event the URI cannot be found, %NULL is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: (transfer none): a #GDateTime * Returns: (transfer none): a #GDateTime
* *
@@ -2845,7 +2845,7 @@ g_bookmark_file_set_visited_date_time (GBookmarkFile *bookmark,
* Gets the time the bookmark for @uri was last visited. * Gets the time the bookmark for @uri was last visited.
* *
* In the event the URI cannot be found, -1 is returned and * In the event the URI cannot be found, -1 is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: a timestamp. * Returns: a timestamp.
* *
@@ -2871,7 +2871,7 @@ g_bookmark_file_get_visited (GBookmarkFile *bookmark,
* Gets the time the bookmark for @uri was last visited. * Gets the time the bookmark for @uri was last visited.
* *
* In the event the URI cannot be found, %NULL is returned and * In the event the URI cannot be found, %NULL is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: (transfer none): a #GDateTime * Returns: (transfer none): a #GDateTime
* *
@@ -2912,7 +2912,7 @@ g_bookmark_file_get_visited_date_time (GBookmarkFile *bookmark,
* the bookmark for @uri belongs to. * the bookmark for @uri belongs to.
* *
* In the event the URI cannot be found, %FALSE is returned and * In the event the URI cannot be found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: %TRUE if @group was found. * Returns: %TRUE if @group was found.
* *
@@ -3007,9 +3007,9 @@ g_bookmark_file_add_group (GBookmarkFile *bookmark,
* for @uri belongs to. * for @uri belongs to.
* *
* In the event the URI cannot be found, %FALSE is returned and * In the event the URI cannot be found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* In the event no group was defined, %FALSE is returned and * In the event no group was defined, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_INVALID_VALUE. * @error is set to %G_BOOKMARK_FILE_ERROR_INVALID_VALUE.
* *
* Returns: %TRUE if @group was successfully removed. * Returns: %TRUE if @group was successfully removed.
* *
@@ -3124,7 +3124,7 @@ g_bookmark_file_set_groups (GBookmarkFile *bookmark,
* Retrieves the list of group names of the bookmark for @uri. * Retrieves the list of group names of the bookmark for @uri.
* *
* In the event the URI cannot be found, %NULL is returned and * In the event the URI cannot be found, %NULL is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* The returned array is %NULL terminated, so @length may optionally * The returned array is %NULL terminated, so @length may optionally
* be %NULL. * be %NULL.
@@ -3274,10 +3274,10 @@ g_bookmark_file_add_application (GBookmarkFile *bookmark,
* that have registered a bookmark for @uri inside @bookmark. * that have registered a bookmark for @uri inside @bookmark.
* *
* In the event the URI cannot be found, %FALSE is returned and * In the event the URI cannot be found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* In the event that no application with name @app_name has registered * In the event that no application with name @app_name has registered
* a bookmark for @uri, %FALSE is returned and error is set to * a bookmark for @uri, %FALSE is returned and error is set to
* #G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. * %G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED.
* *
* Returns: %TRUE if the application was successfully removed. * Returns: %TRUE if the application was successfully removed.
* *
@@ -3324,7 +3324,7 @@ g_bookmark_file_remove_application (GBookmarkFile *bookmark,
* registered by application @name. * registered by application @name.
* *
* In the event the URI cannot be found, %FALSE is returned and * In the event the URI cannot be found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: %TRUE if the application @name was found * Returns: %TRUE if the application @name was found
* *
@@ -3388,10 +3388,10 @@ g_bookmark_file_has_application (GBookmarkFile *bookmark,
* *
* If you try to remove an application by setting its registration count to * If you try to remove an application by setting its registration count to
* zero, and no bookmark for @uri is found, %FALSE is returned and * zero, and no bookmark for @uri is found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND; similarly, * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND; similarly,
* in the event that no application @name has registered a bookmark * in the event that no application @name has registered a bookmark
* for @uri, %FALSE is returned and error is set to * for @uri, %FALSE is returned and error is set to
* #G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark * %G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark
* for @uri is found, one is created. * for @uri is found, one is created.
* *
* Returns: %TRUE if the application's meta-data was successfully * Returns: %TRUE if the application's meta-data was successfully
@@ -3451,10 +3451,10 @@ g_bookmark_file_set_app_info (GBookmarkFile *bookmark,
* *
* If you try to remove an application by setting its registration count to * If you try to remove an application by setting its registration count to
* zero, and no bookmark for @uri is found, %FALSE is returned and * zero, and no bookmark for @uri is found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND; similarly, * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND; similarly,
* in the event that no application @name has registered a bookmark * in the event that no application @name has registered a bookmark
* for @uri, %FALSE is returned and error is set to * for @uri, %FALSE is returned and error is set to
* #G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark * %G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark
* for @uri is found, one is created. * for @uri is found, one is created.
* *
* Returns: %TRUE if the application's meta-data was successfully * Returns: %TRUE if the application's meta-data was successfully
@@ -3622,11 +3622,11 @@ expand_exec_line (const gchar *exec_fmt,
* The string returned in @app_exec must be freed. * The string returned in @app_exec must be freed.
* *
* In the event the URI cannot be found, %FALSE is returned and * In the event the URI cannot be found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the
* event that no application with name @app_name has registered a bookmark * event that no application with name @app_name has registered a bookmark
* for @uri, %FALSE is returned and error is set to * for @uri, %FALSE is returned and error is set to
* #G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. In the event that unquoting * %G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. In the event that unquoting
* the command line fails, an error of the #G_SHELL_ERROR domain is * the command line fails, an error of the %G_SHELL_ERROR domain is
* set and %FALSE is returned. * set and %FALSE is returned.
* *
* Returns: %TRUE on success. * Returns: %TRUE on success.
@@ -3674,11 +3674,11 @@ g_bookmark_file_get_app_info (GBookmarkFile *bookmark,
* The string returned in @app_exec must be freed. * The string returned in @app_exec must be freed.
* *
* In the event the URI cannot be found, %FALSE is returned and * In the event the URI cannot be found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the
* event that no application with name @app_name has registered a bookmark * event that no application with name @app_name has registered a bookmark
* for @uri, %FALSE is returned and error is set to * for @uri, %FALSE is returned and error is set to
* #G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. In the event that unquoting * %G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. In the event that unquoting
* the command line fails, an error of the #G_SHELL_ERROR domain is * the command line fails, an error of the %G_SHELL_ERROR domain is
* set and %FALSE is returned. * set and %FALSE is returned.
* *
* Returns: %TRUE on success. * Returns: %TRUE on success.
@@ -3770,7 +3770,7 @@ g_bookmark_file_get_application_info (GBookmarkFile *bookmark,
* bookmark for @uri. * bookmark for @uri.
* *
* In the event the URI cannot be found, %NULL is returned and * In the event the URI cannot be found, %NULL is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: (array length=length) (transfer full): a newly allocated %NULL-terminated array of strings. * Returns: (array length=length) (transfer full): a newly allocated %NULL-terminated array of strings.
* Use g_strfreev() to free it. * Use g_strfreev() to free it.
@@ -3863,7 +3863,7 @@ g_bookmark_file_get_size (GBookmarkFile *bookmark)
* %NULL, then the bookmark is removed. * %NULL, then the bookmark is removed.
* *
* In the event the URI cannot be found, %FALSE is returned and * In the event the URI cannot be found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: %TRUE if the URI was successfully changed * Returns: %TRUE if the URI was successfully changed
* *
@@ -3980,7 +3980,7 @@ g_bookmark_file_set_icon (GBookmarkFile *bookmark,
* Gets the icon of the bookmark for @uri. * Gets the icon of the bookmark for @uri.
* *
* In the event the URI cannot be found, %FALSE is returned and * In the event the URI cannot be found, %FALSE is returned and
* @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. * @error is set to %G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND.
* *
* Returns: %TRUE if the icon for the bookmark for the URI was found. * Returns: %TRUE if the icon for the bookmark for the URI was found.
* You should free the returned strings. * You should free the returned strings.

4
glib/gconvert.c
View File

@@ -354,7 +354,7 @@ close_converter (GIConv cd)
* Even if the conversion was successful, this may be * Even if the conversion was successful, this may be
* less than @len if there were partial characters * less than @len if there were partial characters
* at the end of the input. If the error * at the end of the input. If the error
* #G_CONVERT_ERROR_ILLEGAL_SEQUENCE occurs, the value * %G_CONVERT_ERROR_ILLEGAL_SEQUENCE occurs, the value
* stored will be the byte offset after the last valid * stored will be the byte offset after the last valid
* input sequence. * input sequence.
* @bytes_written: (out) (optional): the number of bytes stored in * @bytes_written: (out) (optional): the number of bytes stored in
@@ -525,7 +525,7 @@ g_convert_with_iconv (const gchar *str,
* Even if the conversion was successful, this may be * Even if the conversion was successful, this may be
* less than @len if there were partial characters * less than @len if there were partial characters
* at the end of the input. If the error * at the end of the input. If the error
* #G_CONVERT_ERROR_ILLEGAL_SEQUENCE occurs, the value * %G_CONVERT_ERROR_ILLEGAL_SEQUENCE occurs, the value
* stored will be the byte offset after the last valid * stored will be the byte offset after the last valid
* input sequence. * input sequence.
* @bytes_written: (out) (optional): the number of bytes stored in * @bytes_written: (out) (optional): the number of bytes stored in

4
glib/gdate.c
View File

@@ -242,8 +242,8 @@
* @G_DATE_SATURDAY: Saturday * @G_DATE_SATURDAY: Saturday
* @G_DATE_SUNDAY: Sunday * @G_DATE_SUNDAY: Sunday
* *
* Enumeration representing a day of the week; #G_DATE_MONDAY, * Enumeration representing a day of the week; %G_DATE_MONDAY,
* #G_DATE_TUESDAY, etc. #G_DATE_BAD_WEEKDAY is an invalid weekday. * %G_DATE_TUESDAY, etc. %G_DATE_BAD_WEEKDAY is an invalid weekday.
*/ */
/** /**

2
glib/gerror.h
View File

@@ -31,7 +31,7 @@ G_BEGIN_DECLS
/** /**
* GError: * GError:
* @domain: error domain, e.g. #G_FILE_ERROR * @domain: error domain, e.g. %G_FILE_ERROR
* @code: error code, e.g. %G_FILE_ERROR_NOENT * @code: error code, e.g. %G_FILE_ERROR_NOENT
* @message: human-readable informative error message * @message: human-readable informative error message
* *

4
glib/gfileutils.c
View File

@@ -1000,7 +1000,7 @@ get_contents_win32 (const gchar *filename,
* contents and @length to the length of the file contents in bytes. The string * contents and @length to the length of the file contents in bytes. The string
* stored in @contents will be nul-terminated, so for text files you can pass * stored in @contents will be nul-terminated, so for text files you can pass
* %NULL for the @length argument. If the call was not successful, it returns * %NULL for the @length argument. If the call was not successful, it returns
* %FALSE and sets @error. The error domain is #G_FILE_ERROR. Possible error * %FALSE and sets @error. The error domain is %G_FILE_ERROR. Possible error
* codes are those in the #GFileError enumeration. In the error case, * codes are those in the #GFileError enumeration. In the error case,
* @contents is set to %NULL and @length is set to zero. * @contents is set to %NULL and @length is set to zero.
* *
@@ -1271,7 +1271,7 @@ g_file_set_contents (const gchar *filename,
* @filename already exists and is open. * @filename already exists and is open.
* *
* If the call was successful, it returns %TRUE. If the call was not successful, * If the call was successful, it returns %TRUE. If the call was not successful,
* it returns %FALSE and sets @error. The error domain is #G_FILE_ERROR. * it returns %FALSE and sets @error. The error domain is %G_FILE_ERROR.
* Possible error codes are those in the #GFileError enumeration. * Possible error codes are those in the #GFileError enumeration.
* *
* Note that the name for the temporary file is constructed by appending up * Note that the name for the temporary file is constructed by appending up

6
glib/giochannel.c
View File

@@ -593,7 +593,7 @@ g_io_channel_purge (GIOChannel *channel)
* @condition: conditions to watch for * @condition: conditions to watch for
* *
* Creates a #GSource that's dispatched when @condition is met for the * Creates a #GSource that's dispatched when @condition is met for the
* given @channel. For example, if condition is #G_IO_IN, the source will * given @channel. For example, if condition is %G_IO_IN, the source will
* be dispatched when there's data available for reading. * be dispatched when there's data available for reading.
* *
* The callback function invoked by the #GSource should be added with * The callback function invoked by the #GSource should be added with
@@ -1180,8 +1180,8 @@ g_io_channel_seek_position (GIOChannel *channel,
* Flushes the write buffer for the GIOChannel. * Flushes the write buffer for the GIOChannel.
* *
* Returns: the status of the operation: One of * Returns: the status of the operation: One of
* #G_IO_STATUS_NORMAL, #G_IO_STATUS_AGAIN, or * %G_IO_STATUS_NORMAL, %G_IO_STATUS_AGAIN, or
* #G_IO_STATUS_ERROR. * %G_IO_STATUS_ERROR.
**/ **/
GIOStatus GIOStatus
g_io_channel_flush (GIOChannel *channel, g_io_channel_flush (GIOChannel *channel,

42
glib/gkeyfile.c
View File

@@ -1647,7 +1647,7 @@ g_key_file_to_data (GKeyFile *key_file,
* returned keys will be %NULL-terminated, so @length may * returned keys will be %NULL-terminated, so @length may
* optionally be %NULL. In the event that the @group_name cannot * optionally be %NULL. In the event that the @group_name cannot
* be found, %NULL is returned and @error is set to * be found, %NULL is returned and @error is set to
* #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. * %G_KEY_FILE_ERROR_GROUP_NOT_FOUND.
* *
* Returns: (array zero-terminated=1) (transfer full): a newly-allocated %NULL-terminated array of strings. * Returns: (array zero-terminated=1) (transfer full): a newly-allocated %NULL-terminated array of strings.
* Use g_strfreev() to free it. * Use g_strfreev() to free it.
@@ -1817,9 +1817,9 @@ set_not_found_key_error (const char *group_name,
* Use g_key_file_get_string() to retrieve an unescaped UTF-8 string. * Use g_key_file_get_string() to retrieve an unescaped UTF-8 string.
* *
* In the event the key cannot be found, %NULL is returned and * In the event the key cannot be found, %NULL is returned and
* @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the * @error is set to %G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the
* event that the @group_name cannot be found, %NULL is returned * event that the @group_name cannot be found, %NULL is returned
* and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. * and @error is set to %G_KEY_FILE_ERROR_GROUP_NOT_FOUND.
* *
* *
* Returns: a newly allocated string or %NULL if the specified * Returns: a newly allocated string or %NULL if the specified
@@ -1927,9 +1927,9 @@ g_key_file_set_value (GKeyFile *key_file,
* like \s. * like \s.
* *
* In the event the key cannot be found, %NULL is returned and * In the event the key cannot be found, %NULL is returned and
* @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the * @error is set to %G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the
* event that the @group_name cannot be found, %NULL is returned * event that the @group_name cannot be found, %NULL is returned
* and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. * and @error is set to %G_KEY_FILE_ERROR_GROUP_NOT_FOUND.
* *
* Returns: a newly allocated string or %NULL if the specified * Returns: a newly allocated string or %NULL if the specified
* key cannot be found. * key cannot be found.
@@ -2038,9 +2038,9 @@ g_key_file_set_string (GKeyFile *key_file,
* Returns the values associated with @key under @group_name. * Returns the values associated with @key under @group_name.
* *
* In the event the key cannot be found, %NULL is returned and * In the event the key cannot be found, %NULL is returned and
* @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the * @error is set to %G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the
* event that the @group_name cannot be found, %NULL is returned * event that the @group_name cannot be found, %NULL is returned
* and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. * and @error is set to %G_KEY_FILE_ERROR_GROUP_NOT_FOUND.
* *
* Returns: (array zero-terminated=1 length=length) (element-type utf8) (transfer full): * Returns: (array zero-terminated=1 length=length) (element-type utf8) (transfer full):
* a %NULL-terminated string array or %NULL if the specified * a %NULL-terminated string array or %NULL if the specified
@@ -2220,7 +2220,7 @@ g_key_file_set_locale_string (GKeyFile *key_file,
* %G_KEY_FILE_KEEP_TRANSLATIONS in order to load strings for all locales. * %G_KEY_FILE_KEEP_TRANSLATIONS in order to load strings for all locales.
* *
* If @key cannot be found then %NULL is returned and @error is set * If @key cannot be found then %NULL is returned and @error is set
* to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. If the value associated * to %G_KEY_FILE_ERROR_KEY_NOT_FOUND. If the value associated
* with @key cannot be interpreted or no suitable translation can * with @key cannot be interpreted or no suitable translation can
* be found then the untranslated value is returned. * be found then the untranslated value is returned.
* *
@@ -2374,7 +2374,7 @@ g_key_file_get_locale_for_key (GKeyFile *key_file,
* %G_KEY_FILE_KEEP_TRANSLATIONS in order to load strings for all locales. * %G_KEY_FILE_KEEP_TRANSLATIONS in order to load strings for all locales.
* *
* If @key cannot be found then %NULL is returned and @error is set * If @key cannot be found then %NULL is returned and @error is set
* to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. If the values associated * to %G_KEY_FILE_ERROR_KEY_NOT_FOUND. If the values associated
* with @key cannot be interpreted or no suitable translations * with @key cannot be interpreted or no suitable translations
* can be found then the untranslated values are returned. The * can be found then the untranslated values are returned. The
* returned array is %NULL-terminated, so @length may optionally * returned array is %NULL-terminated, so @length may optionally
@@ -2496,9 +2496,9 @@ g_key_file_set_locale_string_list (GKeyFile *key_file,
* boolean. * boolean.
* *
* If @key cannot be found then %FALSE is returned and @error is set * If @key cannot be found then %FALSE is returned and @error is set
* to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value * to %G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value
* associated with @key cannot be interpreted as a boolean then %FALSE * associated with @key cannot be interpreted as a boolean then %FALSE
* is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. * is returned and @error is set to %G_KEY_FILE_ERROR_INVALID_VALUE.
* *
* Returns: the value associated with the key as a boolean, * Returns: the value associated with the key as a boolean,
* or %FALSE if the key was not found or could not be parsed. * or %FALSE if the key was not found or could not be parsed.
@@ -2589,9 +2589,9 @@ g_key_file_set_boolean (GKeyFile *key_file,
* booleans. * booleans.
* *
* If @key cannot be found then %NULL is returned and @error is set to * If @key cannot be found then %NULL is returned and @error is set to
* #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated * %G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated
* with @key cannot be interpreted as booleans then %NULL is returned * with @key cannot be interpreted as booleans then %NULL is returned
* and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. * and @error is set to %G_KEY_FILE_ERROR_INVALID_VALUE.
* *
* Returns: (array length=length) (element-type gboolean) (transfer container): * Returns: (array length=length) (element-type gboolean) (transfer container):
* the values associated with the key as a list of booleans, or %NULL if the * the values associated with the key as a list of booleans, or %NULL if the
@@ -2708,10 +2708,10 @@ g_key_file_set_boolean_list (GKeyFile *key_file,
* integer. * integer.
* *
* If @key cannot be found then 0 is returned and @error is set to * If @key cannot be found then 0 is returned and @error is set to
* #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value associated * %G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value associated
* with @key cannot be interpreted as an integer, or is out of range * with @key cannot be interpreted as an integer, or is out of range
* for a #gint, then 0 is returned * for a #gint, then 0 is returned
* and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. * and @error is set to %G_KEY_FILE_ERROR_INVALID_VALUE.
* *
* Returns: the value associated with the key as an integer, or * Returns: the value associated with the key as an integer, or
* 0 if the key was not found or could not be parsed. * 0 if the key was not found or could not be parsed.
@@ -2959,10 +2959,10 @@ g_key_file_set_uint64 (GKeyFile *key_file,
* integers. * integers.
* *
* If @key cannot be found then %NULL is returned and @error is set to * If @key cannot be found then %NULL is returned and @error is set to
* #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated * %G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated
* with @key cannot be interpreted as integers, or are out of range for * with @key cannot be interpreted as integers, or are out of range for
* #gint, then %NULL is returned * #gint, then %NULL is returned
* and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. * and @error is set to %G_KEY_FILE_ERROR_INVALID_VALUE.
* *
* Returns: (array length=length) (element-type gint) (transfer container): * Returns: (array length=length) (element-type gint) (transfer container):
* the values associated with the key as a list of integers, or %NULL if * the values associated with the key as a list of integers, or %NULL if
@@ -3078,9 +3078,9 @@ g_key_file_set_integer_list (GKeyFile *key_file,
* double. If @group_name is %NULL, the start_group is used. * double. If @group_name is %NULL, the start_group is used.
* *
* If @key cannot be found then 0.0 is returned and @error is set to * If @key cannot be found then 0.0 is returned and @error is set to
* #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value associated * %G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value associated
* with @key cannot be interpreted as a double then 0.0 is returned * with @key cannot be interpreted as a double then 0.0 is returned
* and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. * and @error is set to %G_KEY_FILE_ERROR_INVALID_VALUE.
* *
* Returns: the value associated with the key as a double, or * Returns: the value associated with the key as a double, or
* 0.0 if the key was not found or could not be parsed. * 0.0 if the key was not found or could not be parsed.
@@ -3173,9 +3173,9 @@ g_key_file_set_double (GKeyFile *key_file,
* doubles. * doubles.
* *
* If @key cannot be found then %NULL is returned and @error is set to * If @key cannot be found then %NULL is returned and @error is set to
* #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated * %G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated
* with @key cannot be interpreted as doubles then %NULL is returned * with @key cannot be interpreted as doubles then %NULL is returned
* and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. * and @error is set to %G_KEY_FILE_ERROR_INVALID_VALUE.
* *
* Returns: (array length=length) (element-type gdouble) (transfer container): * Returns: (array length=length) (element-type gdouble) (transfer container):
* the values associated with the key as a list of doubles, or %NULL if the * the values associated with the key as a list of doubles, or %NULL if the

4
glib/glib-unix.c
View File

@@ -48,7 +48,7 @@ G_STATIC_ASSERT (G_ALIGNOF (GPid) == G_ALIGNOF (pid_t));
* Most of GLib is intended to be portable; in contrast, this set of * Most of GLib is intended to be portable; in contrast, this set of
* functions is designed for programs which explicitly target UNIX, * functions is designed for programs which explicitly target UNIX,
* or are using it to build higher level abstractions which would be * or are using it to build higher level abstractions which would be
* conditionally compiled if the platform matches G_OS_UNIX. * conditionally compiled if the platform matches %G_OS_UNIX.
* *
* To use these functions, you must explicitly include the * To use these functions, you must explicitly include the
* "glib-unix.h" header. * "glib-unix.h" header.
@@ -233,7 +233,7 @@ g_unix_signal_source_new (int signum)
/** /**
* g_unix_signal_add_full: (rename-to g_unix_signal_add) * g_unix_signal_add_full: (rename-to g_unix_signal_add)
* @priority: the priority of the signal source. Typically this will be in * @priority: the priority of the signal source. Typically this will be in
* the range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH. * the range between %G_PRIORITY_DEFAULT and %G_PRIORITY_HIGH.
* @signum: Signal number * @signum: Signal number
* @handler: Callback * @handler: Callback
* @user_data: Data for @handler * @user_data: Data for @handler

2
glib/glib-unix.h
View File

@@ -43,7 +43,7 @@ G_BEGIN_DECLS
* *
* Error domain for API in the g_unix_ namespace. Note that there is no * Error domain for API in the g_unix_ namespace. Note that there is no
* exported enumeration mapping %errno. Instead, all functions ensure that * exported enumeration mapping %errno. Instead, all functions ensure that
* %errno is relevant. The code for all #G_UNIX_ERROR is always 0, and the * %errno is relevant. The code for all %G_UNIX_ERROR is always 0, and the
* error message is always generated via g_strerror(). * error message is always generated via g_strerror().
* *
* It is expected that most code will not look at %errno from these APIs. * It is expected that most code will not look at %errno from these APIs.

12
glib/gmain.h
View File

@@ -122,8 +122,8 @@ typedef struct _GSourceCallbackFuncs GSourceCallbackFuncs;
* connected to a callback using g_source_set_callback(). The @dispatch * connected to a callback using g_source_set_callback(). The @dispatch
* function should call the callback function with @user_data and whatever * function should call the callback function with @user_data and whatever
* additional parameters are needed for this type of event source. The * additional parameters are needed for this type of event source. The
* return value of the @dispatch function should be #G_SOURCE_REMOVE if the * return value of the @dispatch function should be %G_SOURCE_REMOVE if the
* source should be removed or #G_SOURCE_CONTINUE to keep it. * source should be removed or %G_SOURCE_CONTINUE to keep it.
* @finalize: Called when the source is finalized. At this point, the source * @finalize: Called when the source is finalized. At this point, the source
* will have been destroyed, had its callback cleared, and have been removed * will have been destroyed, had its callback cleared, and have been removed
* from its #GMainContext, but it will still have its final reference count, * from its #GMainContext, but it will still have its final reference count,
@@ -187,8 +187,8 @@ typedef struct _GSourceFuncs GSourceFuncs;
* different type to this type. Use G_SOURCE_FUNC() to avoid warnings about * different type to this type. Use G_SOURCE_FUNC() to avoid warnings about
* incompatible function types. * incompatible function types.
* *
* Returns: %FALSE if the source should be removed. #G_SOURCE_CONTINUE and * Returns: %FALSE if the source should be removed. %G_SOURCE_CONTINUE and
* #G_SOURCE_REMOVE are more memorable names for the return value. * %G_SOURCE_REMOVE are more memorable names for the return value.
*/ */
typedef gboolean (*GSourceFunc) (gpointer user_data); typedef gboolean (*GSourceFunc) (gpointer user_data);
@@ -328,8 +328,8 @@ struct _GSourceFuncs
* *
* Use this for high priority idle functions. * Use this for high priority idle functions.
* *
* GTK+ uses #G_PRIORITY_HIGH_IDLE + 10 for resizing operations, * GTK+ uses %G_PRIORITY_HIGH_IDLE + 10 for resizing operations,
* and #G_PRIORITY_HIGH_IDLE + 20 for redrawing operations. (This is * and %G_PRIORITY_HIGH_IDLE + 20 for redrawing operations. (This is
* done to ensure that any pending resizes are processed before any * done to ensure that any pending resizes are processed before any
* pending redraws, so that widgets are not redrawn twice unnecessarily.) * pending redraws, so that widgets are not redrawn twice unnecessarily.)
*/ */

2
glib/gmappedfile.c
View File

@@ -232,7 +232,7 @@ mapped_file_new_from_fd (int fd,
* If @filename is the name of an empty, regular file, the function * If @filename is the name of an empty, regular file, the function
* will successfully return an empty #GMappedFile. In other cases of * will successfully return an empty #GMappedFile. In other cases of
* size 0 (e.g. device files such as /dev/null), @error will be set * size 0 (e.g. device files such as /dev/null), @error will be set
* to the #GFileError value #G_FILE_ERROR_INVAL. * to the #GFileError value %G_FILE_ERROR_INVAL.
* *
* Returns: a newly allocated #GMappedFile which must be unref'd * Returns: a newly allocated #GMappedFile which must be unref'd
* with g_mapped_file_unref(), or %NULL if the mapping failed. * with g_mapped_file_unref(), or %NULL if the mapping failed.

2
glib/gmessages.c
View File

@@ -1820,7 +1820,7 @@ g_log_structured (const gchar *log_domain,
* contain the text shown to the user. * contain the text shown to the user.
* *
* The values in the @fields dictionary are likely to be of type String * The values in the @fields dictionary are likely to be of type String
* (#G_VARIANT_TYPE_STRING). Array of bytes (#G_VARIANT_TYPE_BYTESTRING) is also * (%G_VARIANT_TYPE_STRING). Array of bytes (%G_VARIANT_TYPE_BYTESTRING) is also
* supported. In this case the message is handled as binary and will be forwarded * supported. In this case the message is handled as binary and will be forwarded
* to the log writer as such. The size of the array should not be higher than * to the log writer as such. The size of the array should not be higher than
* %G_MAXSSIZE. Otherwise it will be truncated to this size. For other types * %G_MAXSSIZE. Otherwise it will be truncated to this size. For other types

2
glib/goption.c
View File

@@ -336,7 +336,7 @@ G_DEFINE_QUARK (g-option-context-error-quark, g_option_error)
* The @parameter_string can serve multiple purposes. It can be used * The @parameter_string can serve multiple purposes. It can be used
* to add descriptions for "rest" arguments, which are not parsed by * to add descriptions for "rest" arguments, which are not parsed by
* the #GOptionContext, typically something like "FILES" or * the #GOptionContext, typically something like "FILES" or
* "FILE1 FILE2...". If you are using #G_OPTION_REMAINING for * "FILE1 FILE2...". If you are using %G_OPTION_REMAINING for
* collecting "rest" arguments, GLib handles this automatically by * collecting "rest" arguments, GLib handles this automatically by
* using the @arg_description of the corresponding #GOptionEntry in * using the @arg_description of the corresponding #GOptionEntry in
* the usage summary. * the usage summary.

2
glib/goption.h
View File

@@ -278,7 +278,7 @@ struct _GOptionEntry
* or %G_OPTION_ARG_FILENAME_ARRAY. * or %G_OPTION_ARG_FILENAME_ARRAY.
* *
* *
* Using #G_OPTION_REMAINING instead of simply scanning `argv` * Using %G_OPTION_REMAINING instead of simply scanning `argv`
* for leftover arguments has the advantage that GOption takes care of * for leftover arguments has the advantage that GOption takes care of
* necessary encoding conversions for strings or filenames. * necessary encoding conversions for strings or filenames.
* *

4
glib/gqueue.c
View File

@@ -41,7 +41,7 @@
* *
* To create a new GQueue, use g_queue_new(). * To create a new GQueue, use g_queue_new().
* *
* To initialize a statically-allocated GQueue, use #G_QUEUE_INIT or * To initialize a statically-allocated GQueue, use %G_QUEUE_INIT or
* g_queue_init(). * g_queue_init().
* *
* To add elements, use g_queue_push_head(), g_queue_push_head_link(), * To add elements, use g_queue_push_head(), g_queue_push_head_link(),
@@ -118,7 +118,7 @@ g_queue_free_full (GQueue *queue,
* *
* A statically-allocated #GQueue must be initialized with this function * A statically-allocated #GQueue must be initialized with this function
* before it can be used. Alternatively you can initialize it with * before it can be used. Alternatively you can initialize it with
* #G_QUEUE_INIT. It is not necessary to initialize queues created with * %G_QUEUE_INIT. It is not necessary to initialize queues created with
* g_queue_new(). * g_queue_new().
* *
* Since: 2.14 * Since: 2.14

44
glib/gregex.c
View File

@@ -45,7 +45,7 @@
* Perl regular expression. * Perl regular expression.
* *
* Some functions accept a @start_position argument, setting it differs * Some functions accept a @start_position argument, setting it differs
* from just passing over a shortened string and setting #G_REGEX_MATCH_NOTBOL * from just passing over a shortened string and setting %G_REGEX_MATCH_NOTBOL
* in the case of a pattern that begins with any kind of lookbehind assertion. * in the case of a pattern that begins with any kind of lookbehind assertion.
* For example, consider the pattern "\Biss\B" which finds occurrences of "iss" * For example, consider the pattern "\Biss\B" which finds occurrences of "iss"
* in the middle of words. ("\B" matches only if the current position in the * in the middle of words. ("\B" matches only if the current position in the
@@ -57,11 +57,11 @@
* it is able to look behind the starting point to discover that it is * it is able to look behind the starting point to discover that it is
* preceded by a letter. * preceded by a letter.
* *
* Note that, unless you set the #G_REGEX_RAW flag, all the strings passed * Note that, unless you set the %G_REGEX_RAW flag, all the strings passed
* to these functions must be encoded in UTF-8. The lengths and the positions * to these functions must be encoded in UTF-8. The lengths and the positions
* inside the strings are in bytes and not in characters, so, for instance, * inside the strings are in bytes and not in characters, so, for instance,
* "\xc3\xa0" (i.e. "à") is two bytes long but it is treated as a * "\xc3\xa0" (i.e. "à") is two bytes long but it is treated as a
* single character. If you set #G_REGEX_RAW the strings can be non-valid * single character. If you set %G_REGEX_RAW the strings can be non-valid
* UTF-8 strings and a byte is treated as a character, so "\xc3\xa0" is two * UTF-8 strings and a byte is treated as a character, so "\xc3\xa0" is two
* bytes and two characters long. * bytes and two characters long.
* *
@@ -76,11 +76,11 @@
* The behaviour of the dot, circumflex, and dollar metacharacters are * The behaviour of the dot, circumflex, and dollar metacharacters are
* affected by newline characters, the default is to recognize any newline * affected by newline characters, the default is to recognize any newline
* character (the same characters recognized by "\R"). This can be changed * character (the same characters recognized by "\R"). This can be changed
* with #G_REGEX_NEWLINE_CR, #G_REGEX_NEWLINE_LF and #G_REGEX_NEWLINE_CRLF * with %G_REGEX_NEWLINE_CR, %G_REGEX_NEWLINE_LF and %G_REGEX_NEWLINE_CRLF
* compile options, and with #G_REGEX_MATCH_NEWLINE_ANY, * compile options, and with %G_REGEX_MATCH_NEWLINE_ANY,
* #G_REGEX_MATCH_NEWLINE_CR, #G_REGEX_MATCH_NEWLINE_LF and * %G_REGEX_MATCH_NEWLINE_CR, %G_REGEX_MATCH_NEWLINE_LF and
* #G_REGEX_MATCH_NEWLINE_CRLF match options. These settings are also * %G_REGEX_MATCH_NEWLINE_CRLF match options. These settings are also
* relevant when compiling a pattern if #G_REGEX_EXTENDED is set, and an * relevant when compiling a pattern if %G_REGEX_EXTENDED is set, and an
* unescaped "#" outside a character class is encountered. This indicates * unescaped "#" outside a character class is encountered. This indicates
* a comment that lasts until after the next newline. * a comment that lasts until after the next newline.
* *
@@ -860,19 +860,19 @@ g_match_info_get_match_count (const GMatchInfo *match_info)
* able to raise an error as soon as a mistake is made. * able to raise an error as soon as a mistake is made.
* *
* GRegex supports the concept of partial matching by means of the * GRegex supports the concept of partial matching by means of the
* #G_REGEX_MATCH_PARTIAL_SOFT and #G_REGEX_MATCH_PARTIAL_HARD flags. * %G_REGEX_MATCH_PARTIAL_SOFT and %G_REGEX_MATCH_PARTIAL_HARD flags.
* When they are used, the return code for * When they are used, the return code for
* g_regex_match() or g_regex_match_full() is, as usual, %TRUE * g_regex_match() or g_regex_match_full() is, as usual, %TRUE
* for a complete match, %FALSE otherwise. But, when these functions * for a complete match, %FALSE otherwise. But, when these functions
* return %FALSE, you can check if the match was partial calling * return %FALSE, you can check if the match was partial calling
* g_match_info_is_partial_match(). * g_match_info_is_partial_match().
* *
* The difference between #G_REGEX_MATCH_PARTIAL_SOFT and * The difference between %G_REGEX_MATCH_PARTIAL_SOFT and
* #G_REGEX_MATCH_PARTIAL_HARD is that when a partial match is encountered * %G_REGEX_MATCH_PARTIAL_HARD is that when a partial match is encountered
* with #G_REGEX_MATCH_PARTIAL_SOFT, matching continues to search for a * with %G_REGEX_MATCH_PARTIAL_SOFT, matching continues to search for a
* possible complete match, while with #G_REGEX_MATCH_PARTIAL_HARD matching * possible complete match, while with %G_REGEX_MATCH_PARTIAL_HARD matching
* stops at the partial match. * stops at the partial match.
* When both #G_REGEX_MATCH_PARTIAL_SOFT and #G_REGEX_MATCH_PARTIAL_HARD * When both %G_REGEX_MATCH_PARTIAL_SOFT and %G_REGEX_MATCH_PARTIAL_HARD
* are set, the latter takes precedence. * are set, the latter takes precedence.
* *
* There were formerly some restrictions on the pattern for partial matching. * There were formerly some restrictions on the pattern for partial matching.
@@ -903,7 +903,7 @@ g_match_info_is_partial_match (const GMatchInfo *match_info)
* match done with @string against @regex and have the same syntax used by * match done with @string against @regex and have the same syntax used by
* g_regex_replace(). * g_regex_replace().
* *
* The @string_to_expand must be UTF-8 encoded even if #G_REGEX_RAW was * The @string_to_expand must be UTF-8 encoded even if %G_REGEX_RAW was
* passed to g_regex_new(). * passed to g_regex_new().
* *
* The backreferences are extracted from the string passed to the match * The backreferences are extracted from the string passed to the match
@@ -1739,7 +1739,7 @@ g_regex_match (const GRegex *regex,
* flexibility in reusing #GRegex structures. * flexibility in reusing #GRegex structures.
* *
* Setting @start_position differs from just passing over a shortened * Setting @start_position differs from just passing over a shortened
* string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern * string and setting %G_REGEX_MATCH_NOTBOL in the case of a pattern
* that begins with any kind of lookbehind assertion, such as "\b". * that begins with any kind of lookbehind assertion, such as "\b".
* *
* Unless %G_REGEX_RAW is specified in the options, @string must be valid UTF-8. * Unless %G_REGEX_RAW is specified in the options, @string must be valid UTF-8.
@@ -1890,7 +1890,7 @@ g_regex_match_all (const GRegex *regex,
* is not able to capture substrings, so backreferences do not work. * is not able to capture substrings, so backreferences do not work.
* *
* Setting @start_position differs from just passing over a shortened * Setting @start_position differs from just passing over a shortened
* string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern * string and setting %G_REGEX_MATCH_NOTBOL in the case of a pattern
* that begins with any kind of lookbehind assertion, such as "\b". * that begins with any kind of lookbehind assertion, such as "\b".
* *
* Unless %G_REGEX_RAW is specified in the options, @string must be valid UTF-8. * Unless %G_REGEX_RAW is specified in the options, @string must be valid UTF-8.
@@ -2163,7 +2163,7 @@ g_regex_split (const GRegex *regex,
* "a", "b" and "c". * "a", "b" and "c".
* *
* Setting @start_position differs from just passing over a shortened * Setting @start_position differs from just passing over a shortened
* string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern * string and setting %G_REGEX_MATCH_NOTBOL in the case of a pattern
* that begins with any kind of lookbehind assertion, such as "\b". * that begins with any kind of lookbehind assertion, such as "\b".
* *
* Returns: (transfer full): a %NULL-terminated gchar ** array. Free * Returns: (transfer full): a %NULL-terminated gchar ** array. Free
@@ -2792,12 +2792,12 @@ interpolation_list_needs_match (GList *list)
* *
* If you do not need to use backreferences use g_regex_replace_literal(). * If you do not need to use backreferences use g_regex_replace_literal().
* *
* The @replacement string must be UTF-8 encoded even if #G_REGEX_RAW was * The @replacement string must be UTF-8 encoded even if %G_REGEX_RAW was
* passed to g_regex_new(). If you want to use not UTF-8 encoded strings * passed to g_regex_new(). If you want to use not UTF-8 encoded strings
* you can use g_regex_replace_literal(). * you can use g_regex_replace_literal().
* *
* Setting @start_position differs from just passing over a shortened * Setting @start_position differs from just passing over a shortened
* string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that * string and setting %G_REGEX_MATCH_NOTBOL in the case of a pattern that
* begins with any kind of lookbehind assertion, such as "\b". * begins with any kind of lookbehind assertion, such as "\b".
* *
* Returns: a newly allocated string containing the replacements * Returns: a newly allocated string containing the replacements
@@ -2869,7 +2869,7 @@ literal_replacement (const GMatchInfo *match_info,
* include backreferences use g_regex_replace(). * include backreferences use g_regex_replace().
* *
* Setting @start_position differs from just passing over a * Setting @start_position differs from just passing over a
* shortened string and setting #G_REGEX_MATCH_NOTBOL in the * shortened string and setting %G_REGEX_MATCH_NOTBOL in the
* case of a pattern that begins with any kind of lookbehind * case of a pattern that begins with any kind of lookbehind
* assertion, such as "\b". * assertion, such as "\b".
* *
@@ -2912,7 +2912,7 @@ g_regex_replace_literal (const GRegex *regex,
* @eval for that occurrence. * @eval for that occurrence.
* *
* Setting @start_position differs from just passing over a shortened * Setting @start_position differs from just passing over a shortened
* string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern * string and setting %G_REGEX_MATCH_NOTBOL in the case of a pattern
* that begins with any kind of lookbehind assertion, such as "\b". * that begins with any kind of lookbehind assertion, such as "\b".
* *
* The following example uses g_regex_replace_eval() to replace multiple * The following example uses g_regex_replace_eval() to replace multiple

16
glib/gregex.h
View File

@@ -224,8 +224,8 @@ GQuark g_regex_error_quark (void);
* newlines). The "start of line" metacharacter ("^") matches only * newlines). The "start of line" metacharacter ("^") matches only
* at the start of the string, while the "end of line" metacharacter * at the start of the string, while the "end of line" metacharacter
* ("$") matches only at the end of the string, or before a terminating * ("$") matches only at the end of the string, or before a terminating
* newline (unless #G_REGEX_DOLLAR_ENDONLY is set). When * newline (unless %G_REGEX_DOLLAR_ENDONLY is set). When
* #G_REGEX_MULTILINE is set, the "start of line" and "end of line" * %G_REGEX_MULTILINE is set, the "start of line" and "end of line"
* constructs match immediately following or immediately before any * constructs match immediately following or immediately before any
* newline in the string, respectively, as well as at the very start * newline in the string, respectively, as well as at the very start
* and end. This can be changed within a pattern by a "(?m)" option * and end. This can be changed within a pattern by a "(?m)" option
@@ -248,7 +248,7 @@ GQuark g_regex_error_quark (void);
* matches only at the end of the string. Without this option, a * matches only at the end of the string. Without this option, a
* dollar also matches immediately before the final character if * dollar also matches immediately before the final character if
* it is a newline (but not before any other newlines). This option * it is a newline (but not before any other newlines). This option
* is ignored if #G_REGEX_MULTILINE is set. * is ignored if %G_REGEX_MULTILINE is set.
* @G_REGEX_UNGREEDY: Inverts the "greediness" of the quantifiers so that * @G_REGEX_UNGREEDY: Inverts the "greediness" of the quantifiers so that
* they are not greedy by default, but become greedy if followed by "?". * they are not greedy by default, but become greedy if followed by "?".
* It can also be set by a "(?U)" option setting within the pattern. * It can also be set by a "(?U)" option setting within the pattern.
@@ -324,14 +324,14 @@ typedef enum
* metacharacter. * metacharacter.
* @G_REGEX_MATCH_NOTBOL: Specifies that first character of the string is * @G_REGEX_MATCH_NOTBOL: Specifies that first character of the string is
* not the beginning of a line, so the circumflex metacharacter should * not the beginning of a line, so the circumflex metacharacter should
* not match before it. Setting this without #G_REGEX_MULTILINE (at * not match before it. Setting this without %G_REGEX_MULTILINE (at
* compile time) causes circumflex never to match. This option affects * compile time) causes circumflex never to match. This option affects
* only the behaviour of the circumflex metacharacter, it does not * only the behaviour of the circumflex metacharacter, it does not
* affect "\A". * affect "\A".
* @G_REGEX_MATCH_NOTEOL: Specifies that the end of the subject string is * @G_REGEX_MATCH_NOTEOL: Specifies that the end of the subject string is
* not the end of a line, so the dollar metacharacter should not match * not the end of a line, so the dollar metacharacter should not match
* it nor (except in multiline mode) a newline immediately before it. * it nor (except in multiline mode) a newline immediately before it.
* Setting this without #G_REGEX_MULTILINE (at compile time) causes * Setting this without %G_REGEX_MULTILINE (at compile time) causes
* dollar never to match. This option affects only the behaviour of * dollar never to match. This option affects only the behaviour of
* the dollar metacharacter, it does not affect "\Z" or "\z". * the dollar metacharacter, it does not affect "\Z" or "\z".
* @G_REGEX_MATCH_NOTEMPTY: An empty string is not considered to be a valid * @G_REGEX_MATCH_NOTEMPTY: An empty string is not considered to be a valid
@@ -368,12 +368,12 @@ typedef enum
* single characters U+000B LINE TABULATION, U+000C FORM FEED (FF), * single characters U+000B LINE TABULATION, U+000C FORM FEED (FF),
* U+0085 NEXT LINE (NEL), U+2028 LINE SEPARATOR and * U+0085 NEXT LINE (NEL), U+2028 LINE SEPARATOR and
* U+2029 PARAGRAPH SEPARATOR. Since: 2.34 * U+2029 PARAGRAPH SEPARATOR. Since: 2.34
* @G_REGEX_MATCH_PARTIAL_SOFT: An alias for #G_REGEX_MATCH_PARTIAL. Since: 2.34 * @G_REGEX_MATCH_PARTIAL_SOFT: An alias for %G_REGEX_MATCH_PARTIAL. Since: 2.34
* @G_REGEX_MATCH_PARTIAL_HARD: Turns on the partial matching feature. In contrast to * @G_REGEX_MATCH_PARTIAL_HARD: Turns on the partial matching feature. In contrast to
* to #G_REGEX_MATCH_PARTIAL_SOFT, this stops matching as soon as a partial match * to %G_REGEX_MATCH_PARTIAL_SOFT, this stops matching as soon as a partial match
* is found, without continuing to search for a possible complete match. See * is found, without continuing to search for a possible complete match. See
* g_match_info_is_partial_match() for more information. Since: 2.34 * g_match_info_is_partial_match() for more information. Since: 2.34
* @G_REGEX_MATCH_NOTEMPTY_ATSTART: Like #G_REGEX_MATCH_NOTEMPTY, but only applied to * @G_REGEX_MATCH_NOTEMPTY_ATSTART: Like %G_REGEX_MATCH_NOTEMPTY, but only applied to
* the start of the matched string. For anchored * the start of the matched string. For anchored
* patterns this can only happen for pattern containing "\K". Since: 2.34 * patterns this can only happen for pattern containing "\K". Since: 2.34
* *

8
glib/gscanner.c
View File

@@ -216,11 +216,11 @@
* by the scanner (the default is the whitespace characters: space, * by the scanner (the default is the whitespace characters: space,
* tab, carriage-return and line-feed). * tab, carriage-return and line-feed).
* @cset_identifier_first: specifies the characters which can start * @cset_identifier_first: specifies the characters which can start
* identifiers (the default is #G_CSET_a_2_z, "_", and #G_CSET_A_2_Z). * identifiers (the default is %G_CSET_a_2_z, "_", and %G_CSET_A_2_Z).
* @cset_identifier_nth: specifies the characters which can be used * @cset_identifier_nth: specifies the characters which can be used
* in identifiers, after the first character (the default is * in identifiers, after the first character (the default is
* #G_CSET_a_2_z, "_0123456789", #G_CSET_A_2_Z, #G_CSET_LATINS, * %G_CSET_a_2_z, "_0123456789", %G_CSET_A_2_Z, %G_CSET_LATINS,
* #G_CSET_LATINC). * %G_CSET_LATINC).
* @cpair_comment_single: specifies the characters at the start and * @cpair_comment_single: specifies the characters at the start and
* end of single-line comments. The default is "#\n" which means * end of single-line comments. The default is "#\n" which means
* that single-line comments start with a '#' and continue until * that single-line comments start with a '#' and continue until
@@ -256,7 +256,7 @@
* @scan_string_dq: specifies if strings can be enclosed in double * @scan_string_dq: specifies if strings can be enclosed in double
* quotes (the default is %TRUE). * quotes (the default is %TRUE).
* @numbers_2_int: specifies if binary, octal and hexadecimal numbers * @numbers_2_int: specifies if binary, octal and hexadecimal numbers
* are reported as #G_TOKEN_INT (the default is %TRUE). * are reported as %G_TOKEN_INT (the default is %TRUE).
* @int_2_float: specifies if all numbers are reported as %G_TOKEN_FLOAT * @int_2_float: specifies if all numbers are reported as %G_TOKEN_FLOAT
* (the default is %FALSE). * (the default is %FALSE).
* @identifier_2_string: specifies if identifiers are reported as strings * @identifier_2_string: specifies if identifiers are reported as strings

2
glib/gspawn.c
View File

@@ -828,7 +828,7 @@ g_spawn_async_with_pipes (const gchar *working_directory,
* 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 `message` field of returned * `@argv[0]` is not found). Typically the `message` field of returned
* errors should be displayed to users. Possible errors are those from * errors should be displayed to users. Possible errors are those from
* the #G_SPAWN_ERROR domain. * the %G_SPAWN_ERROR domain.
* *
* If an error occurs, @child_pid, @stdin_pipe_out, @stdout_pipe_out, * If an error occurs, @child_pid, @stdin_pipe_out, @stdout_pipe_out,
* and @stderr_pipe_out will not be filled with valid values. * and @stderr_pipe_out will not be filled with valid values.

2
glib/gstdio.h
View File

@@ -61,7 +61,7 @@ typedef struct stat GStatBuf;
* A few functions can't be handled in this way, since they are not defined * A few functions can't be handled in this way, since they are not defined
* in a portable system header that we could include here. * in a portable system header that we could include here.
* *
* #G_STDIO_WRAP_ON_UNIX is not public API and its behaviour is not guaranteed * G_STDIO_WRAP_ON_UNIX is not public API and its behaviour is not guaranteed
* in future. * in future.
*/ */

4
glib/gstrfuncs.c
View File

@@ -906,7 +906,7 @@ g_ascii_strtod (const gchar *nptr,
* the string back using g_ascii_strtod() gives the same machine-number * the string back using g_ascii_strtod() gives the same machine-number
* (on machines with IEEE compatible 64bit doubles). It is * (on machines with IEEE compatible 64bit doubles). It is
* guaranteed that the size of the resulting string will never * guaranteed that the size of the resulting string will never
* be larger than @G_ASCII_DTOSTR_BUF_SIZE bytes, including the terminating * be larger than %G_ASCII_DTOSTR_BUF_SIZE bytes, including the terminating
* nul character, which is always added. * nul character, which is always added.
* *
* Returns: The pointer to the buffer with the converted string. * Returns: The pointer to the buffer with the converted string.
@@ -2030,7 +2030,7 @@ g_strncasecmp (const gchar *s1,
* g_strdelimit: * g_strdelimit:
* @string: the string to convert * @string: the string to convert
* @delimiters: (nullable): a string containing the current delimiters, * @delimiters: (nullable): a string containing the current delimiters,
* or %NULL to use the standard delimiters defined in #G_STR_DELIMITERS * or %NULL to use the standard delimiters defined in %G_STR_DELIMITERS
* @new_delimiter: the new delimiter character * @new_delimiter: the new delimiter character
* *
* Converts any delimiter characters in @string to @new_delimiter. * Converts any delimiter characters in @string to @new_delimiter.

2
glib/gtimer.c
View File

@@ -260,7 +260,7 @@ g_timer_is_active (GTimer *timer)
* Pauses the current thread for the given number of microseconds. * Pauses the current thread for the given number of microseconds.
* *
* There are 1 million microseconds per second (represented by the * There are 1 million microseconds per second (represented by the
* #G_USEC_PER_SEC macro). g_usleep() may have limited precision, * %G_USEC_PER_SEC macro). g_usleep() may have limited precision,
* depending on hardware and operating system; don't rely on the exact * depending on hardware and operating system; don't rely on the exact
* length of the sleep. * length of the sleep.
*/ */

4
gmodule/gmodule.c
View File

@@ -477,7 +477,7 @@ static GRecMutex g_module_global_lock;
* If that fails and @file_name has the ".la"-suffix (and is a libtool * If that fails and @file_name has the ".la"-suffix (and is a libtool
* archive) it tries to open the corresponding module. If that fails * archive) it tries to open the corresponding module. If that fails
* and it doesn't have the proper module suffix for the platform * and it doesn't have the proper module suffix for the platform
* (#G_MODULE_SUFFIX), this suffix will be appended and the corresponding * (%G_MODULE_SUFFIX), this suffix will be appended and the corresponding
* module will be opened. If that fails and @file_name doesn't have the * module will be opened. If that fails and @file_name doesn't have the
* ".la"-suffix, this suffix is appended and g_module_open_full() tries to open * ".la"-suffix, this suffix is appended and g_module_open_full() tries to open
* the corresponding module. If eventually that fails as well, %NULL is * the corresponding module. If eventually that fails as well, %NULL is
@@ -782,7 +782,7 @@ g_module_error (void)
* @symbol: (out): returns the pointer to the symbol value * @symbol: (out): returns the pointer to the symbol value
* *
* Gets a symbol pointer from a module, such as one exported * Gets a symbol pointer from a module, such as one exported
* by #G_MODULE_EXPORT. Note that a valid symbol can be %NULL. * by %G_MODULE_EXPORT. Note that a valid symbol can be %NULL.
* *
* Returns: %TRUE on success * Returns: %TRUE on success
*/ */

2
gobject/gboxed.c
View File

@@ -286,7 +286,7 @@ boxed_proxy_lcopy_value (const GValue *value,
* Boxed type handling functions have to be provided to copy and free * Boxed type handling functions have to be provided to copy and free
* opaque boxed structures of this type. * opaque boxed structures of this type.
* *
* For the general case, it is recommended to use #G_DEFINE_BOXED_TYPE * For the general case, it is recommended to use G_DEFINE_BOXED_TYPE()
* instead of calling g_boxed_type_register_static() directly. The macro * instead of calling g_boxed_type_register_static() directly. The macro
* will create the appropriate `*_get_type()` function for the boxed type. * will create the appropriate `*_get_type()` function for the boxed type.
* *

2
gobject/glib-types.h
View File

@@ -44,7 +44,7 @@ typedef gsize GType;
* The #GType for a boxed type holding a %NULL-terminated array of strings. * The #GType for a boxed type holding a %NULL-terminated array of strings.
* *
* The code fragments in the following example show the use of a property of * The code fragments in the following example show the use of a property of
* type #G_TYPE_STRV with g_object_class_install_property(), g_object_set() * type %G_TYPE_STRV with g_object_class_install_property(), g_object_set()
* and g_object_get(). * and g_object_get().
* *
* |[ * |[

6
gobject/gobject.c
View File

@@ -1780,7 +1780,7 @@ g_object_get_type (void)
* *
* Creates a new instance of a #GObject subtype and sets its properties. * Creates a new instance of a #GObject subtype and sets its properties.
* *
* Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) * Construction parameters (see %G_PARAM_CONSTRUCT, %G_PARAM_CONSTRUCT_ONLY)
* which are not explicitly specified are set to their default values. Any * which are not explicitly specified are set to their default values. Any
* private data for the object is guaranteed to be initialized with zeros, as * private data for the object is guaranteed to be initialized with zeros, as
* per g_type_create_instance(). * per g_type_create_instance().
@@ -2194,7 +2194,7 @@ g_object_new_with_properties (GType object_type,
* *
* Creates a new instance of a #GObject subtype and sets its properties. * Creates a new instance of a #GObject subtype and sets its properties.
* *
* Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) * Construction parameters (see %G_PARAM_CONSTRUCT, %G_PARAM_CONSTRUCT_ONLY)
* which are not explicitly specified are set to their default values. * which are not explicitly specified are set to their default values.
* *
* Returns: (type GObject.Object) (transfer full): a new instance of * Returns: (type GObject.Object) (transfer full): a new instance of
@@ -2266,7 +2266,7 @@ G_GNUC_END_IGNORE_DEPRECATIONS
* *
* Creates a new instance of a #GObject subtype and sets its properties. * Creates a new instance of a #GObject subtype and sets its properties.
* *
* Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) * Construction parameters (see %G_PARAM_CONSTRUCT, %G_PARAM_CONSTRUCT_ONLY)
* which are not explicitly specified are set to their default values. * which are not explicitly specified are set to their default values.
* *
* Returns: a new instance of @object_type * Returns: a new instance of @object_type

4
gobject/gparam.c
View File

@@ -421,7 +421,7 @@ g_param_spec_is_valid_name (const gchar *name)
/** /**
* g_param_spec_internal: (skip) * g_param_spec_internal: (skip)
* @param_type: the #GType for the property; must be derived from #G_TYPE_PARAM * @param_type: the #GType for the property; must be derived from %G_TYPE_PARAM
* @name: the canonical name of the property * @name: the canonical name of the property
* @nick: the nickname of the property * @nick: the nickname of the property
* @blurb: a short description of the property * @blurb: a short description of the property
@@ -1403,7 +1403,7 @@ default_values_cmp (GParamSpec *pspec,
* @pspec_info: The #GParamSpecTypeInfo for this #GParamSpec type. * @pspec_info: The #GParamSpecTypeInfo for this #GParamSpec type.
* *
* Registers @name as the name of a new static type derived * Registers @name as the name of a new static type derived
* from #G_TYPE_PARAM. * from %G_TYPE_PARAM.
* *
* The type system uses the information contained in the #GParamSpecTypeInfo * The type system uses the information contained in the #GParamSpecTypeInfo
* structure pointed to by @info to manage the #GParamSpec type and its * structure pointed to by @info to manage the #GParamSpec type and its

16
gobject/gsignal.c
View File

@@ -1041,7 +1041,7 @@ signal_finalize_hook (GHookList *hook_list,
* *
* Adds an emission hook for a signal, which will get called for any emission * Adds an emission hook for a signal, which will get called for any emission
* of that signal, independent of the instance. This is possible only * of that signal, independent of the instance. This is possible only
* for signals which don't have #G_SIGNAL_NO_HOOKS flag set. * for signals which don't have %G_SIGNAL_NO_HOOKS flag set.
* *
* Returns: the hook id, for later use with g_signal_remove_emission_hook(). * Returns: the hook id, for later use with g_signal_remove_emission_hook().
*/ */
@@ -1458,7 +1458,7 @@ g_signal_query (guint signal_id,
* @accu_data: (nullable) (closure accumulator): user data for the @accumulator. * @accu_data: (nullable) (closure accumulator): user data for the @accumulator.
* @c_marshaller: (nullable): the function to translate arrays of parameter * @c_marshaller: (nullable): the function to translate arrays of parameter
* values to signal emissions into C language callback invocations or %NULL. * values to signal emissions into C language callback invocations or %NULL.
* @return_type: the type of return value, or #G_TYPE_NONE for a signal * @return_type: the type of return value, or %G_TYPE_NONE for a signal
* without a return value. * without a return value.
* @n_params: the number of parameter types to follow. * @n_params: the number of parameter types to follow.
* @...: a list of types, one for each parameter. * @...: a list of types, one for each parameter.
@@ -1534,7 +1534,7 @@ g_signal_new (const gchar *signal_name,
* @accu_data: (nullable) (closure accumulator): user data for the @accumulator. * @accu_data: (nullable) (closure accumulator): user data for the @accumulator.
* @c_marshaller: (nullable): the function to translate arrays of parameter * @c_marshaller: (nullable): the function to translate arrays of parameter
* values to signal emissions into C language callback invocations or %NULL. * values to signal emissions into C language callback invocations or %NULL.
* @return_type: the type of return value, or #G_TYPE_NONE for a signal * @return_type: the type of return value, or %G_TYPE_NONE for a signal
* without a return value. * without a return value.
* @n_params: the number of parameter types to follow. * @n_params: the number of parameter types to follow.
* @...: a list of types, one for each parameter. * @...: a list of types, one for each parameter.
@@ -1672,7 +1672,7 @@ signal_add_class_closure (SignalNode *node,
* @c_marshaller: (nullable): the function to translate arrays of * @c_marshaller: (nullable): the function to translate arrays of
* parameter values to signal emissions into C language callback * parameter values to signal emissions into C language callback
* invocations or %NULL * invocations or %NULL
* @return_type: the type of return value, or #G_TYPE_NONE for a signal * @return_type: the type of return value, or %G_TYPE_NONE for a signal
* without a return value * without a return value
* @n_params: the length of @param_types * @n_params: the length of @param_types
* @param_types: (array length=n_params) (nullable): an array of types, one for * @param_types: (array length=n_params) (nullable): an array of types, one for
@@ -1932,7 +1932,7 @@ g_signal_set_va_marshaller (guint signal_id,
* @accu_data: (nullable) (closure accumulator): user data for the @accumulator. * @accu_data: (nullable) (closure accumulator): user data for the @accumulator.
* @c_marshaller: (nullable): the function to translate arrays of parameter * @c_marshaller: (nullable): the function to translate arrays of parameter
* values to signal emissions into C language callback invocations or %NULL. * values to signal emissions into C language callback invocations or %NULL.
* @return_type: the type of return value, or #G_TYPE_NONE for a signal * @return_type: the type of return value, or %G_TYPE_NONE for a signal
* without a return value. * without a return value.
* @n_params: the number of parameter types in @args. * @n_params: the number of parameter types in @args.
* @args: va_list of #GType, one for each parameter. * @args: va_list of #GType, one for each parameter.
@@ -2203,7 +2203,7 @@ g_signal_chain_from_overridden (const GValue *instance_and_params,
* emitted on. * emitted on.
* @...: parameters to be passed to the parent class closure, followed by a * @...: parameters to be passed to the parent class closure, followed by a
* location for the return value. If the return type of the signal * location for the return value. If the return type of the signal
* is #G_TYPE_NONE, the return value location can be omitted. * is %G_TYPE_NONE, the return value location can be omitted.
* *
* Calls the original class closure of a signal. This function should * Calls the original class closure of a signal. This function should
* only be called from an overridden class closure; see * only be called from an overridden class closure; see
@@ -3254,7 +3254,7 @@ accumulate (GSignalInvocationHint *ihint,
* @detail: the detail * @detail: the detail
* @var_args: a list of parameters to be passed to the signal, followed by a * @var_args: a list of parameters to be passed to the signal, followed by a
* location for the return value. If the return type of the signal * location for the return value. If the return type of the signal
* is #G_TYPE_NONE, the return value location can be omitted. * is %G_TYPE_NONE, the return value location can be omitted.
* *
* Emits a signal. Signal emission is done synchronously. * Emits a signal. Signal emission is done synchronously.
* The method will only return control after all handlers are called or signal emission was stopped. * The method will only return control after all handlers are called or signal emission was stopped.
@@ -3533,7 +3533,7 @@ g_signal_emit_valist (gpointer instance,
* @detail: the detail * @detail: the detail
* @...: parameters to be passed to the signal, followed by a * @...: parameters to be passed to the signal, followed by a
* location for the return value. If the return type of the signal * location for the return value. If the return type of the signal
* is #G_TYPE_NONE, the return value location can be omitted. * is %G_TYPE_NONE, the return value location can be omitted.
* *
* Emits a signal. Signal emission is done synchronously. * Emits a signal. Signal emission is done synchronously.
* The method will only return control after all handlers are called or signal emission was stopped. * The method will only return control after all handlers are called or signal emission was stopped.

2
gobject/gsignal.h
View File

@@ -65,7 +65,7 @@ typedef GVaClosureMarshal GSignalCVaMarshaller;
* Emission hooks allow you to tie a hook to the signal type, so that it will * Emission hooks allow you to tie a hook to the signal type, so that it will
* trap all emissions of that signal, from any object. * trap all emissions of that signal, from any object.
* *
* You may not attach these to signals created with the #G_SIGNAL_NO_HOOKS flag. * You may not attach these to signals created with the %G_SIGNAL_NO_HOOKS flag.
* *
* Returns: whether it wants to stay connected. If it returns %FALSE, the signal * Returns: whether it wants to stay connected. If it returns %FALSE, the signal
* hook is disconnected (and destroyed). * hook is disconnected (and destroyed).

4
gobject/gtype.c
View File

@@ -2849,7 +2849,7 @@ g_type_register_static (GType parent_type,
* instances (if not abstract). The value of @flags determines the nature * instances (if not abstract). The value of @flags determines the nature
* (e.g. abstract or not) of the type. * (e.g. abstract or not) of the type.
* *
* Returns: the new type identifier or #G_TYPE_INVALID if registration failed * Returns: the new type identifier or %G_TYPE_INVALID if registration failed
*/ */
GType GType
g_type_register_dynamic (GType parent_type, g_type_register_dynamic (GType parent_type,
@@ -4759,7 +4759,7 @@ g_type_add_instance_private (GType class_gtype,
* register the private data size in the get_type() implementation and we * register the private data size in the get_type() implementation and we
* hide it behind a macro. the function will return the private size, instead * hide it behind a macro. the function will return the private size, instead
* of the offset, which will be stored inside a static variable defined by * of the offset, which will be stored inside a static variable defined by
* the G_DEFINE_TYPE_EXTENDED macro. the G_DEFINE_TYPE_EXTENDED macro will * the G_DEFINE_TYPE_EXTENDED() macro. the G_DEFINE_TYPE_EXTENDED() macro will
* check the variable and call g_type_class_add_instance_private(), which * check the variable and call g_type_class_add_instance_private(), which
* will use the data size and actually register the private data, then * will use the data size and actually register the private data, then
* return the computed offset of the private data, which will be stored * return the computed offset of the private data, which will be stored

8
gobject/gtype.h
View File

@@ -72,7 +72,7 @@ G_BEGIN_DECLS
* *
* The fundamental type corresponding to #gchar. * The fundamental type corresponding to #gchar.
* *
* The type designated by G_TYPE_CHAR is unconditionally an 8-bit signed integer. * The type designated by %G_TYPE_CHAR is unconditionally an 8-bit signed integer.
* This may or may not be the same type a the C type "gchar". * This may or may not be the same type a the C type "gchar".
*/ */
#define G_TYPE_CHAR G_TYPE_MAKE_FUNDAMENTAL (3) #define G_TYPE_CHAR G_TYPE_MAKE_FUNDAMENTAL (3)
@@ -654,7 +654,7 @@ struct _GTypeQuery
* This macro should only be used in type implementations. * This macro should only be used in type implementations.
* *
* Since: 2.4 * Since: 2.4
* Deprecated: 2.58: Use %G_ADD_PRIVATE and the generated * Deprecated: 2.58: Use G_ADD_PRIVATE() and the generated
* `your_type_get_instance_private()` function instead * `your_type_get_instance_private()` function instead
* Returns: (not nullable): a pointer to the private data structure * Returns: (not nullable): a pointer to the private data structure
*/ */
@@ -1210,7 +1210,7 @@ struct _GInterfaceInfo
* return NULL; * return NULL;
* ]| * ]|
* It should be noted, that it is generally a bad idea to follow the * It should be noted, that it is generally a bad idea to follow the
* #G_VALUE_NOCOPY_CONTENTS hint for reference counted types. Due to * %G_VALUE_NOCOPY_CONTENTS hint for reference counted types. Due to
* reentrancy requirements and reference count assertions performed * reentrancy requirements and reference count assertions performed
* by the signal emission code, reference counts should always be * by the signal emission code, reference counts should always be
* incremented for reference counted contents stored in the value->data * incremented for reference counted contents stored in the value->data
@@ -2256,7 +2256,7 @@ type_name##_get_type (void) \
* register_rectangle_transform_funcs (g_define_type_id)) * register_rectangle_transform_funcs (g_define_type_id))
* ]| * ]|
* *
* Similarly to the %G_DEFINE_TYPE family of macros, the #GType of the newly * Similarly to the `G_DEFINE_TYPE_*` family of macros, the #GType of the newly
* defined boxed type is exposed in the `g_define_type_id` variable. * defined boxed type is exposed in the `g_define_type_id` variable.
* *
* Since: 2.26 * Since: 2.26

4
gobject/gvaluecollector.h
View File

@@ -144,8 +144,8 @@ G_STMT_START { \
* `va_list` variables cannot be passed by reference. * `va_list` variables cannot be passed by reference.
* *
* Note: If you are creating the @value argument just before calling this macro, * Note: If you are creating the @value argument just before calling this macro,
* you should use the #G_VALUE_COLLECT_INIT variant and pass the uninitialized * you should use the G_VALUE_COLLECT_INIT() variant and pass the uninitialized
* #GValue. That variant is faster than #G_VALUE_COLLECT. * #GValue. That variant is faster than G_VALUE_COLLECT().
*/ */
#define G_VALUE_COLLECT(value, var_args, flags, __error) G_STMT_START { \ #define G_VALUE_COLLECT(value, var_args, flags, __error) G_STMT_START { \
GValue *g_vc_value = (value); \ GValue *g_vc_value = (value); \

2
gobject/gvaluetypes.h
View File

@@ -306,7 +306,7 @@ void g_value_set_string_take_ownership (GValue *value,
/** /**
* gchararray: * gchararray:
* *
* A C representable type name for #G_TYPE_STRING. * A C representable type name for %G_TYPE_STRING.
*/ */
typedef gchar* gchararray; typedef gchar* gchararray;