diff options
author | Aaron Jacobs <atheriel@gmail.com> | 2021-12-05 09:39:27 -0500 |
---|---|---|
committer | António Fernandes <antoniof@gnome.org> | 2022-07-30 21:42:40 +0000 |
commit | 1bce7457c24a4c39e8be440d5140b7a42a5280bf (patch) | |
tree | 4c4f061064281fc921e2406ae1202f0a7b2e3956 | |
parent | 3e752a7b3676b82f1b7a0f138a186264d2e49cda (diff) | |
download | nautilus-1bce7457c24a4c39e8be440d5140b7a42a5280bf.tar.gz |
extension: Add docstrings for all remaining public functions
Most of these are pretty sparse but could be expanded on as needed.
-rw-r--r-- | libnautilus-extension/nautilus-file-info.h | 81 | ||||
-rw-r--r-- | libnautilus-extension/nautilus-info-provider.h | 24 |
2 files changed, 105 insertions, 0 deletions
diff --git a/libnautilus-extension/nautilus-file-info.h b/libnautilus-extension/nautilus-file-info.h index 04fc6a157..1fe71b586 100644 --- a/libnautilus-extension/nautilus-file-info.h +++ b/libnautilus-extension/nautilus-file-info.h @@ -149,6 +149,12 @@ void nautilus_file_info_list_free (GList *fil gboolean nautilus_file_info_is_gone (NautilusFileInfo *file_info); /* Name and Location */ +/** + * nautilus_file_info_get_file_type: + * @file_info: a #NautilusFileInfo + * + * Returns: a #GFileType for the location of @file_info + */ GFileType nautilus_file_info_get_file_type (NautilusFileInfo *file_info); /** * nautilus_file_info_get_location: @@ -157,8 +163,27 @@ GFileType nautilus_file_info_get_file_type (NautilusFileInfo *fil * Returns: (transfer full): a #GFile for the location of @file_info */ GFile *nautilus_file_info_get_location (NautilusFileInfo *file_info); +/** + * nautilus_file_info_get_name: + * @file_info: a #NautilusFileInfo + * + * Returns: the file name of @file_info + */ char *nautilus_file_info_get_name (NautilusFileInfo *file_info); +/** + * nautilus_file_info_get_uri: + * @file_info: a #NautilusFileInfo + * + * Returns: the file URI of @file_info + */ char *nautilus_file_info_get_uri (NautilusFileInfo *file_info); +/** + * nautilus_file_info_get_activation_uri: + * @file_info: a #NautilusFileInfo + * + * Returns: the activation URI of @file_info, which may differ from the actual + * URI if e.g. the file is a .desktop file or a Nautilus XML link file + */ char *nautilus_file_info_get_activation_uri (NautilusFileInfo *file_info); /** * nautilus_file_info_get_parent_location: @@ -168,6 +193,13 @@ char *nautilus_file_info_get_activation_uri (NautilusFileInfo *fil * or %NULL if @file_info has no parent */ GFile *nautilus_file_info_get_parent_location (NautilusFileInfo *file_info); +/** + * nautilus_file_info_get_parent_uri: + * @file_info: a #NautilusFileInfo + * + * Returns: the URI for the parent location of @file_info, or the empty string + * if it has none + */ char *nautilus_file_info_get_parent_uri (NautilusFileInfo *file_info); /** * nautilus_file_info_get_mount: @@ -177,6 +209,12 @@ char *nautilus_file_info_get_parent_uri (NautilusFileInfo *fil * or %NULL if @file_info has no mount */ GMount *nautilus_file_info_get_mount (NautilusFileInfo *file_info); +/** + * nautilus_file_info_get_uri_scheme: + * @file_info: a #NautilusFileInfo + * + * Returns: the URI scheme of @file_info + */ char *nautilus_file_info_get_uri_scheme (NautilusFileInfo *file_info); /** * nautilus_file_info_get_parent_info: @@ -197,22 +235,65 @@ NautilusFileInfo *nautilus_file_info_get_parent_info (NautilusFileInfo *fil * Returns: (transfer full): the MIME type of @file_info */ char * nautilus_file_info_get_mime_type (NautilusFileInfo *file_info); +/** + * nautilus_file_info_is_mime_type: + * @file_info: a #NautilusFileInfo + * @mime_type: a MIME type + * + * Returns: %TRUE when the MIME type of @file_info matches @mime_type, and + * %FALSE otherwise + */ gboolean nautilus_file_info_is_mime_type (NautilusFileInfo *file_info, const char *mime_type); +/** + * nautilus_file_info_is_directory: + * @file_info: a #NautilusFileInfo + * + * Returns: %TRUE when @file_info is a directory, and %FALSE otherwise + */ gboolean nautilus_file_info_is_directory (NautilusFileInfo *file_info); +/** + * nautilus_file_info_can_write: + * @file_info: a #NautilusFileInfo + * + * Returns: %TRUE when @file_info is writeable, and %FALSE otherwise + */ gboolean nautilus_file_info_can_write (NautilusFileInfo *file_info); /* Modifying the NautilusFileInfo */ +/** + * nautilus_file_info_add_emblem: + * @file_info: a #NautilusFileInfo + * @emblem_name: the name of an emblem + */ void nautilus_file_info_add_emblem (NautilusFileInfo *file_info, const char *emblem_name); +/** + * nautilus_file_info_get_string_attribute: + * @file_info: a #NautilusFileInfo + * @attribute_name: the name of an attribute + * + * Returns: (nullable): the value for the given @attribute_name, or %NULL if + * there is none + */ char *nautilus_file_info_get_string_attribute (NautilusFileInfo *file_info, const char *attribute_name); +/** + * nautilus_file_info_add_string_attribute: + * @file_info: a #NautilusFileInfo + * @attribute_name: the name of an attribute + * @value: the name of an attribute + */ void nautilus_file_info_add_string_attribute (NautilusFileInfo *file_info, const char *attribute_name, const char *value); /* Invalidating file info */ +/** + * nautilus_file_info_invalidate_extension_info: + * @file_info: a #NautilusFileInfo + */ void nautilus_file_info_invalidate_extension_info (NautilusFileInfo *file_info); /** diff --git a/libnautilus-extension/nautilus-info-provider.h b/libnautilus-extension/nautilus-info-provider.h index 1fa8d2194..128a46b63 100644 --- a/libnautilus-extension/nautilus-info-provider.h +++ b/libnautilus-extension/nautilus-info-provider.h @@ -114,16 +114,40 @@ struct _NautilusInfoProviderInterface }; /* Interface Functions */ +/** + * nautilus_info_provider_update_file_info: + * @provider: a #NautilusInfoProvider + * @file: a #NautilusFileInfo + * @update_complete: the closure to invoke at some later time when returning + * @NAUTILUS_OPERATION_IN_PROGRESS. + * @handle: (transfer none) (nullable) (out): an opaque #NautilusOperationHandle + * that must be set when returning @NAUTILUS_OPERATION_IN_PROGRESS. + * + * Returns: A #NautilusOperationResult. + */ NautilusOperationResult nautilus_info_provider_update_file_info (NautilusInfoProvider *provider, NautilusFileInfo *file, GClosure *update_complete, NautilusOperationHandle **handle); +/** + * nautilus_info_provider_cancel_update: + * @provider: a #NautilusInfoProvider + * @handle: the opaque #NautilusOperationHandle returned from a previous call to + * nautilus_info_provider_update_file_info(). + */ void nautilus_info_provider_cancel_update (NautilusInfoProvider *provider, NautilusOperationHandle *handle); /* Helper functions for implementations */ +/** + * nautilus_info_provider_update_complete_invoke: + * @update_complete: a #GClosure + * @provider: a #NautilusInfoProvider + * @handle: an opaque #NautilusOperationHandle + * @result: a #NautilusOperationResult + */ void nautilus_info_provider_update_complete_invoke (GClosure *update_complete, NautilusInfoProvider *provider, NautilusOperationHandle *handle, |