From b37c62746c7955546dad4df36e81336e02693b79 Mon Sep 17 00:00:00 2001 From: Pavel Holejsovsky Date: Wed, 31 Aug 2011 13:05:22 +0200 Subject: Regenerated GLib annotation cache Regenerated from glib fe4fc3e8b5a5ad8d4113c4df1fe8e0e9f295035e --- gir/gio-2.0.c | 414 +++++++++++++++++++++++++++++++++++++++++------------- gir/glib-2.0.c | 201 ++++++++++++++++++-------- gir/gobject-2.0.c | 43 ++++-- 3 files changed, 491 insertions(+), 167 deletions(-) diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c index 5fadde1a..51d32ddc 100644 --- a/gir/gio-2.0.c +++ b/gir/gio-2.0.c @@ -758,7 +758,7 @@ * GChildWatchFunc: * @pid: the process id of the child process * @status: Status information about the child process, see waitpid(2) for more information about this field - * @data: user data passed to g_child_watch_add() + * @user_data: user data passed to g_child_watch_add() * * The type of functions to be called when a child exists. */ @@ -3388,10 +3388,34 @@ */ +/** + * GIOModuleScope: + * + * Represents a scope for loading IO modules. A scope can be used for blocking + * duplicate modules, or blocking a module you don't want to load. + * + * The scope can be used with g_io_modules_load_all_in_directory_with_scope() + * or g_io_modules_scan_all_in_directory_with_scope(). + * + * Since: 2.30 + */ + + +/** + * GIOModuleScopeFlags: + * @G_IO_MODULES_SCOPE_NONE: No module scan flags + * @G_IO_MODULES_SCOPE_BLOCK_DUPLICATES: When using this scope to load or scan modules, automatically block a modules which has the same base basename as previously loaded module. + * + * Flags for use with g_io_module_scope_new(). + * + * Since: 2.30 + */ + + /** * GIOSchedulerJob: * - * Opaque class for definining and scheduling IO jobs. + * Opaque class for defining and scheduling IO jobs. */ @@ -5042,7 +5066,7 @@ * @user_data: user data passed to g_regex_replace_eval() * * Specifies the type of the function passed to g_regex_replace_eval(). - * It is called for each occurance of the pattern in the string passed + * It is called for each occurrence of the pattern in the string passed * to g_regex_replace_eval(), and it should append the replacement to * @result. * @@ -5140,7 +5164,7 @@ * * The default handler for this signal invokes the "changed" signal * for each affected key. If any other connected handler returns - * %TRUE then this default functionality will be supressed. + * %TRUE then this default functionality will be suppressed. */ @@ -5182,7 +5206,7 @@ * changes in writability might also imply changes in value (if for * example, a new mandatory setting is introduced). If any other * connected handler returns %TRUE then this default functionality - * will be supressed. + * will be suppressed. */ @@ -5803,7 +5827,7 @@ /** * GSourceFunc: - * @data: data passed to the function, set when the source was created with one of the above functions + * @user_data: data passed to the function, set when the source was created with one of the above functions * * Specifies the type of function passed to g_timeout_add(), * g_timeout_add_full(), g_idle_add(), and g_idle_add_full(). @@ -6499,8 +6523,24 @@ /** * GTlsInteractionClass: + * @ask_password: ask for a password synchronously. If the implementation returns %G_TLS_INTERACTION_HANDLED, then the password argument should have been filled in by using g_tls_password_set_value() or a similar function. + * @ask_password_async: ask for a password asynchronously. + * @ask_password_finish: complete operation to ask for a password asynchronously. If the implementation returns %G_TLS_INTERACTION_HANDLED, then the password argument of the async method should have been filled in by using g_tls_password_set_value() or a similar function. + * + * The class for #GTlsInteraction. Derived classes implement the various + * virtual interaction methods to handle TLS interactions. * - * The class for #GTlsInteraction. + * Derived classes can choose to implement whichever interactions methods they'd + * like to support by overriding those virtual methods in their class + * initialization function. If a derived class implements an async method, + * it must also implement the corresponding finish method. + * + * The synchronous interaction methods should implement to display modal dialogs, + * and the asynchronous methods to display modeless dialogs. + * + * If the user cancels an interaction, then the result should be + * %G_TLS_INTERACTION_FAILED and the error should be set with a domain of + * %G_IO_ERROR and code of %G_IO_ERROR_CANCELLED. * * Since: 2.30 */ @@ -6508,9 +6548,9 @@ /** * GTlsInteractionResult: - * @G_TLS_INTERACTION_HANDLED: The interaction completed, and resulting data is available. - * @G_TLS_INTERACTION_ABORTED: The user cancelled the interaction, and requested the operation to be aborted. * @G_TLS_INTERACTION_UNHANDLED: The interaction was unhandled (i.e. not implemented). + * @G_TLS_INTERACTION_HANDLED: The interaction completed, and resulting data is available. + * @G_TLS_INTERACTION_FAILED: The interaction has failed, or was cancelled. and the operation should be aborted. * * #GTlsInteractionResult is returned by various functions in #GTlsInteraction * when finishing an interaction request. @@ -7401,7 +7441,7 @@ * A #GWeakNotify function can be added to an object as a callback that gets * triggered when the object is finalized. Since the object is already being * finalized when the #GWeakNotify is called, there's not much you could do - * with the object, apart from e.g. using its adress as hash-index or the like. + * with the object, apart from e.g. using its address as hash-index or the like. */ @@ -10368,6 +10408,24 @@ */ +/** + * G_TYPE_MAIN_CONTEXT: + * + * The #GType for a boxed type holding a #GMainContext. + * + * Since: 2.30 + */ + + +/** + * G_TYPE_MAIN_LOOP: + * + * The #GType for a boxed type holding a #GMainLoop. + * + * Since: 2.30 + */ + + /** * G_TYPE_MAKE_FUNDAMENTAL: * @x: the fundamental type number. @@ -10641,6 +10699,15 @@ */ +/** + * G_TYPE_SOURCE: + * + * The #GType for a boxed type holding a #GSource. + * + * Since: 2.30 + */ + + /** * G_TYPE_STRING: * @@ -11409,6 +11476,14 @@ * see gio-querymodules. * You are expected to run this command after installing a * GIO module. + * + * The GIO_EXTRA_MODULES environment variable can be + * used to specify additional directories to automatically load modules + * from. This environment variable has the same syntax as the + * PATH. If two modules have the same base name in different + * directories, then the latter one will be ignored. If additional + * directories are specified GIO will load modules from the built-in + * directory last. */ @@ -12754,7 +12829,7 @@ * %G_FILE_ATTRIBUTE_TYPE_INVALID. * * The list of possible attributes for a filesystem (pointed to by a #GFile) is - * availible as a #GFileAttributeInfoList. This list is queryable by key names + * available as a #GFileAttributeInfoList. This list is queryable by key names * as indicated earlier. * * Classes that implement #GFileIface will create a #GFileAttributeInfoList and @@ -13975,7 +14050,7 @@ * * #GSimplePermission is a trivial implementation of #GPermission that * represents a permission that is either always or never allowed. The - * value is given at constuction and doesn't change. + * value is given at construction and doesn't change. * * Calling request or release will result in errors. */ @@ -14458,10 +14533,20 @@ * To use a #GTlsInteraction with a TLS connection use * g_tls_connection_set_interaction(). * - * Callers should instantiate a subclass of this that implements all the - * various callbacks to show the required dialogs, such as - * #GtkTlsInteraction. If no interaction is desired, usually %NULL can be - * passed, see each method taking a #GTlsInteraction for details. + * Callers should instantiate a derived class that implements the various + * interaction methods to show the required dialogs. + * + * Callers should use the 'invoke' functions like + * g_tls_interaction_invoke_ask_password() to run interaction methods. These + * functions make sure that the interaction is invoked in the main loop + * and not in the current thread, if the current thread is not running the + * main loop. + * + * Derived classes can choose to implement whichever interactions methods they'd + * like to support by overriding those virtual methods in their class + * initialization function. Any interactions not implemented will return + * %G_TLS_INTERACTION_UNHANDLED. If a derived class implements an async method, + * it must also implement the corresponding finish method. */ @@ -14826,7 +14911,7 @@ * * xfe 'b' 'a' 'z' x00 x00 x00 xff * - * The integer immediately preceeding the match then contains the offset + * The integer immediately preceding the match then contains the offset * of the integer value of the target. In our example, that's '3'. * This index is dereferenced to find the enum value of '2'. * @@ -14837,7 +14922,7 @@ * To lookup the enum nick for a given value, the value is searched for * in the array. To ensure that the value isn't matching the inside of a * string, we must check that it is either the first item in the array or - * immediately preceeded by the byte 0xff. It must also be immediately + * immediately preceded by the byte 0xff. It must also be immediately * followed by the byte 0xff. * * Because strings always take up a minimum of 2 words, because 0xff or @@ -15320,7 +15405,7 @@ * @commandline: the commandline to use * @application_name: (allow-none): the application name, or %NULL to use @commandline * @flags: flags that can specify details of the created #GAppInfo - * @error: a #GError location to store the error occuring, %NULL to ignore. + * @error: a #GError location to store the error occurring, %NULL to ignore. * * Creates a new #GAppInfo from the given information. * @@ -15872,7 +15957,7 @@ * Gets the platform data associated with the invocation of @cmdline. * * This is a #GVariant dictionary containing information about the - * context in which the invocation occured. It typically contains + * context in which the invocation occurred. It typically contains * information like the current working directory and the startup * notification ID. * @@ -16362,7 +16447,7 @@ * g_async_initable_init_finish: * @initable: a #GAsyncInitable. * @res: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes asynchronous initialization and returns the result. * See g_async_initable_init_async(). @@ -16481,7 +16566,7 @@ * @stream: a #GBufferedInputStream * @count: the number of bytes that will be read from the stream * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Tries to read @count bytes from the stream into the buffer. * Will block during this read. @@ -16620,7 +16705,7 @@ * g_buffered_input_stream_read_byte: * @stream: a #GBufferedInputStream * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Tries to read a single byte from the stream or the buffer. Will block * during this read. @@ -17146,7 +17231,7 @@ /** * g_cancellable_is_cancelled: - * @cancellable: a #GCancellable or NULL. + * @cancellable: (allow-none): a #GCancellable or %NULL * * Checks if a cancellable job has been cancelled. * @@ -17217,7 +17302,7 @@ * @cancellable: a #GCancellable object * * Pushes @cancellable onto the cancellable stack. The current - * cancellable can then be recieved using g_cancellable_get_current(). + * cancellable can then be received using g_cancellable_get_current(). * * This is useful when implementing cancellable operations in * code that does not allow you to pass down the cancellable object. @@ -17258,13 +17343,13 @@ /** * g_cancellable_set_error_if_cancelled: - * @cancellable: a #GCancellable object. - * @error: #GError to append error state to. + * @cancellable: (allow-none): a #GCancellable or %NULL + * @error: #GError to append error state to * * If the @cancellable is cancelled, sets the error to notify * that the operation was cancelled. * - * Returns: %TRUE if @cancellable was cancelled, %FALSE if it was not. + * Returns: %TRUE if @cancellable was cancelled, %FALSE if it was not */ @@ -17496,7 +17581,7 @@ * @flags: a #GConvertFlags controlling the conversion details * @bytes_read: (out): will be set to the number of bytes read from @inbuf on success * @bytes_written: (out): will be set to the number of bytes written to @outbuf on success - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * This is the main operation used when converting data. It is to be called * multiple times in a loop, and each time it will do some work, i.e. @@ -17560,7 +17645,7 @@ * If the flag %G_CONVERTER_FLUSH is set then conversion is modified * to try to write out all internal state to the output. The application * has to call the function multiple times with the flag set, and when - * the availible input has been consumed and all internal state has + * the available input has been consumed and all internal state has * been produced then %G_CONVERTER_FLUSHED (or %G_CONVERTER_FINISHED if * really at the end) is returned instead of %G_CONVERTER_CONVERTED. * This is somewhat similar to what happens at the end of the input stream, @@ -18208,7 +18293,7 @@ * * Note that using G_DATA_STREAM_NEWLINE_TYPE_ANY is slightly unsafe. If a read * chunk ends in "CR" we must read an additional byte to know if this is "CR" or - * "CR LF", and this might block if there is no more data availible. + * "CR LF", and this might block if there is no more data available. */ @@ -19322,7 +19407,7 @@ * Finishes an operation started with g_dbus_connection_send_message_with_reply(). * * Note that @error is only set if a local in-process error - * occured. That is to say that the returned #GDBusMessage object may + * occurred. That is to say that the returned #GDBusMessage object may * be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use * g_dbus_message_to_gerror() to transcode this to a #GError. * @@ -19363,7 +19448,7 @@ * the operation fails with %G_IO_ERROR_INVALID_ARGUMENT. * * Note that @error is only set if a local in-process error - * occured. That is to say that the returned #GDBusMessage object may + * occurred. That is to say that the returned #GDBusMessage object may * be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use * g_dbus_message_to_gerror() to transcode this to a #GError. * @@ -22580,7 +22665,7 @@ * g_drive_eject_with_operation_finish: * @drive: a #GDrive. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes ejecting a drive. If any errors occurred during the operation, * @error will be set to contain the errors and %FALSE will be returned. @@ -23592,7 +23677,7 @@ * g_file_enumerator_close: * @enumerator: a #GFileEnumerator. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Releases all resources used by this enumerator, making the * enumerator return %G_IO_ERROR_CLOSED on all calls. @@ -23626,7 +23711,7 @@ * g_file_enumerator_close_finish: * @enumerator: a #GFileEnumerator. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes closing a file enumerator, started from g_file_enumerator_close_async(). * @@ -23678,7 +23763,7 @@ * g_file_enumerator_next_file: * @enumerator: a #GFileEnumerator. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Returns information for the next file in the enumerated object. * Will block until the information is available. The #GFileInfo @@ -23727,7 +23812,7 @@ * g_file_enumerator_next_files_finish: * @enumerator: a #GFileEnumerator. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes the asynchronous operation started with g_file_enumerator_next_files_async(). * @@ -24016,7 +24101,7 @@ * @prefix: input #GFile. * * Checks whether @file has the prefix specified by @prefix. In other word, - * if the names of inital elements of @files pathname match @prefix. + * if the names of initial elements of @files pathname match @prefix. * Only full pathname elements are matched, so a path like /foo is not * considered a prefix of /foobar, only of /foo/bar. * @@ -24766,7 +24851,7 @@ * @stream: a #GFileInputStream. * @attributes: a file attribute query string. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Queries a file input stream the given @attributes. This function blocks * while querying the stream. For the asynchronous (non-blocking) version @@ -24805,7 +24890,7 @@ * g_file_input_stream_query_info_finish: * @stream: a #GFileInputStream. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes an asynchronous info query operation. * @@ -27061,7 +27146,7 @@ * g_initable_init: * @initable: a #GInitable. * @cancellable: optional #GCancellable object, %NULL to ignore. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Initializes the object implementing the interface. This must be * done before any real use of the object after initial construction. @@ -27094,7 +27179,7 @@ * g_initable_new: * @object_type: a #GType supporting #GInitable. * @cancellable: optional #GCancellable object, %NULL to ignore. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * @first_property_name: the name of the first property, or %NULL if no properties * @...: the value if the first property, followed by and other property value pairs, and ended by %NULL. * @@ -27113,7 +27198,7 @@ * @first_property_name: the name of the first property, followed by the value, and other property value pairs, and ended by %NULL. * @var_args: The var args list generated from @first_property_name. * @cancellable: optional #GCancellable object, %NULL to ignore. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Helper function for constructing #GInitiable object. This is * similar to g_object_new_valist() but also initializes the object @@ -27130,7 +27215,7 @@ * @n_parameters: the number of parameters in @parameters * @parameters: the parameters to use to construct the object * @cancellable: optional #GCancellable object, %NULL to ignore. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Helper function for constructing #GInitiable object. This is * similar to g_object_newv() but also initializes the object @@ -27153,7 +27238,7 @@ * g_input_stream_close: * @stream: A #GInputStream. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Closes the stream, releasing resources related to it. * @@ -27208,7 +27293,7 @@ * g_input_stream_close_finish: * @stream: a #GInputStream. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes closing a stream asynchronously, started from g_input_stream_close_async(). * @@ -27242,7 +27327,7 @@ * @buffer: a buffer to read data into (which should be at least count bytes long). * @count: the number of bytes that will be read from the stream * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Tries to read @count bytes from the stream into the buffer starting at * @buffer. Will block during this read. @@ -27274,7 +27359,7 @@ * @count: the number of bytes that will be read from the stream * @bytes_read: (out): location to store the number of bytes that was read from the stream * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Tries to read @count bytes from the stream into the buffer starting at * @buffer. Will block during this read. @@ -27334,7 +27419,7 @@ * g_input_stream_read_finish: * @stream: a #GInputStream. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes an asynchronous stream read operation. * @@ -27345,7 +27430,7 @@ /** * g_input_stream_set_pending: * @stream: input stream - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Sets @stream to have actions pending. If the pending flag is * already set or @stream is closed, it will return %FALSE and set @@ -27360,7 +27445,7 @@ * @stream: a #GInputStream. * @count: the number of bytes that will be skipped from the stream * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Tries to skip @count bytes from the stream. Will block during the operation. * @@ -27420,7 +27505,7 @@ * g_input_stream_skip_finish: * @stream: a #GInputStream. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes a stream skip operation. * @@ -27627,7 +27712,7 @@ * * This method will not be called in normal use, however it may be * called when probing existing modules and recording which extension - * points that this modle is used for. This means we won't have to + * points that this model is used for. This means we won't have to * load and initialze this module unless its needed. * * If this function is not implemented by the module the module will @@ -27651,6 +27736,45 @@ */ +/** + * g_io_module_scope_block: + * @scope: a module loading scope + * @basename: the basename to block + * + * Block modules with the given @basename from being loaded when + * this scope is used with g_io_modules_scan_all_in_directory_with_scope() + * or g_io_modules_load_all_in_directory_with_scope(). + * + * Since: 2.30 + */ + + +/** + * g_io_module_scope_free: + * @scope: a module loading scope + * + * Free a module scope. + * + * Since: 2.30 + */ + + +/** + * g_io_module_scope_new: + * @flags: flags for the new scope + * + * Create a new scope for loading of IO modules. A scope can be used for + * blocking duplicate modules, or blocking a module you don't want to load. + * + * Specify the %G_IO_MODULES_SCOPE_BLOCK_DUPLICATES flag to block modules + * which have the same base name as a module that has already been seen + * in this scope. + * + * Returns: (transfer full): the new module scope + * Since: 2.30 + */ + + /** * g_io_module_unload: * @module: a #GIOModule. @@ -27681,6 +27805,28 @@ */ +/** + * g_io_modules_load_all_in_directory_with_scope: + * @dirname: pathname for a directory containing modules to load. + * @scope: a scope to use when scanning the modules. + * + * Loads all the modules in the specified directory. + * + * If don't require all modules to be initialized (and thus registering + * all gtypes) then you can use g_io_modules_scan_all_in_directory() + * which allows delayed/lazy loading of modules. + * + * from the directory, + * All the modules are loaded into memory, if you want to + * unload them (enabling on-demand loading) you must call + * g_type_module_unuse() on all the modules. Free the list + * with g_list_free(). + * + * Returns: (element-type GIOModule) (transfer full): a list of #GIOModules loaded + * Since: 2.30 + */ + + /** * g_io_modules_scan_all_in_directory: * @dirname: pathname for a directory containing modules to scan. @@ -27701,6 +27847,27 @@ */ +/** + * g_io_modules_scan_all_in_directory_with_scope: + * @dirname: pathname for a directory containing modules to scan. + * @scope: a scope to use when scanning the modules + * + * Scans all the modules in the specified directory, ensuring that + * any extension point implemented by a module is registered. + * + * This may not actually load and initialize all the types in each + * module, some modules may be lazily loaded and initialized when + * an extension point it implementes is used with e.g. + * g_io_extension_point_get_extensions() or + * g_io_extension_point_get_extension_by_name(). + * + * If you need to guarantee that all types are loaded in all the modules, + * use g_io_modules_load_all_in_directory(). + * + * Since: 2.30 + */ + + /** * g_io_scheduler_cancel_all_jobs: * @@ -27778,7 +27945,7 @@ * g_io_stream_close: * @stream: a #GIOStream * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Closes the stream, releasing resources related to it. This will also * closes the individual input and output streams, if they are not already @@ -27846,7 +28013,7 @@ * g_io_stream_close_finish: * @stream: a #GIOStream * @result: a #GAsyncResult - * @error: a #GError location to store the error occuring, or %NULL to ignore + * @error: a #GError location to store the error occurring, or %NULL to ignore * * Closes a stream. * @@ -27908,7 +28075,7 @@ /** * g_io_stream_set_pending: * @stream: a #GIOStream - * @error: a #GError location to store the error occuring, or %NULL to ignore + * @error: a #GError location to store the error occurring, or %NULL to ignore * * Sets @stream to have actions pending. If the pending flag is * already set or @stream is closed, it will return %FALSE and set @@ -27944,7 +28111,7 @@ /** * g_io_stream_splice_finish: * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes an asynchronous io stream splice operation. * @@ -28013,7 +28180,7 @@ * @size: an integer. * @type: (out) (allow-none): a location to store the type of the loaded icon, %NULL to ignore. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Loads a loadable icon. For the asynchronous version of this function, * see g_loadable_icon_load_async(). @@ -28041,7 +28208,7 @@ * @icon: a #GLoadableIcon. * @res: a #GAsyncResult. * @type: a location to store the type of the loaded icon, %NULL to ignore. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes an asynchronous icon load started in g_loadable_icon_load_async(). * @@ -28324,7 +28491,7 @@ * g_mount_eject_finish: * @mount: a #GMount. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes ejecting a mount. If any errors occurred during the operation, * @error will be set to contain the errors and %FALSE will be returned. @@ -28355,7 +28522,7 @@ * g_mount_eject_with_operation_finish: * @mount: a #GMount. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes ejecting a mount. If any errors occurred during the operation, * @error will be set to contain the errors and %FALSE will be returned. @@ -28491,9 +28658,9 @@ * g_mount_guess_content_type_finish: * @mount: a #GMount * @result: a #GAsyncResult - * @error: a #GError location to store the error occuring, or %NULL to ignore + * @error: a #GError location to store the error occurring, or %NULL to ignore * - * Finishes guessing content types of @mount. If any errors occured + * Finishes guessing content types of @mount. If any errors occurred * during the operation, @error will be set to contain the errors and * %FALSE will be returned. In particular, you may get an * %G_IO_ERROR_NOT_SUPPORTED if the mount does not support content @@ -28511,7 +28678,7 @@ * @mount: a #GMount * @force_rescan: Whether to force a rescan of the content. Otherwise a cached result will be used if available * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore - * @error: a #GError location to store the error occuring, or %NULL to ignore + * @error: a #GError location to store the error occurring, or %NULL to ignore * * Tries to guess the type of content stored on @mount. Returns one or * more textual identifiers of well-known content types (typically @@ -28722,7 +28889,7 @@ * g_mount_remount_finish: * @mount: a #GMount. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes remounting a mount. If any errors occurred during the operation, * @error will be set to contain the errors and %FALSE will be returned. @@ -28764,7 +28931,7 @@ * g_mount_unmount_finish: * @mount: a #GMount. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes unmounting a mount. If any errors occurred during the operation, * @error will be set to contain the errors and %FALSE will be returned. @@ -28795,7 +28962,7 @@ * g_mount_unmount_with_operation_finish: * @mount: a #GMount. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes unmounting a mount. If any errors occurred during the operation, * @error will be set to contain the errors and %FALSE will be returned. @@ -29150,7 +29317,7 @@ * g_output_stream_close: * @stream: A #GOutputStream. * @cancellable: (allow-none): optional cancellable object - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Closes the stream, releasing resources related to it. * @@ -29211,7 +29378,7 @@ * g_output_stream_close_finish: * @stream: a #GOutputStream. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Closes an output stream. * @@ -29223,7 +29390,7 @@ * g_output_stream_flush: * @stream: a #GOutputStream. * @cancellable: (allow-none): optional cancellable object - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Flushed any outstanding buffers in the stream. Will block during * the operation. Closing the stream will implicitly cause a flush. @@ -29259,11 +29426,11 @@ * g_output_stream_flush_finish: * @stream: a #GOutputStream. * @result: a GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes flushing an output stream. * - * Returns: %TRUE if flush operation suceeded, %FALSE otherwise. + * Returns: %TRUE if flush operation succeeded, %FALSE otherwise. */ @@ -29304,7 +29471,7 @@ /** * g_output_stream_set_pending: * @stream: a #GOutputStream. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Sets @stream to have actions pending. If the pending flag is * already set or @stream is closed, it will return %FALSE and set @@ -29320,7 +29487,7 @@ * @source: a #GInputStream. * @flags: a set of #GOutputStreamSpliceFlags. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Splices an input stream into an output stream. * @@ -29357,7 +29524,7 @@ * g_output_stream_splice_finish: * @stream: a #GOutputStream. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes an asynchronous stream splice operation. * @@ -29375,7 +29542,7 @@ * @buffer: (array length=count) (element-type guint8): the buffer containing the data to write. * @count: the number of bytes to write * @cancellable: (allow-none): optional cancellable object - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Tries to write @count bytes from @buffer into the stream. Will block * during the operation. @@ -29409,7 +29576,7 @@ * @count: the number of bytes to write * @bytes_written: (out): location to store the number of bytes that was written to the stream * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: location to store the error occuring, or %NULL to ignore + * @error: location to store the error occurring, or %NULL to ignore * * Tries to write @count bytes from @buffer into the stream. Will block * during the operation. @@ -29475,7 +29642,7 @@ * g_output_stream_write_finish: * @stream: a #GOutputStream. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes a stream write operation. * @@ -30420,7 +30587,7 @@ * @offset: a #goffset. * @type: a #GSeekType. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Seeks in the stream by the given @offset, modified by @type. * @@ -30450,7 +30617,7 @@ * @seekable: a #GSeekable. * @offset: a #goffset. * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Truncates a stream with a given #offset. * @@ -30499,7 +30666,7 @@ * dispatching the signal later. * * The implementation may call this function at any other time it likes - * in response to other events (such as changes occuring outside of the + * in response to other events (such as changes occurring outside of the * program). These calls may originate from a mainloop or may originate * in response to any other action (including from calls to * g_settings_backend_write()). @@ -31354,7 +31521,7 @@ * @returns: %TRUE, if the set succeeds * * Looks up the flags type nicks for the bits specified by @value, puts - * them in an array of strings and writes the array to @key, withing + * them in an array of strings and writes the array to @key, within * @settings. * * It is a programmer error to give a @key that isn't contained in the @@ -32198,7 +32365,7 @@ * sockaddr, which can be passed to low-level functions like * connect() or bind(). * - * If not enough space is availible, a %G_IO_ERROR_NO_SPACE error is + * If not enough space is available, a %G_IO_ERROR_NO_SPACE error is * returned. If the address type is not known on the system * then a %G_IO_ERROR_NOT_SUPPORTED error is returned. * @@ -34041,7 +34208,7 @@ * * Shut down part of a full-duplex connection. * - * If @shutdown_read is %TRUE then the recieving side of the connection + * If @shutdown_read is %TRUE then the receiving side of the connection * is shut down, and further reading is disallowed. * * If @shutdown_write is %TRUE then the sending side of the connection @@ -35273,15 +35440,23 @@ * g_tls_interaction_ask_password: * @interaction: a #GTlsInteraction object * @password: a #GTlsPassword object + * @cancellable: an optional #GCancellable cancellation object + * @error: an optional location to place an error on failure * - * This function is normally called by #GTlsConnection or #GTlsDatabase to - * ask the user for a password. + * Run synchronous interaction to ask the user for a password. In general, + * g_tls_interaction_invoke_ask_password() should be used instead of this + * function. * * Derived subclasses usually implement a password prompt, although they may * also choose to provide a password from elsewhere. The @password value will * be filled in and then @callback will be called. Alternatively the user may * abort this password request, which will usually abort the TLS connection. * + * If the interaction is cancelled by the cancellation object, or by the + * user then %G_TLS_INTERACTION_FAILED will be returned with an error that + * contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may + * not support immediate cancellation. + * * Returns: The status of the ask password interaction. * Since: 2.30 */ @@ -35291,21 +35466,25 @@ * g_tls_interaction_ask_password_async: * @interaction: a #GTlsInteraction object * @password: a #GTlsPassword object - * @callback: will be called when the interaction completes + * @cancellable: an optional #GCancellable cancellation object + * @callback: (allow-none): will be called when the interaction completes * @user_data: (allow-none): data to pass to the @callback * - * This function is normally called by #GTlsConnection or #GTlsDatabase to - * ask the user for a password. + * Run asynchronous interaction to ask the user for a password. In general, + * g_tls_interaction_invoke_ask_password() should be used instead of this + * function. * * Derived subclasses usually implement a password prompt, although they may * also choose to provide a password from elsewhere. The @password value will * be filled in and then @callback will be called. Alternatively the user may * abort this password request, which will usually abort the TLS connection. * - * The @callback will be invoked on thread-default main context of the thread - * that called this function. The @callback should call - * g_tls_interaction_ask_password_finish() to get the status of the user - * interaction. + * If the interaction is cancelled by the cancellation object, or by the + * user then %G_TLS_INTERACTION_FAILED will be returned with an error that + * contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may + * not support immediate cancellation. + * + * Certain implementations may not support immediate cancellation. * * Since: 2.30 */ @@ -35315,13 +35494,50 @@ * g_tls_interaction_ask_password_finish: * @interaction: a #GTlsInteraction object * @result: the result passed to the callback + * @error: an optional location to place an error on failure * * Complete an ask password user interaction request. This should be once - * the g_tls_interaction_ask_password() completion callback is called. + * the g_tls_interaction_ask_password_async() completion callback is called. * * If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsPassword passed * to g_tls_interaction_ask_password() will have its password filled in. * + * If the interaction is cancelled by the cancellation object, or by the + * user then %G_TLS_INTERACTION_FAILED will be returned with an error that + * contains a %G_IO_ERROR_CANCELLED error code. + * + * Returns: The status of the ask password interaction. + * Since: 2.30 + */ + + +/** + * g_tls_interaction_invoke_ask_password: + * @interaction: a #GTlsInteraction object + * @password: a #GTlsPassword object + * @cancellable: an optional #GCancellable cancellation object + * @error: an optional location to place an error on failure + * + * Invoke the interaction to ask the user for a password. It invokes this + * interaction in the main loop, specifically the #GMainContext returned by + * g_main_context_get_thread_default() when the interaction is created. This + * is called by called by #GTlsConnection or #GTlsDatabase to ask the user + * for a password. + * + * Derived subclasses usually implement a password prompt, although they may + * also choose to provide a password from elsewhere. The @password value will + * be filled in and then @callback will be called. Alternatively the user may + * abort this password request, which will usually abort the TLS connection. + * + * The implementation can either be a synchronous (eg: modal dialog) or an + * asynchronous one (eg: modeless dialog). This function will take care of + * calling which ever one correctly. + * + * If the interaction is cancelled by the cancellation object, or by the + * user then %G_TLS_INTERACTION_FAILED will be returned with an error that + * contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may + * not support immediate cancellation. + * * Returns: The status of the ask password interaction. * Since: 2.30 */ @@ -36579,7 +36795,7 @@ * @result: a #GAsyncResult. * @error: a #GError location to store an error, or %NULL to ignore * - * Finishes ejecting a volume. If any errors occured during the operation, + * Finishes ejecting a volume. If any errors occurred during the operation, * @error will be set to contain the errors and %FALSE will be returned. * * Returns: %TRUE, %FALSE if operation failed. @@ -36608,7 +36824,7 @@ * g_volume_eject_with_operation_finish: * @volume: a #GVolume. * @result: a #GAsyncResult. - * @error: a #GError location to store the error occuring, or %NULL to ignore. + * @error: a #GError location to store the error occurring, or %NULL to ignore. * * Finishes ejecting a volume. If any errors occurred during the operation, * @error will be set to contain the errors and %FALSE will be returned. @@ -36782,7 +36998,7 @@ * blocks of a block device that is already represented by the native * volume monitor (for example a CD Audio file system driver). Such * a driver will generate its own #GMount object that needs to be - * assoicated with the #GVolume object that represents the volume. + * associated with the #GVolume object that represents the volume. * * The other is for implementing a #GVolumeMonitor whose sole purpose * is to return #GVolume objects representing entries in the users @@ -36899,7 +37115,7 @@ * @result: a #GAsyncResult * @error: a #GError location to store an error, or %NULL to ignore * - * Finishes mounting a volume. If any errors occured during the operation, + * Finishes mounting a volume. If any errors occurred during the operation, * @error will be set to contain the errors and %FALSE will be returned. * * If the mount operation succeeded, g_volume_get_mount() on @volume diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c index 15610c83..7f9b20e8 100644 --- a/gir/glib-2.0.c +++ b/gir/glib-2.0.c @@ -246,7 +246,7 @@ * GChildWatchFunc: * @pid: the process id of the child process * @status: Status information about the child process, see waitpid(2) for more information about this field - * @data: user data passed to g_child_watch_add() + * @user_data: user data passed to g_child_watch_add() * * The type of functions to be called when a child exists. */ @@ -2118,7 +2118,7 @@ * @user_data: user data passed to g_regex_replace_eval() * * Specifies the type of the function passed to g_regex_replace_eval(). - * It is called for each occurance of the pattern in the string passed + * It is called for each occurrence of the pattern in the string passed * to g_regex_replace_eval(), and it should append the replacement to * @result. * @@ -2351,7 +2351,7 @@ /** * GSourceFunc: - * @data: data passed to the function, set when the source was created with one of the above functions + * @user_data: data passed to the function, set when the source was created with one of the above functions * * Specifies the type of function passed to g_timeout_add(), * g_timeout_add_full(), g_idle_add(), and g_idle_add_full(). @@ -3565,7 +3565,7 @@ * A #GWeakNotify function can be added to an object as a callback that gets * triggered when the object is finalized. Since the object is already being * finalized when the #GWeakNotify is called, there's not much you could do - * with the object, apart from e.g. using its adress as hash-index or the like. + * with the object, apart from e.g. using its address as hash-index or the like. */ @@ -5779,6 +5779,24 @@ */ +/** + * G_TYPE_MAIN_CONTEXT: + * + * The #GType for a boxed type holding a #GMainContext. + * + * Since: 2.30 + */ + + +/** + * G_TYPE_MAIN_LOOP: + * + * The #GType for a boxed type holding a #GMainLoop. + * + * Since: 2.30 + */ + + /** * G_TYPE_MAKE_FUNDAMENTAL: * @x: the fundamental type number. @@ -6052,6 +6070,15 @@ */ +/** + * G_TYPE_SOURCE: + * + * The #GType for a boxed type holding a #GSource. + * + * Since: 2.30 + */ + + /** * G_TYPE_STRING: * @@ -8014,7 +8041,7 @@ * then although there are 9 individual values that comprise the * entire dictionary (two keys, two values, two variants containing * the values, two dictionary entries, plus the dictionary itself), - * only 1 #GVariant instance exists -- the one refering to the + * only 1 #GVariant instance exists -- the one referring to the * dictionary. * * @@ -9192,7 +9219,7 @@ * g_intern_static_string(). An interned string is a canonical * representation for a string. One important advantage of interned * strings is that they can be compared for equality by a simple - * pointer comparision, rather than using strcmp(). + * pointer comparison, rather than using strcmp(). */ @@ -12799,7 +12826,7 @@ * @from_codeset: character set of @str. * @bytes_read: (out): location to store the number of bytes in the input string that were successfully converted, or %NULL. 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 stored will the byte offset after the last valid input sequence. * @bytes_written: (out): the number of bytes stored in the output buffer (not including the terminating nul). - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. * * Converts a string from one character set to another. * @@ -12822,7 +12849,7 @@ * @fallback: UTF-8 string to use in place of character not present in the target encoding. (The string must be representable in the target encoding). * @bytes_read: location to store the number of bytes in the input string that were successfully converted, or %NULL. Even if the conversion was successful, this may be less than @len if there were partial characters at the end of the input. * @bytes_written: the number of bytes stored in the output buffer (not including the terminating nul). - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. * * Converts a string from one character set to another, possibly * including fallback sequences for characters not representable @@ -12849,7 +12876,7 @@ * @converter: conversion descriptor from g_iconv_open() * @bytes_read: location to store the number of bytes in the input string that were successfully converted, or %NULL. 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 stored will the byte offset after the last valid input sequence. * @bytes_written: the number of bytes stored in the output buffer (not including the terminating nul). - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. * * Converts a string from one character set to another. * @@ -13855,15 +13882,15 @@ * within a complete week (Monday to Sunday) is contained within the * same week-numbering year. * - * For Monday, Tuesday and Wednesday occuring near the end of the year, + * For Monday, Tuesday and Wednesday occurring near the end of the year, * this may mean that the week-numbering year is one greater than the * calendar year (so that these days have the same week-numbering year - * as the Thursday occuring early in the next year). + * as the Thursday occurring early in the next year). * - * For Friday, Saturaday and Sunday occuring near the start of the year, + * For Friday, Saturaday and Sunday occurring near the start of the year, * this may mean that the week-numbering year is one less than the * calendar year (so that these days have the same week-numbering year - * as the Thursday occuring late in the previous year). + * as the Thursday occurring late in the previous year). * * An equivalent description is that the week-numbering year is equal to * the calendar year containing the majority of the days in the current @@ -13891,7 +13918,7 @@ * that has more than 4 of its days falling within the calendar year. * * The value 0 is never returned by this function. Days contained - * within a year but occuring before the first ISO 8601 week of that + * within a year but occurring before the first ISO 8601 week of that * year are considered as being contained in the last week of the * previous year. Similarly, the final days of a calendar year may be * considered as being part of the first ISO 8601 week of the next year @@ -14174,6 +14201,46 @@ */ +/** + * g_date_time_source_new: + * @datetime: Time to await + * @cancel_on_set: Also invoke callback if the system clock changes discontiguously + * + * This function is designed for programs that want to schedule an + * event based on real (wall clock) time, as returned by + * g_get_real_time(). For example, HOUR:MINUTE wall-clock displays + * and calendaring software. The callback will be invoked when the + * specified wall clock time @datetime is reached. This includes + * events such as the system clock being set past the given time. + * + * Compare versus g_timeout_source_new() which is defined to use + * monotonic time as returned by g_get_monotonic_time(). + * + * If @cancel_on_set is given, the callback will also be invoked at + * most a second after the system clock is changed. This includes + * being set backwards or forwards, and system + * resume from suspend. Not all operating systems allow detecting all + * relevant events efficiently - this function may cause the process + * to wake up once a second in those cases. + * + * A wall clock display should use @cancel_on_set; a calendaring + * program shouldn't need to. + * + * Note that the return value from the associated callback will be + * ignored; this is a one time watch. + * + * This function currently does not detect time zone + * changes. On Linux, your program should also monitor the + * /etc/timezone file using + * #GFileMonitor. + * + * Clock exampleFIXME: MISSING XINCLUDE CONTENT + * + * Returns: A newly-constructed #GSource + * Since: 2.30 + */ + + /** * g_date_time_to_local: * @datetime: a #GDateTime @@ -14740,7 +14807,7 @@ * * * - * If the call was sucessful, it returns %TRUE. If the call was not successful, + * If the call was successful, it returns %TRUE. If the call was not successful, * it returns %FALSE and sets @error. The error domain is #G_FILE_ERROR. * Possible error codes are those in the #GFileError enumeration. * @@ -14862,7 +14929,7 @@ * g_filename_from_uri: * @uri: a uri describing a filename (escaped, encoded in ASCII). * @hostname: Location to store hostname for the URI, or %NULL. If there is no hostname in the URI, %NULL will be stored in this location. - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. * * Converts an escaped ASCII-encoded URI to a local filename in the * encoding used for filenames. @@ -14879,7 +14946,7 @@ * @len: the length of the string, or -1 if the string is nul-terminated. * @bytes_read: location to store the number of bytes in the input string that were successfully converted, or %NULL. 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 stored will the byte offset after the last valid input sequence. * @bytes_written: the number of bytes stored in the output buffer (not including the terminating nul). - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. * * Converts a string from UTF-8 to the encoding GLib uses for * filenames. Note that on Windows GLib uses UTF-8 for filenames; @@ -14894,7 +14961,7 @@ * g_filename_to_uri: * @filename: an absolute filename specified in the GLib file name encoding, which is the on-disk file name bytes on Unix, and UTF-8 on Windows * @hostname: (allow-none): A UTF-8 encoded hostname, or %NULL for none. - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. * * Converts an absolute filename to an escaped ASCII-encoded URI, with the path * component following Section 3.3. of RFC 2396. @@ -14911,7 +14978,7 @@ * @len: the length of the string, or -1 if the string is nul-terminated. * @bytes_read: location to store the number of bytes in the input string that were successfully converted, or %NULL. 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 stored will the byte offset after the last valid input sequence. * @bytes_written: the number of bytes stored in the output buffer (not including the terminating nul). - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. * * Converts a string which is in the encoding used by GLib for * filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8 @@ -16035,6 +16102,22 @@ */ +/** + * g_hmac_get_digest: + * @hmac: a #GHmac + * @buffer: output buffer + * @digest_len: an inout parameter. The caller initializes it to the size of @buffer. After the call it contains the length of the digest + * + * Gets the digest from @checksum as a raw binary array and places it + * into @buffer. The size of the digest depends on the type of checksum. + * + * Once this function has been called, the #GHmac is closed and can + * no longer be updated with g_checksum_update(). + * + * Since: 2.30 + */ + + /** * g_hmac_get_string: * @hmac: a #GHmac @@ -18337,7 +18420,7 @@ * @len: the length of the string, or -1 if the string is nul-terminated. * @bytes_read: location to store the number of bytes in the input string that were successfully converted, or %NULL. 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 stored will the byte offset after the last valid input sequence. * @bytes_written: the number of bytes stored in the output buffer (not including the terminating nul). - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. * * Converts a string from UTF-8 to the encoding used for strings by * the C runtime (usually the same as that used by the operating @@ -18354,7 +18437,7 @@ * @len: the length of the string, or -1 if the string is nul-terminated. * @bytes_read: location to store the number of bytes in the input string that were successfully converted, or %NULL. 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 stored will the byte offset after the last valid input sequence. * @bytes_written: the number of bytes stored in the output buffer (not including the terminating nul). - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError may occur. * * Converts a string which is in the encoding used for strings by * the C runtime (usually the same as that used by the operating @@ -18413,7 +18496,7 @@ * @priority: the priority for this file descriptor which should be the same as the priority used for g_source_attach() to ensure that the file descriptor is polled whenever the results may be needed. * * Adds a file descriptor to the set of file descriptors polled for - * this context. This will very seldomly be used directly. Instead + * this context. This will very seldom be used directly. Instead * a typical event source will use g_source_add_poll() instead. */ @@ -18422,7 +18505,7 @@ * g_main_context_check: * @context: a #GMainContext * @max_priority: the maximum numerical priority of sources to check - * @fds: array of #GPollFD's that was passed to the last call to g_main_context_query() + * @fds: (array length=n_fds): array of #GPollFD's that was passed to the last call to g_main_context_query() * @n_fds: return value of g_main_context_query() * * Passes the results of polling back to the main loop. @@ -18439,7 +18522,7 @@ * specified, and corresponds to the "main" main loop. See also * g_main_context_get_thread_default(). * - * Returns: the global default main context. + * Returns: (transfer none): the global default main context. */ @@ -18461,7 +18544,7 @@ * multiple sources exist with the same source function and user data, * the first one found will be returned. * - * Returns: the source, if one was found, otherwise %NULL + * Returns: (transfer none): the source, if one was found, otherwise %NULL */ @@ -18472,7 +18555,7 @@ * * Finds a #GSource given a pair of context and ID. * - * Returns: the #GSource if found, otherwise, %NULL + * Returns: (transfer none): the #GSource if found, otherwise, %NULL */ @@ -18485,7 +18568,7 @@ * multiple sources exist with the same user data, the first * one found will be returned. * - * Returns: the source, if one was found, otherwise %NULL + * Returns: (transfer none): the source, if one was found, otherwise %NULL */ @@ -18510,16 +18593,16 @@ * non-default context, so it is not safe to assume that this will * always return %NULL if threads are not initialized.) * - * thread-default context is the global default context. + * %NULL if the thread-default context is the global default context. * - * Returns: the thread-default #GMainContext, or %NULL if the + * Returns: (transfer none): the thread-default #GMainContext, or * Since: 2.22 */ /** * g_main_context_invoke: - * @context: a #GMainContext, or %NULL + * @context: (allow-none): a #GMainContext, or %NULL * @function: function to call * @data: data to pass to @function * @@ -18551,7 +18634,7 @@ /** * g_main_context_invoke_full: - * @context: a #GMainContext, or %NULL + * @context: (allow-none): a #GMainContext, or %NULL * @priority: the priority at which to run @function * @function: function to call * @data: data to pass to @function @@ -18692,8 +18775,8 @@ * g_main_context_query: * @context: a #GMainContext * @max_priority: maximum priority source to check - * @timeout_: location to store timeout to be used in polling - * @fds: location to store #GPollFD records that need to be polled. + * @timeout_: (out): location to store timeout to be used in polling + * @fds: (out caller-allocates) (array length=n_fds): location to store #GPollFD records that need to be polled. * @n_fds: length of @fds. * * Determines information necessary to poll this main loop. @@ -18791,7 +18874,7 @@ * * Returns the currently firing source for this thread. * - * Returns: The currently firing source or %NULL. + * Returns: (transfer none): The currently firing source or %NULL. * Since: 2.12 */ @@ -18952,7 +19035,7 @@ * * Returns the #GMainContext of @loop. * - * Returns: the #GMainContext of @loop + * Returns: (transfer none): the #GMainContext of @loop */ @@ -19616,7 +19699,7 @@ * g_match_info_expand_references: * @match_info: a #GMatchInfo or %NULL * @string_to_expand: the string to expand - * @error: location to store the error occuring, or %NULL to ignore errors + * @error: location to store the error occurring, or %NULL to ignore errors * * Returns a new string containing the text in @string_to_expand with * references and escape sequences expanded. References refer to the last @@ -19883,7 +19966,7 @@ /** * g_match_info_next: * @match_info: a #GMatchInfo structure - * @error: location to store the error occuring, or %NULL to ignore errors + * @error: location to store the error occurring, or %NULL to ignore errors * * Scans for the next match using the same parameters of the previous * call to g_regex_match_full() or g_regex_match() that returned @@ -23039,10 +23122,10 @@ * @start_position: starting index of the string to match * @match_options: match options * @match_info: (out) (allow-none): pointer to location where to store the #GMatchInfo, or %NULL if you do not need it - * @error: location to store the error occuring, or %NULL to ignore errors + * @error: location to store the error occurring, or %NULL to ignore errors * * Using the standard algorithm for regular expression matching only - * the longest match in the string is retrieved, it is not possibile + * the longest match in the string is retrieved, it is not possible * to obtain all the available matches. For instance matching * "<a> <b> <c>" against the pattern "<.*>" * you get "<a> <b> <c>". @@ -23091,7 +23174,7 @@ * @start_position: starting index of the string to match * @match_options: match options * @match_info: (out) (allow-none): pointer to location where to store the #GMatchInfo, or %NULL if you do not need it - * @error: location to store the error occuring, or %NULL to ignore errors + * @error: location to store the error occurring, or %NULL to ignore errors * * Scans for a match in string for the pattern in @regex. * The @match_options are combined with the match options specified @@ -23207,7 +23290,7 @@ * @start_position: starting index of the string to match * @replacement: text to replace each match with * @match_options: options for the match - * @error: location to store the error occuring, or %NULL to ignore errors + * @error: location to store the error occurring, or %NULL to ignore errors * * Replaces all occurrences of the pattern in @regex with the * replacement text. Backreferences of the form '\number' or @@ -23270,7 +23353,7 @@ * @match_options: options for the match * @eval: a function to call for each match * @user_data: user data to pass to the function - * @error: location to store the error occuring, or %NULL to ignore errors + * @error: location to store the error occurring, or %NULL to ignore errors * * Replaces occurrences of the pattern in regex with the output of * @eval for that occurrence. @@ -23331,7 +23414,7 @@ * @start_position: starting index of the string to match * @replacement: text to replace each match with * @match_options: options for the match - * @error: location to store the error occuring, or %NULL to ignore errors + * @error: location to store the error occurring, or %NULL to ignore errors * * Replaces all occurrences of the pattern in @regex with the * replacement text. @replacement is replaced literally, to @@ -25064,10 +25147,10 @@ * Gets the #GMainContext with which the source is associated. * Calling this function on a destroyed source is an error. * - * or %NULL if the context has not yet been added - * to a source. + * source is associated, or %NULL if the context has not + * yet been added to a source. * - * Returns: the #GMainContext with which the source is associated, + * Returns: (transfer none): the #GMainContext with which the */ @@ -27197,7 +27280,7 @@ * if the string is not completely converted it attempts the conversion * again with g_ascii_strtod(), and returns the best match. * - * This function should seldomly be used. The normal situation when reading + * This function should seldom be used. The normal situation when reading * numbers not for human consumption is to use g_ascii_strtod(). Only when * you know that you must expect both locale formatted and C formatted numbers * should you use this. Make sure that you don't pass strings such as comma @@ -28168,7 +28251,7 @@ * just in the order in which they were added to the pool. * * Note, if the maximum number of threads is more than 1, the order - * that threads are executed cannot be guranteed 100%. Threads are + * that threads are executed cannot be guaranteed 100%. Threads are * scheduled by the operating system and are executed at random. It * cannot be assumed that threads are executed in the order they are * created. @@ -28322,7 +28405,7 @@ * Otherwise @time_ is treated is local time. The distinction between * %G_TIME_TYPE_STANDARD and %G_TIME_TYPE_DAYLIGHT is ignored except in * the case that the given @time_ is ambiguous. In Toronto, for example, - * 01:30 on November 7th 2010 occured twice (once inside of daylight + * 01:30 on November 7th 2010 occurred twice (once inside of daylight * savings time and the next, an hour later, outside of daylight savings * time). In this case, the different value of @type would result in a * different interval being returned. @@ -29158,7 +29241,7 @@ * @len: the maximum length (number of characters) of @str to use. If @len < 0, then the string is nul-terminated. * @items_read: location to store number of bytes read, or %NULL. If an error occurs then the index of the invalid input is stored here. * @items_written: location to store number of gunichar2 written, or %NULL. The value stored here does not include the trailing 0. - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. * * Convert a string from UCS-4 to UTF-16. A 0 character will be * added to the result after the converted text. @@ -29177,7 +29260,7 @@ * @len: the maximum length (number of characters) of @str to use. If @len < 0, then the string is nul-terminated. * @items_read: location to store number of characters read, or %NULL. * @items_written: location to store number of bytes written or %NULL. The value here stored does not include the trailing 0 byte. - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. * * Convert a string from a 32-bit fixed width representation as UCS-4. * to UTF-8. The result will be terminated with a 0 byte. @@ -29781,12 +29864,10 @@ /** - * g_unix_signal_add_watch_full: + * g_unix_signal_add_full: * @signum: Signal number - * @priority: the priority of the signal source. Typically this will be in the range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH. * @handler: Callback * @user_data: Data for @handler - * @notify: #GDestroyNotify for @handler * * A convenience function for g_unix_signal_source_new(), which * attaches to the default #GMainContext. You can remove the watch @@ -29970,7 +30051,7 @@ * @len: the maximum length (number of gunichar2) of @str to use. If @len < 0, then the string is nul-terminated. * @items_read: location to store number of words read, or %NULL. If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will be returned in case @str contains a trailing partial character. If an error occurs then the index of the invalid input is stored here. * @items_written: location to store number of characters written, or %NULL. The value stored here does not include the trailing 0 character. - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. * * Convert a string from UTF-16 to UCS-4. The result will be * nul-terminated. @@ -29989,7 +30070,7 @@ * @len: the maximum length (number of gunichar2) of @str to use. If @len < 0, then the string is nul-terminated. * @items_read: location to store number of words read, or %NULL. If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will be returned in case @str contains a trailing partial character. If an error occurs then the index of the invalid input is stored here. * @items_written: location to store number of bytes written, or %NULL. The value stored here does not include the trailing 0 byte. - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. * * Convert a string from UTF-16 to UTF-8. The result will be * terminated with a 0 byte. @@ -30416,7 +30497,7 @@ * @len: the maximum length of @str to use, in bytes. If @len < 0, then the string is nul-terminated. * @items_read: location to store number of bytes read, or %NULL. If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will be returned in case @str contains a trailing partial character. If an error occurs then the index of the invalid input is stored here. * @items_written: location to store number of characters written or %NULL. The value here stored does not include the trailing 0 character. - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. * * Convert a string from UTF-8 to a 32-bit fixed width * representation as UCS-4. A trailing 0 character will be added to the @@ -30454,7 +30535,7 @@ * @len: the maximum length (number of bytes) of @str to use. If @len < 0, then the string is nul-terminated. * @items_read: location to store number of bytes read, or %NULL. If %NULL, then %G_CONVERT_ERROR_PARTIAL_INPUT will be returned in case @str contains a trailing partial character. If an error occurs then the index of the invalid input is stored here. * @items_written: location to store number of gunichar2 written, or %NULL. The value stored here does not include the trailing 0. - * @error: location to store the error occuring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. + * @error: location to store the error occurring, or %NULL to ignore errors. Any of the errors in #GConvertError other than %G_CONVERT_ERROR_NO_CONVERSION may occur. * * Convert a string from UTF-8 to UTF-16. A 0 character will be * added to the result after the converted text. @@ -32377,7 +32458,7 @@ * is returned. * * In case of any error, %NULL will be returned. If @error is non-%NULL - * then it will be set to reflect the error that occured. + * then it will be set to reflect the error that occurred. * * Officially, the language understood by the parser is "any string * produced by g_variant_print()". @@ -33327,7 +33408,7 @@ * on NT-based systems, so checking whether your are running on Win9x * in your own software is moot. The least significant byte is 4 on * Windows NT 4, and 5 on Windows XP. Software that needs really - * detailled version and feature information should use Win32 API like + * detailed version and feature information should use Win32 API like * GetVersionEx() and VerifyVersionInfo(). * * Returns: The version information. diff --git a/gir/gobject-2.0.c b/gir/gobject-2.0.c index d96bc46e..88bea8de 100644 --- a/gir/gobject-2.0.c +++ b/gir/gobject-2.0.c @@ -214,7 +214,7 @@ * GChildWatchFunc: * @pid: the process id of the child process * @status: Status information about the child process, see waitpid(2) for more information about this field - * @data: user data passed to g_child_watch_add() + * @user_data: user data passed to g_child_watch_add() * * The type of functions to be called when a child exists. */ @@ -1430,7 +1430,7 @@ * @user_data: user data passed to g_regex_replace_eval() * * Specifies the type of the function passed to g_regex_replace_eval(). - * It is called for each occurance of the pattern in the string passed + * It is called for each occurrence of the pattern in the string passed * to g_regex_replace_eval(), and it should append the replacement to * @result. * @@ -1594,7 +1594,7 @@ /** * GSourceFunc: - * @data: data passed to the function, set when the source was created with one of the above functions + * @user_data: data passed to the function, set when the source was created with one of the above functions * * Specifies the type of function passed to g_timeout_add(), * g_timeout_add_full(), g_idle_add(), and g_idle_add_full(). @@ -2310,7 +2310,7 @@ * A #GWeakNotify function can be added to an object as a callback that gets * triggered when the object is finalized. Since the object is already being * finalized when the #GWeakNotify is called, there's not much you could do - * with the object, apart from e.g. using its adress as hash-index or the like. + * with the object, apart from e.g. using its address as hash-index or the like. */ @@ -4303,6 +4303,24 @@ */ +/** + * G_TYPE_MAIN_CONTEXT: + * + * The #GType for a boxed type holding a #GMainContext. + * + * Since: 2.30 + */ + + +/** + * G_TYPE_MAIN_LOOP: + * + * The #GType for a boxed type holding a #GMainLoop. + * + * Since: 2.30 + */ + + /** * G_TYPE_MAKE_FUNDAMENTAL: * @x: the fundamental type number. @@ -4576,6 +4594,15 @@ */ +/** + * G_TYPE_SOURCE: + * + * The #GType for a boxed type holding a #GSource. + * + * Since: 2.30 + */ + + /** * G_TYPE_STRING: * @@ -6644,7 +6671,7 @@ * g_closure_sink() checks to see if the object is still floating, and * if so, unsets the floating state and decreases the reference * count. If the closure is not floating, g_closure_sink() does - * nothing. The reason for the existance of the floating state is to + * nothing. The reason for the existence of the floating state is to * prevent cumbersome code sequences like: * |[ * closure = g_cclosure_new (cb_func, cb_data); @@ -7491,7 +7518,7 @@ * * This function is intended for #GObject implementations to re-enforce a * floating object reference. - * Doing this is seldomly required: all + * Doing this is seldom required: all * #GInitiallyUnowneds are created with a floating reference which * usually just needs to be sunken by calling g_object_ref_sink(). * @@ -10696,7 +10723,7 @@ * @value_array: #GValueArray to sort * @compare_func: (scope call): function to compare elements * - * Sort @value_array using @compare_func to compare the elements accoring to + * Sort @value_array using @compare_func to compare the elements according to * the semantics of #GCompareFunc. * * The current implementation uses Quick-Sort as sorting algorithm. @@ -10711,7 +10738,7 @@ * @compare_func: (scope call): function to compare elements * @user_data: (closure): extra data argument provided for @compare_func * - * Sort @value_array using @compare_func to compare the elements accoring + * Sort @value_array using @compare_func to compare the elements according * to the semantics of #GCompareDataFunc. * * The current implementation uses Quick-Sort as sorting algorithm. -- cgit v1.2.1