diff options
55 files changed, 253 insertions, 253 deletions
diff --git a/gio/gdbusconnection.c b/gio/gdbusconnection.c index bd82ab3bb..5f6c5bc38 100644 --- a/gio/gdbusconnection.c +++ b/gio/gdbusconnection.c @@ -5268,7 +5268,7 @@ obj_message_func (GDBusConnection *connection, * #GVariant of incorrect type. * * 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 * 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 * @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 * requested method. If so, the @dispatch function is used to determine * 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. * * 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 * g_dbus_connection_register_object()) in a subtree registered with diff --git a/gio/gdbuserror.c b/gio/gdbuserror.c index b3ea28f5a..4cc542c7e 100644 --- a/gio/gdbuserror.c +++ b/gio/gdbuserror.c @@ -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(). * * 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 * g_dbus_error_get_remote_error(). * diff --git a/gio/gdbusutils.c b/gio/gdbusutils.c index f4cdcb621..112c24e22 100644 --- a/gio/gdbusutils.c +++ b/gio/gdbusutils.c @@ -548,12 +548,12 @@ g_dbus_gvariant_to_gvalue (GVariant *value, * - `G_TYPE_DOUBLE`: 'd' * - `G_TYPE_VARIANT`: Any #GVariantType * - * 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 - * (including e.g. #G_TYPE_OBJECT and #G_TYPE_BOXED derived-types) not + * 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 + * (including e.g. %G_TYPE_OBJECT and %G_TYPE_BOXED derived-types) not * 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 * 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). diff --git a/gio/gdesktopappinfo.c b/gio/gdesktopappinfo.c index 0d0b2c6cc..60d6debb2 100644 --- a/gio/gdesktopappinfo.c +++ b/gio/gdesktopappinfo.c @@ -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 * 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 * diff --git a/gio/gdrive.c b/gio/gdrive.c index 32bdae879..c6c68dda9 100644 --- a/gio/gdrive.c +++ b/gio/gdrive.c @@ -613,7 +613,7 @@ g_drive_poll_for_media_finish (GDrive *drive, * * Gets the identifier of the given kind for @drive. The only * 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 * requested identifier, or %NULL if the #GDrive diff --git a/gio/gfile.c b/gio/gfile.c index 37bd58bdd..1810e3682 100644 --- a/gio/gfile.c +++ b/gio/gfile.c @@ -1041,7 +1041,7 @@ g_file_resolve_relative_path (GFile *file, * "standard::*" means all attributes in the standard namespace. * An example attribute query be "standard::*,owner::user". * 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 * 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 * 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 * * Since: 2.18 @@ -1274,7 +1274,7 @@ g_file_query_file_type (GFile *file, * "standard::*" means all attributes in the standard namespace. * An example attribute query be "standard::*,owner::user". * 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 * 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 * 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. * Also, for symlinks that point to non-existing files the information * 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 * in the filesystem namespace. The standard namespace for filesystem * attributes is "filesystem". Common attributes of interest are - * #G_FILE_ATTRIBUTE_FILESYSTEM_SIZE (the total size of the filesystem - * in bytes), #G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of bytes available), - * and #G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type 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), + * and %G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem). * * If @cancellable is not %NULL, then the operation can be cancelled * 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. * * 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 * is supported on the target filesystem. * @@ -1765,7 +1765,7 @@ g_file_append_to (GFile *file, * The file must not already exist. * * 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 is supported on the target filesystem. * @@ -1833,7 +1833,7 @@ g_file_create (GFile *file, * the destination when the stream is closed. * * 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 * 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. * * 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 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, * those that are copies in a normal file copy operation * (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 * 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. * 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. * - * 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 * @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, * 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 * 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. * * 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. * * 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. * * 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 * 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. * * 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 * 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. * * 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. * * 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 * 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. * * 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 * 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 * @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 * 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 * @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, * passwords are needed during authentication. * @@ -8431,7 +8431,7 @@ g_file_start_mountable_finish (GFile *file, * when the request is satisfied, or %NULL * @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 * 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 * @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 * triggering the cancellable object from another thread. If the operation diff --git a/gio/gfileenumerator.c b/gio/gfileenumerator.c index 429d972ab..e0ed9720e 100644 --- a/gio/gfileenumerator.c +++ b/gio/gfileenumerator.c @@ -721,7 +721,7 @@ g_file_enumerator_get_container (GFileEnumerator *enumerator) * directory of @enumerator. This function is primarily intended to be used * 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. * * This is a convenience method that's equivalent to: diff --git a/gio/gfilemonitor.c b/gio/gfilemonitor.c index 9b9c0ea2d..89c89d203 100644 --- a/gio/gfilemonitor.c +++ b/gio/gfilemonitor.c @@ -172,7 +172,7 @@ g_file_monitor_class_init (GFileMonitorClass *klass) * 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 - * #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. * * In all the other cases, @other_file will be set to #NULL. diff --git a/gio/gioenums.h b/gio/gioenums.h index caab3d72c..efc430152 100644 --- a/gio/gioenums.h +++ b/gio/gioenums.h @@ -392,7 +392,7 @@ typedef enum { * * Indicates a hint from the file system whether files should be * 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 { G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS = 0, @@ -522,7 +522,7 @@ typedef enum { * } * ]| * 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 * %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_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 - * 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 * return an error from g_bus_own_name() rather than entering the waiting queue for that name. (Since 2.54) * diff --git a/gio/giomodule.c b/gio/giomodule.c index 38ea7bc48..2a043ccd9 100644 --- a/gio/giomodule.c +++ b/gio/giomodule.c @@ -1474,7 +1474,7 @@ g_io_extension_point_set_required_type (GIOExtensionPoint *extension_point, * Gets the required type for @extension_point. * * 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 g_io_extension_point_get_required_type (GIOExtensionPoint *extension_point) diff --git a/gio/gresolver.c b/gio/gresolver.c index c38369f9b..90b057cbf 100644 --- a/gio/gresolver.c +++ b/gio/gresolver.c @@ -545,7 +545,7 @@ g_resolver_lookup_by_name (GResolver *resolver, * * 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 - * 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 * of #GInetAddress, or %NULL on error. You diff --git a/gio/gsettings.c b/gio/gsettings.c index e96c94e11..00f8c16c8 100644 --- a/gio/gsettings.c +++ b/gio/gsettings.c @@ -248,7 +248,7 @@ * looks for a boolean property with the name "sensitivity" and * automatically binds it to the writability of the bound setting. * 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} * diff --git a/gio/gsettings.h b/gio/gsettings.h index d3d5a076f..cb35d288e 100644 --- a/gio/gsettings.h +++ b/gio/gsettings.h @@ -284,7 +284,7 @@ typedef gboolean (*GSettingsGetMapping) (GVarian * @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. * @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 * @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 diff --git a/gio/gsettingsbackend.c b/gio/gsettingsbackend.c index 56409f59e..a1a23cc56 100644 --- a/gio/gsettingsbackend.c +++ b/gio/gsettingsbackend.c @@ -60,7 +60,7 @@ static gboolean g_settings_has_backend; * non-strictly-typed data that is stored in a hierarchy. To implement * an alternative storage backend for #GSettings, you need to implement * 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 * method for determining if writing of certain values will fail diff --git a/gio/gsimpleasyncresult.c b/gio/gsimpleasyncresult.c index c971bdfcd..7fd9b43b5 100644 --- a/gio/gsimpleasyncresult.c +++ b/gio/gsimpleasyncresult.c @@ -705,7 +705,7 @@ g_simple_async_result_take_error (GSimpleAsyncResult *simple, /** * g_simple_async_result_set_error_va: (skip) * @simple: a #GSimpleAsyncResult. - * @domain: a #GQuark (usually #G_IO_ERROR). + * @domain: a #GQuark (usually %G_IO_ERROR). * @code: an error code. * @format: a formatted error reporting string. * @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) * @simple: a #GSimpleAsyncResult. - * @domain: a #GQuark (usually #G_IO_ERROR). + * @domain: a #GQuark (usually %G_IO_ERROR). * @code: an error code. * @format: a formatted error reporting string. * @...: 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. * @callback: a #GAsyncReadyCallback. * @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. * @format: a formatted error reporting string. * @...: a list of variables to fill in @format. diff --git a/gio/gtask.c b/gio/gtask.c index ab71d86b4..80c0863ff 100644 --- a/gio/gtask.c +++ b/gio/gtask.c @@ -2005,7 +2005,7 @@ value_free (gpointer value) * * 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. * * This is a very generic low-level method intended primarily for use diff --git a/gio/gtlsdatabase.c b/gio/gtlsdatabase.c index 19ac234ff..7027b121c 100644 --- a/gio/gtlsdatabase.c +++ b/gio/gtlsdatabase.c @@ -469,7 +469,7 @@ g_tls_database_class_init (GTlsDatabaseClass *klass) * certificate in the chain by its #GTlsCertificate:issuer property. * * @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 * (and we are acting as the client). * diff --git a/gio/gvolume.c b/gio/gvolume.c index 0e14ddaf6..cb6d34f8b 100644 --- a/gio/gvolume.c +++ b/gio/gvolume.c @@ -66,13 +66,13 @@ * different kinds of identifiers, such as Hal UDIs, filesystem labels, * traditional Unix devices (e.g. `/dev/sda2`), UUIDs. GIO uses predefined * 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. * * - * 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 - * 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 * libhal_manager_find_device_string_match(). */ diff --git a/gio/tests/gdbus-connection.c b/gio/tests/gdbus-connection.c index 0410a880a..396b1a40a 100644 --- a/gio/tests/gdbus-connection.c +++ b/gio/tests/gdbus-connection.c @@ -416,7 +416,7 @@ test_connection_send (void) /* * 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. */ ca = g_cancellable_new (); diff --git a/gio/tests/gdbus-threading.c b/gio/tests/gdbus-threading.c index 4519fda91..9f3abc430 100644 --- a/gio/tests/gdbus-threading.c +++ b/gio/tests/gdbus-threading.c @@ -176,7 +176,7 @@ test_delivery_in_thread_func (gpointer _data) /* * 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. */ ca = g_cancellable_new (); diff --git a/glib/deprecated/gthread-deprecated.c b/glib/deprecated/gthread-deprecated.c index e7e68fbd6..be98a74b6 100644 --- a/glib/deprecated/gthread-deprecated.c +++ b/glib/deprecated/gthread-deprecated.c @@ -97,7 +97,7 @@ * This macro is defined if POSIX style threads are used. * * 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. * - * 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. * * 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() */ @@ -649,7 +649,7 @@ g_static_mutex_free (GStaticMutex* mutex) * * A #GStaticRecMutex must be initialized with this function before it * 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() */ @@ -949,7 +949,7 @@ g_static_rec_mutex_free (GStaticRecMutex *mutex) * * A #GStaticRWLock must be initialized with this function before it * 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 */ @@ -1295,7 +1295,7 @@ GPrivate static_private_private = G_PRIVATE_INIT (g_static_private_cleanup); * @private_key: a #GStaticPrivate to be initialized * * Initializes @private_key. Alternatively you can initialize it with - * #G_STATIC_PRIVATE_INIT. + * %G_STATIC_PRIVATE_INIT. */ void g_static_private_init (GStaticPrivate *private_key) diff --git a/glib/docs.c b/glib/docs.c index 1194a2dcd..9d6321b8a 100644 --- a/glib/docs.c +++ b/glib/docs.c @@ -108,7 +108,7 @@ * gint: * * 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: * * 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: * * 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: * * 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: * * 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: * * 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: * * A signed integer guaranteed to be 8 bits on all platforms. - * Values of this type can range from #G_MININT8 (= -128) to - * #G_MAXINT8 (= 127). + * Values of this type can range from %G_MININT8 (= -128) to + * %G_MAXINT8 (= 127). */ /** @@ -220,7 +220,7 @@ * guint8: * * 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: * * A signed integer guaranteed to be 16 bits on all platforms. - * Values of this type can range from #G_MININT16 (= -32,768) to - * #G_MAXINT16 (= 32,767). + * Values of this type can range from %G_MININT16 (= -32,768) to + * %G_MAXINT16 (= 32,767). * * To print or scan values of this type, use * %G_GINT16_MODIFIER and/or %G_GINT16_FORMAT. @@ -289,7 +289,7 @@ * guint16: * * 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 * %G_GINT16_MODIFIER and/or %G_GUINT16_FORMAT. @@ -307,15 +307,15 @@ * G_GUINT16_FORMAT: * * 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: * * A signed integer guaranteed to be 32 bits on all platforms. - * Values of this type can range from #G_MININT32 (= -2,147,483,648) - * to #G_MAXINT32 (= 2,147,483,647). + * Values of this type can range from %G_MININT32 (= -2,147,483,648) + * to %G_MAXINT32 (= 2,147,483,647). * * To print or scan values of this type, use * %G_GINT32_MODIFIER and/or %G_GINT32_FORMAT. @@ -334,7 +334,7 @@ * * The platform dependent length modifier for conversion specifiers * 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 */ @@ -343,14 +343,14 @@ * G_GINT32_FORMAT: * * 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: * * 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 * %G_GINT32_MODIFIER and/or %G_GUINT32_FORMAT. @@ -368,15 +368,15 @@ * G_GUINT32_FORMAT: * * 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: * * A signed integer guaranteed to be 64 bits on all platforms. - * Values of this type can range from #G_MININT64 - * (= -9,223,372,036,854,775,808) to #G_MAXINT64 + * 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,807). * * To print or scan values of this type, use @@ -407,7 +407,7 @@ * G_GINT64_FORMAT: * * 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, * even though the types are supported. On such platforms %G_GINT64_FORMAT @@ -421,7 +421,7 @@ * guint64: * * 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). * * To print or scan values of this type, use @@ -438,7 +438,7 @@ * G_GUINT64_FORMAT: * * 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, * even though the types are supported. On such platforms %G_GUINT64_FORMAT @@ -470,7 +470,7 @@ * gfloat: * * 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: * * 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, * 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 - * #G_MAXSIZE. + * %G_MAXSIZE. * * To print or scan values of this type, use * %G_GSIZE_MODIFIER and/or %G_GSIZE_FORMAT. @@ -546,7 +546,7 @@ * G_GSIZE_FORMAT: * * 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 */ @@ -556,8 +556,8 @@ * * A signed variant of #gsize, corresponding to the * ssize_t defined on most platforms. - * Values of this type can range from #G_MINSSIZE - * to #G_MAXSSIZE. + * Values of this type can range from %G_MINSSIZE + * to %G_MAXSSIZE. * * To print or scan values of this type, use * %G_GSSIZE_MODIFIER and/or %G_GSSIZE_FORMAT. @@ -583,7 +583,7 @@ * G_GSSIZE_FORMAT: * * 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 */ @@ -605,8 +605,8 @@ * 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 * 32-bit architectures. - * Values of this type can range from #G_MINOFFSET to - * #G_MAXOFFSET. + * Values of this type can range from %G_MINOFFSET to + * %G_MAXOFFSET. * * To print or scan values of this type, use * %G_GOFFSET_MODIFIER and/or %G_GOFFSET_FORMAT. @@ -631,7 +631,7 @@ * * The platform dependent length modifier for conversion specifiers * 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 */ @@ -640,7 +640,7 @@ * G_GOFFSET_FORMAT: * * 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 */ @@ -652,7 +652,7 @@ * This macro is used to insert #goffset 64-bit integer literals * into the source code. * - * See also #G_GINT64_CONSTANT. + * See also G_GINT64_CONSTANT(). * * Since: 2.20 */ @@ -849,29 +849,29 @@ * G_BYTE_ORDER: * * The host byte order. - * This can be either #G_LITTLE_ENDIAN or #G_BIG_ENDIAN (support for - * #G_PDP_ENDIAN may be added in future.) + * This can be either %G_LITTLE_ENDIAN or %G_BIG_ENDIAN (support for + * %G_PDP_ENDIAN may be added in future.) */ /** * G_LITTLE_ENDIAN: * * Specifies one of the possible types of byte order. - * See #G_BYTE_ORDER. + * See %G_BYTE_ORDER. */ /** * G_BIG_ENDIAN: * * Specifies one of the possible types of byte order. - * See #G_BYTE_ORDER. + * See %G_BYTE_ORDER. */ /** * G_PDP_ENDIAN: * * 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 * @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 * versions always exist. * @@ -1857,7 +1857,7 @@ /** * 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" * around the header. */ @@ -1865,7 +1865,7 @@ /** * 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" * around the header. */ diff --git a/glib/gbookmarkfile.c b/glib/gbookmarkfile.c index 14536ec9b..51dfa23d3 100644 --- a/glib/gbookmarkfile.c +++ b/glib/gbookmarkfile.c @@ -2217,7 +2217,7 @@ g_bookmark_file_set_title (GBookmarkFile *bookmark, * If @uri is %NULL, the title of @bookmark is returned. * * 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 * URI cannot be found. @@ -2302,7 +2302,7 @@ g_bookmark_file_set_description (GBookmarkFile *bookmark, * Retrieves the description of the bookmark for @uri. * * 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 * 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. * * 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 - * @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 * 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. * * 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 - * @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. * @@ -2577,7 +2577,7 @@ g_bookmark_file_set_added_date_time (GBookmarkFile *bookmark, * Gets the time the bookmark for @uri was added to @bookmark * * 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 * @@ -2603,7 +2603,7 @@ g_bookmark_file_get_added (GBookmarkFile *bookmark, * Gets the time the bookmark for @uri was added to @bookmark * * 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 * @@ -2710,7 +2710,7 @@ g_bookmark_file_set_modified_date_time (GBookmarkFile *bookmark, * Gets the time when the bookmark for @uri was last modified. * * 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 * @@ -2736,7 +2736,7 @@ g_bookmark_file_get_modified (GBookmarkFile *bookmark, * Gets the time when the bookmark for @uri was last modified. * * 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 * @@ -2845,7 +2845,7 @@ g_bookmark_file_set_visited_date_time (GBookmarkFile *bookmark, * Gets the time the bookmark for @uri was last visited. * * 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. * @@ -2871,7 +2871,7 @@ g_bookmark_file_get_visited (GBookmarkFile *bookmark, * Gets the time the bookmark for @uri was last visited. * * 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 * @@ -2912,7 +2912,7 @@ g_bookmark_file_get_visited_date_time (GBookmarkFile *bookmark, * the bookmark for @uri belongs to. * * 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. * @@ -3007,9 +3007,9 @@ g_bookmark_file_add_group (GBookmarkFile *bookmark, * for @uri belongs to. * * 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 - * @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. * @@ -3124,7 +3124,7 @@ g_bookmark_file_set_groups (GBookmarkFile *bookmark, * Retrieves the list of group names of the bookmark for @uri. * * 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 * be %NULL. @@ -3274,10 +3274,10 @@ g_bookmark_file_add_application (GBookmarkFile *bookmark, * that have registered a bookmark for @uri inside @bookmark. * * 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 * 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. * @@ -3324,7 +3324,7 @@ g_bookmark_file_remove_application (GBookmarkFile *bookmark, * registered by application @name. * * 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 * @@ -3388,10 +3388,10 @@ g_bookmark_file_has_application (GBookmarkFile *bookmark, * * 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 - * @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 * 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. * * 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 * 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 * 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. * * 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. * * 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 * for @uri, %FALSE is returned and error is set to - * #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 + * %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 * set and %FALSE is returned. * * 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. * * 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 * for @uri, %FALSE is returned and error is set to - * #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 + * %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 * set and %FALSE is returned. * * Returns: %TRUE on success. @@ -3770,7 +3770,7 @@ g_bookmark_file_get_application_info (GBookmarkFile *bookmark, * bookmark for @uri. * * 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. * Use g_strfreev() to free it. @@ -3863,7 +3863,7 @@ g_bookmark_file_get_size (GBookmarkFile *bookmark) * %NULL, then the bookmark is removed. * * 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 * @@ -3980,7 +3980,7 @@ g_bookmark_file_set_icon (GBookmarkFile *bookmark, * Gets the icon of the bookmark for @uri. * * 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. * You should free the returned strings. diff --git a/glib/gconvert.c b/glib/gconvert.c index e51537881..052f019e2 100644 --- a/glib/gconvert.c +++ b/glib/gconvert.c @@ -354,7 +354,7 @@ close_converter (GIConv cd) * Even if the conversion was successful, this may be * less than @len if there were partial characters * 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 * input sequence. * @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 * less than @len if there were partial characters * 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 * input sequence. * @bytes_written: (out) (optional): the number of bytes stored in diff --git a/glib/gdate.c b/glib/gdate.c index 8759cb4cd..73a732df3 100644 --- a/glib/gdate.c +++ b/glib/gdate.c @@ -242,8 +242,8 @@ * @G_DATE_SATURDAY: Saturday * @G_DATE_SUNDAY: Sunday * - * Enumeration representing a day of the week; #G_DATE_MONDAY, - * #G_DATE_TUESDAY, etc. #G_DATE_BAD_WEEKDAY is an invalid weekday. + * Enumeration representing a day of the week; %G_DATE_MONDAY, + * %G_DATE_TUESDAY, etc. %G_DATE_BAD_WEEKDAY is an invalid weekday. */ /** diff --git a/glib/gerror.h b/glib/gerror.h index bc9c03a91..33e1d5aa5 100644 --- a/glib/gerror.h +++ b/glib/gerror.h @@ -31,7 +31,7 @@ G_BEGIN_DECLS /** * 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 * @message: human-readable informative error message * diff --git a/glib/gfileutils.c b/glib/gfileutils.c index 389414cd4..dbbd12011 100644 --- a/glib/gfileutils.c +++ b/glib/gfileutils.c @@ -1000,7 +1000,7 @@ get_contents_win32 (const gchar *filename, * 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 * %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, * @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. * * 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. * * Note that the name for the temporary file is constructed by appending up diff --git a/glib/giochannel.c b/glib/giochannel.c index e93c4b458..12ca051ad 100644 --- a/glib/giochannel.c +++ b/glib/giochannel.c @@ -593,7 +593,7 @@ g_io_channel_purge (GIOChannel *channel) * @condition: conditions to watch for * * 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. * * 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. * * Returns: the status of the operation: One of - * #G_IO_STATUS_NORMAL, #G_IO_STATUS_AGAIN, or - * #G_IO_STATUS_ERROR. + * %G_IO_STATUS_NORMAL, %G_IO_STATUS_AGAIN, or + * %G_IO_STATUS_ERROR. **/ GIOStatus g_io_channel_flush (GIOChannel *channel, diff --git a/glib/gkeyfile.c b/glib/gkeyfile.c index 05329543a..646097044 100644 --- a/glib/gkeyfile.c +++ b/glib/gkeyfile.c @@ -1647,7 +1647,7 @@ g_key_file_to_data (GKeyFile *key_file, * returned keys will be %NULL-terminated, so @length may * optionally be %NULL. In the event that the @group_name cannot * 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. * 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. * * 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 - * 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 @@ -1927,9 +1927,9 @@ g_key_file_set_value (GKeyFile *key_file, * like \s. * * 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 - * 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 * 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. * * 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 - * 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): * 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. * * 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 * 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. * * 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 * can be found then the untranslated values are returned. The * returned array is %NULL-terminated, so @length may optionally @@ -2496,9 +2496,9 @@ g_key_file_set_locale_string_list (GKeyFile *key_file, * boolean. * * 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 - * 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, * 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. * * 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 - * 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): * 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. * * 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 * 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 * 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. * * 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 * #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): * 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. * * 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 - * 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 * 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. * * 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 - * 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): * the values associated with the key as a list of doubles, or %NULL if the diff --git a/glib/glib-unix.c b/glib/glib-unix.c index 83726da73..fd799eaf7 100644 --- a/glib/glib-unix.c +++ b/glib/glib-unix.c @@ -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 * functions is designed for programs which explicitly target UNIX, * 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 * "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) * @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 * @handler: Callback * @user_data: Data for @handler diff --git a/glib/glib-unix.h b/glib/glib-unix.h index a5ea9a1c5..53f193b87 100644 --- a/glib/glib-unix.h +++ b/glib/glib-unix.h @@ -43,7 +43,7 @@ G_BEGIN_DECLS * * Error domain for API in the g_unix_ namespace. Note that there is no * 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(). * * It is expected that most code will not look at %errno from these APIs. diff --git a/glib/gmain.h b/glib/gmain.h index 22103414c..895814a9c 100644 --- a/glib/gmain.h +++ b/glib/gmain.h @@ -122,8 +122,8 @@ typedef struct _GSourceCallbackFuncs GSourceCallbackFuncs; * connected to a callback using g_source_set_callback(). The @dispatch * function should call the callback function with @user_data and whatever * additional parameters are needed for this type of event source. 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. + * return value of the @dispatch function should be %G_SOURCE_REMOVE if the + * source should be removed or %G_SOURCE_CONTINUE to keep it. * @finalize: Called when the source is finalized. At this point, the source * will have been destroyed, had its callback cleared, and have been removed * 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 * incompatible function types. * - * Returns: %FALSE if the source should be removed. #G_SOURCE_CONTINUE and - * #G_SOURCE_REMOVE are more memorable names for the return value. + * Returns: %FALSE if the source should be removed. %G_SOURCE_CONTINUE and + * %G_SOURCE_REMOVE are more memorable names for the return value. */ typedef gboolean (*GSourceFunc) (gpointer user_data); @@ -328,8 +328,8 @@ struct _GSourceFuncs * * Use this for high priority idle functions. * - * GTK+ uses #G_PRIORITY_HIGH_IDLE + 10 for resizing operations, - * and #G_PRIORITY_HIGH_IDLE + 20 for redrawing operations. (This is + * GTK+ uses %G_PRIORITY_HIGH_IDLE + 10 for resizing operations, + * and %G_PRIORITY_HIGH_IDLE + 20 for redrawing operations. (This is * done to ensure that any pending resizes are processed before any * pending redraws, so that widgets are not redrawn twice unnecessarily.) */ diff --git a/glib/gmappedfile.c b/glib/gmappedfile.c index 36e7ca5a8..fb42011b5 100644 --- a/glib/gmappedfile.c +++ b/glib/gmappedfile.c @@ -232,7 +232,7 @@ mapped_file_new_from_fd (int fd, * If @filename is the name of an empty, regular file, the function * will successfully return an empty #GMappedFile. In other cases of * 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 * with g_mapped_file_unref(), or %NULL if the mapping failed. diff --git a/glib/gmessages.c b/glib/gmessages.c index 9480384cf..008bf5c13 100644 --- a/glib/gmessages.c +++ b/glib/gmessages.c @@ -1820,7 +1820,7 @@ g_log_structured (const gchar *log_domain, * contain the text shown to the user. * * 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 * 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 diff --git a/glib/goption.c b/glib/goption.c index 50812ea35..6806013a2 100644 --- a/glib/goption.c +++ b/glib/goption.c @@ -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 * to add descriptions for "rest" arguments, which are not parsed by * 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 * using the @arg_description of the corresponding #GOptionEntry in * the usage summary. diff --git a/glib/goption.h b/glib/goption.h index 44815a77d..7e9c1a3f1 100644 --- a/glib/goption.h +++ b/glib/goption.h @@ -278,7 +278,7 @@ struct _GOptionEntry * 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 * necessary encoding conversions for strings or filenames. * diff --git a/glib/gqueue.c b/glib/gqueue.c index f7acb945a..d53af7ded 100644 --- a/glib/gqueue.c +++ b/glib/gqueue.c @@ -41,7 +41,7 @@ * * 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(). * * 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 * 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(). * * Since: 2.14 diff --git a/glib/gregex.c b/glib/gregex.c index a8a35a424..1aa8416ff 100644 --- a/glib/gregex.c +++ b/glib/gregex.c @@ -45,7 +45,7 @@ * Perl regular expression. * * 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. * 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 @@ -57,11 +57,11 @@ * it is able to look behind the starting point to discover that it is * 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 * 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 - * 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 * bytes and two characters long. * @@ -76,11 +76,11 @@ * The behaviour of the dot, circumflex, and dollar metacharacters are * affected by newline characters, the default is to recognize any newline * 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 - * compile options, and with #G_REGEX_MATCH_NEWLINE_ANY, - * #G_REGEX_MATCH_NEWLINE_CR, #G_REGEX_MATCH_NEWLINE_LF and - * #G_REGEX_MATCH_NEWLINE_CRLF match options. These settings are also - * relevant when compiling a pattern if #G_REGEX_EXTENDED is set, and an + * with %G_REGEX_NEWLINE_CR, %G_REGEX_NEWLINE_LF and %G_REGEX_NEWLINE_CRLF + * compile options, and with %G_REGEX_MATCH_NEWLINE_ANY, + * %G_REGEX_MATCH_NEWLINE_CR, %G_REGEX_MATCH_NEWLINE_LF and + * %G_REGEX_MATCH_NEWLINE_CRLF match options. These settings are also + * relevant when compiling a pattern if %G_REGEX_EXTENDED is set, and an * unescaped "#" outside a character class is encountered. This indicates * 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. * * 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 * g_regex_match() or g_regex_match_full() is, as usual, %TRUE * for a complete match, %FALSE otherwise. But, when these functions * return %FALSE, you can check if the match was partial calling * g_match_info_is_partial_match(). * - * The difference between #G_REGEX_MATCH_PARTIAL_SOFT and - * #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 - * possible complete match, while with #G_REGEX_MATCH_PARTIAL_HARD matching + * The difference between %G_REGEX_MATCH_PARTIAL_SOFT and + * %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 + * possible complete match, while with %G_REGEX_MATCH_PARTIAL_HARD matching * 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. * * 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 * 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(). * * 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. * * 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". * * 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. * * 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". * * 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". * * 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". * * 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(). * - * 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 * you can use g_regex_replace_literal(). * * 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". * * Returns: a newly allocated string containing the replacements @@ -2869,7 +2869,7 @@ literal_replacement (const GMatchInfo *match_info, * include backreferences use g_regex_replace(). * * 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 * assertion, such as "\b". * @@ -2912,7 +2912,7 @@ g_regex_replace_literal (const GRegex *regex, * @eval for that occurrence. * * 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". * * The following example uses g_regex_replace_eval() to replace multiple diff --git a/glib/gregex.h b/glib/gregex.h index 45e198df6..b982f6931 100644 --- a/glib/gregex.h +++ b/glib/gregex.h @@ -224,8 +224,8 @@ GQuark g_regex_error_quark (void); * newlines). The "start of line" metacharacter ("^") matches only * at the start of the string, while the "end of line" metacharacter * ("$") matches only at the end of the string, or before a terminating - * newline (unless #G_REGEX_DOLLAR_ENDONLY is set). When - * #G_REGEX_MULTILINE is set, the "start of line" and "end of line" + * newline (unless %G_REGEX_DOLLAR_ENDONLY is set). When + * %G_REGEX_MULTILINE is set, the "start of line" and "end of line" * constructs match immediately following or immediately before any * 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 @@ -248,7 +248,7 @@ GQuark g_regex_error_quark (void); * matches only at the end of the string. Without this option, a * dollar also matches immediately before the final character if * 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 * 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. @@ -324,14 +324,14 @@ typedef enum * metacharacter. * @G_REGEX_MATCH_NOTBOL: Specifies that first character of the string is * 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 * only the behaviour of the circumflex metacharacter, it does not * affect "\A". * @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 * 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 * the dollar metacharacter, it does not affect "\Z" or "\z". * @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), * U+0085 NEXT LINE (NEL), U+2028 LINE SEPARATOR and * 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 - * 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 * 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 * patterns this can only happen for pattern containing "\K". Since: 2.34 * diff --git a/glib/gscanner.c b/glib/gscanner.c index 9102b3a92..5f342183c 100644 --- a/glib/gscanner.c +++ b/glib/gscanner.c @@ -216,11 +216,11 @@ * by the scanner (the default is the whitespace characters: space, * tab, carriage-return and line-feed). * @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 * 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_LATINC). + * %G_CSET_a_2_z, "_0123456789", %G_CSET_A_2_Z, %G_CSET_LATINS, + * %G_CSET_LATINC). * @cpair_comment_single: specifies the characters at the start and * end of single-line comments. The default is "#\n" which means * 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 * quotes (the default is %TRUE). * @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 * (the default is %FALSE). * @identifier_2_string: specifies if identifiers are reported as strings diff --git a/glib/gspawn.c b/glib/gspawn.c index cce03f81d..0a2cbe54a 100644 --- a/glib/gspawn.c +++ b/glib/gspawn.c @@ -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 * `@argv[0]` is not found). Typically the `message` field of returned * 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, * and @stderr_pipe_out will not be filled with valid values. diff --git a/glib/gstdio.h b/glib/gstdio.h index 7ed9c5dfa..4af0efdb6 100644 --- a/glib/gstdio.h +++ b/glib/gstdio.h @@ -61,7 +61,7 @@ typedef struct stat GStatBuf; * 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. * - * #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. */ diff --git a/glib/gstrfuncs.c b/glib/gstrfuncs.c index 07d0dcd5a..927353309 100644 --- a/glib/gstrfuncs.c +++ b/glib/gstrfuncs.c @@ -906,7 +906,7 @@ g_ascii_strtod (const gchar *nptr, * the string back using g_ascii_strtod() gives the same machine-number * (on machines with IEEE compatible 64bit doubles). It is * 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. * * Returns: The pointer to the buffer with the converted string. @@ -2030,7 +2030,7 @@ g_strncasecmp (const gchar *s1, * g_strdelimit: * @string: the string to convert * @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 * * Converts any delimiter characters in @string to @new_delimiter. diff --git a/glib/gtimer.c b/glib/gtimer.c index 1e7cad4d7..c6a11409d 100644 --- a/glib/gtimer.c +++ b/glib/gtimer.c @@ -260,7 +260,7 @@ g_timer_is_active (GTimer *timer) * Pauses the current thread for the given number of microseconds. * * 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 * length of the sleep. */ diff --git a/gmodule/gmodule.c b/gmodule/gmodule.c index 4a4e279a1..c722c4427 100644 --- a/gmodule/gmodule.c +++ b/gmodule/gmodule.c @@ -477,7 +477,7 @@ static GRecMutex g_module_global_lock; * 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 * 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 * ".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 @@ -782,7 +782,7 @@ g_module_error (void) * @symbol: (out): returns the pointer to the symbol value * * 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 */ diff --git a/gobject/gboxed.c b/gobject/gboxed.c index c1624a598..4a2699257 100644 --- a/gobject/gboxed.c +++ b/gobject/gboxed.c @@ -286,7 +286,7 @@ boxed_proxy_lcopy_value (const GValue *value, * Boxed type handling functions have to be provided to copy and free * 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 * will create the appropriate `*_get_type()` function for the boxed type. * diff --git a/gobject/glib-types.h b/gobject/glib-types.h index 808284622..f0d33234a 100644 --- a/gobject/glib-types.h +++ b/gobject/glib-types.h @@ -44,7 +44,7 @@ typedef gsize GType; * 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 - * 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(). * * |[ diff --git a/gobject/gobject.c b/gobject/gobject.c index 64557eaa0..d33d8e5b0 100644 --- a/gobject/gobject.c +++ b/gobject/gobject.c @@ -1780,7 +1780,7 @@ g_object_get_type (void) * * 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 * private data for the object is guaranteed to be initialized with zeros, as * 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. * - * 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. * * 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. * - * 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. * * Returns: a new instance of @object_type diff --git a/gobject/gparam.c b/gobject/gparam.c index b3e4c671f..e9d9eacb0 100644 --- a/gobject/gparam.c +++ b/gobject/gparam.c @@ -421,7 +421,7 @@ g_param_spec_is_valid_name (const gchar *name) /** * 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 * @nick: the nickname 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. * * 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 * structure pointed to by @info to manage the #GParamSpec type and its diff --git a/gobject/gsignal.c b/gobject/gsignal.c index 7fd4ee92f..fb85fd6ba 100644 --- a/gobject/gsignal.c +++ b/gobject/gsignal.c @@ -1041,7 +1041,7 @@ signal_finalize_hook (GHookList *hook_list, * * 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 - * 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(). */ @@ -1458,7 +1458,7 @@ g_signal_query (guint signal_id, * @accu_data: (nullable) (closure accumulator): user data for the @accumulator. * @c_marshaller: (nullable): the function to translate arrays of parameter * 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. * @n_params: the number of parameter types to follow. * @...: 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. * @c_marshaller: (nullable): the function to translate arrays of parameter * 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. * @n_params: the number of parameter types to follow. * @...: 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 * parameter 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 * @n_params: the length of @param_types * @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. * @c_marshaller: (nullable): the function to translate arrays of parameter * 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. * @n_params: the number of parameter types in @args. * @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. * @...: parameters to be passed to the parent class closure, followed by a * 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 * only be called from an overridden class closure; see @@ -3254,7 +3254,7 @@ accumulate (GSignalInvocationHint *ihint, * @detail: the detail * @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 - * 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. * 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 * @...: parameters to be passed to the signal, followed by a * 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. * The method will only return control after all handlers are called or signal emission was stopped. diff --git a/gobject/gsignal.h b/gobject/gsignal.h index 7e83924f6..04f134434 100644 --- a/gobject/gsignal.h +++ b/gobject/gsignal.h @@ -65,7 +65,7 @@ typedef GVaClosureMarshal GSignalCVaMarshaller; * 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. * - * 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 * hook is disconnected (and destroyed). @@ -155,7 +155,7 @@ typedef enum #define G_SIGNAL_FLAGS_MASK 0x1ff /** * GConnectFlags: - * @G_CONNECT_AFTER: whether the handler should be called before or after the + * @G_CONNECT_AFTER: whether the handler should be called before or after the * default handler of the signal. * @G_CONNECT_SWAPPED: whether the instance and data should be swapped when * calling the handler; see g_signal_connect_swapped() for an example. diff --git a/gobject/gtype.c b/gobject/gtype.c index b19a306d9..cf213b760 100644 --- a/gobject/gtype.c +++ b/gobject/gtype.c @@ -2849,7 +2849,7 @@ g_type_register_static (GType parent_type, * instances (if not abstract). The value of @flags determines the nature * (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 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 * 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 - * 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 * will use the data size and actually register the private data, then * return the computed offset of the private data, which will be stored diff --git a/gobject/gtype.h b/gobject/gtype.h index eaebee42f..2aa5e1316 100644 --- a/gobject/gtype.h +++ b/gobject/gtype.h @@ -72,7 +72,7 @@ G_BEGIN_DECLS * * 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". */ #define G_TYPE_CHAR G_TYPE_MAKE_FUNDAMENTAL (3) @@ -654,7 +654,7 @@ struct _GTypeQuery * This macro should only be used in type implementations. * * 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 * Returns: (not nullable): a pointer to the private data structure */ @@ -1210,7 +1210,7 @@ struct _GInterfaceInfo * return NULL; * ]| * 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 * by the signal emission code, reference counts should always be * incremented for reference counted contents stored in the value->data @@ -1684,7 +1684,7 @@ guint g_type_get_type_registration_serial (void); * * A convenience macro for type implementations. * - * Similar to G_DEFINE_TYPE(), but allows you to insert custom code into the + * Similar to G_DEFINE_TYPE(), but allows you to insert custom code into the * `*_get_type()` function, e.g. interface implementations via G_IMPLEMENT_INTERFACE(). * See G_DEFINE_TYPE_EXTENDED() for an example. * @@ -1744,7 +1744,7 @@ guint g_type_get_type_registration_serial (void); * * Similar to G_DEFINE_TYPE_WITH_CODE(), but defines an abstract type and * allows you to insert custom code into the `*_get_type()` function, e.g. - * interface implementations via G_IMPLEMENT_INTERFACE(). + * interface implementations via G_IMPLEMENT_INTERFACE(). * * See G_DEFINE_TYPE_EXTENDED() for an example. * @@ -1793,7 +1793,7 @@ guint g_type_get_type_registration_serial (void); * * Similar to G_DEFINE_TYPE_WITH_CODE(), but defines a final type and * allows you to insert custom code into the `*_get_type()` function, e.g. - * interface implementations via G_IMPLEMENT_INTERFACE(). + * interface implementations via G_IMPLEMENT_INTERFACE(). * * See G_DEFINE_TYPE_EXTENDED() for an example. * @@ -2256,7 +2256,7 @@ type_name##_get_type (void) \ * 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. * * Since: 2.26 diff --git a/gobject/gvaluecollector.h b/gobject/gvaluecollector.h index 2714b36a7..82e675cdd 100644 --- a/gobject/gvaluecollector.h +++ b/gobject/gvaluecollector.h @@ -144,8 +144,8 @@ G_STMT_START { \ * `va_list` variables cannot be passed by reference. * * 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 - * #GValue. That variant is faster than #G_VALUE_COLLECT. + * you should use the G_VALUE_COLLECT_INIT() variant and pass the uninitialized + * #GValue. That variant is faster than G_VALUE_COLLECT(). */ #define G_VALUE_COLLECT(value, var_args, flags, __error) G_STMT_START { \ GValue *g_vc_value = (value); \ diff --git a/gobject/gvaluetypes.h b/gobject/gvaluetypes.h index df2f0aa99..f37504b3c 100644 --- a/gobject/gvaluetypes.h +++ b/gobject/gvaluetypes.h @@ -306,7 +306,7 @@ void g_value_set_string_take_ownership (GValue *value, /** * gchararray: * - * A C representable type name for #G_TYPE_STRING. + * A C representable type name for %G_TYPE_STRING. */ typedef gchar* gchararray; |