diff options
-rw-r--r-- | gir/gio-2.0.c | 121 | ||||
-rw-r--r-- | gir/glib-2.0.c | 327 | ||||
-rw-r--r-- | gir/gmodule-2.0.c | 4 | ||||
-rw-r--r-- | gir/gobject-2.0.c | 30 |
4 files changed, 253 insertions, 229 deletions
diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c index 1631e112..cdb080f2 100644 --- a/gir/gio-2.0.c +++ b/gir/gio-2.0.c @@ -1952,7 +1952,7 @@ * 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. @@ -5286,7 +5286,7 @@ * The complete example can be found here: * [gapplication-example-cmdline.c](https://gitlab.gnome.org/GNOME/glib/-/blob/HEAD/gio/tests/gapplication-example-cmdline.c) * - * In more complicated cases, the handling of the comandline can be + * In more complicated cases, the handling of the commandline can be * split between the launcher and the primary instance. * |[<!-- language="C" --> * static gboolean @@ -5299,6 +5299,12 @@ * * argv = *arguments; * + * if (argv[0] == NULL) + * { + * *exit_status = 0; + * return FALSE; + * } + * * i = 1; * while (argv[i]) * { @@ -8546,7 +8552,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} * @@ -8638,7 +8644,7 @@ * 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 @@ -10484,13 +10490,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(). */ @@ -12312,10 +12318,6 @@ * consumed, they will no longer be visible to the default handling * (which treats them as filenames to be opened). * - * The dict includes options that have been explicitly specified on the parsed - * commandline, as well as zero values for numeric options that were not - * necessarily specified. - * * It is important to use the proper GVariant format when retrieving * the options with g_variant_dict_lookup(): * - for %G_OPTION_ARG_NONE, use `b` @@ -16843,7 +16845,7 @@ * #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 @@ -16902,7 +16904,7 @@ * * 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 @@ -16914,7 +16916,7 @@ * 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 @@ -17372,7 +17374,7 @@ * 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(). * @@ -17560,12 +17562,12 @@ * - `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). @@ -20536,7 +20538,7 @@ * * 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 * Since: 2.30 @@ -20987,7 +20989,7 @@ * * 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 @@ -21928,7 +21930,7 @@ * 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. * @@ -22238,14 +22240,14 @@ * 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). * @@ -22262,7 +22264,7 @@ * 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 @@ -22270,7 +22272,7 @@ * %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 @@ -22321,7 +22323,7 @@ * 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. * @@ -22354,7 +22356,7 @@ * 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. * @@ -22425,7 +22427,7 @@ * 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. * @@ -22688,7 +22690,7 @@ * "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. * @@ -22812,7 +22814,7 @@ * 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: @@ -24876,7 +24878,7 @@ * 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 @@ -24892,7 +24894,7 @@ * 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 @@ -24900,7 +24902,7 @@ * %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). * @@ -25244,7 +25246,7 @@ * 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 @@ -25370,7 +25372,7 @@ * 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 */ @@ -25397,9 +25399,9 @@ * 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 @@ -25477,7 +25479,7 @@ * "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 @@ -25486,7 +25488,7 @@ * * 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. @@ -25664,7 +25666,7 @@ * 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. * @@ -26171,7 +26173,7 @@ * 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(). * @@ -26232,7 +26234,7 @@ * @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. * @@ -26277,7 +26279,7 @@ * 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 @@ -26428,7 +26430,7 @@ * 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 @@ -27721,7 +27723,7 @@ * 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 */ @@ -32781,7 +32783,7 @@ * * 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 @@ -35116,7 +35118,7 @@ * @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. @@ -35396,7 +35398,7 @@ /** * 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. @@ -35410,7 +35412,7 @@ /** * 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. @@ -39692,7 +39694,7 @@ * * 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 @@ -39789,7 +39791,8 @@ * name of the #GSource used for idle completion of the task. * * This function may only be called before the @task is first used in a thread - * other than the one it was constructed in. + * other than the one it was constructed in. It is called automatically by + * g_task_set_source_tag() if not called already. * * Since: 2.60 */ @@ -39859,13 +39862,19 @@ * @task: the #GTask * @source_tag: an opaque pointer indicating the source of this task * - * Sets @task's source tag. You can use this to tag a task return + * Sets @task's source tag. + * + * You can use this to tag a task return * value with a particular pointer (usually a pointer to the function * doing the tagging) and then later check it using * g_task_get_source_tag() (or g_async_result_is_tagged()) in the * task's "finish" function, to figure out if the response came from a * particular place. * + * A macro wrapper around this function will automatically set the + * task’s name to the string form of @source_tag if it’s not already + * set, for convenience. + * * Since: 2.36 */ @@ -41440,7 +41449,7 @@ * 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/gir/glib-2.0.c b/gir/glib-2.0.c index f09b3de6..9d66e744 100644 --- a/gir/glib-2.0.c +++ b/gir/glib-2.0.c @@ -327,8 +327,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. */ @@ -1748,11 +1748,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 @@ -1788,7 +1788,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 @@ -2862,7 +2862,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. */ @@ -2872,7 +2872,7 @@ * G_BIG_ENDIAN: * * Specifies one of the possible types of byte order. - * See #G_BYTE_ORDER. + * See %G_BYTE_ORDER. */ @@ -2880,8 +2880,8 @@ * 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.) */ @@ -3111,7 +3111,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. */ @@ -3167,7 +3167,7 @@ * 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. */ @@ -3176,7 +3176,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 */ @@ -3195,7 +3195,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 @@ -3386,7 +3386,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 */ @@ -3396,7 +3396,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 */ @@ -3407,7 +3407,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 */ @@ -3417,7 +3417,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 */ @@ -3438,7 +3438,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 */ @@ -3459,7 +3459,7 @@ * 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 */ @@ -3467,7 +3467,7 @@ * 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. */ @@ -3486,7 +3486,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 @@ -3919,7 +3919,7 @@ * G_LITTLE_ENDIAN: * * Specifies one of the possible types of byte order. - * See #G_BYTE_ORDER. + * See %G_BYTE_ORDER. */ @@ -4328,7 +4328,7 @@ * G_PDP_ENDIAN: * * Specifies one of the possible types of byte order - * (currently unused). See #G_BYTE_ORDER. + * (currently unused). See %G_BYTE_ORDER. */ @@ -6150,7 +6150,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 @@ -6162,11 +6162,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. * @@ -6181,11 +6181,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. * @@ -6243,7 +6243,7 @@ * 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. @@ -7279,10 +7279,14 @@ * Each event source is assigned a priority. The default priority, * %G_PRIORITY_DEFAULT, is 0. Values less than 0 denote higher priorities. * Values greater than 0 denote lower priorities. Events from high priority - * sources are always processed before events from lower priority sources. + * sources are always processed before events from lower priority sources: if + * several sources are ready to dispatch, the ones with equal-highest priority + * will be dispatched on the current #GMainContext iteration, and the rest wait + * until a subsequent #GMainContext iteration when they have the highest + * priority of the sources which are ready for dispatch. * * Idle functions can also be added, and assigned a priority. These will - * be run whenever no events with a higher priority are ready to be processed. + * be run whenever no events with a higher priority are ready to be dispatched. * * The #GMainLoop data type represents a main event loop. A GMainLoop is * created with g_main_loop_new(). After adding the initial event sources, @@ -7699,7 +7703,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. * @@ -7946,7 +7950,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(), @@ -9722,7 +9726,7 @@ * 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. @@ -12156,7 +12160,7 @@ * 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 * Since: 2.12 @@ -12174,7 +12178,7 @@ * 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 * Since: 2.66 @@ -12198,11 +12202,11 @@ * 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. @@ -12229,11 +12233,11 @@ * 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. @@ -12252,7 +12256,7 @@ * 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. @@ -12269,7 +12273,7 @@ * 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. @@ -12287,7 +12291,7 @@ * 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. @@ -12309,7 +12313,7 @@ * 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. @@ -12326,9 +12330,9 @@ * 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. * Since: 2.12 @@ -12344,9 +12348,9 @@ * 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. @@ -12363,7 +12367,7 @@ * 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 * Since: 2.12 @@ -12381,7 +12385,7 @@ * 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 * Since: 2.66 @@ -12410,7 +12414,7 @@ * 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. @@ -12442,7 +12446,7 @@ * 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. * Since: 2.12 @@ -12460,7 +12464,7 @@ * 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 * Since: 2.66 @@ -12478,7 +12482,7 @@ * 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 * Since: 2.12 @@ -12496,7 +12500,7 @@ * 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. * Since: 2.12 @@ -12579,7 +12583,7 @@ * %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 * Since: 2.12 @@ -12611,10 +12615,10 @@ * 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. * Since: 2.12 @@ -12632,9 +12636,9 @@ * 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. * Since: 2.12 @@ -12717,10 +12721,10 @@ * * 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 @@ -12764,10 +12768,10 @@ * * 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 @@ -14256,7 +14260,7 @@ * 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 @@ -14350,7 +14354,7 @@ * 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 @@ -17019,7 +17023,7 @@ * 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. * @@ -17147,7 +17151,7 @@ * @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 @@ -19659,8 +19663,8 @@ * 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. */ @@ -20242,7 +20246,7 @@ * @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 @@ -20283,9 +20287,9 @@ * 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. @@ -20305,9 +20309,9 @@ * 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 @@ -20349,9 +20353,9 @@ * 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. @@ -20371,9 +20375,9 @@ * 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 @@ -20426,10 +20430,10 @@ * 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. @@ -20449,10 +20453,10 @@ * 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 @@ -20473,7 +20477,7 @@ * 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. @@ -20521,7 +20525,7 @@ * %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. * @@ -20549,7 +20553,7 @@ * %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 @@ -20585,9 +20589,9 @@ * 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. @@ -20606,9 +20610,9 @@ * 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 @@ -20645,9 +20649,9 @@ * 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 * key cannot be found. @@ -21863,8 +21867,8 @@ * other logging functions; it should only be used from %GLogWriterFunc * implementations. * - * Note also that the value of this does not depend on `G_MESSAGES_DEBUG`, as - * it is domain-dependent. + * Note also that the value of this does not depend on `G_MESSAGES_DEBUG`; see + * the docs for g_log_set_debug_enabled(). * * Returns: %TRUE if debug output is enabled, %FALSE otherwise * Since: 2.72 @@ -21914,9 +21918,9 @@ * g_log_set_debug_enabled: * @enabled: %TRUE to enable debug output, %FALSE otherwise * - * Enable or disable debug output from the GLib logging system is enabled. This - * value interacts disjunctively with `G_MESSAGES_DEBUG` — if either of them - * would allow a debug message to be outputted, it will be. + * Enable or disable debug output from the GLib logging system for all domains. + * This value interacts disjunctively with `G_MESSAGES_DEBUG` — if either of + * them would allow a debug message to be outputted, it will be. * * Note that this should not be used from within library code to enable debug * output — it is intended for external use. @@ -22192,7 +22196,7 @@ * 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 @@ -23274,7 +23278,7 @@ * 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. @@ -23763,7 +23767,7 @@ * 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 @@ -23982,19 +23986,19 @@ * 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. @@ -25092,7 +25096,7 @@ * 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. @@ -26766,7 +26770,7 @@ * * 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 @@ -28012,7 +28016,7 @@ * 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. @@ -28049,7 +28053,7 @@ * 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. @@ -28179,12 +28183,12 @@ * * 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 @@ -28207,7 +28211,7 @@ * @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 @@ -28269,7 +28273,7 @@ * 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". * @@ -28338,7 +28342,7 @@ * "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 @@ -29708,6 +29712,11 @@ * * Possible errors are those from the %G_SHELL_ERROR domain. * + * In particular, if @command_line is an empty string (or a string containing + * only whitespace), %G_SHELL_ERROR_EMPTY_STRING will be returned. It’s + * guaranteed that @argvp will be a non-empty array if this function returns + * successfully. + * * Free the returned vector with g_strfreev(). * * Returns: %TRUE on success, %FALSE if error set @@ -31288,7 +31297,8 @@ /** * g_spawn_async_with_fds: * @working_directory: (type filename) (nullable): child's current working directory, or %NULL to inherit parent's, in the GLib file name encoding - * @argv: (array zero-terminated=1): child's argument vector, in the GLib file name encoding + * @argv: (array zero-terminated=1): child's argument vector, in the GLib file name encoding; + * it must be non-empty and %NULL-terminated * @envp: (array zero-terminated=1) (nullable): child's environment, or %NULL to inherit parent's, in the GLib file name encoding * @flags: flags from #GSpawnFlags * @child_setup: (scope async) (nullable): function to run in the child just before exec() @@ -31314,7 +31324,7 @@ * @working_directory: (type filename) (nullable): child's current working * directory, or %NULL to inherit parent's, in the GLib file name encoding * @argv: (array zero-terminated=1) (element-type filename): child's argument - * vector, in the GLib file name encoding + * vector, in the GLib file name encoding; it must be non-empty and %NULL-terminated * @envp: (array zero-terminated=1) (element-type filename) (nullable): * child's environment, or %NULL to inherit parent's, in the GLib file * name encoding @@ -31339,7 +31349,7 @@ * @working_directory: (type filename) (nullable): child's current working * directory, or %NULL to inherit parent's, in the GLib file name encoding * @argv: (array zero-terminated=1) (element-type filename): child's argument - * vector, in the GLib file name encoding + * vector, in the GLib file name encoding; it must be non-empty and %NULL-terminated * @envp: (array zero-terminated=1) (element-type filename) (nullable): * child's environment, or %NULL to inherit parent's, in the GLib file * name encoding @@ -31519,7 +31529,7 @@ * 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. @@ -31704,7 +31714,7 @@ * @working_directory: (type filename) (nullable): child's current working * directory, or %NULL to inherit parent's * @argv: (array zero-terminated=1) (element-type filename): - * child's argument vector + * child's argument vector, which must be non-empty and %NULL-terminated * @envp: (array zero-terminated=1) (element-type filename) (nullable): * child's environment, or %NULL to inherit parent's * @flags: flags from #GSpawnFlags @@ -32135,7 +32145,7 @@ * 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. @@ -37163,7 +37173,7 @@ /** * 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 @@ -38063,7 +38073,7 @@ * 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. */ @@ -38165,6 +38175,10 @@ * compare the keys with strcmp() when sorting instead of sorting * the original strings. * + * If the two strings are not comparable due to being in different collation + * sequences, the result is undefined. This can happen if the strings are in + * different language scripts, for example. + * * Returns: < 0 if @str1 compares before @str2, * 0 if they compare equal, > 0 if @str1 compares after @str2. */ @@ -41802,7 +41816,8 @@ /** * g_vasprintf: - * @string: (not optional) (nullable): the return location for the newly-allocated string. + * @string: (not optional) (nullable): the return location for the newly-allocated string, + * which will be %NULL if (and only if) this function fails * @format: (not nullable): a standard printf() format string, but notice * [string precision pitfalls][string-precision] * @args: the list of arguments to insert in the output. @@ -41819,7 +41834,7 @@ * * `glib/gprintf.h` must be explicitly included in order to use this function. * - * Returns: the number of bytes printed. + * Returns: the number of bytes printed, or `-1` on failure * Since: 2.4 */ @@ -42437,7 +42452,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. */ @@ -42445,7 +42460,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. */ @@ -42453,7 +42468,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. */ @@ -42461,8 +42476,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. @@ -42473,8 +42488,8 @@ * 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. @@ -42485,8 +42500,8 @@ * 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 @@ -42498,8 +42513,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). */ @@ -42650,7 +42665,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. */ @@ -42661,8 +42676,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. @@ -42702,7 +42717,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. */ @@ -42714,7 +42729,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. @@ -42726,8 +42741,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. @@ -42745,7 +42760,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. */ @@ -42753,7 +42768,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. @@ -42764,7 +42779,7 @@ * 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. @@ -42775,7 +42790,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 @@ -42787,7 +42802,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). */ @@ -42808,7 +42823,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. */ @@ -42816,7 +42831,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. */ diff --git a/gir/gmodule-2.0.c b/gir/gmodule-2.0.c index 988a8b0f..4716aad2 100644 --- a/gir/gmodule-2.0.c +++ b/gir/gmodule-2.0.c @@ -250,7 +250,7 @@ * 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 @@ -277,7 +277,7 @@ * @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/gir/gobject-2.0.c b/gir/gobject-2.0.c index 950a9626..79eb8b78 100644 --- a/gir/gobject-2.0.c +++ b/gir/gobject-2.0.c @@ -1241,7 +1241,7 @@ * 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. * @@ -3333,7 +3333,7 @@ * * 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(). @@ -3372,7 +3372,7 @@ * * 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 @@ -3407,7 +3407,7 @@ * * 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 @@ -4191,7 +4191,7 @@ /** * 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 @@ -4633,7 +4633,7 @@ * @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 @@ -4779,7 +4779,7 @@ * * 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(). */ @@ -4805,7 +4805,7 @@ * 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 @@ -4893,7 +4893,7 @@ * @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. @@ -4928,7 +4928,7 @@ * @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. @@ -5395,7 +5395,7 @@ * @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. @@ -5444,7 +5444,7 @@ * @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. @@ -5484,7 +5484,7 @@ * @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. @@ -5515,7 +5515,7 @@ * @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 @@ -6607,7 +6607,7 @@ * 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 */ |