[glibmm] Updated the *docs.xml files.
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glibmm] Updated the *docs.xml files.
- Date: Wed, 13 Jun 2012 10:34:51 +0000 (UTC)
commit 53596ab1de401a084fffaf7cd181dd1663d14630
Author: Murray Cumming <murrayc murrayc com>
Date: Wed Jun 13 12:32:22 2012 +0200
Updated the *docs.xml files.
* gio/src/gio_docs.xml:
* glib/src/glib_docs.xml: Used the gen_scripts.
ChangeLog | 9 +-
gio/src/gio_docs.xml | 1174 ++++++++++++++++++++++++++++++++++++++++++++----
glib/src/glib_docs.xml | 156 ++++++--
3 files changed, 1221 insertions(+), 118 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 57c4b2f..2d1b639 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,6 +1,13 @@
2012-06-13 Murray Cumming <murrayc murrayc com>
- Update the methods .defs.
+ Updated the *docs.xml files.
+
+ * gio/src/gio_docs.xml:
+ * glib/src/glib_docs.xml: Used the gen_scripts.
+
+2012-06-13 Murray Cumming <murrayc murrayc com>
+
+ Updated the methods .defs.
* gio/src/gio_methods.defs:
* glib/src/glib_functions.defs:
diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml
index 494b5c7..ad03118 100644
--- a/gio/src/gio_docs.xml
+++ b/gio/src/gio_docs.xml
@@ -1593,6 +1593,28 @@ cancellable signal should not do something that can block.
<return></return>
</signal>
+<signal name="GDBusAuthObserver::allow-mechanism">
+<description>
+Emitted to check if @mechanism is allowed to be used.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="observer">
+<parameter_description> The #GDBusAuthObserver emitting the signal.
+</parameter_description>
+</parameter>
+<parameter name="mechanism">
+<parameter_description> The name of the mechanism, e.g. <literal>DBUS_COOKIE_SHA1</literal>.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @mechanism can be used to authenticate the other peer, %FALSE if not.
+
+</return>
+</signal>
+
<signal name="GDBusAuthObserver::authorize-authenticated-peer">
<description>
Emitted to check if a peer that is successfully authenticated
@@ -2146,7 +2168,7 @@ Since: 2.22
Emitted when @file has been changed.
If using #G_FILE_MONITOR_SEND_MOVED flag and @event_type is
-#G_FILE_MONITOR_SEND_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.
@@ -17190,6 +17212,12 @@ content types from a given @appinfo, %FALSE if not.
<description>
Creates a new #GAppInfo from the given information.
+Note that for @commandline, the quoting rules of the Exec key of the
+<ulink url="http://freedesktop.org/Standards/desktop-entry-spec">freedesktop.org Desktop
+Entry Specification</ulink> are applied. For example, if the @commandline contains
+percent-encoded URIs, the percent-character must be doubled in order to prevent it from
+being swallowed by Exec key unquoting. See the specification for exact quoting rules.
+
</description>
<parameters>
@@ -17528,6 +17556,30 @@ for given @content_type or %NULL on error.
</return>
</function>
+<function name="g_app_info_get_supported_types">
+<description>
+Retrieves the list of content types that @app_info claims to support.
+If this information is not provided by the environment, this function
+will return %NULL.
+This function does not take in consideration associations added with
+g_app_info_add_supports_type(), but only those exported directly by
+the application.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GAppInfo that can handle files
+</parameter_description>
+</parameter>
+</parameters>
+<return>
+a list of content types.
+
+</return>
+</function>
+
<function name="g_app_info_launch">
<description>
Launches the application. Passes @files to the launched application
@@ -18290,6 +18342,67 @@ Since: 2.28
</return>
</function>
+<function name="g_application_get_dbus_connection">
+<description>
+Gets the #GDBusConnection being used by the application, or %NULL.
+
+If #GApplication is using its D-Bus backend then this function will
+return the #GDBusConnection being used for uniqueness and
+communication with the desktop environment and other instances of the
+application.
+
+If #GApplication is not using D-Bus then this function will return
+%NULL. This includes the situation where the D-Bus backend would
+normally be in use but we were unable to connect to the bus.
+
+This function must not be called before the application has been
+registered. See g_application_get_is_registered().
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GDBusConnection, or %NULL
+
+</return>
+</function>
+
+<function name="g_application_get_dbus_object_path">
+<description>
+Gets the D-Bus object path being used by the application, or %NULL.
+
+If #GApplication is using its D-Bus backend then this function will
+return the D-Bus object path that #GApplication is using. If the
+application is the primary instance then there is an object published
+at this path. If the application is not the primary instance then
+the result of this function is undefined.
+
+If #GApplication is not using D-Bus then this function will return
+%NULL. This includes the situation where the D-Bus backend would
+normally be in use but we were unable to connect to the bus.
+
+This function must not be called before the application has been
+registered. See g_application_get_is_registered().
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="application">
+<parameter_description> a #GApplication
+</parameter_description>
+</parameter>
+</parameters>
+<return> the object path, or %NULL
+
+</return>
+</function>
+
<function name="g_application_get_default">
<description>
Returns the default #GApplication instance for this process.
@@ -18454,7 +18567,11 @@ Creates a new #GApplication instance.
This function calls g_type_init() for you.
-The application id must be valid. See g_application_id_is_valid().
+If non-%NULL, the application id must be valid. See
+g_application_id_is_valid().
+
+If no application ID is given then some features of #GApplication
+(most notably application uniqueness) will be disabled.
</description>
@@ -18547,6 +18664,9 @@ primary instance. This is implemented by attempting to acquire the
application identifier as a unique bus name on the session bus using
GDBus.
+If there is no application ID or if %G_APPLICATION_NON_UNIQUE was
+given, then this process will always become the primary instance.
+
Due to the internal architecture of GDBus, method calls can be
dispatched at any time (even if a main loop is not running). For
this reason, you must ensure that any object paths that you wish to
@@ -18556,7 +18676,8 @@ If the application has already been registered then %TRUE is
returned with no work performed.
The #GApplication::startup signal is emitted if registration succeeds
-and @application is the primary instance.
+and @application is the primary instance (including the non-unique
+case).
In the event of an error (such as @cancellable being cancelled, or a
failure to connect to the session bus), %FALSE is returned and @error
@@ -18732,7 +18853,8 @@ Sets the unique identifier for @application.
The application id can only be modified if @application has not yet
been registered.
-The application id must be valid. See g_application_id_is_valid().
+If non-%NULL, the application id must be valid. See
+g_application_id_is_valid().
Since: 2.28
@@ -22435,6 +22557,28 @@ Since: 2.26
<return></return>
</function>
+<function name="g_dbus_auth_observer_allow_mechanism">
+<description>
+Emits the #GDBusAuthObserver::allow-mechanism signal on @observer.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="observer">
+<parameter_description> A #GDBusAuthObserver.
+</parameter_description>
+</parameter>
+<parameter name="mechanism">
+<parameter_description> The name of the mechanism, e.g. <literal>DBUS_COOKIE_SHA1</literal>.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @mechanism can be used to authenticate the other peer, %FALSE if not.
+
+</return>
+</function>
+
<function name="g_dbus_auth_observer_authorize_authenticated_peer">
<description>
Emits the #GDBusAuthObserver::authorize-authenticated-peer signal on @observer.
@@ -23331,6 +23475,29 @@ Since: 2.26
</return>
</function>
+<function name="g_dbus_connection_get_last_serial">
+<description>
+Retrieves the last serial number assigned to a #GDBusMessage on
+the current thread. This includes messages sent via both low-level
+API such as g_dbus_connection_send_message() as well as
+high-level API such as g_dbus_connection_emit_signal(),
+g_dbus_connection_call() or g_dbus_proxy_call().
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="connection">
+<parameter_description> A #GDBusConnection.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the last used serial or zero when no message has been sent
+within the current thread.
+
+</return>
+</function>
+
<function name="g_dbus_connection_get_peer_credentials">
<description>
Gets the credentials of the authenticated peer. This will always
@@ -29222,6 +29389,27 @@ otherwise.
</return>
</function>
+<function name="g_desktop_app_info_get_startup_wm_class">
+<description>
+Retrieves the StartupWMClass field from @app_info. This represents the
+WM_CLASS property of the main window of the application, if launched through
+ app_info
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="app_info">
+<parameter_description> a #GDesktopAppInfo that supports startup notify
+</parameter_description>
+</parameter>
+</parameters>
+<return> the startup WM class, or %NULL if none is set
+in the desktop file.
+
+</return>
+</function>
+
<function name="g_desktop_app_info_launch_uris_as_manager">
<description>
This function performs the equivalent of g_app_info_launch_uris(),
@@ -37693,7 +37881,7 @@ operation will finish as much as possible. A stream that failed to
close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
is important to check and report the error to the user.
-If @cancellable is not NULL, then the operation can be cancelled by
+If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
Cancelling a close will still leave the stream closed, but some streams
@@ -37829,9 +38017,9 @@ It is not an error if this is not the same as the requested size, as it
can happen e.g. near the end of a file. Zero is returned on end of file
(or if @count is zero), but never otherwise.
-If @cancellable is not NULL, then the operation can be cancelled by
+If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
-was cancelled, the error G_IO_ERROR_CANCELLED will be returned. If an
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
operation was partially finished when the operation was cancelled the
partial result will be returned, without an error.
@@ -37861,7 +38049,7 @@ On error -1 is returned and @error is set accordingly.
</parameter_description>
</parameter>
</parameters>
-<return> Number of bytes read, or -1 on error
+<return> Number of bytes read, or -1 on error, or 0 on end of file.
</return>
</function>
@@ -37974,6 +38162,136 @@ of the request.
<return></return>
</function>
+<function name="g_input_stream_read_bytes">
+<description>
+Like g_input_stream_read(), this tries to read @count bytes from
+the stream in a blocking fashion. However, rather than reading into
+a user-supplied buffer, this will create a new #GBytes containing
+the data that was read. This may be easier to use from language
+bindings.
+
+If count is zero, returns a zero-length #GBytes and does nothing. A
+value of @count larger than %G_MAXSSIZE will cause a
+%G_IO_ERROR_INVALID_ARGUMENT error.
+
+On success, a new #GBytes is returned. It is not an error if the
+size of this object is not the same as the requested size, as it
+can happen e.g. near the end of a file. A zero-length #GBytes is
+returned on end of file (or if @count is zero), but never
+otherwise.
+
+If @cancellable is not %NULL, then the operation can be cancelled by
+triggering the cancellable object from another thread. If the operation
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
+operation was partially finished when the operation was cancelled the
+partial result will be returned, without an error.
+
+On error %NULL is returned and @error is set accordingly.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> maximum number of bytes that will be read from the stream. Common
+values include 4096 and 8192.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GBytes, or %NULL on error
+</return>
+</function>
+
+<function name="g_input_stream_read_bytes_async">
+<description>
+Request an asynchronous read of @count bytes from the stream into a
+new #GBytes. When the operation is finished @callback will be
+called. You can then call g_input_stream_read_bytes_finish() to get the
+result of the operation.
+
+During an async request no other sync and async calls are allowed
+on @stream, and will result in %G_IO_ERROR_PENDING errors.
+
+A value of @count larger than %G_MAXSSIZE will cause a
+%G_IO_ERROR_INVALID_ARGUMENT error.
+
+On success, the new #GBytes will be passed to the callback. It is
+not an error if this is smaller than the requested size, as it can
+happen e.g. near the end of a file, but generally we try to read as
+many bytes as requested. Zero is returned on end of file (or if
+ count is zero), but never otherwise.
+
+Any outstanding I/O request with higher priority (lower numerical
+value) will be executed before an outstanding request with lower
+priority. Default priority is %G_PRIORITY_DEFAULT.
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes that will be read from the stream
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the <link linkend="io-priority">I/O priority</link>
+of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_input_stream_read_bytes_finish">
+<description>
+Finishes an asynchronous stream read-into-#GBytes operation.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GInputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly-allocated #GBytes, or %NULL on error
+</return>
+</function>
+
<function name="g_input_stream_read_finish">
<description>
Finishes an asynchronous stream read operation.
@@ -37995,7 +38313,7 @@ ignore.
</parameter_description>
</parameter>
</parameters>
-<return> number of bytes read in, or -1 on error.
+<return> number of bytes read in, or -1 on error, or 0 on end of file.
</return>
</function>
@@ -39198,6 +39516,26 @@ Returns a new #GVfs handle for a local vfs.
</return>
</function>
+<function name="g_memory_input_stream_add_bytes">
+<description>
+Appends @bytes to data that can be read from the input stream.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GMemoryInputStream
+</parameter_description>
+</parameter>
+<parameter name="bytes">
+<parameter_description> input data
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_memory_input_stream_add_data">
<description>
Appends @data to data that can be read from the input stream
@@ -39236,6 +39574,23 @@ Creates a new empty #GMemoryInputStream.
</return>
</function>
+<function name="g_memory_input_stream_new_from_bytes">
+<description>
+Creates a new #GMemoryInputStream with data from the given @bytes.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="bytes">
+<parameter_description> a #GBytes
+</parameter_description>
+</parameter>
+</parameters>
+<return> new #GInputStream read from @bytes
+</return>
+</function>
+
<function name="g_memory_input_stream_new_from_data">
<description>
Creates a new #GMemoryInputStream with data in memory of a given size.
@@ -39372,6 +39727,25 @@ finalized, or %NULL
</return>
</function>
+<function name="g_memory_output_stream_steal_as_bytes">
+<description>
+Returns data from the @ostream as a #GBytes. @ostream must be
+closed before calling this function.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="ostream">
+<parameter_description> a #GMemoryOutputStream
+</parameter_description>
+</parameter>
+</parameters>
+<return> the stream's data
+
+</return>
+</function>
+
<function name="g_memory_output_stream_steal_data">
<description>
Gets any loaded data from the @ostream. Ownership of the data
@@ -39416,7 +39790,7 @@ Since: 2.28
<function name="g_menu_append">
<description>
Convenience function for appending a normal menu item to the end of
- menu Combine g_menu_new() and g_menu_insert_item() for a more
+ menu Combine g_menu_item_new() and g_menu_insert_item() for a more
flexible alternative.
Since: 2.32
@@ -39647,7 +40021,7 @@ Since: 2.32
<function name="g_menu_insert">
<description>
Convenience function for inserting a normal menu item into @menu.
-Combine g_menu_new() and g_menu_insert_item() for a more flexible
+Combine g_menu_item_new() and g_menu_insert_item() for a more flexible
alternative.
Since: 2.32
@@ -40616,7 +40990,7 @@ Since: 2.32
<function name="g_menu_prepend">
<description>
Convenience function for prepending a normal menu item to the start
-of @menu. Combine g_menu_new() and g_menu_insert_item() for a more
+of @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more
flexible alternative.
Since: 2.32
@@ -42224,7 +42598,7 @@ close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
is important to check and report the error to the user, otherwise
there might be a loss of data as all data might not be written.
-If @cancellable is not NULL, then the operation can be cancelled by
+If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
Cancelling a close will still leave the stream closed, but there some streams
@@ -42609,7 +42983,7 @@ storage in the stream. All writes block until at least one byte
is written or an error occurs; 0 is never returned (unless
@count is 0).
-If @cancellable is not NULL, then the operation can be cancelled by
+If @cancellable is not %NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
operation was partially finished when the operation was cancelled the
@@ -42658,7 +43032,7 @@ write as many bytes as requested, only stopping on an error.
On a successful write of @count bytes, %TRUE is returned, and @bytes_written
is set to @count.
-If there is an error during the operation FALSE is returned and @error
+If there is an error during the operation %FALSE is returned and @error
is set to indicate the error status, @bytes_written is updated to contain
the number of bytes written into the stream before the error occurred.
@@ -42762,6 +43136,137 @@ g_output_stream_write().
<return></return>
</function>
+<function name="g_output_stream_write_bytes">
+<description>
+Tries to write the data from @bytes into the stream. Will block
+during the operation.
+
+If @bytes is 0-length, returns 0 and does nothing. A #GBytes larger
+than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
+
+On success, the number of bytes written to the stream is returned.
+It is not an error if this is not the same as the requested size, as it
+can happen e.g. on a partial I/O error, or if there is not enough
+storage in the stream. All writes block until at least one byte
+is written or an error occurs; 0 is never returned (unless
+the size of @bytes is 0).
+
+If @cancellable is not %NULL, then the operation can be cancelled by
+triggering the cancellable object from another thread. If the operation
+was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
+operation was partially finished when the operation was cancelled the
+partial result will be returned, without an error.
+
+On error -1 is returned and @error is set accordingly.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="bytes">
+<parameter_description> the #GBytes to write
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional cancellable object
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> Number of bytes written, or -1 on error
+</return>
+</function>
+
+<function name="g_output_stream_write_bytes_async">
+<description>
+Request an asynchronous write of the data in @bytes to the stream.
+When the operation is finished @callback will be called. You can
+then call g_output_stream_write_bytes_finish() to get the result of
+the operation.
+
+During an async request no other sync and async calls are allowed,
+and will result in %G_IO_ERROR_PENDING errors.
+
+A #GBytes larger than %G_MAXSSIZE will cause a
+%G_IO_ERROR_INVALID_ARGUMENT error.
+
+On success, the number of bytes written will be passed to the
+ callback It is not an error if this is not the same as the
+requested size, as it can happen e.g. on a partial I/O error,
+but generally we try to write as many bytes as requested.
+
+You are guaranteed that this method will never fail with
+%G_IO_ERROR_WOULD_BLOCK - if @stream can't accept more data, the
+method will just wait until this changes.
+
+Any outstanding I/O request with higher priority (lower numerical
+value) will be executed before an outstanding request with lower
+priority. Default priority is %G_PRIORITY_DEFAULT.
+
+For the synchronous, blocking version of this function, see
+g_output_stream_write_bytes().
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> A #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="bytes">
+<parameter_description> The bytes to write
+</parameter_description>
+</parameter>
+<parameter name="io_priority">
+<parameter_description> the io priority of the request.
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call when the request is satisfied
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_output_stream_write_bytes_finish">
+<description>
+Finishes a stream write-from-#GBytes operation.
+
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> a #GAsyncResult.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a #GError location to store the error occurring, or %NULL to
+ignore.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #gssize containing the number of bytes written to the stream.
+</return>
+</function>
+
<function name="g_output_stream_write_finish">
<description>
Finishes a stream write operation.
@@ -43180,7 +43685,7 @@ next attempt to read will return the error.
<function name="g_pollable_input_stream_read_nonblocking">
<description>
-Attempts to read up to @size bytes from @stream into @buffer, as
+Attempts to read up to @count bytes from @stream into @buffer, as
with g_input_stream_read(). If @stream is not currently readable,
this will immediately return %G_IO_ERROR_WOULD_BLOCK, and you can
use g_pollable_input_stream_create_source() to create a #GSource
@@ -43201,11 +43706,11 @@ Virtual: read_nonblocking
</parameter_description>
</parameter>
<parameter name="buffer">
-<parameter_description> a buffer to read data into (which should be at least @size
+<parameter_description> a buffer to read data into (which should be at least @count
bytes long).
</parameter_description>
</parameter>
-<parameter name="size">
+<parameter name="count">
<parameter_description> the number of bytes you want to read
</parameter_description>
</parameter>
@@ -43306,7 +43811,7 @@ next attempt to write will return the error.
<function name="g_pollable_output_stream_write_nonblocking">
<description>
-Attempts to write up to @size bytes from @buffer to @stream, as
+Attempts to write up to @count bytes from @buffer to @stream, as
with g_output_stream_write(). If @stream is not currently writable,
this will immediately return %G_IO_ERROR_WOULD_BLOCK, and you can
use g_pollable_output_stream_create_source() to create a #GSource
@@ -43331,7 +43836,7 @@ Virtual: write_nonblocking
data from
</parameter_description>
</parameter>
-<parameter name="size">
+<parameter name="count">
<parameter_description> the number of bytes you want to write
</parameter_description>
</parameter>
@@ -43371,9 +43876,196 @@ Since: 2.28
</return>
</function>
+<function name="g_pollable_source_new_full">
+<description>
+Utility method for #GPollableInputStream and #GPollableOutputStream
+implementations. Creates a new #GSource, as with
+g_pollable_source_new(), but also attaching @child_source (with a
+dummy callback), and @cancellable, if they are non-%NULL.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="pollable_stream">
+<parameter_description> the stream associated with the
+new source
+</parameter_description>
+</parameter>
+<parameter name="child_source">
+<parameter_description> optional child source to attach
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable to attach
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new #GSource.
+
+</return>
+</function>
+
+<function name="g_pollable_stream_read">
+<description>
+Tries to read from @stream, as with g_input_stream_read() (if
+ blocking is %TRUE) or g_pollable_input_stream_read_nonblocking()
+(if @blocking is %FALSE). This can be used to more easily share
+code between blocking and non-blocking implementations of a method.
+
+If @blocking is %FALSE, then @stream must be a
+#GPollableInputStream for which g_pollable_input_stream_can_poll()
+returns %TRUE, or else the behavior is undefined. If @blocking is
+%TRUE, then @stream does not need to be a #GPollableInputStream.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GInputStream
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> a buffer to read data into
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes to read
+</parameter_description>
+</parameter>
+<parameter name="blocking">
+<parameter_description> whether to do blocking I/O
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of bytes read, or -1 on error.
+
+</return>
+</function>
+
+<function name="g_pollable_stream_write">
+<description>
+Tries to write to @stream, as with g_output_stream_write() (if
+ blocking is %TRUE) or g_pollable_output_stream_write_nonblocking()
+(if @blocking is %FALSE). This can be used to more easily share
+code between blocking and non-blocking implementations of a method.
+
+If @blocking is %FALSE, then @stream must be a
+#GPollableOutputStream for which
+g_pollable_output_stream_can_poll() returns %TRUE or else the
+behavior is undefined. If @blocking is %TRUE, then @stream does not
+need to be a #GPollableOutputStream.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> the buffer
+containing the data to write.
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes to write
+</parameter_description>
+</parameter>
+<parameter name="blocking">
+<parameter_description> whether to do blocking I/O
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> the number of bytes written, or -1 on error.
+
+</return>
+</function>
+
+<function name="g_pollable_stream_write_all">
+<description>
+Tries to write @count bytes to @stream, as with
+g_output_stream_write_all(), but using g_pollable_stream_write()
+rather than g_output_stream_write().
+
+On a successful write of @count bytes, %TRUE is returned, and
+ bytes_written is set to @count.
+
+If there is an error during the operation (including
+%G_IO_ERROR_WOULD_BLOCK in the non-blocking case), %FALSE is
+returned and @error is set to indicate the error status,
+ bytes_written is updated to contain the number of bytes written
+into the stream before the error occurred.
+
+As with g_pollable_stream_write(), if @blocking is %FALSE, then
+ stream must be a #GPollableOutputStream for which
+g_pollable_output_stream_can_poll() returns %TRUE or else the
+behavior is undefined. If @blocking is %TRUE, then @stream does not
+need to be a #GPollableOutputStream.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="stream">
+<parameter_description> a #GOutputStream.
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> the buffer
+containing the data to write.
+</parameter_description>
+</parameter>
+<parameter name="count">
+<parameter_description> the number of bytes to write
+</parameter_description>
+</parameter>
+<parameter name="blocking">
+<parameter_description> whether to do blocking I/O
+</parameter_description>
+</parameter>
+<parameter name="bytes_written">
+<parameter_description> location to store the number of bytes that was
+written to the stream
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore.
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store the error occurring, or %NULL to ignore
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE on success, %FALSE if there was an error
+
+</return>
+</function>
+
<function name="g_proxy_address_get_destination_hostname">
<description>
-Gets @proxy's destination hostname.
+Gets @proxy's destination hostname; that is, the name of the host
+that will be connected to via the proxy, not the name of the proxy
+itself.
Since: 2.26
@@ -43391,7 +44083,9 @@ Since: 2.26
<function name="g_proxy_address_get_destination_port">
<description>
-Gets @proxy's destination port.
+Gets @proxy's destination port; that is, the port on the
+destination host that will be connected to via the proxy, not the
+port number of the proxy itself.
Since: 2.26
@@ -43407,6 +44101,25 @@ Since: 2.26
</return>
</function>
+<function name="g_proxy_address_get_destination_protocol">
+<description>
+Gets the protocol that is being spoken to the destination
+server; eg, "http" or "ftp".
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> a #GProxyAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the @proxy's destination protocol
+
+</return>
+</function>
+
<function name="g_proxy_address_get_password">
<description>
Gets @proxy's password.
@@ -43427,7 +44140,7 @@ Since: 2.26
<function name="g_proxy_address_get_protocol">
<description>
-Gets @proxy's protocol.
+Gets @proxy's protocol. eg, "socks" or "http"
Since: 2.26
@@ -43443,6 +44156,24 @@ Since: 2.26
</return>
</function>
+<function name="g_proxy_address_get_uri">
+<description>
+Gets the proxy URI that @proxy was constructed from.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="proxy">
+<parameter_description> a #GProxyAddress
+</parameter_description>
+</parameter>
+</parameters>
+<return> the @proxy's URI, or %NULL if unknown
+
+</return>
+</function>
+
<function name="g_proxy_address_get_username">
<description>
Gets @proxy's username.
@@ -43466,6 +44197,10 @@ Since: 2.26
Creates a new #GProxyAddress for @inetaddr with @protocol that should
tunnel through @dest_hostname and @dest_port.
+(Note that this method doesn't set the #GProxyAddress:uri or
+#GProxyAddress:destination-protocol fields; use g_object_new()
+directly if you want to set those.)
+
Since: 2.26
</description>
@@ -44162,6 +44897,124 @@ for more details.
</return>
</function>
+<function name="g_resolver_lookup_records">
+<description>
+Synchronously performs a DNS record lookup for the given @rrname and returns
+a list of records as #GVariant tuples. See #GResolverRecordType for
+information on what the records contain for each @record_type.
+
+If the DNS resolution fails, @error (if non-%NULL) will be set to
+a value from #GResolverError.
+
+If @cancellable is non-%NULL, it can be used to cancel the
+operation, in which case @error (if non-%NULL) will be set to
+%G_IO_ERROR_CANCELLED.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="rrname">
+<parameter_description> the DNS name to lookup the record for
+</parameter_description>
+</parameter>
+<parameter name="record_type">
+<parameter_description> the type of DNS record to lookup
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList of #GVariant,
+or %NULL on error. You must free each of the records and the list when you are
+done with it. (You can use g_list_free_full() with g_variant_unref() to do this.)
+
+</return>
+</function>
+
+<function name="g_resolver_lookup_records_async">
+<description>
+Begins asynchronously performing a DNS lookup for the given
+ rrname, and eventually calls @callback, which must call
+g_resolver_lookup_records_finish() to get the final result. See
+g_resolver_lookup_records() for more details.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="rrname">
+<parameter_description> the DNS name to lookup the record for
+</parameter_description>
+</parameter>
+<parameter name="record_type">
+<parameter_description> the type of DNS record to lookup
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> a #GCancellable, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> callback to call after resolution completes
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> data for @callback
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_resolver_lookup_records_finish">
+<description>
+Retrieves the result of a previous call to
+g_resolver_lookup_records_async(). Returns a list of records as #GVariant
+tuples. See #GResolverRecordType for information on what the records contain.
+
+If the DNS resolution failed, @error (if non-%NULL) will be set to
+a value from #GResolverError. If the operation was cancelled,
+ error will be set to %G_IO_ERROR_CANCELLED.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="resolver">
+<parameter_description> a #GResolver
+</parameter_description>
+</parameter>
+<parameter name="result">
+<parameter_description> the result passed to your #GAsyncReadyCallback
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for a #GError, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GList of #GVariant,
+or %NULL on error. You must free each of the records and the list when you are
+done with it. (You can use g_list_free_full() with g_variant_unref() to do this.)
+
+</return>
+</function>
+
<function name="g_resolver_lookup_service">
<description>
Synchronously performs a DNS SRV lookup for the given @service and
@@ -44336,19 +45189,19 @@ Since: 2.32
</description>
<parameters>
<parameter name="resource">
-<parameter_description> A #GResource.
+<parameter_description> A #GResource
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A pathname inside the resource.
+<parameter_description> A pathname inside the resource
</parameter_description>
</parameter>
<parameter name="lookup_flags">
-<parameter_description> A #GResourceLookupFlags.
+<parameter_description> A #GResourceLookupFlags
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL.
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -44366,7 +45219,7 @@ Since: 2.32
</description>
<parameters>
</parameters>
-<return> a #GQuark.
+<return> a #GQuark
</return>
</function>
@@ -44383,15 +45236,15 @@ Since: 2.32
</description>
<parameters>
<parameter name="resource">
-<parameter_description> A #GResource.
+<parameter_description> A #GResource
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A pathname inside the resource.
+<parameter_description> A pathname inside the resource
</parameter_description>
</parameter>
<parameter name="lookup_flags">
-<parameter_description> A #GResourceLookupFlags.
+<parameter_description> A #GResourceLookupFlags
</parameter_description>
</parameter>
<parameter name="size">
@@ -44405,11 +45258,11 @@ or %NULL if the length is not needed
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL.
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the file was found. %FALSE if there were errors.
+<return> %TRUE if the file was found. %FALSE if there were errors
</return>
</function>
@@ -44427,15 +45280,15 @@ Since: 2.32
</description>
<parameters>
<parameter name="filename">
-<parameter_description> the path of a filename to load, in the GLib filename encoding.
+<parameter_description> the path of a filename to load, in the GLib filename encoding
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL.
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a new #GResource, or %NULL on error.
+<return> a new #GResource, or %NULL on error
</return>
</function>
@@ -44462,24 +45315,24 @@ Since: 2.32
</description>
<parameters>
<parameter name="resource">
-<parameter_description> A #GResource.
+<parameter_description> A #GResource
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A pathname inside the resource.
+<parameter_description> A pathname inside the resource
</parameter_description>
</parameter>
<parameter name="lookup_flags">
-<parameter_description> A #GResourceLookupFlags.
+<parameter_description> A #GResourceLookupFlags
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL.
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
<return> #GBytes or %NULL on error.
-Free the returned object with g_bytes_unref().
+Free the returned object with g_bytes_unref()
</return>
</function>
@@ -44498,15 +45351,15 @@ Since: 2.32
</description>
<parameters>
<parameter name="data">
-<parameter_description> A #GBytes.
+<parameter_description> A #GBytes
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL.
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> a new #GResource, or %NULL on error.
+<return> a new #GResource, or %NULL on error
</return>
</function>
@@ -44523,24 +45376,24 @@ Since: 2.32
</description>
<parameters>
<parameter name="resource">
-<parameter_description> A #GResource.
+<parameter_description> A #GResource
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A pathname inside the resource.
+<parameter_description> A pathname inside the resource
</parameter_description>
</parameter>
<parameter name="lookup_flags">
-<parameter_description> A #GResourceLookupFlags.
+<parameter_description> A #GResourceLookupFlags
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL.
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
<return> #GInputStream or %NULL on error.
-Free the returned object with g_object_unref().
+Free the returned object with g_object_unref()
</return>
</function>
@@ -44555,11 +45408,11 @@ Since: 2.32
</description>
<parameters>
<parameter name="resource">
-<parameter_description> A #GResource.
+<parameter_description> A #GResource
</parameter_description>
</parameter>
</parameters>
-<return> The passed in #GResource.
+<return> The passed in #GResource
</return>
</function>
@@ -44576,7 +45429,7 @@ Since: 2.32
</description>
<parameters>
<parameter name="resource">
-<parameter_description> A #GResource.
+<parameter_description> A #GResource
</parameter_description>
</parameter>
</parameters>
@@ -44597,15 +45450,15 @@ Since: 2.32
</description>
<parameters>
<parameter name="path">
-<parameter_description> A pathname inside the resource.
+<parameter_description> A pathname inside the resource
</parameter_description>
</parameter>
<parameter name="lookup_flags">
-<parameter_description> A #GResourceLookupFlags.
+<parameter_description> A #GResourceLookupFlags
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL.
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -44626,11 +45479,11 @@ Since: 2.32
</description>
<parameters>
<parameter name="path">
-<parameter_description> A pathname inside the resource.
+<parameter_description> A pathname inside the resource
</parameter_description>
</parameter>
<parameter name="lookup_flags">
-<parameter_description> A #GResourceLookupFlags.
+<parameter_description> A #GResourceLookupFlags
</parameter_description>
</parameter>
<parameter name="size">
@@ -44644,11 +45497,11 @@ or %NULL if the length is not needed
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL.
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the file was found. %FALSE if there were errors.
+<return> %TRUE if the file was found. %FALSE if there were errors
</return>
</function>
@@ -44675,20 +45528,20 @@ Since: 2.32
</description>
<parameters>
<parameter name="path">
-<parameter_description> A pathname inside the resource.
+<parameter_description> A pathname inside the resource
</parameter_description>
</parameter>
<parameter name="lookup_flags">
-<parameter_description> A #GResourceLookupFlags.
+<parameter_description> A #GResourceLookupFlags
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL.
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
<return> #GBytes or %NULL on error.
-Free the returned object with g_bytes_unref().
+Free the returned object with g_bytes_unref()
</return>
</function>
@@ -44706,20 +45559,20 @@ Since: 2.32
</description>
<parameters>
<parameter name="path">
-<parameter_description> A pathname inside the resource.
+<parameter_description> A pathname inside the resource
</parameter_description>
</parameter>
<parameter name="lookup_flags">
-<parameter_description> A #GResourceLookupFlags.
+<parameter_description> A #GResourceLookupFlags
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL.
+<parameter_description> return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
<return> #GInputStream or %NULL on error.
-Free the returned object with g_object_unref().
+Free the returned object with g_object_unref()
</return>
</function>
@@ -44735,7 +45588,7 @@ Since: 2.32
</description>
<parameters>
<parameter name="resource">
-<parameter_description> A #GResource.
+<parameter_description> A #GResource
</parameter_description>
</parameter>
</parameters>
@@ -44751,7 +45604,7 @@ Since: 2.32
</description>
<parameters>
<parameter name="resource">
-<parameter_description> A #GResource.
+<parameter_description> A #GResource
</parameter_description>
</parameter>
</parameters>
@@ -51547,18 +52400,18 @@ Since: 2.22
<function name="g_static_resource_fini">
<description>
-Finalized a GResource initialized by g_static_resource_init ().
+Finalized a GResource initialized by g_static_resource_init().
This is normally used by code generated by
-<link linkend="glib-compile-resources">glib-compile-resources</link> and is
-not typically used by other code.
+<link linkend="glib-compile-resources">glib-compile-resources</link>
+and is not typically used by other code.
Since: 2.32
</description>
<parameters>
<parameter name="static_resource">
-<parameter_description> pointer to a static #GStaticResource.
+<parameter_description> pointer to a static #GStaticResource
</parameter_description>
</parameter>
</parameters>
@@ -51567,22 +52420,22 @@ Since: 2.32
<function name="g_static_resource_get_resource">
<description>
-Gets the GResource that was registred by a call to g_static_resource_init ().
+Gets the GResource that was registred by a call to g_static_resource_init().
This is normally used by code generated by
-<link linkend="glib-compile-resources">glib-compile-resources</link> and is
-not typically used by other code.
+<link linkend="glib-compile-resources">glib-compile-resources</link>
+and is not typically used by other code.
Since: 2.32
</description>
<parameters>
<parameter name="static_resource">
-<parameter_description> pointer to a static #GStaticResource.
+<parameter_description> pointer to a static #GStaticResource
</parameter_description>
</parameter>
</parameters>
-<return> a #GResource.
+<return> a #GResource
</return>
</function>
@@ -51593,15 +52446,15 @@ Initializes a GResource from static data using a
GStaticResource.
This is normally used by code generated by
-<link linkend="glib-compile-resources">glib-compile-resources</link> and is
-not typically used by other code.
+<link linkend="glib-compile-resources">glib-compile-resources</link>
+and is not typically used by other code.
Since: 2.32
</description>
<parameters>
<parameter name="static_resource">
-<parameter_description> pointer to a static #GStaticResource.
+<parameter_description> pointer to a static #GStaticResource
</parameter_description>
</parameter>
</parameters>
@@ -51693,6 +52546,146 @@ Since: 2.28
</return>
</function>
+<function name="g_test_dbus_add_service_dir">
+<description>
+Add a path where dbus-daemon will lookup for .services files. This can't be
+called after g_test_dbus_up().
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GTestDBus
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> path to a directory containing .service files
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_test_dbus_down">
+<description>
+Stop the session bus started by g_test_dbus_up().
+
+This will wait for the singleton returned by g_bus_get() or g_bus_get_sync()
+is destroyed. This is done to ensure that the next unit test won't get a
+leaked singleton from this test.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GTestDBus
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_test_dbus_get_bus_address">
+<description>
+Get the address on which dbus-daemon is running. if g_test_dbus_up() has not
+been called yet, %NULL is returned. This can be used with
+g_dbus_connection_new_for_address()
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GTestDBus
+</parameter_description>
+</parameter>
+</parameters>
+<return> the address of the bus, or %NULL.
+</return>
+</function>
+
+<function name="g_test_dbus_get_flags">
+<description>
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GTestDBus
+</parameter_description>
+</parameter>
+</parameters>
+<return> the value of #GTestDBus:flags property
+</return>
+</function>
+
+<function name="g_test_dbus_new">
+<description>
+Create a new #GTestDBus object.
+
+
+</description>
+<parameters>
+<parameter name="flags">
+<parameter_description> a #GTestDBusFlags
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GTestDBus.
+</return>
+</function>
+
+<function name="g_test_dbus_stop">
+<description>
+Stop the session bus started by g_test_dbus_up().
+
+Unlike g_test_dbus_down(), this won't verify the #GDBusConnection
+singleton returned by g_bus_get() or g_bus_get_sync() is destroyed. Unit
+tests wanting to verify behaviour after the session bus has been stopped
+can use this function but should still call g_test_dbus_down() when done.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GTestDBus
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_test_dbus_unset">
+<description>
+Unset DISPLAY and DBUS_SESSION_BUS_ADDRESS env variables to ensure the test
+won't use user's session bus.
+
+This is useful for unit tests that want to verify behaviour when no session
+bus is running. It is not necessary to call this if unit test already calls
+g_test_dbus_up() before acquiring the session bus.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="g_test_dbus_up">
+<description>
+Start a dbus-daemon instance and set DBUS_SESSION_BUS_ADDRESS. After this
+call, it is safe for unit tests to start sending messages on the session bug.
+
+If this function is called from setup callback of g_test_add(),
+g_test_dbus_down() must be called in its teardown callback.
+
+If this function is called from unit test's main(), then g_test_dbus_down()
+must be called after g_test_run().
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GTestDBus
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_themed_icon_append_name">
<description>
Append a name to the list of icons from within @icon.
@@ -55382,7 +56375,7 @@ Gets the default #GVfs for the system.
</description>
<parameters>
</parameters>
-<return> a #GVfs.
+<return> a #GVfs.
</return>
</function>
@@ -55402,7 +56395,7 @@ Gets a #GFile for @path.
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile.
+<return> a #GFile.
Free the returned object with g_object_unref().
</return>
</function>
@@ -55412,7 +56405,7 @@ Free the returned object with g_object_unref().
Gets a #GFile for @uri.
This operation never fails, but the returned object
-might not support any I/O operation if the URI
+might not support any I/O operation if the URI
is malformed or if the URI scheme is not supported.
@@ -55423,11 +56416,11 @@ is malformed or if the URI scheme is not supported.
</parameter_description>
</parameter>
<parameter name="uri">
-<parameter_description> a string containing a URI
+<parameter_description> a string containing a URI
</parameter_description>
</parameter>
</parameters>
-<return> a #GFile.
+<return> a #GFile.
Free the returned object with g_object_unref().
</return>
</function>
@@ -55457,7 +56450,7 @@ Gets a list of URI schemes supported by @vfs.
</parameter>
</parameters>
<return> a %NULL-terminated array of strings.
-The returned array belongs to GIO and must
+The returned array belongs to GIO and must
not be freed or modified.
</return>
</function>
@@ -55474,14 +56467,15 @@ Checks if the VFS is active.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if construction of the @vfs was successful and it is now active.
+<return> %TRUE if construction of the @vfs was successful
+and it is now active.
</return>
</function>
<function name="g_vfs_parse_name">
<description>
-This operation never fails, but the returned object might
-not support any I/O operations if the @parse_name cannot
+This operation never fails, but the returned object might
+not support any I/O operations if the @parse_name cannot
be parsed by the #GVfs module.
diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml
index 2f1bacc..6990f0d 100644
--- a/glib/src/glib_docs.xml
+++ b/glib/src/glib_docs.xml
@@ -1747,7 +1747,7 @@ You do not need to hold the lock to call this function.
<description>
Increases the reference count of the asynchronous @queue by 1.
- Deprecated: Since 2.8, reference counting is done atomically
+Deprecated: 2.8: Reference counting is done atomically.
so g_async_queue_ref() can be used regardless of the @queue's
lock.
@@ -2030,7 +2030,7 @@ and releases the lock. This function must be called while holding
the @queue's lock. If the reference count went to 0, the @queue
will be destroyed and the memory allocated will be freed.
- Deprecated: Since 2.8, reference counting is done atomically
+Deprecated: 2.8: Reference counting is done atomically.
so g_async_queue_unref() can be used regardless of the @queue's
lock.
@@ -6530,7 +6530,7 @@ Windows a handle for a process (which doesn't have to be a child).
</parameter_description>
</parameter>
<parameter name="notify">
-<parameter_description> function to call when the idle is removed, or %NULL
+<parameter_description> function to call when the idle is removed, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -6650,6 +6650,38 @@ Since: 2.28
<return></return>
</function>
+<function name="g_clear_pointer">
+<description>
+Clears a reference to a variable.
+
+ pp must not be %NULL.
+
+If the reference is %NULL then this function does nothing.
+Otherwise, the variable is destroyed using @destroy and the
+pointer is set to %NULL.
+
+This function is threadsafe and modifies the pointer atomically,
+using memory barriers where needed.
+
+A macro is also included that allows this function to be used without
+pointer casts.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="pp">
+<parameter_description> a pointer to a variable, struct member etc. holding a pointer
+</parameter_description>
+</parameter>
+<parameter name="destroy">
+<parameter_description> a function to which a gpointer can be passed, to destroy * pp
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_closure_add_finalize_notifier">
<description>
Registers a finalization notifier which will be called when the
@@ -10498,7 +10530,7 @@ the local time zone.
This call is equivalent to calling g_date_time_new() with the time
zone returned by g_time_zone_new_local().
-Since: 2.26.
+Since: 2.26
</description>
<parameters>
@@ -10602,7 +10634,7 @@ UTC.
This call is equivalent to calling g_date_time_new() with the time
zone returned by g_time_zone_new_utc().
-Since: 2.26.
+Since: 2.26
</description>
<parameters>
@@ -11554,7 +11586,8 @@ Since: 2.32
<parameters>
<parameter name="envp">
<parameter_description> an environment
-list (eg, as returned from g_get_environ())
+list (eg, as returned from g_get_environ()), or %NULL
+for an empty environment list
</parameter_description>
</parameter>
<parameter name="variable">
@@ -11586,7 +11619,8 @@ Since: 2.32
<parameters>
<parameter name="envp">
<parameter_description> an environment
-list that can be freed using g_strfreev() (e.g., as returned from g_get_environ())
+list that can be freed using g_strfreev() (e.g., as returned from g_get_environ()), or %NULL
+for an empty environment list
</parameter_description>
</parameter>
<parameter name="variable">
@@ -11619,7 +11653,8 @@ Since: 2.32
<parameters>
<parameter name="envp">
<parameter_description> an environment
-list that can be freed using g_strfreev() (e.g., as returned from g_get_environ())
+list that can be freed using g_strfreev() (e.g., as returned from g_get_environ()),
+or %NULL for an empty environment list
</parameter_description>
</parameter>
<parameter name="variable">
@@ -14967,7 +15002,7 @@ range between #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE.
</parameter_description>
</parameter>
<parameter name="notify">
-<parameter_description> function to call when the idle is removed, or %NULL
+<parameter_description> function to call when the idle is removed, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -21079,10 +21114,6 @@ previously installed the #glib_mem_profiler_table with g_mem_set_vtable().
</description>
<parameters>
-<parameter name="void">
-<parameter_description>
-</parameter_description>
-</parameter>
</parameters>
<return></return>
</function>
@@ -22872,7 +22903,9 @@ Since: 2.10
Increases the freeze count on @object. If the freeze count is
non-zero, the emission of "notify" signals on @object is
stopped. The signals are queued until the freeze count is decreased
-to zero.
+to zero. Duplicate notifications are squashed so that at most one
+#GObject::notify signal is emitted for each property modified while the
+object is frozen.
This is necessary for accessors that modify multiple properties to prevent
premature notification while the object is still being modified.
@@ -23681,7 +23714,10 @@ g_object_set_qdata_full().
<description>
Reverts the effect of a previous call to
g_object_freeze_notify(). The freeze count is decreased on @object
-and when it reaches zero, all queued "notify" signals are emitted.
+and when it reaches zero, queued "notify" signals are emitted.
+
+Duplicate notifications for each property are squashed so that at most one
+#GObject::notify signal is emitted for each property.
It is an error to call this function when the freeze count is zero.
@@ -35115,8 +35151,15 @@ specified by the only argument that must be provided, @argv. @argv
should be a %NULL-terminated array of strings, to be passed as the
argument vector for the child. The first string in @argv is of
course the name of the program to execute. By default, the name of
-the program must be a full path; the <envar>PATH</envar> shell variable
-will only be searched if you pass the %G_SPAWN_SEARCH_PATH flag.
+the program must be a full path. If @flags contains the
+%G_SPAWN_SEARCH_PATH flag, the <envar>PATH</envar> environment variable
+is used to search for the executable. If @flags contains the
+%G_SPAWN_SEARCH_PATH_FROM_ENVP flag, the <envar>PATH</envar> variable from
+ envp is used to search for the executable.
+If both the %G_SPAWN_SEARCH_PATH and %G_SPAWN_SEARCH_PATH_FROM_ENVP
+flags are set, the <envar>PATH</envar> variable from @envp takes precedence
+over the environment variable.
+
If the program name is not a full path and %G_SPAWN_SEARCH_PATH flag is not
used, then the program will be run from the current directory (or
@working_directory, if specified); this might be unexpected or even
@@ -35182,7 +35225,11 @@ descriptors will be inherited by the child; otherwise all
descriptors except stdin/stdout/stderr will be closed before
calling exec() in the child. %G_SPAWN_SEARCH_PATH
means that <literal>argv[0]</literal> need not be an absolute path, it
-will be looked for in the user's <envar>PATH</envar>.
+will be looked for in the <envar>PATH</envar> environment variable.
+%G_SPAWN_SEARCH_PATH_FROM_ENVP means need not be an absolute path, it
+will be looked for in the <envar>PATH</envar> variable from @envp. If
+both %G_SPAWN_SEARCH_PATH and %G_SPAWN_SEARCH_PATH_FROM_ENVP are used,
+the value from @envp takes precedence over the environment.
%G_SPAWN_STDOUT_TO_DEV_NULL means that the child's standard output will
be discarded, instead of going to the same location as the parent's
standard output. If you use this flag, @standard_output must be %NULL.
@@ -38153,7 +38200,7 @@ Since: 2.16
</description>
<parameters>
<parameter name="testpath">
-<parameter_description> Slash-separated test case path name for the test.
+<parameter_description> /-separated test case path name for the test.
</parameter_description>
</parameter>
<parameter name="test_data">
@@ -38180,7 +38227,7 @@ Since: 2.16
</description>
<parameters>
<parameter name="testpath">
-<parameter_description> Slash-separated test case path name for the test.
+<parameter_description> /-separated test case path name for the test.
</parameter_description>
</parameter>
<parameter name="test_func">
@@ -40041,7 +40088,7 @@ this function returns the same value, without modifying @time_.
This function may, however, modify @time_ in order to deal with
non-existent times. If the non-existent local @time_ of 02:30 were
-requested on March 13th 2010 in Toronto then this function would
+requested on March 14th 2010 in Toronto then this function would
adjust @time_ to be 03:00 and return the interval containing the
adjusted time.
@@ -40405,7 +40452,7 @@ the range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH.
</parameter_description>
</parameter>
<parameter name="notify">
-<parameter_description> function to call when the timeout is removed, or %NULL
+<parameter_description> function to call when the timeout is removed, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -40512,7 +40559,7 @@ the range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH.
</parameter_description>
</parameter>
<parameter name="notify">
-<parameter_description> function to call when the timeout is removed, or %NULL
+<parameter_description> function to call when the timeout is removed, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -41505,7 +41552,7 @@ macro.
</parameter_description>
</parameter>
</parameters>
-<return> #TRUE if @instance is valid, #FALSE otherwise.
+<return> %TRUE if @instance is valid, %FALSE otherwise.
</return>
</function>
@@ -41856,6 +41903,33 @@ includes the type itself, so that e.g. a fundamental type has depth 1.
</return>
</function>
+<function name="g_type_ensure">
+<description>
+Ensures that the indicated @type has been registered with the
+type system, and its _class_init() method has been run.
+
+In theory, simply calling the type's _get_type() method (or using
+the corresponding macro) is supposed take care of this. However,
+_get_type() methods are often marked %G_GNUC_CONST for performance
+reasons, even though this is technically incorrect (since
+%G_GNUC_CONST requires that the function not have side effects,
+which _get_type() methods do on the first call). As a result, if
+you write a bare call to a _get_type() macro, it may get optimized
+out by the compiler. Using g_type_ensure() guarantees that the
+type's _get_type() method is called.
+
+Since: 2.34
+
+</description>
+<parameters>
+<parameter name="type">
+<parameter_description> a #GType.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="g_type_free_instance">
<description>
Frees an instance of a type, returning it to the instance pool for
@@ -46900,8 +46974,8 @@ the length (not including the nul terminator)
</parameter_description>
</parameter>
</parameters>
-<return> (transfer full) (array zero-terminated=1 length=length)
-(element-type guint8): a newly allocated string
+<return>
+a newly allocated string
</return>
</function>
@@ -47065,6 +47139,11 @@ linkend='gvariant-format-strings'>GVariant Format Strings</link>.
Please note that the syntax of the format string is very likely to be
extended in the future.
+ format_string determines the C types that are used for unpacking
+the values and also determines if the values are copied or borrowed,
+see the section on
+<link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
+
Since: 2.24
</description>
@@ -47198,6 +47277,11 @@ deconstructs it according to @format_string. This call is
essentially a combination of g_variant_get_child_value() and
g_variant_get().
+ format_string determines the C types that are used for unpacking
+the values and also determines if the values are copied or borrowed,
+see the section on
+<link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
+
Since: 2.24
</description>
@@ -47784,6 +47868,11 @@ These two generalisations allow mixing of multiple calls to
g_variant_new_va() and g_variant_get_va() within a single actual
varargs call by the user.
+ format_string determines the C types that are used for unpacking
+the values and also determines if the values are copied or borrowed,
+see the section on
+<link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
+
Since: 2.24
</description>
@@ -48131,6 +48220,11 @@ types, g_variant_iter_next() is definitely preferred. For string
types, use the '&' prefix to avoid allocating any memory at all (and
thereby avoiding the need to free anything as well).
+ format_string determines the C types that are used for unpacking
+the values and also determines if the values are copied or borrowed,
+see the section on
+<link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
+
Since: 2.24
</description>
@@ -48244,6 +48338,11 @@ g_free (key);
For a solution that is likely to be more convenient to C programmers
when dealing with loops, see g_variant_iter_loop().
+ format_string determines the C types that are used for unpacking
+the values and also determines if the values are copied or borrowed,
+see the section on
+<link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
+
Since: 2.24
</description>
@@ -48321,7 +48420,10 @@ g_variant_get(). In the case that %NULL would have been returned,
this function returns %FALSE. Otherwise, it unpacks the returned
value and returns %TRUE.
-See g_variant_get() for information about @format_string.
+ format_string determines the C types that are used for unpacking
+the values and also determines if the values are copied or borrowed,
+see the section on
+<link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
Since: 2.28
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
