Commit 4ae03613 authored by Ernestas Kulik's avatar Ernestas Kulik 🦑

docs: Reorganize and fix

This commit completes the sections file with subsections, moves most
documentation to headers (no real reason to, especially given that
changes there may cause unwanted rebuilds, but it feels better to have
it in the headers) and fixes some annotations.

Closes #565
parent a21de829
Pipeline #23213 passed with stage
in 4 minutes and 42 seconds
......@@ -19,7 +19,6 @@
<xi:include href="xml/nautilus-column.xml" />
<xi:include href="xml/nautilus-file-info.xml" />
<xi:include href="xml/nautilus-menu.xml" />
<xi:include href="xml/nautilus-menu-item.xml" />
<xi:include href="xml/nautilus-property-page.xml" />
</chapter>
......
......@@ -12,6 +12,15 @@ nautilus_module_list_types
NautilusLocationWidgetProvider
NautilusLocationWidgetProviderInterface
nautilus_location_widget_provider_get_widget
<SUBSECTION Standard>
NAUTILUS_LOCATION_WIDGET_PROVIDER
NAUTILUS_IS_LOCATION_WIDGET_PROVIDER
NAUTILUS_TYPE_LOCATION_WIDGET_PROVIDER
NAUTILUS_LOCATION_WIDGET_PROVIDER_GET_IFACE
<SUBSECTION Private>
nautilus_location_widget_provider_get_type
</SECTION>
<SECTION>
......@@ -21,24 +30,46 @@ NautilusMenuProviderInterface
nautilus_menu_provider_get_file_items
nautilus_menu_provider_get_background_items
nautilus_menu_provider_emit_items_updated_signal
<SUBSECTION Standard>
NAUTILUS_MENU_PROVIDER
NAUTILUS_IS_MENU_PROVIDER
NAUTILUS_TYPE_MENU_PROVIDER
NAUTILUS_PROVIDER_GET_IFACE
<SUBSECTION Private>
nautilus_menu_provider_get_type
</SECTION>
<SECTION>
<FILE>nautilus-menu</FILE>
NautilusMenu
NautilusMenuItem
nautilus_menu_new
nautilus_menu_append_item
nautilus_menu_get_items
</SECTION>
<SECTION>
<FILE>nautilus-menu-item</FILE>
NautilusMenuItem
nautilus_menu_item_list_free
nautilus_menu_item_get_type
nautilus_menu_item_new
nautilus_menu_item_activate
nautilus_menu_item_set_submenu
<SUBSECTION Standard>
NAUTILUS_MENU
NAUTILUS_IS_MENU
NAUTILUS_TYPE_MENU
NAUTILUS_MENU_CLASS
NAUTILUS_IS_MENU_CLASS
NAUTILUS_MENU_GET_CLASS
NAUTILUS_MENU_ITEM
NAUTILUS_IS_MENU_ITEM
NAUTILUS_TYPE_MENU_ITEM
NAUTILUS_MENU_ITEM_CLASS
NAUTILUS_IS_MENU_ITEM_CLASS
NAUTILUS_MENU_ITEM_GET_CLASS
<SUBSECTION Private>
nautilus_menu_get_type
nautilus_menu_item_get_type
</SECTION>
<SECTION>
......@@ -46,6 +77,17 @@ nautilus_menu_item_set_submenu
NautilusColumnProvider
NautilusColumnProviderInterface
nautilus_column_provider_get_columns
<SUBSECTION Standard>
NAUTILUS_COLUMN_PROVIDER
NAUTILUS_IS_COLUMN_PROVIDER
NAUTILUS_TYPE_COLUMN_PROVIDER
NAUTILUS_COLUMN_PROVIDER_CLASS
NAUTILUS_IS_COLUMN_PROVIDER_CLASS
NAUTILUS_COLUMN_PROVIDER_GET_CLASS
<SUBSECTION Private>
nautilus_column_provider_get_type
</SECTION>
<SECTION>
......@@ -53,11 +95,19 @@ nautilus_column_provider_get_columns
NautilusPropertyPageProvider
NautilusPropertyPageProviderInterface
nautilus_property_page_provider_get_pages
<SUBSECTION Standard>
NAUTILUS_PROPERTY_PAGE_PROVIDER
NAUTILUS_IS_PROPERTY_PAGE_PROVIDER
NAUTILUS_TYPE_PROPERTY_PAGE_PROVIDER
NAUTILUS_PROPERTY_PAGE_PROVIDER_GET_IFACE
<SUBSECTION Private>
nautilus_property_page_provider_get_type
</SECTION>
<SECTION>
<FILE>nautilus-file-info</FILE>
NAUTILUS_FILE_DEFINED
NautilusFile
NautilusFileInfo
NautilusFileInfoInterface
......@@ -86,12 +136,32 @@ nautilus_file_info_add_emblem
nautilus_file_info_get_string_attribute
nautilus_file_info_add_string_attribute
nautilus_file_info_invalidate_extension_info
<SUBSECTION Standard>
NAUTILUS_FILE_INFO
NAUTILUS_IS_FILE_INFO
NAUTILUS_TYPE_FILE_INFO
NAUTILUS_FILE_INFO_GET_IFACE
<SUBSECTION Private>
nautilus_file_info_get_type
</SECTION>
<SECTION>
<FILE>nautilus-column</FILE>
NautilusColumn
nautilus_column_new
<SUBSECTION Standard>
NAUTILUS_COLUMN
NAUTILUS_IS_COLUMN
NAUTILUS_TYPE_COLUMN
NAUTILUS_COLUMN_CLASS
NAUTILUS_IS_COLUMN_CLASS
NAUTILUS_COLUMN_GET_CLASS
<SUBSECTION Private>
nautilus_column_get_type
</SECTION>
<SECTION>
......@@ -103,11 +173,31 @@ NautilusOperationResult
nautilus_info_provider_update_file_info
nautilus_info_provider_cancel_update
nautilus_info_provider_update_complete_invoke
<SUBSECTION Standard>
NAUTILUS_INFO_PROVIDER
NAUTILUS_IS_INFO_PROVIDER
NAUTILUS_TYPE_INFO_PROVIDER
NAUTILUS_INFO_PROVIDER_GET_IFACE
<SUBSECTION Private>
nautilus_info_provider_get_type
</SECTION>
<SECTION>
<FILE>nautilus-property-page</FILE>
NautilusPropertyPage
nautilus_property_page_new
<SUBSECTION Standard>
NAUTILUS_PROPERTY_PAGE
NAUTILUS_IS_PROPERTY_PAGE
NAUTILUS_TYPE_PROPERTY_PAGE
NAUTILUS_PROPERTY_PAGE_CLASS
NAUTILUS_IS_PROPERTY_PAGE_CLASS
NAUTILUS_PROPERTY_PAGE_GET_CLASS
<SUBSECTION Private>
nautilus_property_page_get_type
</SECTION>
......@@ -25,26 +25,11 @@
G_DEFINE_INTERFACE (NautilusColumnProvider, nautilus_column_provider, G_TYPE_OBJECT)
/**
* SECTION:nautilus-column-provider
* @title: NautilusColumnProvider
* @short_description: Interface to provide additional list view columns
*
* #NautilusColumnProvider allows extension to provide additional columns
* in the file manager list view.
*/
static void
nautilus_column_provider_default_init (NautilusColumnProviderInterface *klass)
{
}
/**
* nautilus_column_provider_get_columns:
* @provider: a #NautilusColumnProvider
*
* Returns: (element-type NautilusColumn) (transfer full): the provided #NautilusColumn objects
*/
GList *
nautilus_column_provider_get_columns (NautilusColumnProvider *self)
{
......
......@@ -49,11 +49,20 @@ G_DECLARE_INTERFACE (NautilusColumnProvider, nautilus_column_provider,
/* For compatibility reasons, remove this once you start introducing breaking changes. */
typedef NautilusColumnProviderInterface NautilusColumnProviderIface;
/**
* SECTION:nautilus-column-provider
* @title: NautilusColumnProvider
* @short_description: Interface to provide additional list view columns
*
* #NautilusColumnProvider allows extension to provide additional columns
* in the file manager list view.
*/
/**
* NautilusColumnProviderInterface:
* @g_iface: The parent interface.
* @get_columns: Returns a #GList of #NautilusColumn.
* See nautilus_column_provider_get_columns() for details.
* See nautilus_column_provider_get_columns() for details.
*
* Interface for extensions to provide additional list view columns.
*/
......@@ -64,7 +73,12 @@ struct _NautilusColumnProviderInterface
GList *(*get_columns) (NautilusColumnProvider *provider);
};
/* Interface Functions */
/**
* nautilus_column_provider_get_columns:
* @provider: a #NautilusColumnProvider
*
* Returns: (element-type NautilusColumn) (transfer full): the provided #NautilusColumn objects
*/
GList *nautilus_column_provider_get_columns (NautilusColumnProvider *provider);
G_END_DECLS
\ No newline at end of file
G_END_DECLS
......@@ -51,29 +51,6 @@ struct _NautilusColumn
G_DEFINE_TYPE (NautilusColumn, nautilus_column, G_TYPE_OBJECT);
/**
* SECTION:nautilus-column
* @title: NautilusColumn
* @short_description: List view column descriptor object
*
* #NautilusColumn is an object that describes a column in the file manager
* list view. Extensions can provide #NautilusColumn by registering a
* #NautilusColumnProvider and returning them from
* nautilus_column_provider_get_columns(), which will be called by the main
* application when creating a view.
*/
/**
* nautilus_column_new:
* @name: identifier of the column
* @attribute: the file attribute to be displayed in the column
* @label: the user-visible label for the column
* @description: a user-visible description of the column
*
* Creates a new column
*
* Returns: a newly created #NautilusColumn
*/
NautilusColumn *
nautilus_column_new (const char *name,
const char *attribute,
......
......@@ -37,6 +37,27 @@ G_BEGIN_DECLS
G_DECLARE_FINAL_TYPE (NautilusColumn, nautilus_column, NAUTILUS, COLUMN, GObject)
/**
* SECTION:nautilus-column
* @title: NautilusColumn
* @short_description: List view column descriptor object
*
* #NautilusColumn is an object that describes a column in the file manager
* list view. Extensions can provide #NautilusColumn by registering a
* #NautilusColumnProvider and returning them from
* nautilus_column_provider_get_columns(), which will be called by the main
* application when creating a view.
*/
/**
* nautilus_column_new:
* @name: (not nullable): identifier of the column
* @attribute: (not nullable): the file attribute to be displayed in the column
* @label: (not nullable): the user-visible label for the column
* @description: (not nullable): a user-visible description of the column
*
* Returns: (transfer full): a new #NautilusColumn
*/
NautilusColumn *nautilus_column_new (const char *name,
const char *attribute,
const char *label,
......
......@@ -34,9 +34,29 @@
* @title: Extension entry points
*/
/**
* nautilus_module_initialize:
* @module: a #GTypeModule used in type registration
*
* Called when the extension is begin loaded to register the types it exports
* and to perform other initializations.
*/
void nautilus_module_initialize (GTypeModule *module);
/**
* nautilus_module_shutdown:
*
* Called when the extension is being unloaded.
*/
void nautilus_module_shutdown (void);
/**
* nautilus_module_list_types:
* @types: (out) (array length=num_types): array of GType *
* @num_types: the number of types in the array
*
* Called after the extension has been initialized and has registered all the
* types it exports, to load them into Nautilus.
*/
void nautilus_module_list_types (const GType **types,
int *num_types);
#endif
\ No newline at end of file
#endif
......@@ -26,22 +26,6 @@ G_DEFINE_INTERFACE (NautilusFileInfo, nautilus_file_info, G_TYPE_OBJECT)
NautilusFileInfo * (*nautilus_file_info_getter)(GFile * location, gboolean create);
/**
* SECTION:nautilus-file-info
* @title: NautilusFileInfo
* @short_description: File interface for nautilus extensions
*
* #NautilusFileInfo provides methods to get and modify information
* about file objects in the file manager.
*/
/**
* nautilus_file_info_list_copy:
* @files: (element-type NautilusFileInfo): the files to copy
*
* Returns: (element-type NautilusFileInfo) (transfer full): a copy of @files.
* Use #nautilus_file_info_list_free to free the list and unref its contents.
*/
GList *
nautilus_file_info_list_copy (GList *files)
{
......@@ -57,12 +41,6 @@ nautilus_file_info_list_copy (GList *files)
return ret;
}
/**
* nautilus_file_info_list_free:
* @files: (element-type NautilusFileInfo): a list created with
* #nautilus_file_info_list_copy
*
*/
void
nautilus_file_info_list_free (GList *files)
{
......@@ -123,12 +101,6 @@ nautilus_file_info_get_name (NautilusFileInfo *self)
return iface->get_name (self);
}
/**
* nautilus_file_info_get_location:
* @file_info: a #NautilusFileInfo
*
* Returns: (transfer full): a #GFile for the location of @file_info
*/
GFile *
nautilus_file_info_get_location (NautilusFileInfo *self)
{
......@@ -170,13 +142,6 @@ nautilus_file_info_get_activation_uri (NautilusFileInfo *self)
return iface->get_activation_uri (self);
}
/**
* nautilus_file_info_get_parent_location:
* @file_info: a #NautilusFileInfo
*
* Returns: (allow-none) (transfer full): a #GFile for the parent location of @file_info,
* or %NULL if @file_info has no parent
*/
GFile *
nautilus_file_info_get_parent_location (NautilusFileInfo *self)
{
......@@ -205,13 +170,6 @@ nautilus_file_info_get_parent_uri (NautilusFileInfo *self)
return iface->get_parent_uri (self);
}
/**
* nautilus_file_info_get_parent_info:
* @file_info: a #NautilusFileInfo
*
* Returns: (allow-none) (transfer full): a #NautilusFileInfo for the parent of @file_info,
* or %NULL if @file_info has no parent
*/
NautilusFileInfo *
nautilus_file_info_get_parent_info (NautilusFileInfo *self)
{
......@@ -226,13 +184,6 @@ nautilus_file_info_get_parent_info (NautilusFileInfo *self)
return iface->get_parent_info (self);
}
/**
* nautilus_file_info_get_mount:
* @file_info: a #NautilusFileInfo
*
* Returns: (allow-none) (transfer full): a #GMount for the mount of @file_info,
* or %NULL if @file_info has no mount
*/
GMount *
nautilus_file_info_get_mount (NautilusFileInfo *self)
{
......@@ -382,12 +333,6 @@ nautilus_file_info_invalidate_extension_info (NautilusFileInfo *self)
iface->invalidate_extension_info (self);
}
/**
* nautilus_file_info_lookup:
* @location: the location to lookup the file info for
*
* Returns: (transfer full): a #NautilusFileInfo
*/
NautilusFileInfo *
nautilus_file_info_lookup (GFile *location)
{
......@@ -396,12 +341,6 @@ nautilus_file_info_lookup (GFile *location)
return nautilus_file_info_getter (location, FALSE);
}
/**
* nautilus_file_info_create:
* @location: the location to create the file info for
*
* Returns: (transfer full): a #NautilusFileInfo
*/
NautilusFileInfo *
nautilus_file_info_create (GFile *location)
{
......@@ -410,12 +349,6 @@ nautilus_file_info_create (GFile *location)
return nautilus_file_info_getter (location, TRUE);
}
/**
* nautilus_file_info_lookup_for_uri:
* @uri: the URI to lookup the file info for
*
* Returns: (transfer full): a #NautilusFileInfo
*/
NautilusFileInfo *
nautilus_file_info_lookup_for_uri (const char *uri)
{
......@@ -428,12 +361,6 @@ nautilus_file_info_lookup_for_uri (const char *uri)
return nautilus_file_info_lookup (location);
}
/**
* nautilus_file_info_create_for_uri:
* @uri: the URI to lookup the file info for
*
* Returns: (transfer full): a #NautilusFileInfo
*/
NautilusFileInfo *
nautilus_file_info_create_for_uri (const char *uri)
{
......
......@@ -45,47 +45,56 @@ G_DECLARE_INTERFACE (NautilusFileInfo, nautilus_file_info, NAUTILUS, FILE_INFO,
*/
typedef struct NautilusFile NautilusFile;
/**
* SECTION:nautilus-file-info
* @title: NautilusFileInfo
* @short_description: File interface for nautilus extensions
*
* #NautilusFileInfo provides methods to get and modify information
* about file objects in the file manager.
*/
/**
* NautilusFileInfoInterface:
* @g_iface: The parent interface.
* @is_gone: Returns whether the file info is gone.
* See nautilus_file_info_is_gone() for details.
* See nautilus_file_info_is_gone() for details.
* @get_name: Returns the file name as a string.
* See nautilus_file_info_get_name() for details.
* See nautilus_file_info_get_name() for details.
* @get_uri: Returns the file URI as a string.
* See nautilus_file_info_get_uri() for details.
* See nautilus_file_info_get_uri() for details.
* @get_parent_uri: Returns the file parent URI as a string.
* See nautilus_file_info_get_parent_uri() for details.
* See nautilus_file_info_get_parent_uri() for details.
* @get_uri_scheme: Returns the file URI scheme as a string.
* See nautilus_file_info_get_uri_scheme() for details.
* See nautilus_file_info_get_uri_scheme() for details.
* @get_mime_type: Returns the file mime type as a string.
* See nautilus_file_info_get_mime_type() for details.
* See nautilus_file_info_get_mime_type() for details.
* @is_mime_type: Returns whether the file is the given mime type.
* See nautilus_file_info_is_mime_type() for details.
* See nautilus_file_info_is_mime_type() for details.
* @is_directory: Returns whether the file is a directory.
* See nautilus_file_info_is_directory() for details.
* See nautilus_file_info_is_directory() for details.
* @add_emblem: Adds an emblem to this file.
* See nautilus_file_info_add_emblem() for details.
* See nautilus_file_info_add_emblem() for details.
* @get_string_attribute: Returns the specified file attribute as a string.
* See nautilus_file_info_get_string_attribute() for details.
* See nautilus_file_info_get_string_attribute() for details.
* @add_string_attribute: Sets the specified string file attribute value.
* See nautilus_file_info_add_string_attribute() for details.
* See nautilus_file_info_add_string_attribute() for details.
* @invalidate_extension_info: Invalidates information of the file provided by extensions.
* See nautilus_file_info_invalidate_extension_info() for details.
* See nautilus_file_info_invalidate_extension_info() for details.
* @get_activation_uri: Returns the file activation URI as a string.
* See nautilus_file_info_get_activation_uri() for details.
* See nautilus_file_info_get_activation_uri() for details.
* @get_file_type: Returns the file type.
* See nautilus_file_info_get_file_type() for details.
* See nautilus_file_info_get_file_type() for details.
* @get_location: Returns the file location as a #GFile.
* See nautilus_file_info_get_location() for details.
* See nautilus_file_info_get_location() for details.
* @get_parent_location: Returns the file parent location as a #GFile.
* See nautilus_file_info_get_parent_location() for details.
* See nautilus_file_info_get_parent_location() for details.
* @get_parent_info: Returns the file parent #NautilusFileInfo.
* See nautilus_file_info_get_parent_info() for details.
* See nautilus_file_info_get_parent_info() for details.
* @get_mount: Returns the file mount as a #GMount.
* See nautilus_file_info_get_mount() for details.
* See nautilus_file_info_get_mount() for details.
* @can_write: Returns whether the file is writable.
* See nautilus_file_info_can_write() for details.
* See nautilus_file_info_can_write() for details.
*
* Interface for extensions to provide additional menu items.
*/
......@@ -124,28 +133,77 @@ struct _NautilusFileInfoInterface
gboolean (*can_write) (NautilusFileInfo *file_info);
};
/**
* nautilus_file_info_list_copy:
* @files: (element-type NautilusFileInfo): the files to copy
*
* Returns: (element-type NautilusFileInfo) (transfer full): a copy of @files.
* Use #nautilus_file_info_list_free to free the list and unref its contents.
*/
GList *nautilus_file_info_list_copy (GList *files);
/**
* nautilus_file_info_list_free:
* @files: (element-type NautilusFileInfo): a list created with #nautilus_file_info_list_copy
*
*/
void nautilus_file_info_list_free (GList *files);
/* Return true if the file has been deleted */
/**
* nautilus_file_info_is_gone:
* @file_info: a #NautilusFileInfo
*
* Returns: whether the file has been deleted
*/
gboolean nautilus_file_info_is_gone (NautilusFileInfo *file_info);
/* Name and Location */
GFileType nautilus_file_info_get_file_type (NautilusFileInfo *file_info);
/**
* nautilus_file_info_get_location:
* @file_info: a #NautilusFileInfo
*
* Returns: (transfer full): a #GFile for the location of @file_info
*/
GFile *nautilus_file_info_get_location (NautilusFileInfo *file_info);
char *nautilus_file_info_get_name (NautilusFileInfo *file_info);
char *nautilus_file_info_get_uri (NautilusFileInfo *file_info);
char *nautilus_file_info_get_activation_uri (NautilusFileInfo *file_info);
/**
* nautilus_file_info_get_parent_location:
* @file_info: a #NautilusFileInfo
*
* Returns: (allow-none) (transfer full): a #GFile for the parent location of @file_info,
* or %NULL if @file_info has no parent
*/
GFile *nautilus_file_info_get_parent_location (NautilusFileInfo *file_info);
char *nautilus_file_info_get_parent_uri (NautilusFileInfo *file_info);
/**
* nautilus_file_info_get_mount:
* @file_info: a #NautilusFileInfo
*
* Returns: (nullable) (transfer full): a #GMount for the mount of @file_info,
* or %NULL if @file_info has no mount
*/
GMount *nautilus_file_info_get_mount (NautilusFileInfo *file_info);
char *nautilus_file_info_get_uri_scheme (NautilusFileInfo *file_info);
/* It's not safe to call this recursively multiple times, as it works
/**
* nautilus_file_info_get_parent_info:
* @file_info: a #NautilusFileInfo
*
* It's not safe to call this recursively multiple times, as it works
* only for files already cached by Nautilus.
*
* Returns: (nullable) (transfer full): a #NautilusFileInfo for the parent of @file_info,
* or %NULL if @file_info has no parent.
*/
NautilusFileInfo *nautilus_file_info_get_parent_info (NautilusFileInfo *file_info);
/* File Type */
/**
* nautilus_file_info_get_parent_info:
* @file_info: a #NautilusFileInfo
*
* Returns: (transfer full): the MIME type of @file_info
*/
char * nautilus_file_info_get_mime_type (NautilusFileInfo *file_info);
gboolean nautilus_file_info_is_mime_type (NautilusFileInfo *file_info,
const char *mime_type);
......@@ -165,9 +223,33 @@ void nautilus_file_info_add_string_attribute (NautilusFileInfo *fil
/* Invalidating file info */
void nautilus_file_info_invalidate_extension_info (NautilusFileInfo *file_info);
/**
* nautilus_file_info_lookup:
* @location: the location for which to look up a corresponding #NautilusFileInfo object
*
* Returns: (transfer full): a #NautilusFileInfo
*/
NautilusFileInfo *nautilus_file_info_lookup (GFile *location);
/**
* nautilus_file_info_create:
* @location: the location to create the file info for
*
* Returns: (transfer full): a #NautilusFileInfo
*/
NautilusFileInfo *nautilus_file_info_create (GFile *location);
/**
* nautilus_file_info_lookup_for_uri:
* @uri: the URI to lookup the file info for
*
* Returns: (transfer full): a #NautilusFileInfo
*/
NautilusFileInfo *nautilus_file_info_lookup_for_uri (const char *uri);
/**
* nautilus_file_info_create_for_uri:
* @uri: the URI to lookup the file info for
*
* Returns: (transfer full): a #NautilusFileInfo
*/
NautilusFileInfo *nautilus_file_info_create_for_uri (const char *uri);
G_END_DECLS
\ No newline at end of file
G_END_DECLS
......@@ -27,17 +27,6 @@
G_DEFINE_INTERFACE (NautilusInfoProvider, nautilus_info_provider, G_TYPE_OBJECT)
/**
* SECTION:nautilus-info-provider
* @title: NautilusInfoProvider
* @short_description: Interface to provide additional information about files
*
* #NautilusInfoProvider allows extension to provide additional information about
* files. When nautilus_info_provider_update_file_info() is called by the application,
* extensions will know that it's time to add extra information to the provided
* #NautilusFileInfo.
*/
static void
nautilus_info_provider_default_init (NautilusInfoProviderInterface *klass)
{
......
......@@ -48,6 +48,17 @@ G_DECLARE_INTERFACE (NautilusInfoProvider, nautilus_info_provider,
/* For compatibility reasons, remove this once you start introducing breaking changes. */
typedef NautilusInfoProviderInterface NautilusInfoProviderIface;
/**
* SECTION:nautilus-info-provider
* @title: NautilusInfoProvider
* @short_description: Interface to provide additional information about files
*
* #NautilusInfoProvider allows extension to provide additional information about
* files. When nautilus_info_provider_update_file_info() is called by the application,
* extensions will know that it's time to add extra information to the provided
* #NautilusFileInfo.
*/
/**
* NautilusOperationHandle:
*
......@@ -89,9 +100,9 @@ typedef enum
* NautilusInfoProviderInterface:
* @g_iface: The parent interface.
* @update_file_info: Returns a #NautilusOperationResult.
* See nautilus_info_provider_update_file_info() for details.
* See nautilus_info_provider_update_file_info() for details.
* @cancel_update: Cancels a previous call to nautilus_info_provider_update_file_info().
* See nautilus_info_provider_cancel_update() for details.
* See nautilus_info_provider_cancel_update() for details.
*
* Interface for extensions to provide additional information about files.
*/
......@@ -123,4 +134,4 @@ void nautilus_info_provider_update_complete_invoke (GClosure
NautilusOperationHandle *handle,
NautilusOperationResult result);
G_END_DECLS
\ No newline at end of file
G_END_DECLS
......@@ -26,28 +26,11 @@
G_DEFINE_INTERFACE (NautilusLocationWidgetProvider, nautilus_location_widget_provider,
G_TYPE_OBJECT)
/**
* SECTION:nautilus-location-widget-provider
* @title: NautilusLocationWidgetProvider
* @short_description: Interface to provide additional location widgets
*
* #NautilusLocationWidgetProvider allows extension to provide additional location
* widgets in the file manager views.
*/
static void