luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-25 06:56:14 +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
Show Stats 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;