diff --git a/docs/reference/gio/Makefile.am b/docs/reference/gio/Makefile.am index 47fdd3851..ee1173255 100644 --- a/docs/reference/gio/Makefile.am +++ b/docs/reference/gio/Makefile.am @@ -25,18 +25,24 @@ IGNORE_HFILES = \ gdbus-2.0 \ gvdb \ inotify \ + kqueue \ libasyncns \ tests \ win32 \ xdgmime \ + gappinfoprivate.h \ gapplicationimpl.h \ gasynchelper.h \ gcontenttypeprivate.h \ + gcredentialsprivate.h \ + gdbus-daemon-generated.h \ + gdbusactiongroup-private.h \ gdbusauth.h \ gdbusauthmechanismanon.h \ gdbusauthmechanismexternal.h \ gdbusauthmechanism.h \ gdbusauthmechanismsha1.h \ + gdbusdaemon.h \ gdbusprivate.h \ gdelayedsettingsbackend.h \ gdummyfile.h \ @@ -45,6 +51,8 @@ IGNORE_HFILES = \ gfileattribute-priv.h \ gfileinfo-priv.h \ giomodule-priv.h \ + gioprivate.h \ + giowin32-priv.h \ glocaldirectorymonitor.h \ glocalfileenumerator.h \ glocalfile.h \ @@ -59,10 +67,12 @@ IGNORE_HFILES = \ gnetworkingprivate.h \ gnetworkmonitorbase.h \ gnetworkmonitornetlink.h \ + gnetworkmonitornm.h \ gnotificationbackend.h \ gnotification-private.h \ gpollfilemonitor.h \ gregistrysettingsbackend.h \ + gresourcefile.h \ gsettingsbackendinternal.h \ gsettings-mapping.h \ gsettingsschema-internal.h \ diff --git a/docs/reference/gio/gio-sections.txt b/docs/reference/gio/gio-sections.txt index 12689478d..4e5e907f3 100644 --- a/docs/reference/gio/gio-sections.txt +++ b/docs/reference/gio/gio-sections.txt @@ -205,6 +205,13 @@ G_FILE G_IS_FILE G_TYPE_FILE G_FILE_GET_IFACE +G_TYPE_FILESYSTEM_PREVIEW_TYPE +G_TYPE_FILE_COPY_FLAGS +G_TYPE_FILE_CREATE_FLAGS +G_TYPE_FILE_MEASURE_FLAGS +G_TYPE_FILE_MONITOR_EVENT +G_TYPE_FILE_MONITOR_FLAGS +G_TYPE_FILE_QUERY_INFO_FLAGS g_file_get_type @@ -402,6 +409,7 @@ G_FILE_INFO_CLASS G_IS_FILE_INFO_CLASS G_FILE_INFO_GET_CLASS g_file_attribute_matcher_get_type +G_TYPE_FILE_TYPE g_file_info_get_type @@ -420,6 +428,12 @@ g_file_attribute_info_list_unref g_file_attribute_info_list_dup g_file_attribute_info_list_lookup g_file_attribute_info_list_add + +G_TYPE_FILE_ATTRIBUTE_INFO_FLAGS +G_TYPE_FILE_ATTRIBUTE_INFO_LIST +G_TYPE_FILE_ATTRIBUTE_MATCHER +G_TYPE_FILE_ATTRIBUTE_STATUS +G_TYPE_FILE_ATTRIBUTE_TYPE g_file_attribute_info_list_get_type @@ -556,6 +570,7 @@ G_IS_EMBLEMED_ICON_CLASS G_TYPE_EMBLEMED_ICON +GEmblemedIconPrivate g_emblemed_icon_get_type @@ -577,6 +592,7 @@ G_EMBLEM_GET_CLASS G_IS_EMBLEM G_IS_EMBLEM_CLASS G_TYPE_EMBLEM +G_TYPE_EMBLEM_ORIGIN
@@ -755,6 +771,8 @@ G_TYPE_DATA_INPUT_STREAM G_DATA_INPUT_STREAM_CLASS G_IS_DATA_INPUT_STREAM_CLASS G_DATA_INPUT_STREAM_GET_CLASS +G_TYPE_DATA_STREAM_BYTE_ORDER +G_TYPE_DATA_STREAM_NEWLINE_TYPE g_data_input_stream_get_type GDataInputStreamPrivate @@ -826,6 +844,7 @@ G_TYPE_OUTPUT_STREAM G_OUTPUT_STREAM_CLASS G_IS_OUTPUT_STREAM_CLASS G_OUTPUT_STREAM_GET_CLASS +G_TYPE_OUTPUT_STREAM_SPLICE_FLAGS g_output_stream_get_type GOutputStreamPrivate @@ -1013,8 +1032,10 @@ G_IO_STREAM_GET_CLASS G_IS_IO_STREAM G_IS_IO_STREAM_CLASS G_TYPE_IO_STREAM +G_TYPE_IO_STREAM_SPLICE_FLAGS GIOStreamPrivate +GIOStreamAdapter g_io_stream_get_type
@@ -1121,6 +1142,8 @@ G_IS_MOUNT G_MOUNT G_MOUNT_GET_IFACE G_TYPE_MOUNT +G_TYPE_MOUNT_MOUNT_FLAGS +G_TYPE_MOUNT_UNMOUNT_FLAGS g_mount_get_type @@ -1203,6 +1226,8 @@ G_DRIVE G_IS_DRIVE G_TYPE_DRIVE G_DRIVE_GET_IFACE +G_TYPE_DRIVE_START_FLAGS +G_TYPE_DRIVE_START_STOP_TYPE g_drive_get_type @@ -1318,6 +1343,8 @@ G_IO_ERROR GIOErrorEnum g_io_error_from_errno g_io_error_from_win32_error + +G_TYPE_IO_ERROR_ENUM g_io_error_quark @@ -1398,6 +1425,7 @@ G_APP_LAUNCH_CONTEXT_GET_CLASS G_IS_APP_LAUNCH_CONTEXT G_IS_APP_LAUNCH_CONTEXT_CLASS G_TYPE_APP_LAUNCH_CONTEXT +G_TYPE_APP_INFO_CREATE_FLAGS g_app_info_get_type g_app_info_create_flags_get_type @@ -1414,6 +1442,7 @@ g_app_info_monitor_get GAppInfoMonitor G_APP_INFO_MONITOR G_IS_APP_INFO_MONITOR +G_TYPE_APP_INFO_MONITOR g_app_info_monitor_get_type @@ -1447,6 +1476,9 @@ G_TYPE_MOUNT_OPERATION G_MOUNT_OPERATION_CLASS G_IS_MOUNT_OPERATION_CLASS G_MOUNT_OPERATION_GET_CLASS +G_TYPE_ASK_PASSWORD_FLAGS +G_TYPE_MOUNT_OPERATION_RESULT +G_TYPE_PASSWORD_SAVE g_mount_operation_get_type g_ask_password_flags_get_type @@ -1551,6 +1583,10 @@ g_desktop_app_info_launch_action g_desktop_app_info_search g_desktop_app_info_get_implementations + +GDesktopAppInfoLookup +GDesktopAppInfoLookupIface +G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME GDesktopAppInfoClass G_TYPE_DESKTOP_APP_INFO @@ -1559,6 +1595,10 @@ G_DESKTOP_APP_INFO_CLASS G_IS_DESKTOP_APP_INFO G_IS_DESKTOP_APP_INFO_CLASS G_DESKTOP_APP_INFO_GET_CLASS +G_DESKTOP_APP_INFO_LOOKUP +G_DESKTOP_APP_INFO_LOOKUP_GET_IFACE +G_IS_DESKTOP_APP_INFO_LOOKUP +G_TYPE_DESKTOP_APP_INFO_LOOKUP g_desktop_app_info_get_type g_desktop_app_info_lookup_get_default_for_uri_scheme @@ -1590,6 +1630,7 @@ G_IO_TYPE_MODULE G_IO_MODULE_CLASS G_IO_IS_MODULE_CLASS G_IO_MODULE_GET_CLASS +G_TYPE_IO_MODULE_SCOPE_FLAGS g_io_module_get_type @@ -1714,6 +1755,7 @@ G_SOCKET_ADDRESS G_SOCKET_ADDRESS_CLASS G_SOCKET_ADDRESS_GET_CLASS G_TYPE_SOCKET_ADDRESS +G_TYPE_SOCKET_FAMILY g_socket_address_get_type @@ -1763,6 +1805,7 @@ G_TYPE_UNIX_SOCKET_ADDRESS G_UNIX_SOCKET_ADDRESS G_UNIX_SOCKET_ADDRESS_CLASS G_UNIX_SOCKET_ADDRESS_GET_CLASS +G_TYPE_UNIX_SOCKET_ADDRESS_TYPE g_unix_socket_address_get_type @@ -1784,6 +1827,8 @@ g_resolver_lookup_service g_resolver_lookup_service_async g_resolver_lookup_service_finish g_resolver_free_targets + +GResolverRecordType g_resolver_lookup_records g_resolver_lookup_records_async g_resolver_lookup_records_finish @@ -1800,6 +1845,8 @@ G_RESOLVER G_RESOLVER_CLASS G_RESOLVER_GET_CLASS G_TYPE_RESOLVER +G_TYPE_RESOLVER_ERROR +G_TYPE_RESOLVER_RECORD_TYPE GResolverPrivate @@ -1923,6 +1970,7 @@ GSocketProtocol GSocketMsgFlags GInputVector GOutputVector +GOutputMessage g_socket_new g_socket_new_from_fd g_socket_bind @@ -1985,6 +2033,9 @@ G_SOCKET G_SOCKET_CLASS G_TYPE_SOCKET G_SOCKET_GET_CLASS +G_TYPE_SOCKET_MSG_FLAGS +G_TYPE_SOCKET_PROTOCOL +G_TYPE_SOCKET_TYPE g_socket_get_type GSocketPrivate @@ -2035,6 +2086,7 @@ G_SOCKET_CLIENT G_SOCKET_CLIENT_CLASS G_SOCKET_CLIENT_GET_CLASS G_TYPE_SOCKET_CLIENT +G_TYPE_SOCKET_CLIENT_EVENT GSocketClientPrivate g_socket_client_get_type @@ -2259,6 +2311,8 @@ G_TYPE_CONVERTER G_CONVERTER G_IS_CONVERTER G_CONVERTER_GET_IFACE +G_TYPE_CONVERTER_FLAGS +G_TYPE_CONVERTER_RESULT g_converter_get_type g_converter_flags_get_type @@ -2339,6 +2393,7 @@ G_IS_ZLIB_COMPRESSOR G_ZLIB_COMPRESSOR_CLASS G_IS_ZLIB_COMPRESSOR_CLASS G_ZLIB_COMPRESSOR_GET_CLASS +G_TYPE_ZLIB_COMPRESSOR_FORMAT g_zlib_compressor_get_type @@ -2365,9 +2420,8 @@ g_zlib_decompressor_get_type gfiledescriptorbased GFileDescriptorBased GFileDescriptorBased -g_file_descriptor_based_get_fd - GFileDescriptorBasedIface +g_file_descriptor_based_get_fd g_file_descriptor_based_get_type G_FILE_DESCRIPTOR_BASED @@ -2411,7 +2465,6 @@ GSettingsBackendPrivate gsettingsschema GSettingsSchema, GSettingsSchemaSource GSettingsSchemaSource -G_TYPE_SETTINGS_SCHEMA_SOURCE g_settings_schema_source_get_default g_settings_schema_source_ref g_settings_schema_source_unref @@ -2425,7 +2478,6 @@ g_settings_schema_source_lookup GSettingsSchema -G_TYPE_SETTINGS_SCHEMA g_settings_schema_ref g_settings_schema_unref @@ -2452,6 +2504,11 @@ g_settings_schema_key_get_name g_settings_schema_key_get_summary g_settings_schema_key_get_description + +G_TYPE_SETTINGS_SCHEMA_KEY +G_TYPE_SETTINGS_SCHEMA +G_TYPE_SETTINGS_SCHEMA_SOURCE + g_settings_schema_get_type g_settings_schema_key_get_type @@ -2532,6 +2589,7 @@ G_SETTINGS G_SETTINGS_CLASS G_SETTINGS_GET_CLASS G_TYPE_SETTINGS +G_TYPE_SETTINGS_BIND_FLAGS GSettingsPrivate @@ -2579,6 +2637,7 @@ G_TYPE_CREDENTIALS G_CREDENTIALS_CLASS G_IS_CREDENTIALS_CLASS G_CREDENTIALS_GET_CLASS +G_TYPE_CREDENTIALS_TYPE g_credentials_get_type g_credentials_type_get_type @@ -2648,6 +2707,7 @@ g_dbus_server_get_client_address G_DBUS_SERVER G_IS_DBUS_SERVER G_TYPE_DBUS_SERVER +G_TYPE_DBUS_SERVER_FLAGS g_dbus_server_get_type @@ -2713,6 +2773,10 @@ g_dbus_message_to_gerror G_DBUS_MESSAGE G_IS_DBUS_MESSAGE G_TYPE_DBUS_MESSAGE +G_TYPE_DBUS_MESSAGE_BYTE_ORDER +G_TYPE_DBUS_MESSAGE_FLAGS +G_TYPE_DBUS_MESSAGE_HEADER_FIELD +G_TYPE_DBUS_MESSAGE_TYPE g_dbus_message_get_type @@ -2786,6 +2850,13 @@ g_dbus_connection_unregister_subtree G_DBUS_CONNECTION G_IS_DBUS_CONNECTION G_TYPE_DBUS_CONNECTION +G_TYPE_BUS_TYPE +G_TYPE_DBUS_CALL_FLAGS +G_TYPE_DBUS_CAPABILITY_FLAGS +G_TYPE_DBUS_CONNECTION_FLAGS +G_TYPE_DBUS_SEND_MESSAGE_FLAGS +G_TYPE_DBUS_SIGNAL_FLAGS +G_TYPE_DBUS_SUBTREE_FLAGS g_dbus_connection_get_type g_bus_type_get_type @@ -2833,6 +2904,8 @@ g_bus_unown_name g_bus_own_name_with_closures g_bus_own_name_on_connection_with_closures + +G_TYPE_BUS_NAME_OWNER_FLAGS g_bus_name_owner_flags_get_type @@ -2848,6 +2921,8 @@ g_bus_unwatch_name g_bus_watch_name_with_closures g_bus_watch_name_on_connection_with_closures + +G_TYPE_BUS_NAME_WATCHER_FLAGS g_bus_name_watcher_flags_get_type @@ -2868,6 +2943,7 @@ g_dbus_error_set_dbus_error g_dbus_error_set_dbus_error_valist g_dbus_error_encode_gerror +G_TYPE_DBUS_ERROR g_dbus_error_quark @@ -2909,6 +2985,7 @@ G_TYPE_DBUS_PROXY G_DBUS_PROXY_CLASS G_IS_DBUS_PROXY_CLASS G_DBUS_PROXY_GET_CLASS +G_TYPE_DBUS_PROXY_FLAGS GDBusProxyPrivate g_dbus_proxy_get_type @@ -2955,6 +3032,8 @@ g_dbus_signal_info_unref g_dbus_property_info_unref g_dbus_arg_info_unref g_dbus_annotation_info_unref + +G_TYPE_DBUS_PROPERTY_INFO_FLAGS g_dbus_annotation_info_get_type g_dbus_arg_info_get_type @@ -3064,6 +3143,7 @@ G_APPLICATION_CLASS G_IS_APPLICATION G_IS_APPLICATION_CLASS G_APPLICATION_GET_CLASS +G_TYPE_APPLICATION_FLAGS GApplicationPrivate g_application_get_type @@ -3176,6 +3256,7 @@ G_TYPE_REMOTE_ACTION_GROUP G_REMOTE_ACTION_GROUP G_IS_REMOTE_ACTION_GROUP G_REMOTE_ACTION_GROUP_GET_IFACE +g_remote_action_group_get_type
@@ -3418,6 +3499,10 @@ GTlsError GTlsAuthenticationMode GTlsCertificateFlags + +G_TYPE_TLS_AUTHENTICATION_MODE +G_TYPE_TLS_CERTIFICATE_FLAGS +G_TYPE_TLS_ERROR
@@ -3501,6 +3586,7 @@ G_TLS_CONNECTION G_TLS_CONNECTION_CLASS G_TLS_CONNECTION_GET_CLASS G_TYPE_TLS_CONNECTION +G_TYPE_TLS_REHANDSHAKE_MODE g_tls_connection_get_type
@@ -3617,6 +3703,11 @@ G_IS_TLS_PASSWORD G_TLS_PASSWORD G_TYPE_TLS_PASSWORD G_TYPE_TLS_PASSWORD_FLAGS +G_TLS_PASSWORD_CLASS +G_TLS_PASSWORD_GET_CLASS +G_IS_TLS_PASSWORD_CLASS + +GTlsPasswordPrivate
@@ -3642,6 +3733,7 @@ G_TLS_INTERACTION G_TLS_INTERACTION_CLASS G_TLS_INTERACTION_GET_CLASS G_TYPE_TLS_INTERACTION_RESULT +G_TYPE_TLS_CERTIFICATE_REQUEST_FLAGS GTlsInteractionPrivate g_tls_interaction_get_type @@ -3844,6 +3936,7 @@ GNetworkConnectivity g_network_monitor_get_connectivity g_network_monitor_get_type +G_TYPE_NETWORK_CONNECTIVITY G_TYPE_NETWORK_MONITOR G_NETWORK_MONITOR G_IS_NETWORK_MONITOR @@ -3864,7 +3957,7 @@ g_dbus_menu_model_get G_TYPE_DBUS_MENU_MODEL G_DBUS_MENU_MODEL -G_IS_BDUS_MENU_MODEL +G_IS_DBUS_MENU_MODEL g_dbus_menu_model_get_type @@ -3946,6 +4039,7 @@ g_menu_model_get_n_items G_MENU_ATTRIBUTE_ACTION +G_MENU_ATTRIBUTE_ACTION_NAMESPACE G_MENU_ATTRIBUTE_TARGET G_MENU_ATTRIBUTE_LABEL G_MENU_ATTRIBUTE_ICON @@ -4031,6 +4125,7 @@ g_resource_enumerate_children g_resource_get_info +GStaticResource g_static_resource_init g_static_resource_fini g_static_resource_get_resource @@ -4078,6 +4173,11 @@ g_test_dbus_unset g_test_dbus_get_type g_test_dbus_flags_get_type + +G_TEST_DBUS +G_IS_TEST_DBUS +G_TYPE_TEST_DBUS +G_TYPE_TEST_DBUS_FLAGS
@@ -4257,6 +4357,7 @@ G_NOTIFICATION G_TYPE_NOTIFICATION G_TYPE_NOTIFICATION_BACKEND g_notification_get_type +G_TYPE_NOTIFICATION_PRIORITY
diff --git a/gio/fen/fen-kernel.c b/gio/fen/fen-kernel.c index ed1e3041f..3619211e1 100644 --- a/gio/fen/fen-kernel.c +++ b/gio/fen/fen-kernel.c @@ -301,7 +301,6 @@ psource_new() /** * port_add: - * @f: * * Unsafe, need lock fen_lock. * port_add will associate a GSource to @f->source diff --git a/gio/gaction.c b/gio/gaction.c index 85717fa0b..a280256f3 100644 --- a/gio/gaction.c +++ b/gio/gaction.c @@ -62,6 +62,13 @@ G_DEFINE_INTERFACE (GAction, g_action, G_TYPE_OBJECT) * inside of a #GSimpleActionGroup. **/ +/** + * GAction: + * + * #GAction is an opaque data structure and can only be accessed + * using the following functions. + **/ + /** * GActionInterface: * @get_name: the virtual function pointer for g_action_get_name() diff --git a/gio/gactiongroup.c b/gio/gactiongroup.c index c608a4a99..fcedb9522 100644 --- a/gio/gactiongroup.c +++ b/gio/gactiongroup.c @@ -76,6 +76,13 @@ * calls to g_action_group_query_action(). */ +/** + * GActionGroup: + * + * #GActionGroup is an opaque data structure and can only be accessed + * using the following functions. + **/ + /** * GActionGroupInterface: * @has_action: the virtual function pointer for g_action_group_has_action() diff --git a/gio/gactionmap.c b/gio/gactionmap.c index c5b3d2eb5..778ca251f 100644 --- a/gio/gactionmap.c +++ b/gio/gactionmap.c @@ -42,6 +42,13 @@ * Since: 2.32 **/ +/** + * GActionMap: + * + * #GActionMap is an opaque data structure and can only be accessed + * using the following functions. + **/ + /** * GActionMapInterface: * @lookup_action: the virtual function pointer for g_action_map_lookup_action() diff --git a/gio/gappinfo.c b/gio/gappinfo.c index df0cfe0cd..49ccb2f3d 100644 --- a/gio/gappinfo.c +++ b/gio/gappinfo.c @@ -825,7 +825,7 @@ g_app_launch_context_class_init (GAppLaunchContextClass *klass) object_class->finalize = g_app_launch_context_finalize; - /* + /** * GAppLaunchContext::launch-failed: * @context: the object emitting the signal * @startup_notify_id: the startup notification id for the failed launch @@ -843,7 +843,7 @@ g_app_launch_context_class_init (GAppLaunchContextClass *klass) NULL, NULL, NULL, G_TYPE_NONE, 1, G_TYPE_STRING); - /* + /** * GAppLaunchContext::launched: * @context: the object emitting the signal * @info: the #GAppInfo that was just launched @@ -1132,6 +1132,12 @@ g_app_info_monitor_class_init (GAppInfoMonitorClass *class) { GObjectClass *object_class = G_OBJECT_CLASS (class); + /** + * GAppInfoMonitor::changed: + * + * Signal emitted when the app info database for changes (ie: newly installed + * or removed applications). + **/ g_app_info_monitor_changed_signal = g_signal_new ("changed", G_TYPE_APP_INFO_MONITOR, G_SIGNAL_RUN_FIRST, 0, NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0); diff --git a/gio/gappinfo.h b/gio/gappinfo.h index 713616fbc..5bf3cf6d1 100644 --- a/gio/gappinfo.h +++ b/gio/gappinfo.h @@ -78,6 +78,7 @@ typedef struct _GAppLaunchContextPrivate GAppLaunchContextPrivate; * @get_commandline: Gets the commandline for the #GAppInfo. Since 2.20 * @get_display_name: Gets the display name for the #GAppInfo. Since 2.24 * @set_as_last_used_for_type: Sets the application as the last used. See g_app_info_set_as_last_used_for_type(). + * @get_supported_types: Retrieves the list of content types that @app_info claims to support. * * Application Information interface, for operating system portability. */ diff --git a/gio/gapplication.c b/gio/gapplication.c index a918ea2be..d09cdb04a 100644 --- a/gio/gapplication.c +++ b/gio/gapplication.c @@ -163,6 +163,14 @@ * [gapplication-example-dbushooks.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-dbushooks.c). */ +/** + * GApplication: + * + * #GApplication is an opaque data structure and can only be accessed + * using the following functions. + * Since: 2.28 + */ + /** * GApplicationClass: * @startup: invoked on the primary instance immediately after registration @@ -202,6 +210,8 @@ * @dbus_unregister: invoked locally during unregistration, if the application * is using its D-Bus backend. Use this to undo anything done by the * @dbus_register vfunc. Since: 2.34 + * @handle_local_options: invoked locally after the parsing of the commandline + * options has occurred. * * Virtual function table for #GApplication. * diff --git a/gio/gapplication.h b/gio/gapplication.h index dbac2a942..658c63350 100644 --- a/gio/gapplication.h +++ b/gio/gapplication.h @@ -41,11 +41,6 @@ G_BEGIN_DECLS typedef struct _GApplicationPrivate GApplicationPrivate; typedef struct _GApplicationClass GApplicationClass; -/** - * GApplication: - * - * Since: 2.28 - */ struct _GApplication { /*< private >*/ diff --git a/gio/gapplicationcommandline.c b/gio/gapplicationcommandline.c index d5e508a86..8ef0f51f9 100644 --- a/gio/gapplicationcommandline.c +++ b/gio/gapplicationcommandline.c @@ -200,6 +200,13 @@ * [gapplication-example-cmdline3.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-cmdline3.c) */ +/** + * GApplicationCommandLine: + * + * #GApplicationCommandLine is an opaque data structure and can only be accessed + * using the following functions. + */ + /** * GApplicationCommandLineClass: * diff --git a/gio/gdbusactiongroup.c b/gio/gdbusactiongroup.c index 57454edd5..d10052c72 100644 --- a/gio/gdbusactiongroup.c +++ b/gio/gdbusactiongroup.c @@ -38,6 +38,13 @@ * that is exported over D-Bus with g_dbus_connection_export_action_group(). */ +/** + * GDBusActionGroup: + * + * #GDBusActionGroup is an opaque data structure and can only be accessed + * using the following functions. + */ + struct _GDBusActionGroup { GObject parent_instance; diff --git a/gio/gdbusmenumodel.c b/gio/gdbusmenumodel.c index 29f2e2507..18c68dfcb 100644 --- a/gio/gdbusmenumodel.c +++ b/gio/gdbusmenumodel.c @@ -37,6 +37,13 @@ * g_dbus_connection_export_menu_model(). */ +/** + * GDBusMenuModel: + * + * #GDBusMenuModel is an opaque data structure and can only be accessed + * using the following functions. + */ + /* * There are 3 main (quasi-)classes involved here: * diff --git a/gio/gdbusobject.c b/gio/gdbusobject.c index 30b2e8618..570d6b7c0 100644 --- a/gio/gdbusobject.c +++ b/gio/gdbusobject.c @@ -37,6 +37,13 @@ * interfaces. */ +/** + * GDBusObject: + * + * #GDBusObject is an opaque data structure and can only be accessed + * using the following functions. + */ + typedef GDBusObjectIface GDBusObjectInterface; G_DEFINE_INTERFACE (GDBusObject, g_dbus_object, G_TYPE_OBJECT) diff --git a/gio/gdbusobjectmanager.c b/gio/gdbusobjectmanager.c index 25081b12c..eb837f0e1 100644 --- a/gio/gdbusobjectmanager.c +++ b/gio/gdbusobjectmanager.c @@ -41,6 +41,13 @@ * and #GDBusObjectManagerServer for the service-side implementation. */ +/** + * GDBusObjectManager: + * + * #GDBusObjectManager is an opaque data structure and can only be accessed + * using the following functions. + */ + typedef GDBusObjectManagerIface GDBusObjectManagerInterface; G_DEFINE_INTERFACE (GDBusObjectManager, g_dbus_object_manager, G_TYPE_OBJECT) diff --git a/gio/gdesktopappinfo.c b/gio/gdesktopappinfo.c index 7bfc90471..786ce0f52 100644 --- a/gio/gdesktopappinfo.c +++ b/gio/gdesktopappinfo.c @@ -4308,6 +4308,13 @@ g_app_info_get_all (void) /* GDesktopAppInfoLookup interface {{{2 */ +/** + * GDesktopAppInfoLookup: + * + * #GDesktopAppInfoLookup is an opaque data structure and can only be accessed + * using the following functions. + **/ + G_GNUC_BEGIN_IGNORE_DEPRECATIONS typedef GDesktopAppInfoLookupIface GDesktopAppInfoLookupInterface; diff --git a/gio/gdesktopappinfo.h b/gio/gdesktopappinfo.h index 79f986463..97cbe3909 100644 --- a/gio/gdesktopappinfo.h +++ b/gio/gdesktopappinfo.h @@ -116,7 +116,9 @@ gchar * g_desktop_app_info_get_action_name (GDeskto #endif /* G_DISABLE_DEPRECATED */ /** - * GDesktopAppInfoLookup: + * GDesktopAppInfoLookupIface: + * @get_default_for_uri_scheme: Virtual method for + * g_desktop_app_info_lookup_get_default_for_uri_scheme(). * * Interface that is used by backends to associate default * handlers with URI schemes. diff --git a/gio/gfile.h b/gio/gfile.h index 60a8d7028..368bb045f 100644 --- a/gio/gfile.h +++ b/gio/gfile.h @@ -150,6 +150,9 @@ typedef struct _GFileIface GFileIface; * @eject_mountable_with_operation_finish: Finishes an eject operation using a #GMountOperation. Since 2.22. * @poll_mountable: Polls a mountable object for media changes. Since 2.22. * @poll_mountable_finish: Finishes an poll operation for media changes. Since 2.22. + * @measure_disk_usage: Recursively measures the disk usage of @file. Since 2.38 + * @measure_disk_usage_async: Asynchronously recursively measures the disk usage of @file. Since 2.38 + * @measure_disk_usage_finish: Finishes an asynchronous recursive measurement of the disk usage of @file. Since 2.38 * * An interface for writing VFS file handles. **/ diff --git a/gio/gfiledescriptorbased.h b/gio/gfiledescriptorbased.h index d4a3bf226..7c9d8bc41 100644 --- a/gio/gfiledescriptorbased.h +++ b/gio/gfiledescriptorbased.h @@ -41,7 +41,9 @@ typedef struct _GFileDescriptorBasedIface GFileDescriptorBasedIface; /** * GFileDescriptorBasedIface: * @g_iface: The parent interface. + * @get_fd: Gets the underlying file descriptor. * + * An interface for file descriptor based io objects. **/ struct _GFileDescriptorBasedIface { diff --git a/gio/gfileinfo.h b/gio/gfileinfo.h index cec887273..1af56ae21 100644 --- a/gio/gfileinfo.h +++ b/gio/gfileinfo.h @@ -826,7 +826,7 @@ typedef struct _GFileInfoClass GFileInfoClass; * was trashed. Corresponding #GFileAttributeType is * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. * - * Since: 2.24. + * Since: 2.24 **/ #define G_FILE_ATTRIBUTE_TRASH_ORIG_PATH "trash::orig-path" /* byte string */ @@ -838,7 +838,7 @@ typedef struct _GFileInfoClass GFileInfoClass; * was trashed. The format of the returned string is YYYY-MM-DDThh:mm:ss. * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. * - * Since: 2.24. + * Since: 2.24 **/ #define G_FILE_ATTRIBUTE_TRASH_DELETION_DATE "trash::deletion-date" /* string */ diff --git a/gio/gicon.h b/gio/gicon.h index 5a0986487..b0c45b4bd 100644 --- a/gio/gicon.h +++ b/gio/gicon.h @@ -52,6 +52,7 @@ typedef struct _GIconIface GIconIface; * @from_tokens: Constructs a #GIcon from tokens. Set the #GError if * the tokens are malformed. Don't implement if the #GIcon can't be * serialized (Since 2.20). + * @serialize: Serializes a #GIcon into a #GVariant. Since: 2.38 * * GIconIface is used to implement GIcon types for various * different systems. See #GThemedIcon and #GLoadableIcon for diff --git a/gio/giomodule.c b/gio/giomodule.c index 256cb8311..b22ea4993 100644 --- a/gio/giomodule.c +++ b/gio/giomodule.c @@ -224,12 +224,24 @@ static void g_io_module_finalize (GObject *object); static gboolean g_io_module_load_module (GTypeModule *gmodule); static void g_io_module_unload_module (GTypeModule *gmodule); +/** + * GIOExtension: + * + * #GIOExtension is an opaque data structure and can only be accessed + * using the following functions. + */ struct _GIOExtension { char *name; GType type; gint priority; }; +/** + * GIOExtensionPoint: + * + * #GIOExtensionPoint is an opaque data structure and can only be accessed + * using the following functions. + */ struct _GIOExtensionPoint { GType required_type; char *name; diff --git a/gio/gnetworkmonitor.c b/gio/gnetworkmonitor.c index 65ffda394..b08de473a 100644 --- a/gio/gnetworkmonitor.c +++ b/gio/gnetworkmonitor.c @@ -48,6 +48,22 @@ * Since: 2.32 */ +/** + * GNetworkMonitorInterface: + * @g_iface: The parent interface. + * @network_changed: the virtual function pointer for the + * GNetworkMonitor::network-changed signal. + * @can_reach: the virtual function pointer for g_network_monitor_can_reach() + * @can_reach_async: the virtual function pointer for + * g_network_monitor_can_reach_async() + * @can_reach_finish: the virtual function pointer for + * g_network_monitor_can_reach_finish() + * + * The virtual function table for #GNetworkMonitor. + * + * Since: 2.32 + */ + G_DEFINE_INTERFACE_WITH_CODE (GNetworkMonitor, g_network_monitor, G_TYPE_OBJECT, g_type_interface_add_prerequisite (g_define_type_id, G_TYPE_INITABLE);) diff --git a/gio/gproxyaddress.c b/gio/gproxyaddress.c index 1d0ab217a..0227b9ec7 100644 --- a/gio/gproxyaddress.c +++ b/gio/gproxyaddress.c @@ -43,6 +43,14 @@ * Since: 2.26 **/ +/** + * GProxyAddressClass: + * + * Class structure for #GProxyAddress. + * + * Since: 2.26 + **/ + enum { PROP_0, diff --git a/gio/gproxyresolver.c b/gio/gproxyresolver.c index d51dcc523..eb3552f60 100644 --- a/gio/gproxyresolver.c +++ b/gio/gproxyresolver.c @@ -41,6 +41,19 @@ * the method g_socket_connectable_proxy_enumerate(). */ +/** + * GProxyResolverInterface: + * @g_iface: The parent interface. + * @is_supported: the virtual function pointer for g_proxy_resolver_is_supported() + * @lookup: the virtual function pointer for g_proxy_resolver_lookup() + * @lookup_async: the virtual function pointer for + * g_proxy_resolver_lookup_async() + * @lookup_finish: the virtual function pointer for + * g_proxy_resolver_lookup_finish() + * + * The virtual function table for #GProxyResolver. + */ + G_DEFINE_INTERFACE (GProxyResolver, g_proxy_resolver, G_TYPE_OBJECT) static void diff --git a/gio/gremoteactiongroup.c b/gio/gremoteactiongroup.c index 760cdfe3d..ad0655c22 100644 --- a/gio/gremoteactiongroup.c +++ b/gio/gremoteactiongroup.c @@ -55,6 +55,13 @@ * Since: 2.32 **/ +/** + * GRemoteActionGroup: + * + * #GRemoteActionGroup is an opaque data structure and can only be accessed + * using the following functions. + **/ + /** * GRemoteActionGroupInterface: * @activate_action_full: the virtual function pointer for g_remote_action_group_activate_action_full() diff --git a/gio/gresource.c b/gio/gresource.c index 4e54fd21a..0b056464f 100644 --- a/gio/gresource.c +++ b/gio/gresource.c @@ -129,6 +129,13 @@ G_DEFINE_BOXED_TYPE (GResource, g_resource, g_resource_ref, g_resource_unref) * Since: 2.32 */ +/** + * GStaticResource: + * + * #GStaticResource is an opaque data structure and can only be accessed + * using the following functions. + **/ + /** * g_resource_error_quark: * diff --git a/gio/gsettings.c b/gio/gsettings.c index 035a1c51d..648509512 100644 --- a/gio/gsettings.c +++ b/gio/gsettings.c @@ -230,6 +230,13 @@ * #G_SETTINGS_BIND_NO_SENSITIVITY flag. */ +/** + * GSettings: + * + * #GSettings is an opaque data structure and can only be accessed + * using the following functions. + **/ + struct _GSettingsPrivate { /* where the signals go... */ diff --git a/gio/gsettingsbackend.h b/gio/gsettingsbackend.h index fbec206b1..96ce14180 100644 --- a/gio/gsettingsbackend.h +++ b/gio/gsettingsbackend.h @@ -59,6 +59,21 @@ G_BEGIN_DECLS typedef struct _GSettingsBackendPrivate GSettingsBackendPrivate; typedef struct _GSettingsBackendClass GSettingsBackendClass; +/** + * GSettingsBackendClass: + * @read: virtual method to read a key's value + * @get_writable: virtual method to get if a key is writable + * @write: virtual method to change key's value + * @write_tree: virtual method to change a tree of keys + * @reset: virtual method to reset state + * @subscribe: virtual method to subscribe to key changes + * @unsubscribe: virtual method to unsubscribe to key changes + * @sync: virtual method to sync state + * @get_permission: virtual method to get permission of a key + * @read_user_value: virtual method to read user's key value + * + * Class structure for #GSettingsBackend. + */ struct _GSettingsBackendClass { GObjectClass parent_class; diff --git a/gio/gsettingsschema.c b/gio/gsettingsschema.c index f5159241d..e3966fdbf 100644 --- a/gio/gsettingsschema.c +++ b/gio/gsettingsschema.c @@ -128,6 +128,13 @@ * Since: 2.32 **/ +/** + * GSettingsSchemaKey: + * + * #GSettingsSchemaKey is an opaque data structure and can only be accessed + * using the following functions. + **/ + /** * GSettingsSchema: * @@ -836,13 +843,15 @@ ensure_schema_lists (void) /** * g_settings_list_schemas: * + * + * * Returns: (element-type utf8) (transfer none): a list of #GSettings * schemas that are available. The list must not be modified or * freed. * * Since: 2.26 * - * Deprecated:2.40: Use g_settings_schema_source_list_schemas() instead. + * Deprecated: 2.40: Use g_settings_schema_source_list_schemas() instead. * If you used g_settings_list_schemas() to check for the presence of * a particular schema, use g_settings_schema_source_lookup() instead * of your whole loop. @@ -858,13 +867,15 @@ g_settings_list_schemas (void) /** * g_settings_list_relocatable_schemas: * + * + * * Returns: (element-type utf8) (transfer none): a list of relocatable * #GSettings schemas that are available. The list must not be * modified or freed. * * Since: 2.28 * - * Deprecated:2.40: Use g_settings_schema_source_list_schemas() instead + * Deprecated: 2.40: Use g_settings_schema_source_list_schemas() instead **/ const gchar * const * g_settings_list_relocatable_schemas (void) diff --git a/gio/gsimpleaction.c b/gio/gsimpleaction.c index 589972a26..e9eb3603d 100644 --- a/gio/gsimpleaction.c +++ b/gio/gsimpleaction.c @@ -36,6 +36,14 @@ * * See also #GtkAction. */ + +/** + * GSimpleAction: + * + * #GSimpleAction is an opaque data structure and can only be accessed + * using the following functions. + **/ + struct _GSimpleAction { GObject parent_instance; diff --git a/gio/gsocketcontrolmessage.h b/gio/gsocketcontrolmessage.h index 37da11ad0..ae6989242 100644 --- a/gio/gsocketcontrolmessage.h +++ b/gio/gsocketcontrolmessage.h @@ -54,6 +54,8 @@ typedef struct _GSocketControlMessageClass GSocketControlMessag * @get_type: gets the protocol specific type of the message. * @serialize: Writes out the message data. * @deserialize: Tries to deserialize a message. + * + * Class structure for #GSocketControlMessage. **/ struct _GSocketControlMessageClass diff --git a/gio/gsocketlistener.h b/gio/gsocketlistener.h index 157c2cd67..82d309acb 100644 --- a/gio/gsocketlistener.h +++ b/gio/gsocketlistener.h @@ -52,6 +52,8 @@ typedef struct _GSocketListenerClass GSocketListenerClass /** * GSocketListenerClass: * @changed: virtual method called when the set of socket listened to changes + * + * Class structure for #GSocketListener. **/ struct _GSocketListenerClass { diff --git a/gio/gsocketservice.h b/gio/gsocketservice.h index ec391d1bc..a30b348de 100644 --- a/gio/gsocketservice.h +++ b/gio/gsocketservice.h @@ -49,6 +49,8 @@ typedef struct _GSocketServiceClass GSocketServiceClass; /** * GSocketServiceClass: * @incomming: signal emitted when new connections are accepted + * + * Class structure for #GSocketService. */ struct _GSocketServiceClass { diff --git a/gio/gtcpwrapperconnection.c b/gio/gtcpwrapperconnection.c index 3bdecf1f7..18eae3dd0 100644 --- a/gio/gtcpwrapperconnection.c +++ b/gio/gtcpwrapperconnection.c @@ -35,6 +35,13 @@ * Since: 2.28 */ +/** + * GTcpWrapperConnection: + * + * #GTcpWrapperConnection is an opaque data structure and can only be accessed + * using the following functions. + **/ + #include "config.h" #include "gtcpwrapperconnection.h" diff --git a/gio/gtlsbackend.c b/gio/gtlsbackend.c index aa46e3a3c..a2073eeb5 100644 --- a/gio/gtlsbackend.c +++ b/gio/gtlsbackend.c @@ -60,6 +60,10 @@ * @title: GTlsBackend * @short_description: TLS backend implementation * @include: gio/gio.h + * + * TLS (Transport Layer Security, aka SSL) backend + * + * Since: 2.28 */ /** diff --git a/gio/gtlscertificate.c b/gio/gtlscertificate.c index 81e072f57..b3d0c2c97 100644 --- a/gio/gtlscertificate.c +++ b/gio/gtlscertificate.c @@ -524,7 +524,6 @@ g_tls_certificate_new_from_file (const gchar *file, /** * g_tls_certificate_new_from_files: - * @cert_file: file containing one or more PEM-encoded certificates to * import * @key_file: file containing a PEM-encoded private key to import diff --git a/gio/gtlsclientconnection.h b/gio/gtlsclientconnection.h index b711a47ed..23e90f5fd 100644 --- a/gio/gtlsclientconnection.h +++ b/gio/gtlsclientconnection.h @@ -34,6 +34,14 @@ G_BEGIN_DECLS typedef struct _GTlsClientConnectionInterface GTlsClientConnectionInterface; +/** + * GTlsClientConnectionInterface: + * @g_iface: The parent interface. + * + * vtable for a #GTlsClientConnection implementation. + * + * Since: 2.26 + */ struct _GTlsClientConnectionInterface { GTypeInterface g_iface; diff --git a/gio/gtlspassword.h b/gio/gtlspassword.h index 61b3a29a7..1b5786839 100644 --- a/gio/gtlspassword.h +++ b/gio/gtlspassword.h @@ -46,6 +46,15 @@ struct _GTlsPassword GTlsPasswordPrivate *priv; }; +/** + * GTlsPasswordClass: + * @get_value: virtual method for g_tls_password_get_value() + * @set_value: virtual method for g_tls_password_set_value() + * @get_default_warning: virtual method for g_tls_password_get_warning() if no + * value has been set using g_tls_password_set_warning() + * + * Class structure for #GTlsPassword. + */ struct _GTlsPasswordClass { GObjectClass parent_class; diff --git a/gio/gtlsserverconnection.h b/gio/gtlsserverconnection.h index a0051cca5..ad61e30fc 100644 --- a/gio/gtlsserverconnection.h +++ b/gio/gtlsserverconnection.h @@ -42,6 +42,14 @@ G_BEGIN_DECLS */ typedef struct _GTlsServerConnectionInterface GTlsServerConnectionInterface; +/** + * GTlsServerConnectionInterface: + * @g_iface: The parent interface. + * + * vtable for a #GTlsServerConnection implementation. + * + * Since: 2.26 + */ struct _GTlsServerConnectionInterface { GTypeInterface g_iface; diff --git a/gio/gunixconnection.c b/gio/gunixconnection.c index b5da60a4e..3bfbd4ff2 100644 --- a/gio/gunixconnection.c +++ b/gio/gunixconnection.c @@ -46,6 +46,13 @@ * Since: 2.22 */ +/** + * GUnixConnection: + * + * #GUnixConnection is an opaque data structure and can only be accessed + * using the following functions. + **/ + G_DEFINE_TYPE_WITH_CODE (GUnixConnection, g_unix_connection, G_TYPE_SOCKET_CONNECTION, g_socket_connection_factory_register_type (g_define_type_id, diff --git a/gio/gunixfdlist.c b/gio/gunixfdlist.c index 5808e40cd..de4e772ce 100644 --- a/gio/gunixfdlist.c +++ b/gio/gunixfdlist.c @@ -31,6 +31,13 @@ * file when using it. */ +/** + * GUnixFDList: + * + * #GUnixFDList is an opaque data structure and can only be accessed + * using the following functions. + **/ + #include "config.h" #include diff --git a/gio/gunixfdmessage.c b/gio/gunixfdmessage.c index 12e62c53f..523d7296b 100644 --- a/gio/gunixfdmessage.c +++ b/gio/gunixfdmessage.c @@ -34,6 +34,13 @@ * file when using it. */ +/** + * GUnixFDMessage: + * + * #GUnixFDMessage is an opaque data structure and can only be accessed + * using the following functions. + **/ + #include "config.h" #include diff --git a/gio/gwin32mount.c b/gio/gwin32mount.c index 58986a1ac..5ae80c85c 100644 --- a/gio/gwin32mount.c +++ b/gio/gwin32mount.c @@ -117,7 +117,7 @@ _win32_get_displayname (const char *drive) return name ? name : g_strdup (drive); } -/** +/* * _g_win32_mount_new: * @volume_monitor: a #GVolumeMonitor. * @path: a win32 path. diff --git a/gio/kqueue/kqueue-exclusions.c b/gio/kqueue/kqueue-exclusions.c index 6be0e739a..748d7a92a 100644 --- a/gio/kqueue/kqueue-exclusions.c +++ b/gio/kqueue/kqueue-exclusions.c @@ -29,7 +29,7 @@ static gboolean ke_debug_enabled = FALSE; #define KE_W if (ke_debug_enabled) g_warning -/** +/* * _ke_is_excluded: * @full_path - a path to file to check. * diff --git a/gio/kqueue/kqueue-helper.c b/gio/kqueue/kqueue-helper.c index 1a95b8322..2bf9af56d 100644 --- a/gio/kqueue/kqueue-helper.c +++ b/gio/kqueue/kqueue-helper.c @@ -428,7 +428,7 @@ process_kqueue_notifications (GIOChannel *gioc, } -/** +/* * _kh_startup_impl: * @unused: unused * @@ -479,7 +479,7 @@ _kh_startup_impl (gpointer unused) } -/** +/* * _kh_startup: * Kqueue backend initialization. * diff --git a/gio/win32/gwinhttpfile.c b/gio/win32/gwinhttpfile.c index a9fa5ab2f..160168d2f 100644 --- a/gio/win32/gwinhttpfile.c +++ b/gio/win32/gwinhttpfile.c @@ -75,7 +75,7 @@ g_winhttp_file_init (GWinHttpFile *winhttp) { } -/** +/* * _g_winhttp_file_new: * @vfs: GWinHttpVfs to use * @uri: URI of the GWinHttpFile to create. diff --git a/gio/win32/gwinhttpfileinputstream.c b/gio/win32/gwinhttpfileinputstream.c index 909300e56..484294888 100644 --- a/gio/win32/gwinhttpfileinputstream.c +++ b/gio/win32/gwinhttpfileinputstream.c @@ -92,7 +92,7 @@ g_winhttp_file_input_stream_init (GWinHttpFileInputStream *info) { } -/** +/* * g_winhttp_file_input_stream_new: * @file: the GWinHttpFile being read * @connection: handle to the HTTP connection, as from WinHttpConnect() diff --git a/gio/win32/gwinhttpfileoutputstream.c b/gio/win32/gwinhttpfileoutputstream.c index 760a87a1c..d596a6844 100644 --- a/gio/win32/gwinhttpfileoutputstream.c +++ b/gio/win32/gwinhttpfileoutputstream.c @@ -81,7 +81,7 @@ g_winhttp_file_output_stream_init (GWinHttpFileOutputStream *info) { } -/** +/* * g_winhttp_file_output_stream_new: * @file: the GWinHttpFile being read * @connection: handle to the HTTP connection, as from WinHttpConnect()