diff options
author | José Alburquerque <jaalburqu@svn.gnome.org> | 2012-11-07 15:09:06 -0500 |
---|---|---|
committer | José Alburquerque <jaalburqu@svn.gnome.org> | 2012-11-07 15:09:06 -0500 |
commit | 177014c0aa65b98bd25dad7fc823c8a00549136e (patch) | |
tree | 61533098d8ff251e15e905ec8b7f26f57aaa3fc1 | |
parent | ff911d0ce28843a282d81c7410119fc92da1f1e1 (diff) | |
download | glibmm-177014c0aa65b98bd25dad7fc823c8a00549136e.tar.gz |
Regenerate the XML docs files for glibmm and giomm.
* gio/src/gio_docs.xml:
* glib/src/glib_docs.xml: These files now include enum XML
documentation. (They've been regenerated with glib-2.34.1.)
* glib/src/glib_extra_objects.defs: Add IOChannel to avoid a gmmproc
documentation warning.
-rw-r--r-- | ChangeLog | 10 | ||||
-rw-r--r-- | gio/src/gio_docs.xml | 2595 | ||||
-rw-r--r-- | glib/src/glib_docs.xml | 4335 | ||||
-rw-r--r-- | glib/src/glib_extra_objects.defs | 5 |
4 files changed, 6895 insertions, 50 deletions
@@ -1,3 +1,13 @@ +2012-11-05 José Alburquerque <jaalburquerque@gmail.com> + + Regenerate the XML docs files for glibmm and giomm. + + * gio/src/gio_docs.xml: + * glib/src/glib_docs.xml: These files now include enum XML + documentation. (They've been regenerated with glib-2.34.1.) + * glib/src/glib_extra_objects.defs: Add IOChannel to avoid a gmmproc + documentation warning. + 2012-11-04 José Alburquerque <jaalburquerque@gmail.com> gmmproc: Make enum documentation possible. diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml index 0e60881d..bec33843 100644 --- a/gio/src/gio_docs.xml +++ b/gio/src/gio_docs.xml @@ -1431,6 +1431,31 @@ Since: 2.28 <return></return> </signal> +<enum name="GAppInfoCreateFlags"> +<description> +Flags used when creating a #GAppInfo. + +</description> +<parameters> +<parameter name="G_APP_INFO_CREATE_NONE"> +<parameter_description> No flags. +</parameter_description> +</parameter> +<parameter name="G_APP_INFO_CREATE_NEEDS_TERMINAL"> +<parameter_description> Application opens in a terminal window. +</parameter_description> +</parameter> +<parameter name="G_APP_INFO_CREATE_SUPPORTS_URIS"> +<parameter_description> Application supports URI arguments. +</parameter_description> +</parameter> +<parameter name="G_APP_INFO_CREATE_SUPPORTS_STARTUP_NOTIFICATION"> +<parameter_description> Application supports startup notification. Since 2.26 +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GApplication::activate"> <description> The ::activate signal is emitted on the primary instance when an @@ -1527,6 +1552,169 @@ after registration. See g_application_register(). <return></return> </signal> +<enum name="GApplicationFlags"> +<description> +Flags used to define the behaviour of a #GApplication. + +Since: 2.28 + +</description> +<parameters> +<parameter name="G_APPLICATION_FLAGS_NONE"> +<parameter_description> Default +</parameter_description> +</parameter> +<parameter name="G_APPLICATION_IS_SERVICE"> +<parameter_description> Run as a service. In this mode, registration +fails if the service is already running, and the application will +stay around for a while when the use count falls to zero. +</parameter_description> +</parameter> +<parameter name="G_APPLICATION_IS_LAUNCHER"> +<parameter_description> Don't try to become the primary instance. +</parameter_description> +</parameter> +<parameter name="G_APPLICATION_HANDLES_OPEN"> +<parameter_description> This application handles opening files (in +the primary instance). Note that this flag only affects the default +implementation of local_command_line(), and has no effect if +%G_APPLICATION_HANDLES_COMMAND_LINE is given. +See g_application_run() for details. +</parameter_description> +</parameter> +<parameter name="G_APPLICATION_HANDLES_COMMAND_LINE"> +<parameter_description> This application handles command line +arguments (in the primary instance). Note that this flag only affect +the default implementation of local_command_line(). +See g_application_run() for details. +</parameter_description> +</parameter> +<parameter name="G_APPLICATION_SEND_ENVIRONMENT"> +<parameter_description> Send the environment of the +launching process to the primary instance. Set this flag if your +application is expected to behave differently depending on certain +environment variables. For instance, an editor might be expected +to use the <envar>GIT_COMMITTER_NAME</envar> environment variable +when editing a git commit message. The environment is available +to the #GApplication::command-line signal handler, via +g_application_command_line_getenv(). +</parameter_description> +</parameter> +<parameter name="G_APPLICATION_NON_UNIQUE"> +<parameter_description> Make no attempts to do any of the typical +single-instance application negotiation, even if the application +ID is given. The application neither attempts to become the +owner of the application ID nor does it check if an existing +owner already exists. Everything occurs in the local process. +Since: 2.30. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GAskPasswordFlags"> +<description> +#GAskPasswordFlags are used to request specific information from the +user, or to notify the user of their choices in an authentication +situation. + +</description> +<parameters> +<parameter name="G_ASK_PASSWORD_NEED_PASSWORD"> +<parameter_description> operation requires a password. +</parameter_description> +</parameter> +<parameter name="G_ASK_PASSWORD_NEED_USERNAME"> +<parameter_description> operation requires a username. +</parameter_description> +</parameter> +<parameter name="G_ASK_PASSWORD_NEED_DOMAIN"> +<parameter_description> operation requires a domain. +</parameter_description> +</parameter> +<parameter name="G_ASK_PASSWORD_SAVING_SUPPORTED"> +<parameter_description> operation supports saving settings. +</parameter_description> +</parameter> +<parameter name="G_ASK_PASSWORD_ANONYMOUS_SUPPORTED"> +<parameter_description> operation supports anonymous users. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GBusNameOwnerFlags"> +<description> +Flags used in g_bus_own_name(). + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_BUS_NAME_OWNER_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT"> +<parameter_description> Allow another message bus connection to claim the name. +</parameter_description> +</parameter> +<parameter name="G_BUS_NAME_OWNER_FLAGS_REPLACE"> +<parameter_description> If another message bus connection owns the name and have +specified #G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT, then take the name from the other connection. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GBusNameWatcherFlags"> +<description> +Flags used in g_bus_watch_name(). + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_BUS_NAME_WATCHER_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_BUS_NAME_WATCHER_FLAGS_AUTO_START"> +<parameter_description> If no-one owns the name when +beginning to watch the name, ask the bus to launch an owner for the +name. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GBusType"> +<description> +An enumeration for well-known message buses. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_BUS_TYPE_STARTER"> +<parameter_description> An alias for the message bus that activated the process, if any. +</parameter_description> +</parameter> +<parameter name="G_BUS_TYPE_NONE"> +<parameter_description> Not a message bus. +</parameter_description> +</parameter> +<parameter name="G_BUS_TYPE_SYSTEM"> +<parameter_description> The system-wide message bus. +</parameter_description> +</parameter> +<parameter name="G_BUS_TYPE_SESSION"> +<parameter_description> The login session message bus. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GCancellable::cancelled"> <description> Emitted when the operation has been cancelled. @@ -1593,6 +1781,83 @@ cancellable signal should not do something that can block. <return></return> </signal> +<enum name="GConverterFlags"> +<description> +Flags used when calling a g_converter_convert(). + +Since: 2.24 + +</description> +<parameters> +<parameter name="G_CONVERTER_NO_FLAGS"> +<parameter_description> No flags. +</parameter_description> +</parameter> +<parameter name="G_CONVERTER_INPUT_AT_END"> +<parameter_description> At end of input data +</parameter_description> +</parameter> +<parameter name="G_CONVERTER_FLUSH"> +<parameter_description> Flush data +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GConverterResult"> +<description> +Results returned from g_converter_convert(). + +Since: 2.24 + +</description> +<parameters> +<parameter name="G_CONVERTER_ERROR"> +<parameter_description> There was an error during conversion. +</parameter_description> +</parameter> +<parameter name="G_CONVERTER_CONVERTED"> +<parameter_description> Some data was consumed or produced +</parameter_description> +</parameter> +<parameter name="G_CONVERTER_FINISHED"> +<parameter_description> The conversion is finished +</parameter_description> +</parameter> +<parameter name="G_CONVERTER_FLUSHED"> +<parameter_description> Flushing is finished +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GCredentialsType"> +<description> +Enumeration describing different kinds of native credential types. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_CREDENTIALS_TYPE_INVALID"> +<parameter_description> Indicates an invalid native credential type. +</parameter_description> +</parameter> +<parameter name="G_CREDENTIALS_TYPE_LINUX_UCRED"> +<parameter_description> The native credentials type is a <type>struct ucred</type>. +</parameter_description> +</parameter> +<parameter name="G_CREDENTIALS_TYPE_FREEBSD_CMSGCRED"> +<parameter_description> The native credentials type is a <type>struct cmsgcred</type>. +</parameter_description> +</parameter> +<parameter name="G_CREDENTIALS_TYPE_OPENBSD_SOCKPEERCRED"> +<parameter_description> The native credentials type is a <type>struct sockpeercred</type>. Added in 2.30. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GDBusAuthObserver::allow-mechanism"> <description> Emitted to check if @mechanism is allowed to be used. @@ -1642,6 +1907,47 @@ Since: 2.26 </return> </signal> +<enum name="GDBusCallFlags"> +<description> +Flags used in g_dbus_connection_call() and similar APIs. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_CALL_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_CALL_FLAGS_NO_AUTO_START"> +<parameter_description> The bus must not launch +an owner for the destination name in response to this method +invocation. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDBusCapabilityFlags"> +<description> +Capabilities negotiated with the remote peer. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_CAPABILITY_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_CAPABILITY_FLAGS_UNIX_FD_PASSING"> +<parameter_description> The connection +supports exchanging UNIX file descriptors with the remote peer. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GDBusConnection::closed"> <description> Emitted when the connection is closed. @@ -1688,6 +1994,271 @@ remote peer closed its end of the connection. <return></return> </signal> +<enum name="GDBusConnectionFlags"> +<description> +Flags used when creating a new #GDBusConnection. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_CONNECTION_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_CLIENT"> +<parameter_description> Perform authentication against server. +</parameter_description> +</parameter> +<parameter name="G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER"> +<parameter_description> Perform authentication against client. +</parameter_description> +</parameter> +<parameter name="G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS"> +<parameter_description> When +authenticating as a server, allow the anonymous authentication +method. +</parameter_description> +</parameter> +<parameter name="G_DBUS_CONNECTION_FLAGS_MESSAGE_BUS_CONNECTION"> +<parameter_description> Pass this flag if connecting to a peer that is a +message bus. This means that the Hello() method will be invoked as part of the connection setup. +</parameter_description> +</parameter> +<parameter name="G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING"> +<parameter_description> If set, processing of D-Bus messages is +delayed until g_dbus_connection_start_message_processing() is called. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDBusError"> +<description> +Error codes for the %G_DBUS_ERROR error domain. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_ERROR_FAILED"> +<parameter_description> +A generic error; "something went wrong" - see the error message for +more. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_NO_MEMORY"> +<parameter_description> +There was not enough memory to complete an operation. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SERVICE_UNKNOWN"> +<parameter_description> +The bus doesn't know how to launch a service to supply the bus name +you wanted. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_NAME_HAS_NO_OWNER"> +<parameter_description> +The bus name you referenced doesn't exist (i.e. no application owns +it). +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_NO_REPLY"> +<parameter_description> +No reply to a message expecting one, usually means a timeout occurred. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_IO_ERROR"> +<parameter_description> +Something went wrong reading or writing to a socket, for example. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_BAD_ADDRESS"> +<parameter_description> +A D-Bus bus address was malformed. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_NOT_SUPPORTED"> +<parameter_description> +Requested operation isn't supported (like ENOSYS on UNIX). +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_LIMITS_EXCEEDED"> +<parameter_description> +Some limited resource is exhausted. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_ACCESS_DENIED"> +<parameter_description> +Security restrictions don't allow doing what you're trying to do. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_AUTH_FAILED"> +<parameter_description> +Authentication didn't work. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_NO_SERVER"> +<parameter_description> +Unable to connect to server (probably caused by ECONNREFUSED on a +socket). +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_TIMEOUT"> +<parameter_description> +Certain timeout errors, possibly ETIMEDOUT on a socket. Note that +%G_DBUS_ERROR_NO_REPLY is used for message reply timeouts. Warning: +this is confusingly-named given that %G_DBUS_ERROR_TIMED_OUT also +exists. We can't fix it for compatibility reasons so just be +careful. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_NO_NETWORK"> +<parameter_description> +No network access (probably ENETUNREACH on a socket). +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_ADDRESS_IN_USE"> +<parameter_description> +Can't bind a socket since its address is in use (i.e. EADDRINUSE). +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_DISCONNECTED"> +<parameter_description> +The connection is disconnected and you're trying to use it. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_INVALID_ARGS"> +<parameter_description> +Invalid arguments passed to a method call. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_FILE_NOT_FOUND"> +<parameter_description> +Missing file. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_FILE_EXISTS"> +<parameter_description> +Existing file and the operation you're using does not silently overwrite. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_UNKNOWN_METHOD"> +<parameter_description> +Method name you invoked isn't known by the object you invoked it on. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_TIMED_OUT"> +<parameter_description> +Certain timeout errors, e.g. while starting a service. Warning: this is +confusingly-named given that %G_DBUS_ERROR_TIMEOUT also exists. We +can't fix it for compatibility reasons so just be careful. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_MATCH_RULE_NOT_FOUND"> +<parameter_description> +Tried to remove or modify a match rule that didn't exist. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_MATCH_RULE_INVALID"> +<parameter_description> +The match rule isn't syntactically valid. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_EXEC_FAILED"> +<parameter_description> +While starting a new process, the exec() call failed. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_FORK_FAILED"> +<parameter_description> +While starting a new process, the fork() call failed. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_CHILD_EXITED"> +<parameter_description> +While starting a new process, the child exited with a status code. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_CHILD_SIGNALED"> +<parameter_description> +While starting a new process, the child exited on a signal. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_FAILED"> +<parameter_description> +While starting a new process, something went wrong. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_SETUP_FAILED"> +<parameter_description> +We failed to setup the environment correctly. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_CONFIG_INVALID"> +<parameter_description> +We failed to setup the config parser correctly. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_SERVICE_INVALID"> +<parameter_description> +Bus name was not valid. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_SERVICE_NOT_FOUND"> +<parameter_description> +Service file not found in system-services directory. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_PERMISSIONS_INVALID"> +<parameter_description> +Permissions are incorrect on the setuid helper. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_FILE_INVALID"> +<parameter_description> +Service file invalid (Name, User or Exec missing). +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SPAWN_NO_MEMORY"> +<parameter_description> +Tried to get a UNIX process ID and it wasn't available. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_UNIX_PROCESS_ID_UNKNOWN"> +<parameter_description> +Tried to get a UNIX process ID and it wasn't available. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_INVALID_SIGNATURE"> +<parameter_description> +A type signature is not valid. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_INVALID_FILE_CONTENT"> +<parameter_description> +A file contains invalid syntax or is otherwise broken. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN"> +<parameter_description> +Asked for SELinux security context and it wasn't available. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_ADT_AUDIT_DATA_UNKNOWN"> +<parameter_description> +Asked for ADT audit data and it wasn't available. +</parameter_description> +</parameter> +<parameter name="G_DBUS_ERROR_OBJECT_PATH_IN_USE"> +<parameter_description> +There's already an object with the requested object path. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GDBusInterfaceSkeleton::g-authorize-method"> <description> Emitted when a method is invoked by a remote caller and used to @@ -1742,6 +2313,153 @@ Since: 2.30 </return> </signal> +<enum name="GDBusInterfaceSkeletonFlags"> +<description> +Flags describing the behavior of a #GDBusInterfaceSkeleton instance. + +Since: 2.30 + +</description> +<parameters> +<parameter name="G_DBUS_INTERFACE_SKELETON_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_INTERFACE_SKELETON_FLAGS_HANDLE_METHOD_INVOCATIONS_IN_THREAD"> +<parameter_description> Each method invocation is handled in +a thread dedicated to the invocation. This means that the method implementation can use blocking IO +without blocking any other part of the process. It also means that the method implementation must +use locking to access data structures used by other threads. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDBusMessageByteOrder"> +<description> +Enumeration used to describe the byte order of a D-Bus message. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_MESSAGE_BYTE_ORDER_BIG_ENDIAN"> +<parameter_description> The byte order is big endian. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_BYTE_ORDER_LITTLE_ENDIAN"> +<parameter_description> The byte order is little endian. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDBusMessageFlags"> +<description> +Message flags used in #GDBusMessage. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_MESSAGE_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED"> +<parameter_description> A reply is not expected. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_FLAGS_NO_AUTO_START"> +<parameter_description> The bus must not launch an +owner for the destination name in response to this message. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDBusMessageHeaderField"> +<description> +Header fields used in #GDBusMessage. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_MESSAGE_HEADER_FIELD_INVALID"> +<parameter_description> Not a valid header field. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_HEADER_FIELD_PATH"> +<parameter_description> The object path. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE"> +<parameter_description> The interface name. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_HEADER_FIELD_MEMBER"> +<parameter_description> The method or signal name. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME"> +<parameter_description> The name of the error that occurred. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL"> +<parameter_description> The serial number the message is a reply to. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION"> +<parameter_description> The name the message is intended for. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_HEADER_FIELD_SENDER"> +<parameter_description> Unique name of the sender of the message (filled in by the bus). +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE"> +<parameter_description> The signature of the message body. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS"> +<parameter_description> The number of UNIX file descriptors that accompany the message. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDBusMessageType"> +<description> +Message types used in #GDBusMessage. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_MESSAGE_TYPE_INVALID"> +<parameter_description> Message is of invalid type. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_TYPE_METHOD_CALL"> +<parameter_description> Method call. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_TYPE_METHOD_RETURN"> +<parameter_description> Method reply. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_TYPE_ERROR"> +<parameter_description> Error reply. +</parameter_description> +</parameter> +<parameter name="G_DBUS_MESSAGE_TYPE_SIGNAL"> +<parameter_description> Signal emission. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GDBusObject::interface-added"> <description> Emitted when @interface is added to @object. @@ -1961,6 +2679,28 @@ Since: 2.30 <return></return> </signal> +<enum name="GDBusObjectManagerClientFlags"> +<description> +Flags used when constructing a #GDBusObjectManagerClient. + +Since: 2.30 + +</description> +<parameters> +<parameter name="G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_DO_NOT_AUTO_START"> +<parameter_description> If not set and the +manager is for a well-known name, then request the bus to launch +an owner for the name if no-one owns the name. This flag can only +be used in managers for well-known names. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GDBusObjectSkeleton::authorize-method"> <description> Emitted when a method is invoked by a remote caller and used to @@ -1994,6 +2734,29 @@ Since: 2.30 </return> </signal> +<enum name="GDBusPropertyInfoFlags"> +<description> +Flags describing the access control of a D-Bus property. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_PROPERTY_INFO_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_PROPERTY_INFO_FLAGS_READABLE"> +<parameter_description> Property is readable. +</parameter_description> +</parameter> +<parameter name="G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE"> +<parameter_description> Property is writable. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GDBusProxy::g-properties-changed"> <description> Emitted when one or more D-Bus properties on @proxy changes. The @@ -2057,6 +2820,60 @@ Since: 2.26 <return></return> </signal> +<enum name="GDBusProxyFlags"> +<description> +Flags used when constructing an instance of a #GDBusProxy derived class. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_PROXY_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES"> +<parameter_description> Don't load properties. +</parameter_description> +</parameter> +<parameter name="G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS"> +<parameter_description> Don't connect to signals on the remote object. +</parameter_description> +</parameter> +<parameter name="G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START"> +<parameter_description> If not set and the proxy if for a well-known name, +then request the bus to launch an owner for the name if no-one owns the name. This flag can +only be used in proxies for well-known names. +</parameter_description> +</parameter> +<parameter name="G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES"> +<parameter_description> If set, the property value for any <emphasis>invalidated property</emphasis> will be (asynchronously) retrieved upon receiving the <ulink url="http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties">PropertiesChanged</ulink> D-Bus signal and the property will not cause emission of the #GDBusProxy::g-properties-changed signal. When the value is received the #GDBusProxy::g-properties-changed signal is emitted for the property along with the retrieved value. Since 2.32. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDBusSendMessageFlags"> +<description> +Flags used when sending #GDBusMessage<!-- -->s on a #GDBusConnection. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_SEND_MESSAGE_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL"> +<parameter_description> Do not automatically +assign a serial number from the #GDBusConnection object when +sending a message. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GDBusServer::new-connection"> <description> Emitted when a new authenticated connection has been made. Use @@ -2100,6 +2917,122 @@ run. </return> </signal> +<enum name="GDBusServerFlags"> +<description> +Flags used when creating a #GDBusServer. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_SERVER_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_SERVER_FLAGS_RUN_IN_THREAD"> +<parameter_description> All #GDBusServer::new-connection +signals will run in separated dedicated threads (see signal for +details). +</parameter_description> +</parameter> +<parameter name="G_DBUS_SERVER_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS"> +<parameter_description> Allow the anonymous +authentication method. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDBusSignalFlags"> +<description> +Flags used when subscribing to signals via g_dbus_connection_signal_subscribe(). + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_SIGNAL_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_SIGNAL_FLAGS_NO_MATCH_RULE"> +<parameter_description> Don't actually send the AddMatch +D-Bus call for this signal subscription. This gives you more control +over which match rules you add (but you must add them manually). +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDBusSubtreeFlags"> +<description> +Flags passed to g_dbus_connection_register_subtree(). + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_DBUS_SUBTREE_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES"> +<parameter_description> Method calls to objects not in the enumerated range +will still be dispatched. This is useful if you want +to dynamically spawn objects in the subtree. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDataStreamByteOrder"> +<description> +#GDataStreamByteOrder is used to ensure proper endianness of streaming data sources +across various machine architectures. + + +</description> +<parameters> +<parameter name="G_DATA_STREAM_BYTE_ORDER_BIG_ENDIAN"> +<parameter_description> Selects Big Endian byte order. +</parameter_description> +</parameter> +<parameter name="G_DATA_STREAM_BYTE_ORDER_LITTLE_ENDIAN"> +<parameter_description> Selects Little Endian byte order. +</parameter_description> +</parameter> +<parameter name="G_DATA_STREAM_BYTE_ORDER_HOST_ENDIAN"> +<parameter_description> Selects endianness based on host machine's architecture. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDataStreamNewlineType"> +<description> +#GDataStreamNewlineType is used when checking for or setting the line endings for a given file. + +</description> +<parameters> +<parameter name="G_DATA_STREAM_NEWLINE_TYPE_LF"> +<parameter_description> Selects "LF" line endings, common on most modern UNIX platforms. +</parameter_description> +</parameter> +<parameter name="G_DATA_STREAM_NEWLINE_TYPE_CR"> +<parameter_description> Selects "CR" line endings. +</parameter_description> +</parameter> +<parameter name="G_DATA_STREAM_NEWLINE_TYPE_CR_LF"> +<parameter_description> Selects "CR, LF" line ending, common on Microsoft Windows. +</parameter_description> +</parameter> +<parameter name="G_DATA_STREAM_NEWLINE_TYPE_ANY"> +<parameter_description> Automatically try to handle any line ending type. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GDrive::changed"> <description> Emitted when the drive's state has changed. @@ -2163,6 +3096,245 @@ Since: 2.22 <return></return> </signal> +<enum name="GDriveStartFlags"> +<description> +Flags used when starting a drive. + +Since: 2.22 + +</description> +<parameters> +<parameter name="G_DRIVE_START_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDriveStartStopType"> +<description> +Enumeration describing how a drive can be started/stopped. + +Since: 2.22 + +</description> +<parameters> +<parameter name="G_DRIVE_START_STOP_TYPE_UNKNOWN"> +<parameter_description> Unknown or drive doesn't support +start/stop. +</parameter_description> +</parameter> +<parameter name="G_DRIVE_START_STOP_TYPE_SHUTDOWN"> +<parameter_description> The stop method will physically +shut down the drive and e.g. power down the port the drive is +attached to. +</parameter_description> +</parameter> +<parameter name="G_DRIVE_START_STOP_TYPE_NETWORK"> +<parameter_description> The start/stop methods are used +for connecting/disconnect to the drive over the network. +</parameter_description> +</parameter> +<parameter name="G_DRIVE_START_STOP_TYPE_MULTIDISK"> +<parameter_description> The start/stop methods will +assemble/disassemble a virtual drive from several physical +drives. +</parameter_description> +</parameter> +<parameter name="G_DRIVE_START_STOP_TYPE_PASSWORD"> +<parameter_description> The start/stop methods will +unlock/lock the disk (for example using the ATA <quote>SECURITY +UNLOCK DEVICE</quote> command) +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GEmblemOrigin"> +<description> +GEmblemOrigin is used to add information about the origin of the emblem +to #GEmblem. + +Since: 2.18 + +</description> +<parameters> +<parameter name="G_EMBLEM_ORIGIN_UNKNOWN"> +<parameter_description> Emblem of unknown origin +</parameter_description> +</parameter> +<parameter name="G_EMBLEM_ORIGIN_DEVICE"> +<parameter_description> Emblem adds device-specific information +</parameter_description> +</parameter> +<parameter name="G_EMBLEM_ORIGIN_LIVEMETADATA"> +<parameter_description> Emblem depicts live metadata, such as "readonly" +</parameter_description> +</parameter> +<parameter name="G_EMBLEM_ORIGIN_TAG"> +<parameter_description> Emblem comes from a user-defined tag, e.g. set by nautilus (in the future) +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GFileAttributeInfoFlags"> +<description> +Flags specifying the behaviour of an attribute. + +</description> +<parameters> +<parameter name="G_FILE_ATTRIBUTE_INFO_NONE"> +<parameter_description> no flags set. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE"> +<parameter_description> copy the attribute values when the file is copied. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED"> +<parameter_description> copy the attribute values when the file is moved. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GFileAttributeStatus"> +<description> +Used by g_file_set_attributes_from_info() when setting file attributes. + +</description> +<parameters> +<parameter name="G_FILE_ATTRIBUTE_STATUS_UNSET"> +<parameter_description> Attribute value is unset (empty). +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_STATUS_SET"> +<parameter_description> Attribute value is set. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING"> +<parameter_description> Indicates an error in setting the value. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GFileAttributeType"> +<description> +The data types for file attributes. + +</description> +<parameters> +<parameter name="G_FILE_ATTRIBUTE_TYPE_INVALID"> +<parameter_description> indicates an invalid or uninitalized type. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_TYPE_STRING"> +<parameter_description> a null terminated UTF8 string. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_TYPE_BYTE_STRING"> +<parameter_description> a zero terminated string of non-zero bytes. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_TYPE_BOOLEAN"> +<parameter_description> a boolean value. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_TYPE_UINT32"> +<parameter_description> an unsigned 4-byte/32-bit integer. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_TYPE_INT32"> +<parameter_description> a signed 4-byte/32-bit integer. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_TYPE_UINT64"> +<parameter_description> an unsigned 8-byte/64-bit integer. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_TYPE_INT64"> +<parameter_description> a signed 8-byte/64-bit integer. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_TYPE_OBJECT"> +<parameter_description> a #GObject. +</parameter_description> +</parameter> +<parameter name="G_FILE_ATTRIBUTE_TYPE_STRINGV"> +<parameter_description> a %NULL terminated char **. Since 2.22 +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GFileCopyFlags"> +<description> +Flags used when copying or moving files. + +</description> +<parameters> +<parameter name="G_FILE_COPY_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_FILE_COPY_OVERWRITE"> +<parameter_description> Overwrite any existing files +</parameter_description> +</parameter> +<parameter name="G_FILE_COPY_BACKUP"> +<parameter_description> Make a backup of any existing files. +</parameter_description> +</parameter> +<parameter name="G_FILE_COPY_NOFOLLOW_SYMLINKS"> +<parameter_description> Don't follow symlinks. +</parameter_description> +</parameter> +<parameter name="G_FILE_COPY_ALL_METADATA"> +<parameter_description> Copy all file metadata instead of just default set used for copy (see #GFileInfo). +</parameter_description> +</parameter> +<parameter name="G_FILE_COPY_NO_FALLBACK_FOR_MOVE"> +<parameter_description> Don't use copy and delete fallback if native move not supported. +</parameter_description> +</parameter> +<parameter name="G_FILE_COPY_TARGET_DEFAULT_PERMS"> +<parameter_description> Leaves target file with default perms, instead of setting the source file perms. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GFileCreateFlags"> +<description> +Flags used when an operation may create a file. + +</description> +<parameters> +<parameter name="G_FILE_CREATE_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_FILE_CREATE_PRIVATE"> +<parameter_description> Create a file that can only be +accessed by the current user. +</parameter_description> +</parameter> +<parameter name="G_FILE_CREATE_REPLACE_DESTINATION"> +<parameter_description> Replace the destination +as if it didn't exist before. Don't try to keep any old +permissions, replace instead of following links. This +is generally useful if you're doing a "copy over" +rather than a "save new version of" replace operation. +You can think of it as "unlink destination" before +writing to it, although the implementation may not +be exactly like that. Since 2.20 +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GFileMonitor::changed"> <description> Emitted when @file has been changed. @@ -2195,6 +3367,128 @@ In all the other cases, @other_file will be set to #NULL. <return></return> </signal> +<enum name="GFileMonitorEvent"> +<description> +Specifies what type of event a monitor event is. + +</description> +<parameters> +<parameter name="G_FILE_MONITOR_EVENT_CHANGED"> +<parameter_description> a file changed. +</parameter_description> +</parameter> +<parameter name="G_FILE_MONITOR_EVENT_CHANGES_DONE_HINT"> +<parameter_description> a hint that this was probably the last change in a set of changes. +</parameter_description> +</parameter> +<parameter name="G_FILE_MONITOR_EVENT_DELETED"> +<parameter_description> a file was deleted. +</parameter_description> +</parameter> +<parameter name="G_FILE_MONITOR_EVENT_CREATED"> +<parameter_description> a file was created. +</parameter_description> +</parameter> +<parameter name="G_FILE_MONITOR_EVENT_ATTRIBUTE_CHANGED"> +<parameter_description> a file attribute was changed. +</parameter_description> +</parameter> +<parameter name="G_FILE_MONITOR_EVENT_PRE_UNMOUNT"> +<parameter_description> the file location will soon be unmounted. +</parameter_description> +</parameter> +<parameter name="G_FILE_MONITOR_EVENT_UNMOUNTED"> +<parameter_description> the file location was unmounted. +</parameter_description> +</parameter> +<parameter name="G_FILE_MONITOR_EVENT_MOVED"> +<parameter_description> the file was moved. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GFileMonitorFlags"> +<description> +Flags used to set what a #GFileMonitor will watch for. + +</description> +<parameters> +<parameter name="G_FILE_MONITOR_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_FILE_MONITOR_WATCH_MOUNTS"> +<parameter_description> Watch for mount events. +</parameter_description> +</parameter> +<parameter name="G_FILE_MONITOR_SEND_MOVED"> +<parameter_description> Pair DELETED and CREATED events caused +by file renames (moves) and send a single G_FILE_MONITOR_EVENT_MOVED +event instead (NB: not supported on all backends; the default +behaviour -without specifying this flag- is to send single DELETED +and CREATED events). +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GFileQueryInfoFlags"> +<description> +Flags used when querying a #GFileInfo. + +</description> +<parameters> +<parameter name="G_FILE_QUERY_INFO_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS"> +<parameter_description> Don't follow symlinks. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GFileType"> +<description> +Indicates the file's on-disk type. + +</description> +<parameters> +<parameter name="G_FILE_TYPE_UNKNOWN"> +<parameter_description> File's type is unknown. +</parameter_description> +</parameter> +<parameter name="G_FILE_TYPE_REGULAR"> +<parameter_description> File handle represents a regular file. +</parameter_description> +</parameter> +<parameter name="G_FILE_TYPE_DIRECTORY"> +<parameter_description> File handle represents a directory. +</parameter_description> +</parameter> +<parameter name="G_FILE_TYPE_SYMBOLIC_LINK"> +<parameter_description> File handle represents a symbolic link +(Unix systems). +</parameter_description> +</parameter> +<parameter name="G_FILE_TYPE_SPECIAL"> +<parameter_description> File is a "special" file, such as a socket, fifo, +block device, or character device. +</parameter_description> +</parameter> +<parameter name="G_FILE_TYPE_SHORTCUT"> +<parameter_description> File is a shortcut (Windows systems). +</parameter_description> +</parameter> +<parameter name="G_FILE_TYPE_MOUNTABLE"> +<parameter_description> File is a mountable location. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GFilenameCompleter::got-completion-data"> <description> Emitted when the file name completion information comes available. @@ -2205,6 +3499,274 @@ Emitted when the file name completion information comes available. <return></return> </signal> +<enum name="GFilesystemPreviewType"> +<description> +Indicates a hint from the file system whether files should be +previewed in a file manager. Returned as the value of the key +#G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW. + +</description> +<parameters> +<parameter name="G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS"> +<parameter_description> Only preview files if user has explicitly requested it. +</parameter_description> +</parameter> +<parameter name="G_FILESYSTEM_PREVIEW_TYPE_IF_LOCAL"> +<parameter_description> Preview files if user has requested preview of "local" files. +</parameter_description> +</parameter> +<parameter name="G_FILESYSTEM_PREVIEW_TYPE_NEVER"> +<parameter_description> Never preview files. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GIOErrorEnum"> +<description> +Error codes returned by GIO functions. + + +</description> +<parameters> +<parameter name="G_IO_ERROR_FAILED"> +<parameter_description> Generic error condition for when any operation fails. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_NOT_FOUND"> +<parameter_description> File not found. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_EXISTS"> +<parameter_description> File already exists. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_IS_DIRECTORY"> +<parameter_description> File is a directory. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_NOT_DIRECTORY"> +<parameter_description> File is not a directory. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_NOT_EMPTY"> +<parameter_description> File is a directory that isn't empty. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_NOT_REGULAR_FILE"> +<parameter_description> File is not a regular file. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_NOT_SYMBOLIC_LINK"> +<parameter_description> File is not a symbolic link. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_NOT_MOUNTABLE_FILE"> +<parameter_description> File cannot be mounted. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_FILENAME_TOO_LONG"> +<parameter_description> Filename is too many characters. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_INVALID_FILENAME"> +<parameter_description> Filename is invalid or contains invalid characters. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_TOO_MANY_LINKS"> +<parameter_description> File contains too many symbolic links. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_NO_SPACE"> +<parameter_description> No space left on drive. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_INVALID_ARGUMENT"> +<parameter_description> Invalid argument. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_PERMISSION_DENIED"> +<parameter_description> Permission denied. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_NOT_SUPPORTED"> +<parameter_description> Operation not supported for the current backend. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_NOT_MOUNTED"> +<parameter_description> File isn't mounted. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_ALREADY_MOUNTED"> +<parameter_description> File is already mounted. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_CLOSED"> +<parameter_description> File was closed. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_CANCELLED"> +<parameter_description> Operation was cancelled. See #GCancellable. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_PENDING"> +<parameter_description> Operations are still pending. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_READ_ONLY"> +<parameter_description> File is read only. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_CANT_CREATE_BACKUP"> +<parameter_description> Backup couldn't be created. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_WRONG_ETAG"> +<parameter_description> File's Entity Tag was incorrect. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_TIMED_OUT"> +<parameter_description> Operation timed out. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_WOULD_RECURSE"> +<parameter_description> Operation would be recursive. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_BUSY"> +<parameter_description> File is busy. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_WOULD_BLOCK"> +<parameter_description> Operation would block. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_HOST_NOT_FOUND"> +<parameter_description> Host couldn't be found (remote operations). +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_WOULD_MERGE"> +<parameter_description> Operation would merge files. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_FAILED_HANDLED"> +<parameter_description> Operation failed and a helper program has +already interacted with the user. Do not display any error dialog. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_TOO_MANY_OPEN_FILES"> +<parameter_description> The current process has too many files +open and can't open any more. Duplicate descriptors do count toward +this limit. Since 2.20 +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_NOT_INITIALIZED"> +<parameter_description> The object has not been initialized. Since 2.22 +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_ADDRESS_IN_USE"> +<parameter_description> The requested address is already in use. Since 2.22 +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_PARTIAL_INPUT"> +<parameter_description> Need more input to finish operation. Since 2.24 +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_INVALID_DATA"> +<parameter_description> There input data was invalid. Since 2.24 +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_DBUS_ERROR"> +<parameter_description> A remote object generated an error that +doesn't correspond to a locally registered #GError error +domain. Use g_dbus_error_get_remote_error() to extract the D-Bus +error name and g_dbus_error_strip_remote_error() to fix up the +message so it matches what was received on the wire. Since 2.26. +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_HOST_UNREACHABLE"> +<parameter_description> Host unreachable. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_NETWORK_UNREACHABLE"> +<parameter_description> Network unreachable. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_CONNECTION_REFUSED"> +<parameter_description> Connection refused. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_PROXY_FAILED"> +<parameter_description> Connection to proxy server failed. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_PROXY_AUTH_FAILED"> +<parameter_description> Proxy authentication failed. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_PROXY_NEED_AUTH"> +<parameter_description> Proxy server needs authentication. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_PROXY_NOT_ALLOWED"> +<parameter_description> Proxy connection is not allowed by ruleset. +Since 2.26 +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GIOModuleScopeFlags"> +<description> +Flags for use with g_io_module_scope_new(). + +Since: 2.30 + +</description> +<parameters> +<parameter name="G_IO_MODULE_SCOPE_NONE"> +<parameter_description> No module scan flags +</parameter_description> +</parameter> +<parameter name="G_IO_MODULE_SCOPE_BLOCK_DUPLICATES"> +<parameter_description> When using this scope to load or +scan modules, automatically block a modules which has the same base +basename as previously loaded module. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GIOStreamSpliceFlags"> +<description> +GIOStreamSpliceFlags determine how streams should be spliced. + +Since: 2.28 + +</description> +<parameters> +<parameter name="G_IO_STREAM_SPLICE_NONE"> +<parameter_description> Do not close either stream. +</parameter_description> +</parameter> +<parameter name="G_IO_STREAM_SPLICE_CLOSE_STREAM1"> +<parameter_description> Close the first stream after +the splice. +</parameter_description> +</parameter> +<parameter name="G_IO_STREAM_SPLICE_CLOSE_STREAM2"> +<parameter_description> Close the second stream after +the splice. +</parameter_description> +</parameter> +<parameter name="G_IO_STREAM_SPLICE_WAIT_FOR_BOTH"> +<parameter_description> Wait for both splice operations to finish +before calling the callback. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GMenuModel::items-changed"> <description> Emitted when a change has occured to the menu. @@ -2298,6 +3860,19 @@ finalized. <return></return> </signal> +<enum name="GMountMountFlags"> +<description> +Flags used when mounting a mount. + +</description> +<parameters> +<parameter name="G_MOUNT_MOUNT_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GMountOperation::aborted"> <description> Emitted by the backend when e.g. a device becomes unavailable @@ -2479,6 +4054,49 @@ is completed <return></return> </signal> +<enum name="GMountOperationResult"> +<description> +#GMountOperationResult is returned as a result when a request for +information is send by the mounting operation. + +</description> +<parameters> +<parameter name="G_MOUNT_OPERATION_HANDLED"> +<parameter_description> The request was fulfilled and the +user specified data is now available +</parameter_description> +</parameter> +<parameter name="G_MOUNT_OPERATION_ABORTED"> +<parameter_description> The user requested the mount operation +to be aborted +</parameter_description> +</parameter> +<parameter name="G_MOUNT_OPERATION_UNHANDLED"> +<parameter_description> The request was unhandled (i.e. not +implemented) +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GMountUnmountFlags"> +<description> +Flags used when an unmounting a mount. + +</description> +<parameters> +<parameter name="G_MOUNT_UNMOUNT_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_MOUNT_UNMOUNT_FORCE"> +<parameter_description> Unmount even if there are outstanding +file operations on the mount. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GNetworkMonitor::network-changed"> <description> Emitted when the network configuration changes. If @available is @@ -2503,6 +4121,53 @@ Since: 2.32 <return></return> </signal> +<enum name="GOutputStreamSpliceFlags"> +<description> +GOutputStreamSpliceFlags determine how streams should be spliced. + +</description> +<parameters> +<parameter name="G_OUTPUT_STREAM_SPLICE_NONE"> +<parameter_description> Do not close either stream. +</parameter_description> +</parameter> +<parameter name="G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE"> +<parameter_description> Close the source stream after +the splice. +</parameter_description> +</parameter> +<parameter name="G_OUTPUT_STREAM_SPLICE_CLOSE_TARGET"> +<parameter_description> Close the target stream after +the splice. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GPasswordSave"> +<description> +#GPasswordSave is used to indicate the lifespan of a saved password. + +#Gvfs stores passwords in the Gnome keyring when this flag allows it +to, and later retrieves it again from there. + +</description> +<parameters> +<parameter name="G_PASSWORD_SAVE_NEVER"> +<parameter_description> never save a password. +</parameter_description> +</parameter> +<parameter name="G_PASSWORD_SAVE_FOR_SESSION"> +<parameter_description> save a password for the session. +</parameter_description> +</parameter> +<parameter name="G_PASSWORD_SAVE_PERMANENTLY"> +<parameter_description> save a password permanently. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GResolver::reload"> <description> Emitted when the resolver notices that the system resolver @@ -2518,6 +4183,141 @@ configuration has changed. <return></return> </signal> +<enum name="GResolverError"> +<description> +An error code used with %G_RESOLVER_ERROR in a #GError returned +from a #GResolver routine. + +Since: 2.22 + +</description> +<parameters> +<parameter name="G_RESOLVER_ERROR_NOT_FOUND"> +<parameter_description> the requested name/address/service was not +found +</parameter_description> +</parameter> +<parameter name="G_RESOLVER_ERROR_TEMPORARY_FAILURE"> +<parameter_description> the requested information could not +be looked up due to a network error or similar problem +</parameter_description> +</parameter> +<parameter name="G_RESOLVER_ERROR_INTERNAL"> +<parameter_description> unknown error +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GResolverRecordType"> +<description> +The type of record that g_resolver_lookup_records() or +g_resolver_lookup_records_async() should retrieve. The records are returned +as lists of #GVariant tuples. Each record type has different values in +the variant tuples returned. + +%G_RESOLVER_RECORD_SRV records are returned as variants with the signature +'(qqqs)', containing a guint16 with the priority, a guint16 with the +weight, a guint16 with the port, and a string of the hostname. + +%G_RESOLVER_RECORD_MX records are returned as variants with the signature +'(qs)', representing a guint16 with the preference, and a string containing +the mail exchanger hostname. + +%G_RESOLVER_RECORD_TXT records are returned as variants with the signature +'(as)', representing an array of the strings in the text record. + +%G_RESOLVER_RECORD_SOA records are returned as variants with the signature +'(ssuuuuu)', representing a string containing the primary name server, a +string containing the administrator, the serial as a guint32, the refresh +interval as guint32, the retry interval as a guint32, the expire timeout +as a guint32, and the ttl as a guint32. + +%G_RESOLVER_RECORD_NS records are returned as variants with the signature +'(s)', representing a string of the hostname of the name server. + +Since: 2.34 + +</description> +<parameters> +<parameter name="G_RESOLVER_RECORD_SRV"> +<parameter_description> lookup DNS SRV records for a domain +</parameter_description> +</parameter> +<parameter name="G_RESOLVER_RECORD_MX"> +<parameter_description> lookup DNS MX records for a domain +</parameter_description> +</parameter> +<parameter name="G_RESOLVER_RECORD_TXT"> +<parameter_description> lookup DNS TXT records for a name +</parameter_description> +</parameter> +<parameter name="G_RESOLVER_RECORD_SOA"> +<parameter_description> lookup DNS SOA records for a zone +</parameter_description> +</parameter> +<parameter name="G_RESOLVER_RECORD_NS"> +<parameter_description> lookup DNS NS records for a domain +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GResourceError"> +<description> +An error code used with %G_RESOURCE_ERROR in a #GError returned +from a #GResource routine. + +Since: 2.32 + +</description> +<parameters> +<parameter name="G_RESOURCE_ERROR_NOT_FOUND"> +<parameter_description> no file was found at the requested path +</parameter_description> +</parameter> +<parameter name="G_RESOURCE_ERROR_INTERNAL"> +<parameter_description> unknown error +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GResourceFlags"> +<description> +GResourceFlags give information about a particular file inside a resource +bundle. + +Since: 2.32 + +</description> +<parameters> +<parameter name="G_RESOURCE_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +<parameter name="G_RESOURCE_FLAGS_COMPRESSED"> +<parameter_description> The file is compressed. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GResourceLookupFlags"> +<description> +GResourceLookupFlags determine how resource path lookups are handled. + +Since: 2.32 + +</description> +<parameters> +<parameter name="G_RESOURCE_LOOKUP_FLAGS_NONE"> +<parameter_description> No flags set. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GSettings::change-event"> <description> The "change-event" signal is emitted once per change event that @@ -2644,6 +4444,46 @@ callbacks when the writability of "x" changes. <return></return> </signal> +<enum name="GSettingsBindFlags"> +<description> +Flags used when creating a binding. These flags determine in which +direction the binding works. The default is to synchronize in both +directions. + +</description> +<parameters> +<parameter name="G_SETTINGS_BIND_DEFAULT"> +<parameter_description> Equivalent to <literal>G_SETTINGS_BIND_GET|G_SETTINGS_BIND_SET</literal> +</parameter_description> +</parameter> +<parameter name="G_SETTINGS_BIND_GET"> +<parameter_description> Update the #GObject property when the setting changes. +It is an error to use this flag if the property is not writable. +</parameter_description> +</parameter> +<parameter name="G_SETTINGS_BIND_SET"> +<parameter_description> Update the setting when the #GObject property changes. +It is an error to use this flag if the property is not readable. +</parameter_description> +</parameter> +<parameter name="G_SETTINGS_BIND_NO_SENSITIVITY"> +<parameter_description> Do not try to bind a "sensitivity" property to the writability of the setting +</parameter_description> +</parameter> +<parameter name="G_SETTINGS_BIND_GET_NO_CHANGES"> +<parameter_description> When set in addition to #G_SETTINGS_BIND_GET, set the #GObject property +value initially from the setting, but do not listen for changes of the setting +</parameter_description> +</parameter> +<parameter name="G_SETTINGS_BIND_INVERT_BOOLEAN"> +<parameter_description> When passed to g_settings_bind(), uses a pair of mapping functions that invert +the boolean value when mapping between the setting and the property. The setting and property must both +be booleans. You cannot pass this flag to g_settings_bind_with_mapping(). +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GSimpleAction::activate"> <description> Indicates that the action was just activated. @@ -2834,6 +4674,162 @@ Since: 2.32 <return></return> </signal> +<enum name="GSocketClientEvent"> +<description> +Describes an event occurring on a #GSocketClient. See the +#GSocketClient::event signal for more details. + +Additional values may be added to this type in the future. + +Since: 2.32 + +</description> +<parameters> +<parameter name="G_SOCKET_CLIENT_RESOLVING"> +<parameter_description> The client is doing a DNS lookup. +</parameter_description> +</parameter> +<parameter name="G_SOCKET_CLIENT_RESOLVED"> +<parameter_description> The client has completed a DNS lookup. +</parameter_description> +</parameter> +<parameter name="G_SOCKET_CLIENT_CONNECTING"> +<parameter_description> The client is connecting to a remote +host (either a proxy or the destination server). +</parameter_description> +</parameter> +<parameter name="G_SOCKET_CLIENT_CONNECTED"> +<parameter_description> The client has connected to a remote +host. +</parameter_description> +</parameter> +<parameter name="G_SOCKET_CLIENT_PROXY_NEGOTIATING"> +<parameter_description> The client is negotiating +with a proxy to connect to the destination server. +</parameter_description> +</parameter> +<parameter name="G_SOCKET_CLIENT_PROXY_NEGOTIATED"> +<parameter_description> The client has negotiated +with the proxy server. +</parameter_description> +</parameter> +<parameter name="G_SOCKET_CLIENT_TLS_HANDSHAKING"> +<parameter_description> The client is performing a +TLS handshake. +</parameter_description> +</parameter> +<parameter name="G_SOCKET_CLIENT_TLS_HANDSHAKED"> +<parameter_description> The client has performed a +TLS handshake. +</parameter_description> +</parameter> +<parameter name="G_SOCKET_CLIENT_COMPLETE"> +<parameter_description> The client is done with a particular +#GSocketConnectable. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GSocketFamily"> +<description> +The protocol family of a #GSocketAddress. (These values are +identical to the system defines %AF_INET, %AF_INET6 and %AF_UNIX, +if available.) + +Since: 2.22 + +</description> +<parameters> +<parameter name="G_SOCKET_FAMILY_INVALID"> +<parameter_description> no address family +</parameter_description> +</parameter> +<parameter name="G_SOCKET_FAMILY_IPV4"> +<parameter_description> the IPv4 family +</parameter_description> +</parameter> +<parameter name="G_SOCKET_FAMILY_IPV6"> +<parameter_description> the IPv6 family +</parameter_description> +</parameter> +<parameter name="G_SOCKET_FAMILY_UNIX"> +<parameter_description> the UNIX domain family +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GSocketMsgFlags"> +<description> +Flags used in g_socket_receive_message() and g_socket_send_message(). +The flags listed in the enum are some commonly available flags, but the +values used for them are the same as on the platform, and any other flags +are passed in/out as is. So to use a platform specific flag, just include +the right system header and pass in the flag. + +Since: 2.22 + +</description> +<parameters> +<parameter name="G_SOCKET_MSG_NONE"> +<parameter_description> No flags. +</parameter_description> +</parameter> +<parameter name="G_SOCKET_MSG_OOB"> +<parameter_description> Request to send/receive out of band data. +</parameter_description> +</parameter> +<parameter name="G_SOCKET_MSG_PEEK"> +<parameter_description> Read data from the socket without removing it from +the queue. +</parameter_description> +</parameter> +<parameter name="G_SOCKET_MSG_DONTROUTE"> +<parameter_description> Don't use a gateway to send out the packet, +only send to hosts on directly connected networks. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GSocketProtocol"> +<description> +A protocol identifier is specified when creating a #GSocket, which is a +family/type specific identifier, where 0 means the default protocol for +the particular family/type. + +This enum contains a set of commonly available and used protocols. You +can also pass any other identifiers handled by the platform in order to +use protocols not listed here. + +Since: 2.22 + +</description> +<parameters> +<parameter name="G_SOCKET_PROTOCOL_UNKNOWN"> +<parameter_description> The protocol type is unknown +</parameter_description> +</parameter> +<parameter name="G_SOCKET_PROTOCOL_DEFAULT"> +<parameter_description> The default protocol for the family/type +</parameter_description> +</parameter> +<parameter name="G_SOCKET_PROTOCOL_TCP"> +<parameter_description> TCP over IP +</parameter_description> +</parameter> +<parameter name="G_SOCKET_PROTOCOL_UDP"> +<parameter_description> UDP over IP +</parameter_description> +</parameter> +<parameter name="G_SOCKET_PROTOCOL_SCTP"> +<parameter_description> SCTP over IP +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GSocketService::incoming"> <description> The ::incoming signal is emitted when a new incoming connection @@ -2867,6 +4863,51 @@ g_socket_listener_add_address() </return> </signal> +<enum name="GSocketType"> +<description> +Flags used when creating a #GSocket. Some protocols may not implement +all the socket types. + +Since: 2.22 + +</description> +<parameters> +<parameter name="G_SOCKET_TYPE_INVALID"> +<parameter_description> Type unknown or wrong +</parameter_description> +</parameter> +<parameter name="G_SOCKET_TYPE_STREAM"> +<parameter_description> Reliable connection-based byte streams (e.g. TCP). +</parameter_description> +</parameter> +<parameter name="G_SOCKET_TYPE_DATAGRAM"> +<parameter_description> Connectionless, unreliable datagram passing. +(e.g. UDP) +</parameter_description> +</parameter> +<parameter name="G_SOCKET_TYPE_SEQPACKET"> +<parameter_description> Reliable connection-based passing of datagrams +of fixed maximum length (e.g. SCTP). +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTestDBusFlags"> +<description> +Flags to define future #GTestDBus behaviour. + +Since: 2.34 + +</description> +<parameters> +<parameter name="G_TEST_DBUS_NONE"> +<parameter_description> No flags. +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GThreadedSocketService::run"> <description> The ::run signal is emitted in a worker thread in response to an @@ -2894,6 +4935,83 @@ not return until the connection is closed. </return> </signal> +<enum name="GTlsAuthenticationMode"> +<description> +The client authentication mode for a #GTlsServerConnection. + +Since: 2.28 + +</description> +<parameters> +<parameter name="G_TLS_AUTHENTICATION_NONE"> +<parameter_description> client authentication not required +</parameter_description> +</parameter> +<parameter name="G_TLS_AUTHENTICATION_REQUESTED"> +<parameter_description> client authentication is requested +</parameter_description> +</parameter> +<parameter name="G_TLS_AUTHENTICATION_REQUIRED"> +<parameter_description> client authentication is required +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTlsCertificateFlags"> +<description> +A set of flags describing TLS certification validation. This can be +used to set which validation steps to perform (eg, with +g_tls_client_connection_set_validation_flags()), or to describe why +a particular certificate was rejected (eg, in +#GTlsConnection::accept-certificate). + +Since: 2.28 + +</description> +<parameters> +<parameter name="G_TLS_CERTIFICATE_UNKNOWN_CA"> +<parameter_description> The signing certificate authority is +not known. +</parameter_description> +</parameter> +<parameter name="G_TLS_CERTIFICATE_BAD_IDENTITY"> +<parameter_description> The certificate does not match the +expected identity of the site that it was retrieved from. +</parameter_description> +</parameter> +<parameter name="G_TLS_CERTIFICATE_NOT_ACTIVATED"> +<parameter_description> The certificate's activation time +is still in the future +</parameter_description> +</parameter> +<parameter name="G_TLS_CERTIFICATE_EXPIRED"> +<parameter_description> The certificate has expired +</parameter_description> +</parameter> +<parameter name="G_TLS_CERTIFICATE_REVOKED"> +<parameter_description> The certificate has been revoked +according to the #GTlsConnection's certificate revocation list. +</parameter_description> +</parameter> +<parameter name="G_TLS_CERTIFICATE_INSECURE"> +<parameter_description> The certificate's algorithm is +considered insecure. +</parameter_description> +</parameter> +<parameter name="G_TLS_CERTIFICATE_GENERIC_ERROR"> +<parameter_description> Some other error occurred validating +the certificate +</parameter_description> +</parameter> +<parameter name="G_TLS_CERTIFICATE_VALIDATE_ALL"> +<parameter_description> the combination of all of the above +flags +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GTlsConnection::accept-certificate"> <description> Emitted during the TLS handshake after the peer certificate has @@ -2955,6 +5073,169 @@ no one else overrides it. </return> </signal> +<enum name="GTlsDatabaseLookupFlags"> +<description> +Flags for g_tls_database_lookup_certificate_handle(), +g_tls_database_lookup_certificate_issuer(), +and g_tls_database_lookup_certificates_issued_by(). + +Since: 2.30 + +</description> +<parameters> +<parameter name="G_TLS_DATABASE_LOOKUP_NONE"> +<parameter_description> No lookup flags +</parameter_description> +</parameter> +<parameter name="G_TLS_DATABASE_LOOKUP_KEYPAIR"> +<parameter_description> Restrict lookup to certificates that have +a private key. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTlsDatabaseVerifyFlags"> +<description> +Flags for g_tls_database_verify_chain(). + +Since: 2.30 + +</description> +<parameters> +<parameter name="G_TLS_DATABASE_VERIFY_NONE"> +<parameter_description> No verification flags +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTlsError"> +<description> +An error code used with %G_TLS_ERROR in a #GError returned from a +TLS-related routine. + +Since: 2.28 + +</description> +<parameters> +<parameter name="G_TLS_ERROR_UNAVAILABLE"> +<parameter_description> No TLS provider is available +</parameter_description> +</parameter> +<parameter name="G_TLS_ERROR_MISC"> +<parameter_description> Miscellaneous TLS error +</parameter_description> +</parameter> +<parameter name="G_TLS_ERROR_BAD_CERTIFICATE"> +<parameter_description> A certificate could not be parsed +</parameter_description> +</parameter> +<parameter name="G_TLS_ERROR_NOT_TLS"> +<parameter_description> The TLS handshake failed because the +peer does not seem to be a TLS server. +</parameter_description> +</parameter> +<parameter name="G_TLS_ERROR_HANDSHAKE"> +<parameter_description> The TLS handshake failed because the +peer's certificate was not acceptable. +</parameter_description> +</parameter> +<parameter name="G_TLS_ERROR_CERTIFICATE_REQUIRED"> +<parameter_description> The TLS handshake failed because +the server requested a client-side certificate, but none was +provided. See g_tls_connection_set_certificate(). +</parameter_description> +</parameter> +<parameter name="G_TLS_ERROR_EOF"> +<parameter_description> The TLS connection was closed without proper +notice, which may indicate an attack. See +g_tls_connection_set_require_close_notify(). +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTlsInteractionResult"> +<description> +#GTlsInteractionResult is returned by various functions in #GTlsInteraction +when finishing an interaction request. + +Since: 2.30 + +</description> +<parameters> +<parameter name="G_TLS_INTERACTION_UNHANDLED"> +<parameter_description> The interaction was unhandled (i.e. not +implemented). +</parameter_description> +</parameter> +<parameter name="G_TLS_INTERACTION_HANDLED"> +<parameter_description> The interaction completed, and resulting data +is available. +</parameter_description> +</parameter> +<parameter name="G_TLS_INTERACTION_FAILED"> +<parameter_description> The interaction has failed, or was cancelled. +and the operation should be aborted. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTlsPasswordFlags"> +<description> +Various flags for the password. + +Since: 2.30 + +</description> +<parameters> +<parameter name="G_TLS_PASSWORD_NONE"> +<parameter_description> No flags +</parameter_description> +</parameter> +<parameter name="G_TLS_PASSWORD_RETRY"> +<parameter_description> The password was wrong, and the user should retry. +</parameter_description> +</parameter> +<parameter name="G_TLS_PASSWORD_MANY_TRIES"> +<parameter_description> Hint to the user that the password has been +wrong many times, and the user may not have many chances left. +</parameter_description> +</parameter> +<parameter name="G_TLS_PASSWORD_FINAL_TRY"> +<parameter_description> Hint to the user that this is the last try to get +this password right. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTlsRehandshakeMode"> +<description> +When to allow rehandshaking. See +g_tls_connection_set_rehandshake_mode(). + +Since: 2.28 + +</description> +<parameters> +<parameter name="G_TLS_REHANDSHAKE_NEVER"> +<parameter_description> Never allow rehandshaking +</parameter_description> +</parameter> +<parameter name="G_TLS_REHANDSHAKE_SAFELY"> +<parameter_description> Allow safe rehandshaking only +</parameter_description> +</parameter> +<parameter name="G_TLS_REHANDSHAKE_UNSAFELY"> +<parameter_description> Allow unsafe rehandshaking +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GUnixMountMonitor::mountpoints-changed"> <description> Emitted when the unix mount points have changed. @@ -2983,6 +5264,51 @@ Emitted when the unix mounts have changed. <return></return> </signal> +<enum name="GUnixSocketAddressType"> +<description> +The type of name used by a #GUnixSocketAddress. +%G_UNIX_SOCKET_ADDRESS_PATH indicates a traditional unix domain +socket bound to a filesystem path. %G_UNIX_SOCKET_ADDRESS_ANONYMOUS +indicates a socket not bound to any name (eg, a client-side socket, +or a socket created with socketpair()). + +For abstract sockets, there are two incompatible ways of naming +them; the man pages suggest using the entire <literal>struct +sockaddr_un</literal> as the name, padding the unused parts of the +%sun_path field with zeroes; this corresponds to +%G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED. However, many programs +instead just use a portion of %sun_path, and pass an appropriate +smaller length to bind() or connect(). This is +%G_UNIX_SOCKET_ADDRESS_ABSTRACT. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_UNIX_SOCKET_ADDRESS_INVALID"> +<parameter_description> invalid +</parameter_description> +</parameter> +<parameter name="G_UNIX_SOCKET_ADDRESS_ANONYMOUS"> +<parameter_description> anonymous +</parameter_description> +</parameter> +<parameter name="G_UNIX_SOCKET_ADDRESS_PATH"> +<parameter_description> a filesystem path +</parameter_description> +</parameter> +<parameter name="G_UNIX_SOCKET_ADDRESS_ABSTRACT"> +<parameter_description> an abstract name +</parameter_description> +</parameter> +<parameter name="G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED"> +<parameter_description> an abstract name, 0-padded +to the full length of a unix socket name +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GVolume::changed"> <description> Emitted when the volume has been changed. @@ -3225,6 +5551,30 @@ Emitted when a mountable volume is removed from the system. <return></return> </signal> +<enum name="GZlibCompressorFormat"> +<description> +Used to select the type of data format to use for #GZlibDecompressor +and #GZlibCompressor. + +Since: 2.24 + +</description> +<parameters> +<parameter name="G_ZLIB_COMPRESSOR_FORMAT_ZLIB"> +<parameter_description> deflate compression with zlib header +</parameter_description> +</parameter> +<parameter name="G_ZLIB_COMPRESSOR_FORMAT_GZIP"> +<parameter_description> gzip file format +</parameter_description> +</parameter> +<parameter name="G_ZLIB_COMPRESSOR_FORMAT_RAW"> +<parameter_description> deflate compression with no header +</parameter_description> +</parameter> +</parameters> +</enum> + <function name="example_animal_call_poke"> <description> Asynchronously invokes the <link linkend="gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke">Poke()</link> D-Bus method on @proxy. @@ -3349,6 +5699,46 @@ Since: 2.30 <return></return> </function> +<function name="example_animal_dup_bar"> +<description> +Gets a copy of the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Bar">"Bar"</link> D-Bus property. + +Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. + +Since: 2.36 + +</description> +<parameters> +<parameter name="object"> +<parameter_description> A #ExampleAnimal. +</parameter_description> +</parameter> +</parameters> +<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free(). + +</return> +</function> + +<function name="example_animal_dup_foo"> +<description> +Gets a copy of the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Foo">"Foo"</link> D-Bus property. + +Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. + +Since: 2.30 + +</description> +<parameters> +<parameter name="object"> +<parameter_description> A #ExampleAnimal. +</parameter_description> +</parameter> +</parameters> +<return> The property value or %NULL if the property is not set. The returned value should be freed with g_free(). + +</return> +</function> + <function name="example_animal_dup_mood"> <description> Gets a copy of the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood">"Mood"</link> D-Bus property. @@ -3389,6 +5779,50 @@ Since: 2.30 <return></return> </function> +<function name="example_animal_get_bar"> +<description> +Gets the value of the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Bar">"Bar"</link> D-Bus property. + +Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. + +<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use example_animal_dup_bar() if on another thread.</warning> + +Since: 2.36 + +</description> +<parameters> +<parameter name="object"> +<parameter_description> A #ExampleAnimal. +</parameter_description> +</parameter> +</parameters> +<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object. + +</return> +</function> + +<function name="example_animal_get_foo"> +<description> +Gets the value of the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Foo">"Foo"</link> D-Bus property. + +Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side. + +<warning>The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where @object was constructed. Use example_animal_dup_foo() if on another thread.</warning> + +Since: 2.30 + +</description> +<parameters> +<parameter name="object"> +<parameter_description> A #ExampleAnimal. +</parameter_description> +</parameter> +</parameters> +<return> The property value or %NULL if the property is not set. Do not free the returned value, it belongs to @object. + +</return> +</function> + <function name="example_animal_get_mood"> <description> Gets the value of the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood">"Mood"</link> D-Bus property. @@ -3666,6 +6100,50 @@ Since: 2.30 </return> </function> +<function name="example_animal_set_bar"> +<description> +Sets the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Bar">"Bar"</link> D-Bus property to @value. + +Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side. + +Since: 2.36 + +</description> +<parameters> +<parameter name="object"> +<parameter_description> A #ExampleAnimal. +</parameter_description> +</parameter> +<parameter name="value"> +<parameter_description> The value to set. +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="example_animal_set_foo"> +<description> +Sets the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Foo">"Foo"</link> D-Bus property to @value. + +Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side. + +Since: 2.30 + +</description> +<parameters> +<parameter name="object"> +<parameter_description> A #ExampleAnimal. +</parameter_description> +</parameter> +<parameter name="value"> +<parameter_description> The value to set. +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="example_animal_set_mood"> <description> Sets the <link linkend="gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood">"Mood"</link> D-Bus property to @value. @@ -9670,13 +12148,11 @@ Since: 2.0 <description> Gets a machine-readable description of the <link linkend="gdbus-interface-ChangingInterfaceV10.top_of_page">ChangingInterfaceV10</link> D-Bus interface. -Since: 10.0 </description> <parameters> </parameters> <return> A #GDBusInterfaceInfo. Do not free. - </return> </function> @@ -9685,7 +12161,6 @@ Since: 10.0 Overrides all #GObject properties in the #FooiGenChangingInterfaceV10 interface for a concrete class. The properties are overridden in the order they are defined. -Since: 10.0 </description> <parameters> @@ -9699,7 +12174,6 @@ Since: 10.0 </parameter> </parameters> <return> The last property id. - </return> </function> @@ -9712,8 +12186,6 @@ You can then call foo_igen_changing_interface_v10_proxy_new_finish() to get the See foo_igen_changing_interface_v10_proxy_new_sync() for the synchronous, blocking version of this constructor. -Since: 10.0 - </description> <parameters> <parameter name="connection"> @@ -9752,7 +12224,6 @@ Since: 10.0 <description> Finishes an operation started with foo_igen_changing_interface_v10_proxy_new(). -Since: 10.0 </description> <parameters> @@ -9766,7 +12237,6 @@ Since: 10.0 </parameter> </parameters> <return> The constructed proxy object or %NULL if @error is set. - </return> </function> @@ -9779,8 +12249,6 @@ You can then call foo_igen_changing_interface_v10_proxy_new_for_bus_finish() to See foo_igen_changing_interface_v10_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor. -Since: 10.0 - </description> <parameters> <parameter name="bus_type"> @@ -9819,7 +12287,6 @@ Since: 10.0 <description> Finishes an operation started with foo_igen_changing_interface_v10_proxy_new_for_bus(). -Since: 10.0 </description> <parameters> @@ -9833,7 +12300,6 @@ Since: 10.0 </parameter> </parameters> <return> The constructed proxy object or %NULL if @error is set. - </return> </function> @@ -9845,7 +12311,6 @@ The calling thread is blocked until a reply is received. See foo_igen_changing_interface_v10_proxy_new_for_bus() for the asynchronous version of this constructor. -Since: 10.0 </description> <parameters> @@ -9875,7 +12340,6 @@ Since: 10.0 </parameter> </parameters> <return> The constructed proxy object or %NULL if @error is set. - </return> </function> @@ -9887,7 +12351,6 @@ The calling thread is blocked until a reply is received. See foo_igen_changing_interface_v10_proxy_new() for the asynchronous version of this constructor. -Since: 10.0 </description> <parameters> @@ -9917,7 +12380,6 @@ Since: 10.0 </parameter> </parameters> <return> The constructed proxy object or %NULL if @error is set. - </return> </function> @@ -9925,13 +12387,11 @@ Since: 10.0 <description> Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV10.top_of_page">ChangingInterfaceV10</link>. -Since: 10.0 </description> <parameters> </parameters> <return> The skeleton object. - </return> </function> @@ -10998,13 +13458,11 @@ Since: 2.0 <description> Gets a machine-readable description of the <link linkend="gdbus-interface-ChangingInterfaceV2.top_of_page">ChangingInterfaceV2</link> D-Bus interface. -Since: 2.0 </description> <parameters> </parameters> <return> A #GDBusInterfaceInfo. Do not free. - </return> </function> @@ -11013,7 +13471,6 @@ Since: 2.0 Overrides all #GObject properties in the #FooiGenChangingInterfaceV2 interface for a concrete class. The properties are overridden in the order they are defined. -Since: 2.0 </description> <parameters> @@ -11027,7 +13484,6 @@ Since: 2.0 </parameter> </parameters> <return> The last property id. - </return> </function> @@ -11040,8 +13496,6 @@ You can then call foo_igen_changing_interface_v2_proxy_new_finish() to get the r See foo_igen_changing_interface_v2_proxy_new_sync() for the synchronous, blocking version of this constructor. -Since: 2.0 - </description> <parameters> <parameter name="connection"> @@ -11080,7 +13534,6 @@ Since: 2.0 <description> Finishes an operation started with foo_igen_changing_interface_v2_proxy_new(). -Since: 2.0 </description> <parameters> @@ -11094,7 +13547,6 @@ Since: 2.0 </parameter> </parameters> <return> The constructed proxy object or %NULL if @error is set. - </return> </function> @@ -11107,8 +13559,6 @@ You can then call foo_igen_changing_interface_v2_proxy_new_for_bus_finish() to g See foo_igen_changing_interface_v2_proxy_new_for_bus_sync() for the synchronous, blocking version of this constructor. -Since: 2.0 - </description> <parameters> <parameter name="bus_type"> @@ -11147,7 +13597,6 @@ Since: 2.0 <description> Finishes an operation started with foo_igen_changing_interface_v2_proxy_new_for_bus(). -Since: 2.0 </description> <parameters> @@ -11161,7 +13610,6 @@ Since: 2.0 </parameter> </parameters> <return> The constructed proxy object or %NULL if @error is set. - </return> </function> @@ -11173,7 +13621,6 @@ The calling thread is blocked until a reply is received. See foo_igen_changing_interface_v2_proxy_new_for_bus() for the asynchronous version of this constructor. -Since: 2.0 </description> <parameters> @@ -11203,7 +13650,6 @@ Since: 2.0 </parameter> </parameters> <return> The constructed proxy object or %NULL if @error is set. - </return> </function> @@ -11215,7 +13661,6 @@ The calling thread is blocked until a reply is received. See foo_igen_changing_interface_v2_proxy_new() for the asynchronous version of this constructor. -Since: 2.0 </description> <parameters> @@ -11245,7 +13690,6 @@ Since: 2.0 </parameter> </parameters> <return> The constructed proxy object or %NULL if @error is set. - </return> </function> @@ -11253,13 +13697,11 @@ Since: 2.0 <description> Creates a skeleton object for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV2.top_of_page">ChangingInterfaceV2</link>. -Since: 2.0 </description> <parameters> </parameters> <return> The skeleton object. - </return> </function> @@ -13890,7 +16332,6 @@ Gets the #FooiGenChangingInterfaceV1 instance for the D-Bus interface <link l <description> Gets the #FooiGenChangingInterfaceV10 instance for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV10.top_of_page">ChangingInterfaceV10</link> on @object, if any. -Since: 10.0 </description> <parameters> @@ -13900,7 +16341,6 @@ Since: 10.0 </parameter> </parameters> <return> A #FooiGenChangingInterfaceV10 that must be freed with g_object_unref() or %NULL if @object does not implement the interface. - </return> </function> @@ -13908,7 +16348,6 @@ Since: 10.0 <description> Gets the #FooiGenChangingInterfaceV2 instance for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV2.top_of_page">ChangingInterfaceV2</link> on @object, if any. -Since: 2.0 </description> <parameters> @@ -13918,7 +16357,6 @@ Since: 2.0 </parameter> </parameters> <return> A #FooiGenChangingInterfaceV2 that must be freed with g_object_unref() or %NULL if @object does not implement the interface. - </return> </function> @@ -14416,7 +16854,6 @@ Like foo_igen_object_get_changing_interface_v10() but doesn't increase the refer <warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning> -Since: 10.0 </description> <parameters> @@ -14426,7 +16863,6 @@ Since: 10.0 </parameter> </parameters> <return> A #FooiGenChangingInterfaceV10 or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object. - </return> </function> @@ -14436,7 +16872,6 @@ Like foo_igen_object_get_changing_interface_v2() but doesn't increase the refere <warning>It is not safe to use the returned object if you are on another thread than the one where the #GDBusObjectManagerClient or #GDBusObjectManagerServer for @object is running.</warning> -Since: 2.0 </description> <parameters> @@ -14446,7 +16881,6 @@ Since: 2.0 </parameter> </parameters> <return> A #FooiGenChangingInterfaceV2 or %NULL if @object does not implement the interface. Do not free the returned object, it is owned by @object. - </return> </function> @@ -14762,8 +17196,6 @@ Sets the #FooiGenChangingInterfaceV1 instance for the D-Bus interface <link l <description> Sets the #FooiGenChangingInterfaceV10 instance for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV10.top_of_page">ChangingInterfaceV10</link> on @object. -Since: 10.0 - </description> <parameters> <parameter name="object"> @@ -14782,8 +17214,6 @@ Since: 10.0 <description> Sets the #FooiGenChangingInterfaceV2 instance for the D-Bus interface <link linkend="gdbus-interface-ChangingInterfaceV2.top_of_page">ChangingInterfaceV2</link> on @object. -Since: 2.0 - </description> <parameters> <parameter name="object"> @@ -39501,6 +41931,22 @@ associated with @extension. </return> </function> +<function name="g_io_module_load"> +<description> +Required API for GIO modules to implement. +This function is ran after the module has been loaded into GIO, +to initialize the module. + +</description> +<parameters> +<parameter name="module"> +<parameter_description> a #GIOModule. +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_io_module_new"> <description> Creates a new GIOModule that will load the specific @@ -39519,6 +41965,43 @@ or %NULL on error. </return> </function> +<function name="g_io_module_query"> +<description> +Optional API for GIO modules to implement. + +Should return a list of all the extension points that may be +implemented in this module. + +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 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 +always be loaded, initialized and then unloaded on application startup +so that it can register its extension points during init. + +Note that a module need not actually implement all the extension points +that g_io_module_query returns, since the exact list of extension may +depend on runtime issues. However all extension points actually implemented +must be returned by g_io_module_query() (if defined). + +When installing a module that implements g_io_module_query you must +run gio-querymodules in order to build the cache files required for +lazy loading. + +Since: 2.24 + +</description> +<parameters> +</parameters> +<return> A %NULL-terminated array of strings, listing the supported +extension points of the module. The array must be suitable for +freeing with g_strfreev(). + +</return> +</function> + <function name="g_io_module_scope_block"> <description> Block modules with the given @basename from being loaded when @@ -39580,6 +42063,22 @@ Since: 2.30 </return> </function> +<function name="g_io_module_unload"> +<description> +Required API for GIO modules to implement. +This function is ran when the module is being unloaded from GIO, +to finalize the module. + +</description> +<parameters> +<parameter name="module"> +<parameter_description> a #GIOModule. +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_io_modules_load_all_in_directory"> <description> Loads all the modules in the specified directory. diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml index 64ad562e..ae53b9d0 100644 --- a/glib/src/glib_docs.xml +++ b/glib/src/glib_docs.xml @@ -1,4 +1,1074 @@ <root> +<enum name="GBindingFlags"> +<description> +Flags to be passed to g_object_bind_property() or +g_object_bind_property_full(). + +This enumeration can be extended at later date. + +Since: 2.26 + +</description> +<parameters> +<parameter name="G_BINDING_DEFAULT"> +<parameter_description> The default binding; if the source property +changes, the target property is updated with its value. +</parameter_description> +</parameter> +<parameter name="G_BINDING_BIDIRECTIONAL"> +<parameter_description> Bidirectional binding; if either the +property of the source or the property of the target changes, +the other is updated. +</parameter_description> +</parameter> +<parameter name="G_BINDING_SYNC_CREATE"> +<parameter_description> Synchronize the values of the source and +target properties when creating the binding; the direction of +the synchronization is always from the source to the target. +</parameter_description> +</parameter> +<parameter name="G_BINDING_INVERT_BOOLEAN"> +<parameter_description> If the two properties being bound are +booleans, setting one to %TRUE will result in the other being +set to %FALSE and vice versa. This flag will only work for +boolean properties, and cannot be used when passing custom +transformation functions to g_object_bind_property_full(). +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GBookmarkFileError"> +<description> +Error codes returned by bookmark file parsing. + +</description> +<parameters> +<parameter name="G_BOOKMARK_FILE_ERROR_INVALID_URI"> +<parameter_description> URI was ill-formed +</parameter_description> +</parameter> +<parameter name="G_BOOKMARK_FILE_ERROR_INVALID_VALUE"> +<parameter_description> a requested field was not found +</parameter_description> +</parameter> +<parameter name="G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED"> +<parameter_description> a requested application did +not register a bookmark +</parameter_description> +</parameter> +<parameter name="G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND"> +<parameter_description> a requested URI was not found +</parameter_description> +</parameter> +<parameter name="G_BOOKMARK_FILE_ERROR_READ"> +<parameter_description> document was ill formed +</parameter_description> +</parameter> +<parameter name="G_BOOKMARK_FILE_ERROR_UNKNOWN_ENCODING"> +<parameter_description> the text being parsed was +in an unknown encoding +</parameter_description> +</parameter> +<parameter name="G_BOOKMARK_FILE_ERROR_WRITE"> +<parameter_description> an error occurred while writing +</parameter_description> +</parameter> +<parameter name="G_BOOKMARK_FILE_ERROR_FILE_NOT_FOUND"> +<parameter_description> requested file was not found +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GChecksumType"> +<description> +The hashing algorithm to be used by #GChecksum when performing the +digest of some data. + +Note that the #GChecksumType enumeration may be extended at a later +date to include new hashing algorithm types. + +Since: 2.16 + +</description> +<parameters> +<parameter name="G_CHECKSUM_MD5"> +<parameter_description> Use the MD5 hashing algorithm +</parameter_description> +</parameter> +<parameter name="G_CHECKSUM_SHA1"> +<parameter_description> Use the SHA-1 hashing algorithm +</parameter_description> +</parameter> +<parameter name="G_CHECKSUM_SHA256"> +<parameter_description> Use the SHA-256 hashing algorithm +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GConnectFlags"> +<description> +The connection flags are used to specify the behaviour of a signal's +connection. + +</description> +<parameters> +<parameter name="G_CONNECT_AFTER"> +<parameter_description> whether the handler should be called before or after the +default handler of the signal. +</parameter_description> +</parameter> +<parameter name="G_CONNECT_SWAPPED"> +<parameter_description> whether the instance and data should be swapped when +calling the handler. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GConvertError"> +<description> +Error codes returned by character set conversion routines. + +</description> +<parameters> +<parameter name="G_CONVERT_ERROR_NO_CONVERSION"> +<parameter_description> Conversion between the requested character +sets is not supported. +</parameter_description> +</parameter> +<parameter name="G_CONVERT_ERROR_ILLEGAL_SEQUENCE"> +<parameter_description> Invalid byte sequence in conversion input. +</parameter_description> +</parameter> +<parameter name="G_CONVERT_ERROR_FAILED"> +<parameter_description> Conversion failed for some reason. +</parameter_description> +</parameter> +<parameter name="G_CONVERT_ERROR_PARTIAL_INPUT"> +<parameter_description> Partial character sequence at end of input. +</parameter_description> +</parameter> +<parameter name="G_CONVERT_ERROR_BAD_URI"> +<parameter_description> URI is invalid. +</parameter_description> +</parameter> +<parameter name="G_CONVERT_ERROR_NOT_ABSOLUTE_PATH"> +<parameter_description> Pathname is not an absolute path. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDateDMY"> +<description> +This enumeration isn't used in the API, but may be useful if you need +to mark a number as a day, month, or year. + +</description> +<parameters> +<parameter name="G_DATE_DAY"> +<parameter_description> a day +</parameter_description> +</parameter> +<parameter name="G_DATE_MONTH"> +<parameter_description> a month +</parameter_description> +</parameter> +<parameter name="G_DATE_YEAR"> +<parameter_description> a year +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDateMonth"> +<description> +Enumeration representing a month; values are #G_DATE_JANUARY, +#G_DATE_FEBRUARY, etc. #G_DATE_BAD_MONTH is the invalid value. + +</description> +<parameters> +<parameter name="G_DATE_BAD_MONTH"> +<parameter_description> invalid value +</parameter_description> +</parameter> +<parameter name="G_DATE_JANUARY"> +<parameter_description> January +</parameter_description> +</parameter> +<parameter name="G_DATE_FEBRUARY"> +<parameter_description> February +</parameter_description> +</parameter> +<parameter name="G_DATE_MARCH"> +<parameter_description> March +</parameter_description> +</parameter> +<parameter name="G_DATE_APRIL"> +<parameter_description> April +</parameter_description> +</parameter> +<parameter name="G_DATE_MAY"> +<parameter_description> May +</parameter_description> +</parameter> +<parameter name="G_DATE_JUNE"> +<parameter_description> June +</parameter_description> +</parameter> +<parameter name="G_DATE_JULY"> +<parameter_description> July +</parameter_description> +</parameter> +<parameter name="G_DATE_AUGUST"> +<parameter_description> August +</parameter_description> +</parameter> +<parameter name="G_DATE_SEPTEMBER"> +<parameter_description> September +</parameter_description> +</parameter> +<parameter name="G_DATE_OCTOBER"> +<parameter_description> October +</parameter_description> +</parameter> +<parameter name="G_DATE_NOVEMBER"> +<parameter_description> November +</parameter_description> +</parameter> +<parameter name="G_DATE_DECEMBER"> +<parameter_description> December +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GDateWeekday"> +<description> +Enumeration representing a day of the week; #G_DATE_MONDAY, +#G_DATE_TUESDAY, etc. #G_DATE_BAD_WEEKDAY is an invalid weekday. + +</description> +<parameters> +<parameter name="G_DATE_BAD_WEEKDAY"> +<parameter_description> invalid value +</parameter_description> +</parameter> +<parameter name="G_DATE_MONDAY"> +<parameter_description> Monday +</parameter_description> +</parameter> +<parameter name="G_DATE_TUESDAY"> +<parameter_description> Tuesday +</parameter_description> +</parameter> +<parameter name="G_DATE_WEDNESDAY"> +<parameter_description> Wednesday +</parameter_description> +</parameter> +<parameter name="G_DATE_THURSDAY"> +<parameter_description> Thursday +</parameter_description> +</parameter> +<parameter name="G_DATE_FRIDAY"> +<parameter_description> Friday +</parameter_description> +</parameter> +<parameter name="G_DATE_SATURDAY"> +<parameter_description> Saturday +</parameter_description> +</parameter> +<parameter name="G_DATE_SUNDAY"> +<parameter_description> Sunday +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GErrorType"> +<description> +The possible errors, used in the @v_error field +of #GTokenValue, when the token is a %G_TOKEN_ERROR. + +</description> +<parameters> +<parameter name="G_ERR_UNKNOWN"> +<parameter_description> unknown error +</parameter_description> +</parameter> +<parameter name="G_ERR_UNEXP_EOF"> +<parameter_description> unexpected end of file +</parameter_description> +</parameter> +<parameter name="G_ERR_UNEXP_EOF_IN_STRING"> +<parameter_description> unterminated string constant +</parameter_description> +</parameter> +<parameter name="G_ERR_UNEXP_EOF_IN_COMMENT"> +<parameter_description> unterminated comment +</parameter_description> +</parameter> +<parameter name="G_ERR_NON_DIGIT_IN_CONST"> +<parameter_description> non-digit character in a number +</parameter_description> +</parameter> +<parameter name="G_ERR_DIGIT_RADIX"> +<parameter_description> digit beyond radix in a number +</parameter_description> +</parameter> +<parameter name="G_ERR_FLOAT_RADIX"> +<parameter_description> non-decimal floating point number +</parameter_description> +</parameter> +<parameter name="G_ERR_FLOAT_MALFORMED"> +<parameter_description> malformed floating point number +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GFileError"> +<description> +Values corresponding to @errno codes returned from file operations +on UNIX. Unlike @errno codes, GFileError values are available on +all systems, even Windows. The exact meaning of each code depends +on what sort of file operation you were performing; the UNIX +documentation gives more details. The following error code descriptions +come from the GNU C Library manual, and are under the copyright +of that manual. + +It's not very portable to make detailed assumptions about exactly +which errors will be returned from a given operation. Some errors +don't occur on some systems, etc., sometimes there are subtle +differences in when a system will report a given error, etc. + +</description> +<parameters> +<parameter name="G_FILE_ERROR_EXIST"> +<parameter_description> Operation not permitted; only the owner of +the file (or other resource) or processes with special privileges +can perform the operation. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_ISDIR"> +<parameter_description> File is a directory; you cannot open a directory +for writing, or create or remove hard links to it. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_ACCES"> +<parameter_description> Permission denied; the file permissions do not +allow the attempted operation. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_NAMETOOLONG"> +<parameter_description> Filename too long. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_NOENT"> +<parameter_description> No such file or directory. This is a "file +doesn't exist" error for ordinary files that are referenced in +contexts where they are expected to already exist. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_NOTDIR"> +<parameter_description> A file that isn't a directory was specified when +a directory is required. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_NXIO"> +<parameter_description> No such device or address. The system tried to +use the device represented by a file you specified, and it +couldn't find the device. This can mean that the device file was +installed incorrectly, or that the physical device is missing or +not correctly attached to the computer. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_NODEV"> +<parameter_description> The underlying file system of the specified file +does not support memory mapping. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_ROFS"> +<parameter_description> The directory containing the new link can't be +modified because it's on a read-only file system. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_TXTBSY"> +<parameter_description> Text file busy. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_FAULT"> +<parameter_description> You passed in a pointer to bad memory. +(GLib won't reliably return this, don't pass in pointers to bad +memory.) +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_LOOP"> +<parameter_description> Too many levels of symbolic links were encountered +in looking up a file name. This often indicates a cycle of symbolic +links. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_NOSPC"> +<parameter_description> No space left on device; write operation on a +file failed because the disk is full. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_NOMEM"> +<parameter_description> No memory available. The system cannot allocate +more virtual memory because its capacity is full. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_MFILE"> +<parameter_description> The current process has too many files open and +can't open any more. Duplicate descriptors do count toward this +limit. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_NFILE"> +<parameter_description> There are too many distinct file openings in the +entire system. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_BADF"> +<parameter_description> Bad file descriptor; for example, I/O on a +descriptor that has been closed or reading from a descriptor open +only for writing (or vice versa). +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_INVAL"> +<parameter_description> Invalid argument. This is used to indicate +various kinds of problems with passing the wrong argument to a +library function. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_PIPE"> +<parameter_description> Broken pipe; there is no process reading from the +other end of a pipe. Every library function that returns this +error code also generates a `SIGPIPE' signal; this signal +terminates the program if not handled or blocked. Thus, your +program will never actually see this code unless it has handled +or blocked `SIGPIPE'. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_AGAIN"> +<parameter_description> Resource temporarily unavailable; the call might +work if you try again later. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_INTR"> +<parameter_description> Interrupted function call; an asynchronous signal +occurred and prevented completion of the call. When this +happens, you should try the call again. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_IO"> +<parameter_description> Input/output error; usually used for physical read +or write errors. i.e. the disk or other physical device hardware +is returning errors. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_PERM"> +<parameter_description> Operation not permitted; only the owner of the +file (or other resource) or processes with special privileges can +perform the operation. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_NOSYS"> +<parameter_description> Function not implemented; this indicates that +the system is missing some functionality. +</parameter_description> +</parameter> +<parameter name="G_FILE_ERROR_FAILED"> +<parameter_description> Does not correspond to a UNIX error code; this +is the standard "failed for unspecified reason" error code present +in all #GError error code enumerations. Returned if no specific +code applies. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GFileTest"> +<description> +A test to perform on a file using g_file_test(). + +</description> +<parameters> +<parameter name="G_FILE_TEST_IS_REGULAR"> +<parameter_description> %TRUE if the file is a regular file +(not a directory). Note that this test will also return %TRUE +if the tested file is a symlink to a regular file. +</parameter_description> +</parameter> +<parameter name="G_FILE_TEST_IS_SYMLINK"> +<parameter_description> %TRUE if the file is a symlink. +</parameter_description> +</parameter> +<parameter name="G_FILE_TEST_IS_DIR"> +<parameter_description> %TRUE if the file is a directory. +</parameter_description> +</parameter> +<parameter name="G_FILE_TEST_IS_EXECUTABLE"> +<parameter_description> %TRUE if the file is executable. +</parameter_description> +</parameter> +<parameter name="G_FILE_TEST_EXISTS"> +<parameter_description> %TRUE if the file exists. It may or may not +be a regular file. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GFormatSizeFlags"> +<description> +Flags to modify the format of the string returned by g_format_size_full(). + +</description> +<parameters> +<parameter name="G_FORMAT_SIZE_DEFAULT"> +<parameter_description> behave the same as g_format_size() +</parameter_description> +</parameter> +<parameter name="G_FORMAT_SIZE_LONG_FORMAT"> +<parameter_description> include the exact number of bytes as part +of the returned string. For example, "45.6 kB (45,612 bytes)". +</parameter_description> +</parameter> +<parameter name="G_FORMAT_SIZE_IEC_UNITS"> +<parameter_description> use IEC (base 1024) units with "KiB"-style +suffixes. IEC units should only be used for reporting things with +a strong "power of 2" basis, like RAM sizes or RAID stripe sizes. +Network and storage sizes should be reported in the normal SI units. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GHookFlagMask"> +<description> +Flags used internally in the #GHook implementation. + +</description> +<parameters> +<parameter name="G_HOOK_FLAG_ACTIVE"> +<parameter_description> set if the hook has not been destroyed +</parameter_description> +</parameter> +<parameter name="G_HOOK_FLAG_IN_CALL"> +<parameter_description> set if the hook is currently being run +</parameter_description> +</parameter> +<parameter name="G_HOOK_FLAG_MASK"> +<parameter_description> A mask covering all bits reserved for +hook flags; see %G_HOOK_FLAG_USER_SHIFT +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GIOChannelError"> +<description> +Error codes returned by #GIOChannel operations. + +</description> +<parameters> +<parameter name="G_IO_CHANNEL_ERROR_FBIG"> +<parameter_description> File too large. +</parameter_description> +</parameter> +<parameter name="G_IO_CHANNEL_ERROR_INVAL"> +<parameter_description> Invalid argument. +</parameter_description> +</parameter> +<parameter name="G_IO_CHANNEL_ERROR_IO"> +<parameter_description> IO error. +</parameter_description> +</parameter> +<parameter name="G_IO_CHANNEL_ERROR_ISDIR"> +<parameter_description> File is a directory. +</parameter_description> +</parameter> +<parameter name="G_IO_CHANNEL_ERROR_NOSPC"> +<parameter_description> No space left on device. +</parameter_description> +</parameter> +<parameter name="G_IO_CHANNEL_ERROR_NXIO"> +<parameter_description> No such device or address. +</parameter_description> +</parameter> +<parameter name="G_IO_CHANNEL_ERROR_OVERFLOW"> +<parameter_description> Value too large for defined datatype. +</parameter_description> +</parameter> +<parameter name="G_IO_CHANNEL_ERROR_PIPE"> +<parameter_description> Broken pipe. +</parameter_description> +</parameter> +<parameter name="G_IO_CHANNEL_ERROR_FAILED"> +<parameter_description> Some other error. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GIOCondition"> +<description> +A bitwise combination representing a condition to watch for on an +event source. + +</description> +<parameters> +<parameter name="G_IO_IN"> +<parameter_description> There is data to read. +</parameter_description> +</parameter> +<parameter name="G_IO_OUT"> +<parameter_description> Data can be written (without blocking). +</parameter_description> +</parameter> +<parameter name="G_IO_PRI"> +<parameter_description> There is urgent data to read. +</parameter_description> +</parameter> +<parameter name="G_IO_ERR"> +<parameter_description> Error condition. +</parameter_description> +</parameter> +<parameter name="G_IO_HUP"> +<parameter_description> Hung up (the connection has been broken, usually for +pipes and sockets). +</parameter_description> +</parameter> +<parameter name="G_IO_NVAL"> +<parameter_description> Invalid request. The file descriptor is not open. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GIOError"> +<description> +#GIOError is only used by the deprecated functions +g_io_channel_read(), g_io_channel_write(), and g_io_channel_seek(). + +</description> +<parameters> +<parameter name="G_IO_ERROR_NONE"> +<parameter_description> no error +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_AGAIN"> +<parameter_description> an EAGAIN error occurred +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_INVAL"> +<parameter_description> an EINVAL error occurred +</parameter_description> +</parameter> +<parameter name="G_IO_ERROR_UNKNOWN"> +<parameter_description> another error occurred +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GIOFlags"> +<description> +Specifies properties of a #GIOChannel. Some of the flags can only be +read with g_io_channel_get_flags(), but not changed with +g_io_channel_set_flags(). + +</description> +<parameters> +<parameter name="G_IO_FLAG_APPEND"> +<parameter_description> turns on append mode, corresponds to <literal>O_APPEND</literal> +(see the documentation of the UNIX open() +syscall). +</parameter_description> +</parameter> +<parameter name="G_IO_FLAG_NONBLOCK"> +<parameter_description> turns on nonblocking mode, corresponds to +<literal>O_NONBLOCK</literal>/<literal>O_NDELAY</literal> +(see the documentation of the UNIX open() syscall). +</parameter_description> +</parameter> +<parameter name="G_IO_FLAG_IS_READABLE"> +<parameter_description> indicates that the io channel is readable. +This flag cannot be changed. +</parameter_description> +</parameter> +<parameter name="G_IO_FLAG_IS_WRITABLE"> +<parameter_description> indicates that the io channel is writable. +This flag cannot be changed. +</parameter_description> +</parameter> +<parameter name="G_IO_FLAG_IS_SEEKABLE"> +<parameter_description> indicates that the io channel is seekable, +i.e. that g_io_channel_seek_position() can +be used on it. This flag cannot be changed. +</parameter_description> +</parameter> +<parameter name="G_IO_FLAG_MASK"> +<parameter_description> the mask that specifies all the valid flags. +</parameter_description> +</parameter> +<parameter name="G_IO_FLAG_GET_MASK"> +<parameter_description> the mask of the flags that are returned from +g_io_channel_get_flags(). +</parameter_description> +</parameter> +<parameter name="G_IO_FLAG_SET_MASK"> +<parameter_description> the mask of the flags that the user can modify +with g_io_channel_set_flags(). +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GIOStatus"> +<description> +Stati returned by most of the #GIOFuncs functions. + +</description> +<parameters> +<parameter name="G_IO_STATUS_ERROR"> +<parameter_description> An error occurred. +</parameter_description> +</parameter> +<parameter name="G_IO_STATUS_NORMAL"> +<parameter_description> Success. +</parameter_description> +</parameter> +<parameter name="G_IO_STATUS_EOF"> +<parameter_description> End of file. +</parameter_description> +</parameter> +<parameter name="G_IO_STATUS_AGAIN"> +<parameter_description> Resource temporarily unavailable. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GKeyFileError"> +<description> +Error codes returned by key file parsing. + +</description> +<parameters> +<parameter name="G_KEY_FILE_ERROR_UNKNOWN_ENCODING"> +<parameter_description> the text being parsed was in +an unknown encoding +</parameter_description> +</parameter> +<parameter name="G_KEY_FILE_ERROR_PARSE"> +<parameter_description> document was ill-formed +</parameter_description> +</parameter> +<parameter name="G_KEY_FILE_ERROR_NOT_FOUND"> +<parameter_description> the file was not found +</parameter_description> +</parameter> +<parameter name="G_KEY_FILE_ERROR_KEY_NOT_FOUND"> +<parameter_description> a requested key was not found +</parameter_description> +</parameter> +<parameter name="G_KEY_FILE_ERROR_GROUP_NOT_FOUND"> +<parameter_description> a requested group was not found +</parameter_description> +</parameter> +<parameter name="G_KEY_FILE_ERROR_INVALID_VALUE"> +<parameter_description> a value could not be parsed +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GKeyFileFlags"> +<description> +Flags which influence the parsing. + +</description> +<parameters> +<parameter name="G_KEY_FILE_NONE"> +<parameter_description> No flags, default behaviour +</parameter_description> +</parameter> +<parameter name="G_KEY_FILE_KEEP_COMMENTS"> +<parameter_description> Use this flag if you plan to write the +(possibly modified) contents of the key file back to a file; +otherwise all comments will be lost when the key file is +written back. +</parameter_description> +</parameter> +<parameter name="G_KEY_FILE_KEEP_TRANSLATIONS"> +<parameter_description> Use this flag if you plan to write the +(possibly modified) contents of the key file back to a file; +otherwise only the translations for the current language will be +written back. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GLogLevelFlags"> +<description> +Flags specifying the level of log messages. + +It is possible to change how GLib treats messages of the various +levels using g_log_set_handler() and g_log_set_fatal_mask(). + +</description> +<parameters> +<parameter name="G_LOG_FLAG_RECURSION"> +<parameter_description> internal flag +</parameter_description> +</parameter> +<parameter name="G_LOG_FLAG_FATAL"> +<parameter_description> internal flag +</parameter_description> +</parameter> +<parameter name="G_LOG_LEVEL_ERROR"> +<parameter_description> log level for errors, see g_error(). +This level is also used for messages produced by g_assert(). +</parameter_description> +</parameter> +<parameter name="G_LOG_LEVEL_CRITICAL"> +<parameter_description> log level for critical messages, see g_critical(). +This level is also used for messages produced by g_return_if_fail() +and g_return_val_if_fail(). +</parameter_description> +</parameter> +<parameter name="G_LOG_LEVEL_WARNING"> +<parameter_description> log level for warnings, see g_warning() +</parameter_description> +</parameter> +<parameter name="G_LOG_LEVEL_MESSAGE"> +<parameter_description> log level for messages, see g_message() +</parameter_description> +</parameter> +<parameter name="G_LOG_LEVEL_INFO"> +<parameter_description> log level for informational messages +</parameter_description> +</parameter> +<parameter name="G_LOG_LEVEL_DEBUG"> +<parameter_description> log level for debug messages, see g_debug() +</parameter_description> +</parameter> +<parameter name="G_LOG_LEVEL_MASK"> +<parameter_description> a mask including all log levels +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GMarkupCollectType"> +<description> +A mixed enumerated type and flags field. You must specify one type +(string, strdup, boolean, tristate). Additionally, you may optionally +bitwise OR the type with the flag %G_MARKUP_COLLECT_OPTIONAL. + +It is likely that this enum will be extended in the future to +support other types. + +</description> +<parameters> +<parameter name="G_MARKUP_COLLECT_INVALID"> +<parameter_description> used to terminate the list of attributes +to collect +</parameter_description> +</parameter> +<parameter name="G_MARKUP_COLLECT_STRING"> +<parameter_description> collect the string pointer directly from +the attribute_values[] array. Expects a parameter of type (const +char **). If %G_MARKUP_COLLECT_OPTIONAL is specified and the +attribute isn't present then the pointer will be set to %NULL +</parameter_description> +</parameter> +<parameter name="G_MARKUP_COLLECT_STRDUP"> +<parameter_description> as with %G_MARKUP_COLLECT_STRING, but +expects a parameter of type (char **) and g_strdup()s the +returned pointer. The pointer must be freed with g_free() +</parameter_description> +</parameter> +<parameter name="G_MARKUP_COLLECT_BOOLEAN"> +<parameter_description> expects a parameter of type (gboolean *) +and parses the attribute value as a boolean. Sets %FALSE if the +attribute isn't present. Valid boolean values consist of +(case-insensitive) "false", "f", "no", "n", "0" and "true", "t", +"yes", "y", "1" +</parameter_description> +</parameter> +<parameter name="G_MARKUP_COLLECT_TRISTATE"> +<parameter_description> as with %G_MARKUP_COLLECT_BOOLEAN, but +in the case of a missing attribute a value is set that compares +equal to neither %FALSE nor %TRUE G_MARKUP_COLLECT_OPTIONAL is +implied +</parameter_description> +</parameter> +<parameter name="G_MARKUP_COLLECT_OPTIONAL"> +<parameter_description> can be bitwise ORed with the other fields. +If present, allows the attribute not to appear. A default value +is set depending on what value type is used +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GMarkupError"> +<description> +Error codes returned by markup parsing. + +</description> +<parameters> +<parameter name="G_MARKUP_ERROR_BAD_UTF8"> +<parameter_description> text being parsed was not valid UTF-8 +</parameter_description> +</parameter> +<parameter name="G_MARKUP_ERROR_EMPTY"> +<parameter_description> document contained nothing, or only whitespace +</parameter_description> +</parameter> +<parameter name="G_MARKUP_ERROR_PARSE"> +<parameter_description> document was ill-formed +</parameter_description> +</parameter> +<parameter name="G_MARKUP_ERROR_UNKNOWN_ELEMENT"> +<parameter_description> error should be set by #GMarkupParser +functions; element wasn't known +</parameter_description> +</parameter> +<parameter name="G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE"> +<parameter_description> error should be set by #GMarkupParser +functions; attribute wasn't known +</parameter_description> +</parameter> +<parameter name="G_MARKUP_ERROR_INVALID_CONTENT"> +<parameter_description> error should be set by #GMarkupParser +functions; content was invalid +</parameter_description> +</parameter> +<parameter name="G_MARKUP_ERROR_MISSING_ATTRIBUTE"> +<parameter_description> error should be set by #GMarkupParser +functions; a required attribute was missing +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GMarkupParseFlags"> +<description> +Flags that affect the behaviour of the parser. + +</description> +<parameters> +<parameter name="G_MARKUP_DO_NOT_USE_THIS_UNSUPPORTED_FLAG"> +<parameter_description> flag you should not use +</parameter_description> +</parameter> +<parameter name="G_MARKUP_TREAT_CDATA_AS_TEXT"> +<parameter_description> When this flag is set, CDATA marked +sections are not passed literally to the @passthrough function of +the parser. Instead, the content of the section (without the +<literal><![CDATA[</literal> and <literal>]]></literal>) is +passed to the @text function. This flag was added in GLib 2.12 +</parameter_description> +</parameter> +<parameter name="G_MARKUP_PREFIX_ERROR_POSITION"> +<parameter_description> Normally errors caught by GMarkup +itself have line/column information prefixed to them to let the +caller know the location of the error. When this flag is set the +location information is also prefixed to errors generated by the +#GMarkupParser implementation functions +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GModuleFlags"> +<description> +Flags passed to g_module_open(). +Note that these flags are not supported on all platforms. + +</description> +<parameters> +<parameter name="G_MODULE_BIND_LAZY"> +<parameter_description> specifies that symbols are only resolved when +needed. The default action is to bind all symbols when the module +is loaded. +</parameter_description> +</parameter> +<parameter name="G_MODULE_BIND_LOCAL"> +<parameter_description> specifies that symbols in the module should +not be added to the global name space. The default action on most +platforms is to place symbols in the module in the global name space, +which may cause conflicts with existing symbols. +</parameter_description> +</parameter> +<parameter name="G_MODULE_BIND_MASK"> +<parameter_description> mask for all flags. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GNormalizeMode"> +<description> +Defines how a Unicode string is transformed in a canonical +form, standardizing such issues as whether a character with +an accent is represented as a base character and combining +accent or as a single precomposed character. Unicode strings +should generally be normalized before comparing them. + +</description> +<parameters> +<parameter name="G_NORMALIZE_DEFAULT"> +<parameter_description> standardize differences that do not affect the +text content, such as the above-mentioned accent representation +</parameter_description> +</parameter> +<parameter name="G_NORMALIZE_NFD"> +<parameter_description> another name for %G_NORMALIZE_DEFAULT +</parameter_description> +</parameter> +<parameter name="G_NORMALIZE_DEFAULT_COMPOSE"> +<parameter_description> like %G_NORMALIZE_DEFAULT, but with +composed forms rather than a maximally decomposed form +</parameter_description> +</parameter> +<parameter name="G_NORMALIZE_NFC"> +<parameter_description> another name for %G_NORMALIZE_DEFAULT_COMPOSE +</parameter_description> +</parameter> +<parameter name="G_NORMALIZE_ALL"> +<parameter_description> beyond %G_NORMALIZE_DEFAULT also standardize the +"compatibility" characters in Unicode, such as SUPERSCRIPT THREE +to the standard forms (in this case DIGIT THREE). Formatting +information may be lost but for most text operations such +characters should be considered the same +</parameter_description> +</parameter> +<parameter name="G_NORMALIZE_NFKD"> +<parameter_description> another name for %G_NORMALIZE_ALL +</parameter_description> +</parameter> +<parameter name="G_NORMALIZE_ALL_COMPOSE"> +<parameter_description> like %G_NORMALIZE_ALL, but with composed +forms rather than a maximally decomposed form +</parameter_description> +</parameter> +<parameter name="G_NORMALIZE_NFKC"> +<parameter_description> another name for %G_NORMALIZE_ALL_COMPOSE +</parameter_description> +</parameter> +</parameters> +</enum> + <signal name="GObject::notify"> <description> The notify signal is emitted on an object when one of its @@ -33,6 +1103,2354 @@ detail strings for the notify signal. <return></return> </signal> +<enum name="GOnceStatus"> +<description> +The possible statuses of a one-time initialization function +controlled by a #GOnce struct. + +Since: 2.4 + +</description> +<parameters> +<parameter name="G_ONCE_STATUS_NOTCALLED"> +<parameter_description> the function has not been called yet. +</parameter_description> +</parameter> +<parameter name="G_ONCE_STATUS_PROGRESS"> +<parameter_description> the function call is currently in progress. +</parameter_description> +</parameter> +<parameter name="G_ONCE_STATUS_READY"> +<parameter_description> the function has been called. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GOptionArg"> +<description> +The #GOptionArg enum values determine which type of extra argument the +options expect to find. If an option expects an extra argument, it +can be specified in several ways; with a short option: +<option>-x arg</option>, with a long option: <option>--name arg</option> +or combined in a single argument: <option>--name=arg</option>. + +</description> +<parameters> +<parameter name="G_OPTION_ARG_NONE"> +<parameter_description> No extra argument. This is useful for simple flags. +</parameter_description> +</parameter> +<parameter name="G_OPTION_ARG_STRING"> +<parameter_description> The option takes a string argument. +</parameter_description> +</parameter> +<parameter name="G_OPTION_ARG_INT"> +<parameter_description> The option takes an integer argument. +</parameter_description> +</parameter> +<parameter name="G_OPTION_ARG_CALLBACK"> +<parameter_description> The option provides a callback to parse the +extra argument. +</parameter_description> +</parameter> +<parameter name="G_OPTION_ARG_FILENAME"> +<parameter_description> The option takes a filename as argument. +</parameter_description> +</parameter> +<parameter name="G_OPTION_ARG_STRING_ARRAY"> +<parameter_description> The option takes a string argument, multiple +uses of the option are collected into an array of strings. +</parameter_description> +</parameter> +<parameter name="G_OPTION_ARG_FILENAME_ARRAY"> +<parameter_description> The option takes a filename as argument, +multiple uses of the option are collected into an array of strings. +</parameter_description> +</parameter> +<parameter name="G_OPTION_ARG_DOUBLE"> +<parameter_description> The option takes a double argument. The argument +can be formatted either for the user's locale or for the "C" locale. Since 2.12 +</parameter_description> +</parameter> +<parameter name="G_OPTION_ARG_INT64"> +<parameter_description> The option takes a 64-bit integer. Like %G_OPTION_ARG_INT +but for larger numbers. The number can be in decimal base, or in hexadecimal +(when prefixed with <literal>0x</literal>, for example, <literal>0xffffffff</literal>). +Since 2.12 +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GOptionError"> +<description> +Error codes returned by option parsing. + +</description> +<parameters> +<parameter name="G_OPTION_ERROR_UNKNOWN_OPTION"> +<parameter_description> An option was not known to the parser. +This error will only be reported, if the parser hasn't been instructed +to ignore unknown options, see g_option_context_set_ignore_unknown_options(). +</parameter_description> +</parameter> +<parameter name="G_OPTION_ERROR_BAD_VALUE"> +<parameter_description> A value couldn't be parsed. +</parameter_description> +</parameter> +<parameter name="G_OPTION_ERROR_FAILED"> +<parameter_description> A #GOptionArgFunc callback failed. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GOptionFlags"> +<description> +Flags which modify individual options. + +</description> +<parameters> +<parameter name="G_OPTION_FLAG_HIDDEN"> +<parameter_description> The option doesn't appear in <option>--help</option> +output. +</parameter_description> +</parameter> +<parameter name="G_OPTION_FLAG_IN_MAIN"> +<parameter_description> The option appears in the main section of the +<option>--help</option> output, even if it is defined in a group. +</parameter_description> +</parameter> +<parameter name="G_OPTION_FLAG_REVERSE"> +<parameter_description> For options of the %G_OPTION_ARG_NONE kind, this flag +indicates that the sense of the option is reversed. +</parameter_description> +</parameter> +<parameter name="G_OPTION_FLAG_NO_ARG"> +<parameter_description> For options of the %G_OPTION_ARG_CALLBACK kind, +this flag indicates that the callback does not take any argument +(like a %G_OPTION_ARG_NONE option). Since 2.8 +</parameter_description> +</parameter> +<parameter name="G_OPTION_FLAG_FILENAME"> +<parameter_description> For options of the %G_OPTION_ARG_CALLBACK +kind, this flag indicates that the argument should be passed to the +callback in the GLib filename encoding rather than UTF-8. Since 2.8 +</parameter_description> +</parameter> +<parameter name="G_OPTION_FLAG_OPTIONAL_ARG"> +<parameter_description> For options of the %G_OPTION_ARG_CALLBACK +kind, this flag indicates that the argument supply is optional. If no argument +is given then data of %GOptionParseFunc will be set to NULL. Since 2.8 +</parameter_description> +</parameter> +<parameter name="G_OPTION_FLAG_NOALIAS"> +<parameter_description> This flag turns off the automatic conflict resolution +which prefixes long option names with <literal>groupname-</literal> if +there is a conflict. This option should only be used in situations where +aliasing is necessary to model some legacy commandline interface. It is +not safe to use this option, unless all option groups are under your +direct control. Since 2.8. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GParamFlags"> +<description> +Through the #GParamFlags flag values, certain aspects of parameters +can be configured. + +</description> +<parameters> +<parameter name="G_PARAM_READABLE"> +<parameter_description> the parameter is readable +</parameter_description> +</parameter> +<parameter name="G_PARAM_WRITABLE"> +<parameter_description> the parameter is writable +</parameter_description> +</parameter> +<parameter name="G_PARAM_CONSTRUCT"> +<parameter_description> the parameter will be set upon object construction +</parameter_description> +</parameter> +<parameter name="G_PARAM_CONSTRUCT_ONLY"> +<parameter_description> the parameter will only be set upon object construction +</parameter_description> +</parameter> +<parameter name="G_PARAM_LAX_VALIDATION"> +<parameter_description> upon parameter conversion (see g_param_value_convert()) +strict validation is not required +</parameter_description> +</parameter> +<parameter name="G_PARAM_STATIC_NAME"> +<parameter_description> the string used as name when constructing the +parameter is guaranteed to remain valid and +unmodified for the lifetime of the parameter. +Since 2.8 +</parameter_description> +</parameter> +<parameter name="G_PARAM_STATIC_NICK"> +<parameter_description> the string used as nick when constructing the +parameter is guaranteed to remain valid and +unmmodified for the lifetime of the parameter. +Since 2.8 +</parameter_description> +</parameter> +<parameter name="G_PARAM_STATIC_BLURB"> +<parameter_description> the string used as blurb when constructing the +parameter is guaranteed to remain valid and +unmodified for the lifetime of the parameter. +Since 2.8 +</parameter_description> +</parameter> +<parameter name="G_PARAM_PRIVATE"> +<parameter_description> internal +</parameter_description> +</parameter> +<parameter name="G_PARAM_DEPRECATED"> +<parameter_description> the parameter is deprecated and will be removed +in a future version. A warning will be generated if it is used +while running with G_ENABLE_DIAGNOSTIC=1. +Since 2.26 +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GRegexCompileFlags"> +<description> +Flags specifying compile-time options. + +Since: 2.14 + +</description> +<parameters> +<parameter name="G_REGEX_CASELESS"> +<parameter_description> Letters in the pattern match both upper- and +lowercase letters. This option can be changed within a pattern +by a "(?i)" option setting. +</parameter_description> +</parameter> +<parameter name="G_REGEX_MULTILINE"> +<parameter_description> By default, GRegex treats the strings as consisting +of a single line of characters (even if it actually contains +newlines). The "start of line" metacharacter ("^") matches only +at the start of the string, while the "end of line" metacharacter +("$") matches only at the end of the string, or before a terminating +newline (unless #G_REGEX_DOLLAR_ENDONLY is set). When +#G_REGEX_MULTILINE is set, the "start of line" and "end of line" +constructs match immediately following or immediately before any +newline in the string, respectively, as well as at the very start +and end. This can be changed within a pattern by a "(?m)" option +setting. +</parameter_description> +</parameter> +<parameter name="G_REGEX_DOTALL"> +<parameter_description> A dot metacharater (".") in the pattern matches all +characters, including newlines. Without it, newlines are excluded. +This option can be changed within a pattern by a ("?s") option setting. +</parameter_description> +</parameter> +<parameter name="G_REGEX_EXTENDED"> +<parameter_description> Whitespace data characters in the pattern are +totally ignored except when escaped or inside a character class. +Whitespace does not include the VT character (code 11). In addition, +characters between an unescaped "#" outside a character class and +the next newline character, inclusive, are also ignored. This can +be changed within a pattern by a "(?x)" option setting. +</parameter_description> +</parameter> +<parameter name="G_REGEX_ANCHORED"> +<parameter_description> The pattern is forced to be "anchored", that is, +it is constrained to match only at the first matching point in the +string that is being searched. This effect can also be achieved by +appropriate constructs in the pattern itself such as the "^" +metacharater. +</parameter_description> +</parameter> +<parameter name="G_REGEX_DOLLAR_ENDONLY"> +<parameter_description> A dollar metacharacter ("$") in the pattern +matches only at the end of the string. Without this option, a +dollar also matches immediately before the final character if +it is a newline (but not before any other newlines). This option +is ignored if #G_REGEX_MULTILINE is set. +</parameter_description> +</parameter> +<parameter name="G_REGEX_UNGREEDY"> +<parameter_description> Inverts the "greediness" of the quantifiers so that +they are not greedy by default, but become greedy if followed by "?". +It can also be set by a "(?U)" option setting within the pattern. +</parameter_description> +</parameter> +<parameter name="G_REGEX_RAW"> +<parameter_description> Usually strings must be valid UTF-8 strings, using this +flag they are considered as a raw sequence of bytes. +</parameter_description> +</parameter> +<parameter name="G_REGEX_NO_AUTO_CAPTURE"> +<parameter_description> Disables the use of numbered capturing +parentheses in the pattern. Any opening parenthesis that is not +followed by "?" behaves as if it were followed by "?:" but named +parentheses can still be used for capturing (and they acquire numbers +in the usual way). +</parameter_description> +</parameter> +<parameter name="G_REGEX_OPTIMIZE"> +<parameter_description> Optimize the regular expression. If the pattern will +be used many times, then it may be worth the effort to optimize it +to improve the speed of matches. +</parameter_description> +</parameter> +<parameter name="G_REGEX_FIRSTLINE"> +<parameter_description> Limits an unanchored pattern to match before (or at) the +first newline. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_DUPNAMES"> +<parameter_description> Names used to identify capturing subpatterns need not +be unique. This can be helpful for certain types of pattern when it +is known that only one instance of the named subpattern can ever be +matched. +</parameter_description> +</parameter> +<parameter name="G_REGEX_NEWLINE_CR"> +<parameter_description> Usually any newline character or character sequence is +recognized. If this option is set, the only recognized newline character +is '\r'. +</parameter_description> +</parameter> +<parameter name="G_REGEX_NEWLINE_LF"> +<parameter_description> Usually any newline character or character sequence is +recognized. If this option is set, the only recognized newline character +is '\n'. +</parameter_description> +</parameter> +<parameter name="G_REGEX_NEWLINE_CRLF"> +<parameter_description> Usually any newline character or character sequence is +recognized. If this option is set, the only recognized newline character +sequence is '\r\n'. +</parameter_description> +</parameter> +<parameter name="G_REGEX_NEWLINE_ANYCRLF"> +<parameter_description> Usually any newline character or character sequence +is recognized. If this option is set, the only recognized newline character +sequences are '\r', '\n', and '\r\n'. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_BSR_ANYCRLF"> +<parameter_description> Usually any newline character or character sequence +is recognised. If this option is set, then "\R" only recognizes the newline +characters '\r', '\n' and '\r\n'. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_JAVASCRIPT_COMPAT"> +<parameter_description> Changes behaviour so that it is compatible with +JavaScript rather than PCRE. Since: 2.34 +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GRegexError"> +<description> +Error codes returned by regular expressions functions. + +Since: 2.14 + +</description> +<parameters> +<parameter name="G_REGEX_ERROR_COMPILE"> +<parameter_description> Compilation of the regular expression failed. +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_OPTIMIZE"> +<parameter_description> Optimization of the regular expression failed. +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_REPLACE"> +<parameter_description> Replacement failed due to an ill-formed replacement +string. +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_MATCH"> +<parameter_description> The match process failed. +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_INTERNAL"> +<parameter_description> Internal error of the regular expression engine. +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_STRAY_BACKSLASH"> +<parameter_description> "\\" at end of pattern. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_MISSING_CONTROL_CHAR"> +<parameter_description> "\\c" at end of pattern. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_UNRECOGNIZED_ESCAPE"> +<parameter_description> Unrecognized character follows "\\". +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_QUANTIFIERS_OUT_OF_ORDER"> +<parameter_description> Numbers out of order in "{}" +quantifier. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_QUANTIFIER_TOO_BIG"> +<parameter_description> Number too big in "{}" quantifier. +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_UNTERMINATED_CHARACTER_CLASS"> +<parameter_description> Missing terminating "]" for +character class. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_INVALID_ESCAPE_IN_CHARACTER_CLASS"> +<parameter_description> Invalid escape sequence +in character class. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_RANGE_OUT_OF_ORDER"> +<parameter_description> Range out of order in character class. +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_NOTHING_TO_REPEAT"> +<parameter_description> Nothing to repeat. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_UNRECOGNIZED_CHARACTER"> +<parameter_description> Unrecognized character after "(?", +"(?<" or "(?P". Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_POSIX_NAMED_CLASS_OUTSIDE_CLASS"> +<parameter_description> POSIX named classes are +supported only within a class. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_UNMATCHED_PARENTHESIS"> +<parameter_description> Missing terminating ")" or ")" +without opening "(". Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_INEXISTENT_SUBPATTERN_REFERENCE"> +<parameter_description> Reference to non-existent +subpattern. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_UNTERMINATED_COMMENT"> +<parameter_description> Missing terminating ")" after comment. +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_EXPRESSION_TOO_LARGE"> +<parameter_description> Regular expression too large. +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_MEMORY_ERROR"> +<parameter_description> Failed to get memory. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_VARIABLE_LENGTH_LOOKBEHIND"> +<parameter_description> Lookbehind assertion is not +fixed length. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_MALFORMED_CONDITION"> +<parameter_description> Malformed number or name after "(?(". +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_TOO_MANY_CONDITIONAL_BRANCHES"> +<parameter_description> Conditional group contains +more than two branches. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_ASSERTION_EXPECTED"> +<parameter_description> Assertion expected after "(?(". +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_UNKNOWN_POSIX_CLASS_NAME"> +<parameter_description> Unknown POSIX class name. +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_POSIX_COLLATING_ELEMENTS_NOT_SUPPORTED"> +<parameter_description> POSIX collating +elements are not supported. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_HEX_CODE_TOO_LARGE"> +<parameter_description> Character value in "\\x{...}" sequence +is too large. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_INVALID_CONDITION"> +<parameter_description> Invalid condition "(?(0)". Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_SINGLE_BYTE_MATCH_IN_LOOKBEHIND"> +<parameter_description> \\C not allowed in +lookbehind assertion. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_INFINITE_LOOP"> +<parameter_description> Recursive call could loop indefinitely. +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_MISSING_SUBPATTERN_NAME_TERMINATOR"> +<parameter_description> Missing terminator +in subpattern name. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_DUPLICATE_SUBPATTERN_NAME"> +<parameter_description> Two named subpatterns have +the same name. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_MALFORMED_PROPERTY"> +<parameter_description> Malformed "\\P" or "\\p" sequence. +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_UNKNOWN_PROPERTY"> +<parameter_description> Unknown property name after "\\P" or +"\\p". Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_SUBPATTERN_NAME_TOO_LONG"> +<parameter_description> Subpattern name is too long +(maximum 32 characters). Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_TOO_MANY_SUBPATTERNS"> +<parameter_description> Too many named subpatterns (maximum +10,000). Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_INVALID_OCTAL_VALUE"> +<parameter_description> Octal value is greater than "\\377". +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_TOO_MANY_BRANCHES_IN_DEFINE"> +<parameter_description> "DEFINE" group contains more +than one branch. Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_DEFINE_REPETION"> +<parameter_description> Repeating a "DEFINE" group is not allowed. +This error is never raised. Since: 2.16 Deprecated: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_INCONSISTENT_NEWLINE_OPTIONS"> +<parameter_description> Inconsistent newline options. +Since 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_MISSING_BACK_REFERENCE"> +<parameter_description> "\\g" is not followed by a braced, +angle-bracketed, or quoted name or number, or by a plain number. Since: 2.16 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_INVALID_RELATIVE_REFERENCE"> +<parameter_description> relative reference must not be zero. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_BACKTRACKING_CONTROL_VERB_ARGUMENT_FORBIDDEN"> +<parameter_description> the backtracing +control verb used does not allow an argument. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_UNKNOWN_BACKTRACKING_CONTROL_VERB"> +<parameter_description> unknown backtracing +control verb. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_NUMBER_TOO_BIG"> +<parameter_description> number is too big in escape sequence. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_MISSING_SUBPATTERN_NAME"> +<parameter_description> Missing subpattern name. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_MISSING_DIGIT"> +<parameter_description> Missing digit. Since 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_INVALID_DATA_CHARACTER"> +<parameter_description> In JavaScript compatibility mode, +"[" is an invalid data character. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_EXTRA_SUBPATTERN_NAME"> +<parameter_description> different names for subpatterns of the +same number are not allowed. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_BACKTRACKING_CONTROL_VERB_ARGUMENT_REQUIRED"> +<parameter_description> the backtracing control +verb requires an argument. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_INVALID_CONTROL_CHAR"> +<parameter_description> "\\c" must be followed by an ASCII +character. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_MISSING_NAME"> +<parameter_description> "\\k" is not followed by a braced, angle-bracketed, or +quoted name. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_NOT_SUPPORTED_IN_CLASS"> +<parameter_description> "\\N" is not supported in a class. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_TOO_MANY_FORWARD_REFERENCES"> +<parameter_description> too many forward references. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_NAME_TOO_LONG"> +<parameter_description> the name is too long in "(*MARK)", "(*PRUNE)", +"(*SKIP)", or "(*THEN)". Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_ERROR_CHARACTER_VALUE_TOO_LARGE"> +<parameter_description> the character value in the \\u sequence is +too large. Since: 2.34 +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GRegexMatchFlags"> +<description> +Flags specifying match-time options. + +Since: 2.14 + +</description> +<parameters> +<parameter name="G_REGEX_MATCH_ANCHORED"> +<parameter_description> The pattern is forced to be "anchored", that is, +it is constrained to match only at the first matching point in the +string that is being searched. This effect can also be achieved by +appropriate constructs in the pattern itself such as the "^" +metacharater. +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_NOTBOL"> +<parameter_description> Specifies that first character of the string is +not the beginning of a line, so the circumflex metacharacter should +not match before it. Setting this without #G_REGEX_MULTILINE (at +compile time) causes circumflex never to match. This option affects +only the behaviour of the circumflex metacharacter, it does not +affect "\A". +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_NOTEOL"> +<parameter_description> Specifies that the end of the subject string is +not the end of a line, so the dollar metacharacter should not match +it nor (except in multiline mode) a newline immediately before it. +Setting this without #G_REGEX_MULTILINE (at compile time) causes +dollar never to match. This option affects only the behaviour of +the dollar metacharacter, it does not affect "\Z" or "\z". +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_NOTEMPTY"> +<parameter_description> An empty string is not considered to be a valid +match if this option is set. If there are alternatives in the pattern, +they are tried. If all the alternatives match the empty string, the +entire match fails. For example, if the pattern "a?b?" is applied to +a string not beginning with "a" or "b", it matches the empty string +at the start of the string. With this flag set, this match is not +valid, so GRegex searches further into the string for occurrences +of "a" or "b". +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_PARTIAL"> +<parameter_description> Turns on the partial matching feature, for more +documentation on partial matching see g_match_info_is_partial_match(). +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_NEWLINE_CR"> +<parameter_description> Overrides the newline definition set when +creating a new #GRegex, setting the '\r' character as line terminator. +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_NEWLINE_LF"> +<parameter_description> Overrides the newline definition set when +creating a new #GRegex, setting the '\n' character as line terminator. +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_NEWLINE_CRLF"> +<parameter_description> Overrides the newline definition set when +creating a new #GRegex, setting the '\r\n' characters sequence as line terminator. +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_NEWLINE_ANY"> +<parameter_description> Overrides the newline definition set when +creating a new #GRegex, any Unicode newline sequence +is recognised as a newline. These are '\r', '\n' and '\rn', and the +single characters U+000B LINE TABULATION, U+000C FORM FEED (FF), +U+0085 NEXT LINE (NEL), U+2028 LINE SEPARATOR and +U+2029 PARAGRAPH SEPARATOR. +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_NEWLINE_ANYCRLF"> +<parameter_description> Overrides the newline definition set when +creating a new #GRegex; any '\r', '\n', or '\r\n' character sequence +is recognized as a newline. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_BSR_ANYCRLF"> +<parameter_description> Overrides the newline definition for "\R" set when +creating a new #GRegex; only '\r', '\n', or '\r\n' character sequences +are recognized as a newline by "\R". Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_BSR_ANY"> +<parameter_description> Overrides the newline definition for "\R" set when +creating a new #GRegex; any Unicode newline character or character sequence +are recognized as a newline by "\R". These are '\r', '\n' and '\rn', and the +single characters U+000B LINE TABULATION, U+000C FORM FEED (FF), +U+0085 NEXT LINE (NEL), U+2028 LINE SEPARATOR and +U+2029 PARAGRAPH SEPARATOR. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_PARTIAL_SOFT"> +<parameter_description> An alias for #G_REGEX_MATCH_PARTIAL. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_PARTIAL_HARD"> +<parameter_description> Turns on the partial matching feature. In contrast to +to #G_REGEX_MATCH_PARTIAL_SOFT, this stops matching as soon as a partial match +is found, without continuing to search for a possible complete match. See +see g_match_info_is_partial_match() for more information. Since: 2.34 +</parameter_description> +</parameter> +<parameter name="G_REGEX_MATCH_NOTEMPTY_ATSTART"> +<parameter_description> Like #G_REGEX_MATCH_NOTEMPTY, but only applied to +the start of the matched string. For anchored +patterns this can only happen for pattern containing "\K". Since: 2.34 +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GSeekType"> +<description> +An enumeration specifying the base position for a +g_io_channel_seek_position() operation. + +</description> +<parameters> +<parameter name="G_SEEK_CUR"> +<parameter_description> the current position in the file. +</parameter_description> +</parameter> +<parameter name="G_SEEK_SET"> +<parameter_description> the start of the file. +</parameter_description> +</parameter> +<parameter name="G_SEEK_END"> +<parameter_description> the end of the file. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GShellError"> +<description> +Error codes returned by shell functions. + +</description> +<parameters> +<parameter name="G_SHELL_ERROR_BAD_QUOTING"> +<parameter_description> Mismatched or otherwise mangled quoting. +</parameter_description> +</parameter> +<parameter name="G_SHELL_ERROR_EMPTY_STRING"> +<parameter_description> String to be parsed was empty. +</parameter_description> +</parameter> +<parameter name="G_SHELL_ERROR_FAILED"> +<parameter_description> Some other error. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GSignalFlags"> +<description> +The signal flags are used to specify a signal's behaviour, the overall +signal description outlines how especially the RUN flags control the +stages of a signal emission. + +</description> +<parameters> +<parameter name="G_SIGNAL_RUN_FIRST"> +<parameter_description> Invoke the object method handler in the first emission stage. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_RUN_LAST"> +<parameter_description> Invoke the object method handler in the third emission stage. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_RUN_CLEANUP"> +<parameter_description> Invoke the object method handler in the last emission stage. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_NO_RECURSE"> +<parameter_description> Signals being emitted for an object while currently being in +emission for this very object will not be emitted recursively, +but instead cause the first emission to be restarted. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_DETAILED"> +<parameter_description> This signal supports "::detail" appendices to the signal name +upon handler connections and emissions. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_ACTION"> +<parameter_description> Action signals are signals that may freely be emitted on alive +objects from user code via g_signal_emit() and friends, without +the need of being embedded into extra code that performs pre or +post emission adjustments on the object. They can also be thought +of as object methods which can be called generically by +third-party code. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_NO_HOOKS"> +<parameter_description> No emissions hooks are supported for this signal. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_MUST_COLLECT"> +<parameter_description> Varargs signal emission will always collect the +arguments, even if there are no signal handlers connected. Since 2.30. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_DEPRECATED"> +<parameter_description> The signal is deprecated and will be removed +in a future version. A warning will be generated if it is connected while +running with G_ENABLE_DIAGNOSTIC=1. Since 2.32. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GSignalMatchType"> +<description> +The match types specify what g_signal_handlers_block_matched(), +g_signal_handlers_unblock_matched() and g_signal_handlers_disconnect_matched() +match signals by. + +</description> +<parameters> +<parameter name="G_SIGNAL_MATCH_ID"> +<parameter_description> The signal id must be equal. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_MATCH_DETAIL"> +<parameter_description> The signal detail be equal. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_MATCH_CLOSURE"> +<parameter_description> The closure must be the same. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_MATCH_FUNC"> +<parameter_description> The C closure callback must be the same. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_MATCH_DATA"> +<parameter_description> The closure data must be the same. +</parameter_description> +</parameter> +<parameter name="G_SIGNAL_MATCH_UNBLOCKED"> +<parameter_description> Only unblocked signals may matched. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GSpawnError"> +<description> +Error codes returned by spawning processes. + +</description> +<parameters> +<parameter name="G_SPAWN_ERROR_FORK"> +<parameter_description> Fork failed due to lack of memory. +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_READ"> +<parameter_description> Read or select on pipes failed. +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_CHDIR"> +<parameter_description> Changing to working directory failed. +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_ACCES"> +<parameter_description> execv() returned <literal>EACCES</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_PERM"> +<parameter_description> execv() returned <literal>EPERM</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_TOO_BIG"> +<parameter_description> execv() returned <literal>E2BIG</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_2BIG"> +<parameter_description> deprecated alias for %G_SPAWN_ERROR_TOO_BIG +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_NOEXEC"> +<parameter_description> execv() returned <literal>ENOEXEC</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_NAMETOOLONG"> +<parameter_description> execv() returned <literal>ENAMETOOLONG</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_NOENT"> +<parameter_description> execv() returned <literal>ENOENT</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_NOMEM"> +<parameter_description> execv() returned <literal>ENOMEM</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_NOTDIR"> +<parameter_description> execv() returned <literal>ENOTDIR</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_LOOP"> +<parameter_description> execv() returned <literal>ELOOP</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_TXTBUSY"> +<parameter_description> execv() returned <literal>ETXTBUSY</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_IO"> +<parameter_description> execv() returned <literal>EIO</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_NFILE"> +<parameter_description> execv() returned <literal>ENFILE</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_MFILE"> +<parameter_description> execv() returned <literal>EMFILE</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_INVAL"> +<parameter_description> execv() returned <literal>EINVAL</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_ISDIR"> +<parameter_description> execv() returned <literal>EISDIR</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_LIBBAD"> +<parameter_description> execv() returned <literal>ELIBBAD</literal> +</parameter_description> +</parameter> +<parameter name="G_SPAWN_ERROR_FAILED"> +<parameter_description> Some other fatal failure, +<literal>error->message</literal> should explain. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GSpawnFlags"> +<description> +Flags passed to g_spawn_sync(), g_spawn_async() and g_spawn_async_with_pipes(). + +</description> +<parameters> +<parameter name="G_SPAWN_LEAVE_DESCRIPTORS_OPEN"> +<parameter_description> the parent's open file descriptors will be +inherited by the child; otherwise all descriptors except stdin/stdout/stderr +will be closed before calling exec() in the child. +</parameter_description> +</parameter> +<parameter name="G_SPAWN_DO_NOT_REAP_CHILD"> +<parameter_description> the child will not be automatically reaped; you +must use g_child_watch_add() yourself (or call waitpid() +or handle <literal>SIGCHLD</literal> yourself), or the child will become a zombie. +</parameter_description> +</parameter> +<parameter name="G_SPAWN_SEARCH_PATH"> +<parameter_description> <literal>argv[0]</literal> need not be an absolute path, +it will be looked for in the user's <envar>PATH</envar>. +</parameter_description> +</parameter> +<parameter name="G_SPAWN_STDOUT_TO_DEV_NULL"> +<parameter_description> the child's standard output will be discarded, +instead of going to the same location as the parent's standard output. +</parameter_description> +</parameter> +<parameter name="G_SPAWN_STDERR_TO_DEV_NULL"> +<parameter_description> the child's standard error will be discarded. +</parameter_description> +</parameter> +<parameter name="G_SPAWN_CHILD_INHERITS_STDIN"> +<parameter_description> the child will inherit the parent's standard +input (by default, the child's standard input is attached to +<filename>/dev/null</filename>). +</parameter_description> +</parameter> +<parameter name="G_SPAWN_FILE_AND_ARGV_ZERO"> +<parameter_description> the first element of <literal>argv</literal> is +the file to execute, while the remaining elements are the actual argument +vector to pass to the file. Normally g_spawn_async_with_pipes() uses +<literal>argv[0]</literal> as the file to execute, and passes all of +<literal>argv</literal> to the child. +</parameter_description> +</parameter> +<parameter name="G_SPAWN_SEARCH_PATH_FROM_ENVP"> +<parameter_description> if <literal>argv[0]</literal> is not an abolute path, +it will be looked for in the <envar>PATH</envar> from the passed child +environment. Since: 2.34 +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTestTrapFlags"> +<description> +Test traps are guards around forked tests. +These flags determine what traps to set. + +</description> +<parameters> +<parameter name="G_TEST_TRAP_SILENCE_STDOUT"> +<parameter_description> Redirect stdout of the test child to +<filename>/dev/null</filename> so it cannot be observed on the +console during test runs. The actual output is still captured +though to allow later tests with g_test_trap_assert_stdout(). +</parameter_description> +</parameter> +<parameter name="G_TEST_TRAP_SILENCE_STDERR"> +<parameter_description> Redirect stderr of the test child to +<filename>/dev/null</filename> so it cannot be observed on the +console during test runs. The actual output is still captured +though to allow later tests with g_test_trap_assert_stderr(). +</parameter_description> +</parameter> +<parameter name="G_TEST_TRAP_INHERIT_STDIN"> +<parameter_description> If this flag is given, stdin of the +forked child process is shared with stdin of its parent process. +It is redirected to <filename>/dev/null</filename> otherwise. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GThreadError"> +<description> +Possible errors of thread related functions. + +</description> +<parameters> +<parameter name="G_THREAD_ERROR_AGAIN"> +<parameter_description> a thread couldn't be created due to resource +shortage. Try again later. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GThreadPriority"> +<description> +Deprecated:2.32: Thread priorities no longer have any effect. + +</description> +<parameters> +<parameter name="G_THREAD_PRIORITY_LOW"> +<parameter_description> a priority lower than normal +</parameter_description> +</parameter> +<parameter name="G_THREAD_PRIORITY_NORMAL"> +<parameter_description> the default priority +</parameter_description> +</parameter> +<parameter name="G_THREAD_PRIORITY_HIGH"> +<parameter_description> a priority higher than normal +</parameter_description> +</parameter> +<parameter name="G_THREAD_PRIORITY_URGENT"> +<parameter_description> the highest priority +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTimeType"> +<description> +Disambiguates a given time in two ways. + +First, specifies if the given time is in universal or local time. + +Second, if the time is in local time, specifies if it is local +standard time or local daylight time. This is important for the case +where the same local time occurs twice (during daylight savings time +transitions, for example). + +</description> +<parameters> +<parameter name="G_TIME_TYPE_STANDARD"> +<parameter_description> the time is in local standard time +</parameter_description> +</parameter> +<parameter name="G_TIME_TYPE_DAYLIGHT"> +<parameter_description> the time is in local daylight time +</parameter_description> +</parameter> +<parameter name="G_TIME_TYPE_UNIVERSAL"> +<parameter_description> the time is in UTC +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTokenType"> +<description> +The possible types of token returned from each +g_scanner_get_next_token() call. + +</description> +<parameters> +<parameter name="G_TOKEN_EOF"> +<parameter_description> the end of the file +</parameter_description> +</parameter> +<parameter name="G_TOKEN_LEFT_PAREN"> +<parameter_description> a '(' character +</parameter_description> +</parameter> +<parameter name="G_TOKEN_LEFT_CURLY"> +<parameter_description> a '{' character +</parameter_description> +</parameter> +<parameter name="G_TOKEN_LEFT_BRACE"> +<parameter_description> a '[' character +</parameter_description> +</parameter> +<parameter name="G_TOKEN_RIGHT_CURLY"> +<parameter_description> a '}' character +</parameter_description> +</parameter> +<parameter name="G_TOKEN_RIGHT_PAREN"> +<parameter_description> a ')' character +</parameter_description> +</parameter> +<parameter name="G_TOKEN_RIGHT_BRACE"> +<parameter_description> a ']' character +</parameter_description> +</parameter> +<parameter name="G_TOKEN_EQUAL_SIGN"> +<parameter_description> a '=' character +</parameter_description> +</parameter> +<parameter name="G_TOKEN_COMMA"> +<parameter_description> a ',' character +</parameter_description> +</parameter> +<parameter name="G_TOKEN_NONE"> +<parameter_description> not a token +</parameter_description> +</parameter> +<parameter name="G_TOKEN_ERROR"> +<parameter_description> an error occurred +</parameter_description> +</parameter> +<parameter name="G_TOKEN_CHAR"> +<parameter_description> a character +</parameter_description> +</parameter> +<parameter name="G_TOKEN_BINARY"> +<parameter_description> a binary integer +</parameter_description> +</parameter> +<parameter name="G_TOKEN_OCTAL"> +<parameter_description> an octal integer +</parameter_description> +</parameter> +<parameter name="G_TOKEN_INT"> +<parameter_description> an integer +</parameter_description> +</parameter> +<parameter name="G_TOKEN_HEX"> +<parameter_description> a hex integer +</parameter_description> +</parameter> +<parameter name="G_TOKEN_FLOAT"> +<parameter_description> a floating point number +</parameter_description> +</parameter> +<parameter name="G_TOKEN_STRING"> +<parameter_description> a string +</parameter_description> +</parameter> +<parameter name="G_TOKEN_SYMBOL"> +<parameter_description> a symbol +</parameter_description> +</parameter> +<parameter name="G_TOKEN_IDENTIFIER"> +<parameter_description> an identifier +</parameter_description> +</parameter> +<parameter name="G_TOKEN_IDENTIFIER_NULL"> +<parameter_description> a null identifier +</parameter_description> +</parameter> +<parameter name="G_TOKEN_COMMENT_SINGLE"> +<parameter_description> one line comment +</parameter_description> +</parameter> +<parameter name="G_TOKEN_COMMENT_MULTI"> +<parameter_description> multi line comment +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTraverseFlags"> +<description> +Specifies which nodes are visited during several of the tree +functions, including g_node_traverse() and g_node_find(). + +</description> +<parameters> +<parameter name="G_TRAVERSE_LEAVES"> +<parameter_description> only leaf nodes should be visited. This name has +been introduced in 2.6, for older version use +%G_TRAVERSE_LEAFS. +</parameter_description> +</parameter> +<parameter name="G_TRAVERSE_NON_LEAVES"> +<parameter_description> only non-leaf nodes should be visited. This +name has been introduced in 2.6, for older +version use %G_TRAVERSE_NON_LEAFS. +</parameter_description> +</parameter> +<parameter name="G_TRAVERSE_ALL"> +<parameter_description> all nodes should be visited. +</parameter_description> +</parameter> +<parameter name="G_TRAVERSE_MASK"> +<parameter_description> a mask of all traverse flags. +</parameter_description> +</parameter> +<parameter name="G_TRAVERSE_LEAFS"> +<parameter_description> identical to %G_TRAVERSE_LEAVES. +</parameter_description> +</parameter> +<parameter name="G_TRAVERSE_NON_LEAFS"> +<parameter_description> identical to %G_TRAVERSE_NON_LEAVES. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTraverseType"> +<description> +Specifies the type of traveral performed by g_tree_traverse(), +g_node_traverse() and g_node_find(). + +</description> +<parameters> +<parameter name="G_IN_ORDER"> +<parameter_description> vists a node's left child first, then the node itself, +then its right child. This is the one to use if you +want the output sorted according to the compare +function. +</parameter_description> +</parameter> +<parameter name="G_PRE_ORDER"> +<parameter_description> visits a node, then its children. +</parameter_description> +</parameter> +<parameter name="G_POST_ORDER"> +<parameter_description> visits the node's children, then the node itself. +</parameter_description> +</parameter> +<parameter name="G_LEVEL_ORDER"> +<parameter_description> is not implemented for <link +linkend="glib-Balanced-Binary-Trees">Balanced Binary +Trees</link>. For <link +linkend="glib-N-ary-Trees">N-ary Trees</link>, it +vists the root node first, then its children, then +its grandchildren, and so on. Note that this is less +efficient than the other orders. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTypeDebugFlags"> +<description> +The <type>GTypeDebugFlags</type> enumeration values can be passed to +g_type_init_with_debug_flags() to trigger debugging messages during runtime. +Note that the messages can also be triggered by setting the +<envar>GOBJECT_DEBUG</envar> environment variable to a ':'-separated list of +"objects" and "signals". + +</description> +<parameters> +<parameter name="G_TYPE_DEBUG_NONE"> +<parameter_description> Print no messages. +</parameter_description> +</parameter> +<parameter name="G_TYPE_DEBUG_OBJECTS"> +<parameter_description> Print messages about object bookkeeping. +</parameter_description> +</parameter> +<parameter name="G_TYPE_DEBUG_SIGNALS"> +<parameter_description> Print messages about signal emissions. +</parameter_description> +</parameter> +<parameter name="G_TYPE_DEBUG_MASK"> +<parameter_description> Mask covering all debug flags. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTypeFlags"> +<description> +Bit masks used to check or determine characteristics of a type. + +</description> +<parameters> +<parameter name="G_TYPE_FLAG_ABSTRACT"> +<parameter_description> Indicates an abstract type. No instances can be +created for an abstract type. +</parameter_description> +</parameter> +<parameter name="G_TYPE_FLAG_VALUE_ABSTRACT"> +<parameter_description> Indicates an abstract value type, i.e. a type +that introduces a value table, but can't be used for +g_value_init(). +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GTypeFundamentalFlags"> +<description> +Bit masks used to check or determine specific characteristics of a +fundamental type. + +</description> +<parameters> +<parameter name="G_TYPE_FLAG_CLASSED"> +<parameter_description> Indicates a classed type. +</parameter_description> +</parameter> +<parameter name="G_TYPE_FLAG_INSTANTIATABLE"> +<parameter_description> Indicates an instantiable type (implies classed). +</parameter_description> +</parameter> +<parameter name="G_TYPE_FLAG_DERIVABLE"> +<parameter_description> Indicates a flat derivable type. +</parameter_description> +</parameter> +<parameter name="G_TYPE_FLAG_DEEP_DERIVABLE"> +<parameter_description> Indicates a deep derivable type (implies derivable). +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GUnicodeBreakType"> +<description> +These are the possible line break classifications. + +The five Hangul types were added in Unicode 4.1, so, has been +introduced in GLib 2.10. Note that new types may be added in the future. +Applications should be ready to handle unknown values. +They may be regarded as %G_UNICODE_BREAK_UNKNOWN. + +See <ulink url="http://www.unicode.org/unicode/reports/tr14/">http://www.unicode.org/unicode/reports/tr14/</ulink>. + +</description> +<parameters> +<parameter name="G_UNICODE_BREAK_MANDATORY"> +<parameter_description> Mandatory Break (BK) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_CARRIAGE_RETURN"> +<parameter_description> Carriage Return (CR) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_LINE_FEED"> +<parameter_description> Line Feed (LF) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_COMBINING_MARK"> +<parameter_description> Attached Characters and Combining Marks (CM) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_SURROGATE"> +<parameter_description> Surrogates (SG) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_ZERO_WIDTH_SPACE"> +<parameter_description> Zero Width Space (ZW) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_INSEPARABLE"> +<parameter_description> Inseparable (IN) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_NON_BREAKING_GLUE"> +<parameter_description> Non-breaking ("Glue") (GL) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_CONTINGENT"> +<parameter_description> Contingent Break Opportunity (CB) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_SPACE"> +<parameter_description> Space (SP) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_AFTER"> +<parameter_description> Break Opportunity After (BA) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_BEFORE"> +<parameter_description> Break Opportunity Before (BB) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_BEFORE_AND_AFTER"> +<parameter_description> Break Opportunity Before and After (B2) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_HYPHEN"> +<parameter_description> Hyphen (HY) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_NON_STARTER"> +<parameter_description> Nonstarter (NS) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_OPEN_PUNCTUATION"> +<parameter_description> Opening Punctuation (OP) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_CLOSE_PUNCTUATION"> +<parameter_description> Closing Punctuation (CL) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_QUOTATION"> +<parameter_description> Ambiguous Quotation (QU) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_EXCLAMATION"> +<parameter_description> Exclamation/Interrogation (EX) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_IDEOGRAPHIC"> +<parameter_description> Ideographic (ID) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_NUMERIC"> +<parameter_description> Numeric (NU) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_INFIX_SEPARATOR"> +<parameter_description> Infix Separator (Numeric) (IS) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_SYMBOL"> +<parameter_description> Symbols Allowing Break After (SY) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_ALPHABETIC"> +<parameter_description> Ordinary Alphabetic and Symbol Characters (AL) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_PREFIX"> +<parameter_description> Prefix (Numeric) (PR) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_POSTFIX"> +<parameter_description> Postfix (Numeric) (PO) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_COMPLEX_CONTEXT"> +<parameter_description> Complex Content Dependent (South East Asian) (SA) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_AMBIGUOUS"> +<parameter_description> Ambiguous (Alphabetic or Ideographic) (AI) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_UNKNOWN"> +<parameter_description> Unknown (XX) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_NEXT_LINE"> +<parameter_description> Next Line (NL) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_WORD_JOINER"> +<parameter_description> Word Joiner (WJ) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_HANGUL_L_JAMO"> +<parameter_description> Hangul L Jamo (JL) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_HANGUL_V_JAMO"> +<parameter_description> Hangul V Jamo (JV) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_HANGUL_T_JAMO"> +<parameter_description> Hangul T Jamo (JT) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_HANGUL_LV_SYLLABLE"> +<parameter_description> Hangul LV Syllable (H2) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_HANGUL_LVT_SYLLABLE"> +<parameter_description> Hangul LVT Syllable (H3) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_CLOSE_PARANTHESIS"> +<parameter_description> Closing Parenthesis (CP). Since 2.28 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_CONDITIONAL_JAPANESE_STARTER"> +<parameter_description> Conditional Japanese Starter (CJ). Since: 2.32 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_BREAK_HEBREW_LETTER"> +<parameter_description> Hebrew Letter (HL). Since: 2.32 +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GUnicodeScript"> +<description> +The #GUnicodeScript enumeration identifies different writing +systems. The values correspond to the names as defined in the +Unicode standard. The enumeration has been added in GLib 2.14, +and is interchangeable with #PangoScript. + +Note that new types may be added in the future. Applications +should be ready to handle unknown values. +See <ulink +url="http://www.unicode.org/reports/tr24/">Unicode Standard Annex +#24: Script names</ulink>. + +</description> +<parameters> +<parameter name="G_UNICODE_SCRIPT_INVALID_CODE"> +<parameter_description> +a value never returned from g_unichar_get_script() +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_COMMON"> +<parameter_description> a character used by multiple different scripts +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_INHERITED"> +<parameter_description> a mark glyph that takes its script from the +i base glyph to which it is attached +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_ARABIC"> +<parameter_description> Arabic +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_ARMENIAN"> +<parameter_description> Armenian +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_BENGALI"> +<parameter_description> Bengali +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_BOPOMOFO"> +<parameter_description> Bopomofo +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_CHEROKEE"> +<parameter_description> Cherokee +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_COPTIC"> +<parameter_description> Coptic +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_CYRILLIC"> +<parameter_description> Cyrillic +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_DESERET"> +<parameter_description> Deseret +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_DEVANAGARI"> +<parameter_description> Devanagari +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_ETHIOPIC"> +<parameter_description> Ethiopic +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_GEORGIAN"> +<parameter_description> Georgian +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_GOTHIC"> +<parameter_description> Gothic +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_GREEK"> +<parameter_description> Greek +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_GUJARATI"> +<parameter_description> Gujarati +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_GURMUKHI"> +<parameter_description> Gurmukhi +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_HAN"> +<parameter_description> Han +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_HANGUL"> +<parameter_description> Hangul +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_HEBREW"> +<parameter_description> Hebrew +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_HIRAGANA"> +<parameter_description> Hiragana +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_KANNADA"> +<parameter_description> Kannada +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_KATAKANA"> +<parameter_description> Katakana +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_KHMER"> +<parameter_description> Khmer +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_LAO"> +<parameter_description> Lao +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_LATIN"> +<parameter_description> Latin +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_MALAYALAM"> +<parameter_description> Malayalam +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_MONGOLIAN"> +<parameter_description> Mongolian +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_MYANMAR"> +<parameter_description> Myanmar +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_OGHAM"> +<parameter_description> Ogham +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_OLD_ITALIC"> +<parameter_description> Old Italic +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_ORIYA"> +<parameter_description> Oriya +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_RUNIC"> +<parameter_description> Runic +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_SINHALA"> +<parameter_description> Sinhala +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_SYRIAC"> +<parameter_description> Syriac +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_TAMIL"> +<parameter_description> Tamil +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_TELUGU"> +<parameter_description> Telugu +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_THAANA"> +<parameter_description> Thaana +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_THAI"> +<parameter_description> Thai +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_TIBETAN"> +<parameter_description> Tibetan +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_CANADIAN_ABORIGINAL"> +<parameter_description> +Canadian Aboriginal +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_YI"> +<parameter_description> Yi +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_TAGALOG"> +<parameter_description> Tagalog +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_HANUNOO"> +<parameter_description> Hanunoo +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_BUHID"> +<parameter_description> Buhid +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_TAGBANWA"> +<parameter_description> Tagbanwa +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_BRAILLE"> +<parameter_description> Braille +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_CYPRIOT"> +<parameter_description> Cypriot +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_LIMBU"> +<parameter_description> Limbu +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_OSMANYA"> +<parameter_description> Osmanya +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_SHAVIAN"> +<parameter_description> Shavian +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_LINEAR_B"> +<parameter_description> Linear B +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_TAI_LE"> +<parameter_description> Tai Le +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_UGARITIC"> +<parameter_description> Ugaritic +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_NEW_TAI_LUE"> +<parameter_description> +New Tai Lue +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_BUGINESE"> +<parameter_description> Buginese +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_GLAGOLITIC"> +<parameter_description> Glagolitic +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_TIFINAGH"> +<parameter_description> Tifinagh +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_SYLOTI_NAGRI"> +<parameter_description> +Syloti Nagri +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_OLD_PERSIAN"> +<parameter_description> +Old Persian +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_KHAROSHTHI"> +<parameter_description> Kharoshthi +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_UNKNOWN"> +<parameter_description> an unassigned code point +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_BALINESE"> +<parameter_description> Balinese +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_CUNEIFORM"> +<parameter_description> Cuneiform +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_PHOENICIAN"> +<parameter_description> Phoenician +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_PHAGS_PA"> +<parameter_description> Phags-pa +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_NKO"> +<parameter_description> N'Ko +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_KAYAH_LI"> +<parameter_description> Kayah Li. Since 2.16.3 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_LEPCHA"> +<parameter_description> Lepcha. Since 2.16.3 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_REJANG"> +<parameter_description> Rejang. Since 2.16.3 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_SUNDANESE"> +<parameter_description> Sundanese. Since 2.16.3 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_SAURASHTRA"> +<parameter_description> Saurashtra. Since 2.16.3 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_CHAM"> +<parameter_description> Cham. Since 2.16.3 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_OL_CHIKI"> +<parameter_description> Ol Chiki. Since 2.16.3 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_VAI"> +<parameter_description> Vai. Since 2.16.3 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_CARIAN"> +<parameter_description> Carian. Since 2.16.3 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_LYCIAN"> +<parameter_description> Lycian. Since 2.16.3 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_LYDIAN"> +<parameter_description> Lydian. Since 2.16.3 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_AVESTAN"> +<parameter_description> Avestan. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_BAMUM"> +<parameter_description> Bamum. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_EGYPTIAN_HIEROGLYPHS"> +<parameter_description> +Egyptian Hieroglpyhs. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_IMPERIAL_ARAMAIC"> +<parameter_description> +Imperial Aramaic. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_INSCRIPTIONAL_PAHLAVI"> +<parameter_description> +Inscriptional Pahlavi. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_INSCRIPTIONAL_PARTHIAN"> +<parameter_description> +Inscriptional Parthian. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_JAVANESE"> +<parameter_description> Javanese. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_KAITHI"> +<parameter_description> Kaithi. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_LISU"> +<parameter_description> Lisu. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_MEETEI_MAYEK"> +<parameter_description> +Meetei Mayek. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_OLD_SOUTH_ARABIAN"> +<parameter_description> +Old South Arabian. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_OLD_TURKIC"> +<parameter_description> Old Turkic. Since 2.28 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_SAMARITAN"> +<parameter_description> Samaritan. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_TAI_THAM"> +<parameter_description> Tai Tham. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_TAI_VIET"> +<parameter_description> Tai Viet. Since 2.26 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_BATAK"> +<parameter_description> Batak. Since 2.28 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_BRAHMI"> +<parameter_description> Brahmi. Since 2.28 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_MANDAIC"> +<parameter_description> Mandaic. Since 2.28 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_CHAKMA"> +<parameter_description> Chakma. Since: 2.32 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_MEROITIC_CURSIVE"> +<parameter_description> Meroitic Cursive. Since: 2.32 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_MEROITIC_HIEROGLYPHS"> +<parameter_description> Meroitic Hieroglyphs. Since: 2.32 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_MIAO"> +<parameter_description> Miao. Since: 2.32 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_SHARADA"> +<parameter_description> Sharada. Since: 2.32 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_SORA_SOMPENG"> +<parameter_description> Sora Sompeng. Since: 2.32 +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SCRIPT_TAKRI"> +<parameter_description> Takri. Since: 2.32 +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GUnicodeType"> +<description> +These are the possible character classifications from the +Unicode specification. +See <ulink url="http://www.unicode.org/Public/UNIDATA/UnicodeData.html">http://www.unicode.org/Public/UNIDATA/UnicodeData.html</ulink>. + +</description> +<parameters> +<parameter name="G_UNICODE_CONTROL"> +<parameter_description> General category "Other, Control" (Cc) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_FORMAT"> +<parameter_description> General category "Other, Format" (Cf) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_UNASSIGNED"> +<parameter_description> General category "Other, Not Assigned" (Cn) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_PRIVATE_USE"> +<parameter_description> General category "Other, Private Use" (Co) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SURROGATE"> +<parameter_description> General category "Other, Surrogate" (Cs) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_LOWERCASE_LETTER"> +<parameter_description> General category "Letter, Lowercase" (Ll) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_MODIFIER_LETTER"> +<parameter_description> General category "Letter, Modifier" (Lm) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_OTHER_LETTER"> +<parameter_description> General category "Letter, Other" (Lo) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_TITLECASE_LETTER"> +<parameter_description> General category "Letter, Titlecase" (Lt) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_UPPERCASE_LETTER"> +<parameter_description> General category "Letter, Uppercase" (Lu) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SPACING_MARK"> +<parameter_description> General category "Mark, Spacing" (Mc) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_ENCLOSING_MARK"> +<parameter_description> General category "Mark, Enclosing" (Me) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_NON_SPACING_MARK"> +<parameter_description> General category "Mark, Nonspacing" (Mn) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_DECIMAL_NUMBER"> +<parameter_description> General category "Number, Decimal Digit" (Nd) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_LETTER_NUMBER"> +<parameter_description> General category "Number, Letter" (Nl) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_OTHER_NUMBER"> +<parameter_description> General category "Number, Other" (No) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_CONNECT_PUNCTUATION"> +<parameter_description> General category "Punctuation, Connector" (Pc) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_DASH_PUNCTUATION"> +<parameter_description> General category "Punctuation, Dash" (Pd) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_CLOSE_PUNCTUATION"> +<parameter_description> General category "Punctuation, Close" (Pe) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_FINAL_PUNCTUATION"> +<parameter_description> General category "Punctuation, Final quote" (Pf) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_INITIAL_PUNCTUATION"> +<parameter_description> General category "Punctuation, Initial quote" (Pi) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_OTHER_PUNCTUATION"> +<parameter_description> General category "Punctuation, Other" (Po) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_OPEN_PUNCTUATION"> +<parameter_description> General category "Punctuation, Open" (Ps) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_CURRENCY_SYMBOL"> +<parameter_description> General category "Symbol, Currency" (Sc) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_MODIFIER_SYMBOL"> +<parameter_description> General category "Symbol, Modifier" (Sk) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_MATH_SYMBOL"> +<parameter_description> General category "Symbol, Math" (Sm) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_OTHER_SYMBOL"> +<parameter_description> General category "Symbol, Other" (So) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_LINE_SEPARATOR"> +<parameter_description> General category "Separator, Line" (Zl) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_PARAGRAPH_SEPARATOR"> +<parameter_description> General category "Separator, Paragraph" (Zp) +</parameter_description> +</parameter> +<parameter name="G_UNICODE_SPACE_SEPARATOR"> +<parameter_description> General category "Separator, Space" (Zs) +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GUserDirectory"> +<description> +These are logical ids for special directories which are defined +depending on the platform used. You should use g_get_user_special_dir() +to retrieve the full path associated to the logical id. + +The #GUserDirectory enumeration can be extended at later date. Not +every platform has a directory for every logical id in this +enumeration. + +Since: 2.14 + +</description> +<parameters> +<parameter name="G_USER_DIRECTORY_DESKTOP"> +<parameter_description> the user's Desktop directory +</parameter_description> +</parameter> +<parameter name="G_USER_DIRECTORY_DOCUMENTS"> +<parameter_description> the user's Documents directory +</parameter_description> +</parameter> +<parameter name="G_USER_DIRECTORY_DOWNLOAD"> +<parameter_description> the user's Downloads directory +</parameter_description> +</parameter> +<parameter name="G_USER_DIRECTORY_MUSIC"> +<parameter_description> the user's Music directory +</parameter_description> +</parameter> +<parameter name="G_USER_DIRECTORY_PICTURES"> +<parameter_description> the user's Pictures directory +</parameter_description> +</parameter> +<parameter name="G_USER_DIRECTORY_PUBLIC_SHARE"> +<parameter_description> the user's shared directory +</parameter_description> +</parameter> +<parameter name="G_USER_DIRECTORY_TEMPLATES"> +<parameter_description> the user's Templates directory +</parameter_description> +</parameter> +<parameter name="G_USER_DIRECTORY_VIDEOS"> +<parameter_description> the user's Movies directory +</parameter_description> +</parameter> +<parameter name="G_USER_N_DIRECTORIES"> +<parameter_description> the number of enum values +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GVariantClass"> +<description> +The range of possible top-level types of #GVariant instances. + +Since: 2.24 + +</description> +<parameters> +<parameter name="G_VARIANT_CLASS_BOOLEAN"> +<parameter_description> The #GVariant is a boolean. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_BYTE"> +<parameter_description> The #GVariant is a byte. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_INT16"> +<parameter_description> The #GVariant is a signed 16 bit integer. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_UINT16"> +<parameter_description> The #GVariant is an unsigned 16 bit integer. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_INT32"> +<parameter_description> The #GVariant is a signed 32 bit integer. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_UINT32"> +<parameter_description> The #GVariant is an unsigned 32 bit integer. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_INT64"> +<parameter_description> The #GVariant is a signed 64 bit integer. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_UINT64"> +<parameter_description> The #GVariant is an unsigned 64 bit integer. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_HANDLE"> +<parameter_description> The #GVariant is a file handle index. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_DOUBLE"> +<parameter_description> The #GVariant is a double precision floating +point value. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_STRING"> +<parameter_description> The #GVariant is a normal string. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_OBJECT_PATH"> +<parameter_description> The #GVariant is a D-Bus object path +string. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_SIGNATURE"> +<parameter_description> The #GVariant is a D-Bus signature string. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_VARIANT"> +<parameter_description> The #GVariant is a variant. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_MAYBE"> +<parameter_description> The #GVariant is a maybe-typed value. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_ARRAY"> +<parameter_description> The #GVariant is an array. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_TUPLE"> +<parameter_description> The #GVariant is a tuple. +</parameter_description> +</parameter> +<parameter name="G_VARIANT_CLASS_DICT_ENTRY"> +<parameter_description> The #GVariant is a dictionary entry. +</parameter_description> +</parameter> +</parameters> +</enum> + +<enum name="GVariantParseError"> +<description> +Error codes returned by parsing text-format GVariants. + +</description> +<parameters> +<parameter name="G_VARIANT_PARSE_ERROR_FAILED"> +<parameter_description> generic error (unused) +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_BASIC_TYPE_EXPECTED"> +<parameter_description> a non-basic #GVariantType was given where a basic type was expected +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_CANNOT_INFER_TYPE"> +<parameter_description> cannot infer the #GVariantType +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_DEFINITE_TYPE_EXPECTED"> +<parameter_description> an indefinite #GVariantType was given where a definite type was expected +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_INPUT_NOT_AT_END"> +<parameter_description> extra data after parsing finished +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_INVALID_CHARACTER"> +<parameter_description> invalid character in number or unicode escape +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_INVALID_FORMAT_STRING"> +<parameter_description> not a valid #GVariant format string +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_INVALID_OBJECT_PATH"> +<parameter_description> not a valid object path +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_INVALID_SIGNATURE"> +<parameter_description> not a valid type signature +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_INVALID_TYPE_STRING"> +<parameter_description> not a valid #GVariant type string +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_NO_COMMON_TYPE"> +<parameter_description> could not find a common type for array entries +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_NUMBER_OUT_OF_RANGE"> +<parameter_description> the numerical value is out of range of the given type +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_NUMBER_TOO_BIG"> +<parameter_description> the numerical value is out of range for any type +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_TYPE_ERROR"> +<parameter_description> cannot parse as variant of the specified type +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_UNEXPECTED_TOKEN"> +<parameter_description> an unexpected token was encountered +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_UNKNOWN_KEYWORD"> +<parameter_description> an unknown keyword was encountered +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_UNTERMINATED_STRING_CONSTANT"> +<parameter_description> unterminated string constant +</parameter_description> +</parameter> +<parameter name="G_VARIANT_PARSE_ERROR_VALUE_EXPECTED"> +<parameter_description> no value given +</parameter_description> +</parameter> +</parameters> +</enum> + <function name="g_access"> <description> A wrapper for the POSIX access() function. This function is used to @@ -68,6 +3486,52 @@ error. </return> </function> +<function name="g_alloca"> +<description> +Allocates @size bytes on the stack; these bytes will be freed when the current +stack frame is cleaned up. This macro essentially just wraps the alloca() +function present on most UNIX variants. +Thus it provides the same advantages and pitfalls as alloca(): +<variablelist> +<varlistentry><term></term><listitem><para> ++ alloca() is very fast, as on most systems it's implemented by just adjusting +the stack pointer register. +</para></listitem></varlistentry> +<varlistentry><term></term><listitem><para> ++ It doesn't cause any memory fragmentation, within its scope, separate alloca() +blocks just build up and are released together at function end. +</para></listitem></varlistentry> +<varlistentry><term></term><listitem><para> +- Allocation sizes have to fit into the current stack frame. For instance in a +threaded environment on Linux, the per-thread stack size is limited to 2 Megabytes, +so be sparse with alloca() uses. +</para></listitem></varlistentry> +<varlistentry><term></term><listitem><para> +- Allocation failure due to insufficient stack space is not indicated with a %NULL +return like e.g. with malloc(). Instead, most systems probably handle it the same +way as out of stack space situations from infinite function recursion, i.e. +with a segmentation fault. +</para></listitem></varlistentry> +<varlistentry><term></term><listitem><para> +- Special care has to be taken when mixing alloca() with GNU C variable sized arrays. +Stack space allocated with alloca() in the same scope as a variable sized array +will be freed together with the variable sized array upon exit of that scope, and +not upon exit of the enclosing function scope. +</para></listitem></varlistentry> +</variablelist> + + +</description> +<parameters> +<parameter name="size"> +<parameter_description> number of bytes to allocate. +</parameter_description> +</parameter> +</parameters> +<return> space for @size bytes, allocated on the stack +</return> +</function> + <function name="g_array_append_val"> <description> Adds the value on to the end of the array. The array will grow in @@ -19887,6 +23351,61 @@ there is more work to do. </return> </function> +<function name="g_main_destroy"> +<description> +Frees the memory allocated for the #GMainLoop. + +Deprecated: 2.2: Use g_main_loop_unref() instead + +</description> +<parameters> +<parameter name="loop"> +<parameter_description> a #GMainLoop +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_main_is_running"> +<description> +Checks if the main loop is running. + +Deprecated: 2.2: Use g_main_loop_is_running() instead + +</description> +<parameters> +<parameter name="loop"> +<parameter_description> a #GMainLoop +</parameter_description> +</parameter> +</parameters> +<return> %TRUE if the main loop is running + +</return> +</function> + +<function name="g_main_iteration"> +<description> +Runs a single iteration for the default #GMainContext. + +Deprecated: 2.2: Use g_main_context_iteration() instead. + +</description> +<parameters> +<parameter name="may_block"> +<parameter_description> set to %TRUE if it should block (i.e. wait) until an event +source becomes ready. It will return after an event source has been +processed. If set to %FALSE it will return immediately if no event +source is ready to be processed. +</parameter_description> +</parameter> +</parameters> +<return> %TRUE if more events are pending. + +</return> +</function> + <function name="g_main_loop_get_context"> <description> Returns the #GMainContext of @loop. @@ -20007,6 +23526,91 @@ the result is zero, free the loop and free all associated memory. <return></return> </function> +<function name="g_main_new"> +<description> +Creates a new #GMainLoop for th default main context. + +Deprecated: 2.2: Use g_main_loop_new() instead + +</description> +<parameters> +<parameter name="is_running"> +<parameter_description> set to %TRUE to indicate that the loop is running. This +is not very important since calling g_main_run() will set this +to %TRUE anyway. +</parameter_description> +</parameter> +</parameters> +<return> a new #GMainLoop + +</return> +</function> + +<function name="g_main_pending"> +<description> +Checks if any events are pending for the default #GMainContext +(i.e. ready to be processed). + + +</description> +<parameters> +</parameters> +<return> %TRUE if any events are pending. + +Deprected: 2.2: Use g_main_context_pending() instead. +</return> +</function> + +<function name="g_main_quit"> +<description> +Stops the #GMainLoop. +If g_main_run() was called to run the #GMainLoop, it will now return. + +Deprecated: 2.2: Use g_main_loop_quit() instead + +</description> +<parameters> +<parameter name="loop"> +<parameter_description> a #GMainLoop +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_main_run"> +<description> +Runs a main loop until it stops running. + +Deprecated: 2.2: Use g_main_loop_run() instead + +</description> +<parameters> +<parameter name="loop"> +<parameter_description> a #GMainLoop +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_main_set_poll_func"> +<description> +Sets the function to use for the handle polling of file descriptors +for the default main context. + +Deprecated: 2.2: Use g_main_context_set_poll_func() again + +</description> +<parameters> +<parameter name="func"> +<parameter_description> the function to call to poll all file descriptors +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_malloc"> <description> Allocates @n_bytes bytes of memory. @@ -21925,6 +25529,120 @@ current thread leads to undefined behaviour. <return></return> </function> +<function name="g_new"> +<description> +Allocates @n_structs elements of type @struct_type. +The returned pointer is cast to a pointer to the given type. +If @n_structs is 0 it returns %NULL. +Care is taken to avoid overflow when calculating the size of the allocated block. + +Since the returned pointer is already casted to the right type, +it is normally unnecessary to cast it explicitly, and doing +so might hide memory allocation errors. + + +</description> +<parameters> +<parameter name="struct_type"> +<parameter_description> the type of the elements to allocate +</parameter_description> +</parameter> +<parameter name="n_structs"> +<parameter_description> the number of elements to allocate +</parameter_description> +</parameter> +</parameters> +<return> a pointer to the allocated memory, cast to a pointer to @struct_type +</return> +</function> + +<function name="g_new0"> +<description> +Allocates @n_structs elements of type @struct_type, initialized to 0's. +The returned pointer is cast to a pointer to the given type. +If @n_structs is 0 it returns %NULL. +Care is taken to avoid overflow when calculating the size of the allocated block. + +Since the returned pointer is already casted to the right type, +it is normally unnecessary to cast it explicitly, and doing +so might hide memory allocation errors. + + +</description> +<parameters> +<parameter name="struct_type"> +<parameter_description> the type of the elements to allocate. +</parameter_description> +</parameter> +<parameter name="n_structs"> +<parameter_description> the number of elements to allocate. +</parameter_description> +</parameter> +</parameters> +<return> a pointer to the allocated memory, cast to a pointer to @struct_type. +</return> +</function> + +<function name="g_newa"> +<description> +Wraps g_alloca() in a more typesafe manner. + + +</description> +<parameters> +<parameter name="struct_type"> +<parameter_description> Type of memory chunks to be allocated +</parameter_description> +</parameter> +<parameter name="n_structs"> +<parameter_description> Number of chunks to be allocated +</parameter_description> +</parameter> +</parameters> +<return> Pointer to stack space for @n_structs chunks of type @struct_type +</return> +</function> + +<function name="g_node_append"> +<description> +Inserts a #GNode as the last child of the given parent. + + +</description> +<parameters> +<parameter name="parent"> +<parameter_description> the #GNode to place the new #GNode under +</parameter_description> +</parameter> +<parameter name="node"> +<parameter_description> the #GNode to insert +</parameter_description> +</parameter> +</parameters> +<return> the inserted #GNode +</return> +</function> + +<function name="g_node_append_data"> +<description> +Inserts a new #GNode as the last child of the given parent. + + +</description> +<parameters> +<parameter name="parent"> +<parameter_description> the #GNode to place the new #GNode under +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> the data for the new #GNode +</parameter_description> +</parameter> +</parameters> +<return> the new #GNode +</return> +</function> + <function name="g_node_child_index"> <description> Gets the position of the first child of a #GNode @@ -22130,6 +25848,23 @@ Finds the first child of a #GNode with the given data. </return> </function> +<function name="g_node_first_child"> +<description> +Gets the first child of a #GNode. + + +</description> +<parameters> +<parameter name="node"> +<parameter_description> a #GNode +</parameter_description> +</parameter> +</parameters> +<return> the first child of @node, or %NULL if @node is %NULL +or has no children +</return> +</function> + <function name="g_node_first_sibling"> <description> Gets the first sibling of a #GNode. @@ -22238,6 +25973,79 @@ If sibling is %NULL, the node is inserted as the last child of @parent. </return> </function> +<function name="g_node_insert_data"> +<description> +Inserts a new #GNode at the given position. + + +</description> +<parameters> +<parameter name="parent"> +<parameter_description> the #GNode to place the new #GNode under +</parameter_description> +</parameter> +<parameter name="position"> +<parameter_description> the position to place the new #GNode at. If position is -1, +the new #GNode is inserted as the last child of @parent +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> the data for the new #GNode +</parameter_description> +</parameter> +</parameters> +<return> the new #GNode +</return> +</function> + +<function name="g_node_insert_data_after"> +<description> +Inserts a new #GNode after the given sibling. + + +</description> +<parameters> +<parameter name="parent"> +<parameter_description> the #GNode to place the new #GNode under +</parameter_description> +</parameter> +<parameter name="sibling"> +<parameter_description> the sibling #GNode to place the new #GNode after +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> the data for the new #GNode +</parameter_description> +</parameter> +</parameters> +<return> the new #GNode +</return> +</function> + +<function name="g_node_insert_data_before"> +<description> +Inserts a new #GNode before the given sibling. + + +</description> +<parameters> +<parameter name="parent"> +<parameter_description> the #GNode to place the new #GNode under +</parameter_description> +</parameter> +<parameter name="sibling"> +<parameter_description> the sibling #GNode to place the new #GNode before +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> the data for the new #GNode +</parameter_description> +</parameter> +</parameters> +<return> the new #GNode +</return> +</function> + <function name="g_node_is_ancestor"> <description> Returns %TRUE if @node is an ancestor of @descendant. @@ -22367,6 +26175,23 @@ Used to create the first node in a tree. </return> </function> +<function name="g_node_next_sibling"> +<description> +Gets the next sibling of a #GNode. + + +</description> +<parameters> +<parameter name="node"> +<parameter_description> a #GNode +</parameter_description> +</parameter> +</parameters> +<return> the next sibling of @node, or %NULL if @node is the last node +or %NULL +</return> +</function> + <function name="g_node_nth_child"> <description> Gets a child of a #GNode, using the given index. @@ -22409,6 +26234,43 @@ Inserts a #GNode as the first child of the given parent. </return> </function> +<function name="g_node_prepend_data"> +<description> +Inserts a new #GNode as the first child of the given parent. + + +</description> +<parameters> +<parameter name="parent"> +<parameter_description> the #GNode to place the new #GNode under +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> the data for the new #GNode +</parameter_description> +</parameter> +</parameters> +<return> the new #GNode +</return> +</function> + +<function name="g_node_prev_sibling"> +<description> +Gets the previous sibling of a #GNode. + + +</description> +<parameters> +<parameter name="node"> +<parameter_description> a #GNode +</parameter_description> +</parameter> +</parameters> +<return> the previous sibling of @node, or %NULL if @node is the first +node or %NULL +</return> +</function> + <function name="g_node_reverse_children"> <description> Reverses the order of the children of a #GNode. @@ -30450,6 +34312,102 @@ Since: 2.6 </return> </function> +<function name="g_renew"> +<description> +Reallocates the memory pointed to by @mem, so that it now has space for +@n_structs elements of type @struct_type. It returns the new address of +the memory, which may have been moved. +Care is taken to avoid overflow when calculating the size of the allocated block. + + +</description> +<parameters> +<parameter name="struct_type"> +<parameter_description> the type of the elements to allocate +</parameter_description> +</parameter> +<parameter name="mem"> +<parameter_description> the currently allocated memory +</parameter_description> +</parameter> +<parameter name="n_structs"> +<parameter_description> the number of elements to allocate +</parameter_description> +</parameter> +</parameters> +<return> a pointer to the new allocated memory, cast to a pointer to @struct_type +</return> +</function> + +<function name="g_return_if_fail"> +<description> +Verifies that the expression evaluates to %TRUE. If the expression +evaluates to %FALSE, a critical message is logged and the current +function returns. This can only be used in functions which do not +return a value. + +If G_DISABLE_CHECKS is defined then the check is not performed. You +should therefore not depend on any side effects of @expr. + +</description> +<parameters> +<parameter name="expr"> +<parameter_description> the expression to check +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_return_if_reached"> +<description> +Logs a critical message and returns from the current function. +This can only be used in functions which do not return a value. + +</description> +<parameters> +</parameters> +<return></return> +</function> + +<function name="g_return_val_if_fail"> +<description> +Verifies that the expression evaluates to %TRUE. If the expression +evaluates to %FALSE, a critical message is logged and @val is +returned from the current function. + +If G_DISABLE_CHECKS is defined then the check is not performed. You +should therefore not depend on any side effects of @expr. + +</description> +<parameters> +<parameter name="expr"> +<parameter_description> the expression to check +</parameter_description> +</parameter> +<parameter name="val"> +<parameter_description> the value to return from the current function +if the expression is not true +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_return_val_if_reached"> +<description> +Logs a critical message and returns @val. + +</description> +<parameters> +<parameter name="val"> +<parameter_description> the value to return from the current function +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_rmdir"> <description> A wrapper for the POSIX rmdir() function. The rmdir() function @@ -32647,6 +36605,66 @@ is #G_TYPE_NONE, the return value location can be omitted. <return></return> </function> +<function name="g_signal_connect"> +<description> +Connects a #GCallback function to a signal for a particular object. + +The handler will be called before the default handler of the signal. + + +</description> +<parameters> +<parameter name="instance"> +<parameter_description> the instance to connect to. +</parameter_description> +</parameter> +<parameter name="detailed_signal"> +<parameter_description> a string of the form "signal-name::detail". +</parameter_description> +</parameter> +<parameter name="c_handler"> +<parameter_description> the #GCallback to connect. +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> data to pass to @c_handler calls. +</parameter_description> +</parameter> +</parameters> +<return> the handler id +</return> +</function> + +<function name="g_signal_connect_after"> +<description> +Connects a #GCallback function to a signal for a particular object. + +The handler will be called after the default handler of the signal. + + +</description> +<parameters> +<parameter name="instance"> +<parameter_description> the instance to connect to. +</parameter_description> +</parameter> +<parameter name="detailed_signal"> +<parameter_description> a string of the form "signal-name::detail". +</parameter_description> +</parameter> +<parameter name="c_handler"> +<parameter_description> the #GCallback to connect. +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> data to pass to @c_handler calls. +</parameter_description> +</parameter> +</parameters> +<return> the handler id +</return> +</function> + <function name="g_signal_connect_closure"> <description> Connects a closure to a signal for a particular object. @@ -32802,6 +36820,37 @@ g_signal_handler_disconnect (instance, id); </return> </function> +<function name="g_signal_connect_swapped"> +<description> +Connects a #GCallback function to a signal for a particular object. + +The instance on which the signal is emitted and @data will be swapped when +calling the handler. + + +</description> +<parameters> +<parameter name="instance"> +<parameter_description> the instance to connect to. +</parameter_description> +</parameter> +<parameter name="detailed_signal"> +<parameter_description> a string of the form "signal-name::detail". +</parameter_description> +</parameter> +<parameter name="c_handler"> +<parameter_description> the #GCallback to connect. +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> data to pass to @c_handler calls. +</parameter_description> +</parameter> +</parameters> +<return> the handler id +</return> +</function> + <function name="g_signal_emit"> <description> Emits a signal. @@ -33081,6 +37130,30 @@ connected to a signal of @instance and is currently blocked. <return></return> </function> +<function name="g_signal_handlers_block_by_func"> +<description> +Blocks all handlers on an instance that match @func and @data. + + +</description> +<parameters> +<parameter name="instance"> +<parameter_description> The instance to block handlers from. +</parameter_description> +</parameter> +<parameter name="func"> +<parameter_description> The C closure callback of the handlers (useless for non-C closures). +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> The closure data of the handlers' closures. +</parameter_description> +</parameter> +</parameters> +<return> The number of handlers that matched. +</return> +</function> + <function name="g_signal_handlers_block_matched"> <description> Blocks all handlers on an instance that match a certain selection criteria. @@ -33128,6 +37201,52 @@ and/or @data the handlers have to match. </return> </function> +<function name="g_signal_handlers_disconnect_by_data"> +<description> +Disconnects all handlers on an instance that match @data. + +Since: 2.32 + +</description> +<parameters> +<parameter name="instance"> +<parameter_description> The instance to remove handlers from +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> the closure data of the handlers' closures +</parameter_description> +</parameter> +</parameters> +<return> The number of handlers that matched. + +</return> +</function> + +<function name="g_signal_handlers_disconnect_by_func"> +<description> +Disconnects all handlers on an instance that match @func and @data. + + +</description> +<parameters> +<parameter name="instance"> +<parameter_description> The instance to remove handlers from. +</parameter_description> +</parameter> +<parameter name="func"> +<parameter_description> The C closure callback of the handlers (useless for non-C closures). +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> The closure data of the handlers' closures. +</parameter_description> +</parameter> +</parameters> +<return> The number of handlers that matched. +</return> +</function> + <function name="g_signal_handlers_disconnect_matched"> <description> Disconnects all handlers on an instance that match a certain @@ -33176,6 +37295,30 @@ and/or @data the handlers have to match. </return> </function> +<function name="g_signal_handlers_unblock_by_func"> +<description> +Unblocks all handlers on an instance that match @func and @data. + + +</description> +<parameters> +<parameter name="instance"> +<parameter_description> The instance to unblock handlers from. +</parameter_description> +</parameter> +<parameter name="func"> +<parameter_description> The C closure callback of the handlers (useless for non-C closures). +</parameter_description> +</parameter> +<parameter name="data"> +<parameter_description> The closure data of the handlers' closures. +</parameter_description> +</parameter> +</parameters> +<return> The number of handlers that matched. +</return> +</function> + <function name="g_signal_handlers_unblock_matched"> <description> Unblocks all handlers on an instance that match a certain selection @@ -36902,7 +41045,7 @@ Also see g_strchomp() and g_strstrip(). <function name="g_strcmp0"> <description> -Compares @str1 and @str2 like strcmp(). Handles %NULL +Compares @str1 and @str2 like strcmp(). Handles %NULL gracefully by sorting it before non-%NULL strings. Comparing two %NULL pointers returns 0. @@ -36919,7 +41062,7 @@ Since: 2.16 </parameter_description> </parameter> </parameters> -<return> -1, 0 or 1, if @str1 is <, == or > than @str2. +<return> an integer less than, equal to, or greater than zero, if @str1 is <, == or > than @str2. </return> </function> @@ -41994,6 +46137,55 @@ Since: 2.24 </return> </function> +<function name="g_try_new"> +<description> +Attempts to allocate @n_structs elements of type @struct_type, and returns +%NULL on failure. Contrast with g_new(), which aborts the program on failure. +The returned pointer is cast to a pointer to the given type. +The function returns %NULL when @n_structs is 0 of if an overflow occurs. + +Since: 2.8 + +</description> +<parameters> +<parameter name="struct_type"> +<parameter_description> the type of the elements to allocate +</parameter_description> +</parameter> +<parameter name="n_structs"> +<parameter_description> the number of elements to allocate +</parameter_description> +</parameter> +</parameters> +<return> a pointer to the allocated memory, cast to a pointer to @struct_type +</return> +</function> + +<function name="g_try_new0"> +<description> +Attempts to allocate @n_structs elements of type @struct_type, initialized +to 0's, and returns %NULL on failure. Contrast with g_new0(), which aborts +the program on failure. +The returned pointer is cast to a pointer to the given type. +The function returns %NULL when @n_structs is 0 of if an overflow occurs. + +Since: 2.8 + +</description> +<parameters> +<parameter name="struct_type"> +<parameter_description> the type of the elements to allocate +</parameter_description> +</parameter> +<parameter name="n_structs"> +<parameter_description> the number of elements to allocate +</parameter_description> +</parameter> +</parameters> +<return> a pointer to the allocated memory, cast to a pointer to @struct_type +</return> +</function> + <function name="g_try_realloc"> <description> Attempts to realloc @mem to a new size, @n_bytes, and returns %NULL @@ -42042,6 +46234,35 @@ Since: 2.24 </return> </function> +<function name="g_try_renew"> +<description> +Attempts to reallocate the memory pointed to by @mem, so that it now has +space for @n_structs elements of type @struct_type, and returns %NULL on +failure. Contrast with g_renew(), which aborts the program on failure. +It returns the new address of the memory, which may have been moved. +The function returns %NULL if an overflow occurs. + +Since: 2.8 + +</description> +<parameters> +<parameter name="struct_type"> +<parameter_description> the type of the elements to allocate +</parameter_description> +</parameter> +<parameter name="mem"> +<parameter_description> the currently allocated memory +</parameter_description> +</parameter> +<parameter name="n_structs"> +<parameter_description> the number of elements to allocate +</parameter_description> +</parameter> +</parameters> +<return> a pointer to the new allocated memory, cast to a pointer to @struct_type +</return> +</function> + <function name="g_tuples_destroy"> <description> Frees the records which were returned by g_relation_select(). This @@ -45144,6 +49365,25 @@ Unicode character, returns (gunichar)-1. </return> </function> +<function name="g_utf8_next_char"> +<description> +Skips to the next character in a UTF-8 string. The string must be +valid; this macro is as fast as possible, and has no error-checking. +You would use this macro to iterate over a string character by +character. The macro returns the start of the next UTF-8 character. +Before using this macro, use g_utf8_validate() to validate strings +that may contain invalid UTF-8. + +</description> +<parameters> +<parameter name="p"> +<parameter_description> Pointer to the start of a valid UTF-8 character +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + <function name="g_utf8_normalize"> <description> Converts a string into canonical form, standardizing @@ -51236,6 +55476,34 @@ Since: 2.30 <return></return> </function> +<function name="g_warn_if_fail"> +<description> +Logs a warning if the expression is not true. + +Since: 2.16 + +</description> +<parameters> +<parameter name="expr"> +<parameter_description> the expression to check +</parameter_description> +</parameter> +</parameters> +<return></return> +</function> + +<function name="g_warn_if_reached"> +<description> +Logs a critical warning. + +Since: 2.16 + +</description> +<parameters> +</parameters> +<return></return> +</function> + <function name="g_warning"> <description> A convenience function/macro to log a warning message. @@ -51620,6 +55888,16 @@ Corresponds to the standard C <type>char</type> type. <return></return> </function> +<function name="gchararray"> +<description> +A C representable type name for #G_TYPE_STRING. + +</description> +<parameters> +</parameters> +<return></return> +</function> + <function name="gconstpointer"> <description> An untyped pointer to constant data. @@ -52043,6 +56321,59 @@ Values of this type can range from 0 to #G_MAXULONG. <return></return> </function> +<function name="gunichar"> +<description> +A type which can hold any UTF-32 or UCS-4 character code, +also known as a Unicode code point. + +If you want to produce the UTF-8 representation of a #gunichar, +use g_ucs4_to_utf8(). See also g_utf8_to_ucs4() for the reverse +process. + +To print/scan values of this type as integer, use +%G_GINT32_MODIFIER and/or %G_GUINT32_FORMAT. + +The notation to express a Unicode code point in running text is +as a hexadecimal number with four to six digits and uppercase +letters, prefixed by the string "U+". Leading zeros are omitted, +unless the code point would have fewer than four hexadecimal digits. +For example, "U+0041 LATIN CAPITAL LETTER A". To print a code point +in the U+-notation, use the format string "U+\%04"G_GINT32_FORMAT"X". +To scan, use the format string "U+\%06"G_GINT32_FORMAT"X". + +|[ +gunichar c; +sscanf ("U+0041", "U+%06"G_GINT32_FORMAT"X", &c) +g_print ("Read U+%04"G_GINT32_FORMAT"X", c); +]| + +</description> +<parameters> +</parameters> +<return></return> +</function> + +<function name="gunichar2"> +<description> +A type which can hold any UTF-16 code +point<footnote id="utf16_surrogate_pairs">UTF-16 also has so called +<firstterm>surrogate pairs</firstterm> to encode characters beyond +the BMP as pairs of 16bit numbers. Surrogate pairs cannot be stored +in a single gunichar2 field, but all GLib functions accepting gunichar2 +arrays will correctly interpret surrogate pairs.</footnote>. + +To print/scan values of this type to/from text you need to convert +to/from UTF-8, using g_utf16_to_utf8()/g_utf8_to_utf16(). + +To print/scan values of this type as integer, use +%G_GINT16_MODIFIER and/or %G_GUINT16_FORMAT. + +</description> +<parameters> +</parameters> +<return></return> +</function> + <function name="gushort"> <description> Corresponds to the standard C <type>unsigned short</type> type. diff --git a/glib/src/glib_extra_objects.defs b/glib/src/glib_extra_objects.defs index 0b28216d..d173edce 100644 --- a/glib/src/glib_extra_objects.defs +++ b/glib/src/glib_extra_objects.defs @@ -22,6 +22,11 @@ (c-name "GArray") ) +(define-object IOChannel + (in-module "GLib") + (c-name "GIOChannel") +) + (define-object KeyFile (in-module "GLib") (c-name "GKeyFile") |