Commit 246c0cbb authored by Corentin Noël's avatar Corentin Noël

Prepare source files to documentation

parent 890a5f82
...@@ -118,7 +118,7 @@ tracker_data_provider_begin (TrackerDataProvider *data_provider, ...@@ -118,7 +118,7 @@ tracker_data_provider_begin (TrackerDataProvider *data_provider,
* @url: a #GFile to enumerate * @url: a #GFile to enumerate
* @attributes: an attribute query string * @attributes: an attribute query string
* @flags: a set of #TrackerDirectoryFlags * @flags: a set of #TrackerDirectoryFlags
* @io_priority: the [I/O priority][io-priority] of the request * @io_priority: the I/O priority of the request (example: %G_PRIORITY_DEFAULT)
* @cancellable: (allow-none): optional #GCancellable object, %NULL to * @cancellable: (allow-none): optional #GCancellable object, %NULL to
* ignore * ignore
* @callback: (scope async): a #GAsyncReadyCallback to call when the * @callback: (scope async): a #GAsyncReadyCallback to call when the
......
...@@ -55,13 +55,6 @@ typedef struct _TrackerDataProviderIface TrackerDataProviderIface; ...@@ -55,13 +55,6 @@ typedef struct _TrackerDataProviderIface TrackerDataProviderIface;
* using @begin_finish. * using @begin_finish.
* @begin_finish: Called when the data_provider is completing the * @begin_finish: Called when the data_provider is completing the
* asynchronous operation provided by @begin_async. * asynchronous operation provided by @begin_async.
* @end: Called when the data_provider is synchronously
* closing and cleaning up the iteration of a given location.
* @end_async: Called when the data_provider is asynchronously
* closing and cleaning up the iteration of a given location.
* Completed using @end_finish.
* @end_finish: Called when the data_provider is completing the
* asynchronous operation provided by @end_async.
* *
* Virtual methods left to implement. * Virtual methods left to implement.
**/ **/
......
...@@ -132,7 +132,7 @@ static void notifier_events_cb (TrackerDecorator *decorator, ...@@ -132,7 +132,7 @@ static void notifier_events_cb (TrackerDecorator *decorator,
* *
* Returns: the #GQuark used for the domain of a #GError. * Returns: the #GQuark used for the domain of a #GError.
* *
* Since: 0.18. * Since: 0.18
**/ **/
G_DEFINE_QUARK (TrackerDecoratorError, tracker_decorator_error) G_DEFINE_QUARK (TrackerDecoratorError, tracker_decorator_error)
...@@ -175,7 +175,7 @@ tracker_decorator_info_new (TrackerDecorator *decorator, ...@@ -175,7 +175,7 @@ tracker_decorator_info_new (TrackerDecorator *decorator,
* *
* Returns: the same @info passed in, or %NULL on error. * Returns: the same @info passed in, or %NULL on error.
* *
* Since: 0.18. * Since: 0.18
**/ **/
TrackerDecoratorInfo * TrackerDecoratorInfo *
tracker_decorator_info_ref (TrackerDecoratorInfo *info) tracker_decorator_info_ref (TrackerDecoratorInfo *info)
...@@ -191,7 +191,7 @@ tracker_decorator_info_ref (TrackerDecoratorInfo *info) ...@@ -191,7 +191,7 @@ tracker_decorator_info_ref (TrackerDecoratorInfo *info)
* Decreases the reference count of @info by 1 and frees it when the * Decreases the reference count of @info by 1 and frees it when the
* reference count reaches 0. * reference count reaches 0.
* *
* Since: 0.18. * Since: 0.18
**/ **/
void void
tracker_decorator_info_unref (TrackerDecoratorInfo *info) tracker_decorator_info_unref (TrackerDecoratorInfo *info)
...@@ -1259,7 +1259,7 @@ tracker_decorator_class_init (TrackerDecoratorClass *klass) ...@@ -1259,7 +1259,7 @@ tracker_decorator_class_init (TrackerDecoratorClass *klass)
* #TrackerDecorator sees resources that are available for * #TrackerDecorator sees resources that are available for
* extended metadata extraction. * extended metadata extraction.
* *
* Since: 0.18. * Since: 0.18
**/ **/
signals[ITEMS_AVAILABLE] = signals[ITEMS_AVAILABLE] =
g_signal_new ("items-available", g_signal_new ("items-available",
...@@ -1277,7 +1277,7 @@ tracker_decorator_class_init (TrackerDecoratorClass *klass) ...@@ -1277,7 +1277,7 @@ tracker_decorator_class_init (TrackerDecoratorClass *klass)
* #TrackerDecorator has finished extracted extended metadata * #TrackerDecorator has finished extracted extended metadata
* for resources in the database. * for resources in the database.
* *
* Since: 0.18. * Since: 0.18
**/ **/
signals[FINISHED] = signals[FINISHED] =
g_signal_new ("finished", g_signal_new ("finished",
...@@ -1323,7 +1323,7 @@ tracker_decorator_init (TrackerDecorator *decorator) ...@@ -1323,7 +1323,7 @@ tracker_decorator_init (TrackerDecorator *decorator)
* *
* Returns: a const gchar* or #NULL if an error happened. * Returns: a const gchar* or #NULL if an error happened.
* *
* Since: 0.18. * Since: 0.18
**/ **/
const gchar * const gchar *
tracker_decorator_get_data_source (TrackerDecorator *decorator) tracker_decorator_get_data_source (TrackerDecorator *decorator)
...@@ -1345,7 +1345,7 @@ tracker_decorator_get_data_source (TrackerDecorator *decorator) ...@@ -1345,7 +1345,7 @@ tracker_decorator_get_data_source (TrackerDecorator *decorator)
* *
* Returns: (transfer none): a const gchar** or #NULL. * Returns: (transfer none): a const gchar** or #NULL.
* *
* Since: 0.18. * Since: 0.18
**/ **/
const gchar ** const gchar **
tracker_decorator_get_class_names (TrackerDecorator *decorator) tracker_decorator_get_class_names (TrackerDecorator *decorator)
...@@ -1369,7 +1369,7 @@ tracker_decorator_get_class_names (TrackerDecorator *decorator) ...@@ -1369,7 +1369,7 @@ tracker_decorator_get_class_names (TrackerDecorator *decorator)
* *
* Returns: the number of items queued to be processed, always >= 0. * Returns: the number of items queued to be processed, always >= 0.
* *
* Since: 0.18. * Since: 0.18
**/ **/
guint guint
tracker_decorator_get_n_items (TrackerDecorator *decorator) tracker_decorator_get_n_items (TrackerDecorator *decorator)
...@@ -1393,7 +1393,7 @@ tracker_decorator_get_n_items (TrackerDecorator *decorator) ...@@ -1393,7 +1393,7 @@ tracker_decorator_get_n_items (TrackerDecorator *decorator)
* @id is the same IDs emitted by tracker-store when the database is updated for * @id is the same IDs emitted by tracker-store when the database is updated for
* consistency. For details, see the GraphUpdated signal. * consistency. For details, see the GraphUpdated signal.
* *
* Since: 0.18. * Since: 0.18
**/ **/
void void
tracker_decorator_prepend_id (TrackerDecorator *decorator, tracker_decorator_prepend_id (TrackerDecorator *decorator,
...@@ -1420,7 +1420,7 @@ tracker_decorator_prepend_id (TrackerDecorator *decorator, ...@@ -1420,7 +1420,7 @@ tracker_decorator_prepend_id (TrackerDecorator *decorator,
* queue. @id is the same IDs emitted by tracker-store when the database is * queue. @id is the same IDs emitted by tracker-store when the database is
* updated for consistency. For details, see the GraphUpdated signal. * updated for consistency. For details, see the GraphUpdated signal.
* *
* Since: 0.18. * Since: 0.18
**/ **/
void void
tracker_decorator_delete_id (TrackerDecorator *decorator, tracker_decorator_delete_id (TrackerDecorator *decorator,
...@@ -1458,7 +1458,7 @@ tracker_decorator_delete_id (TrackerDecorator *decorator, ...@@ -1458,7 +1458,7 @@ tracker_decorator_delete_id (TrackerDecorator *decorator,
* This function will give a #GError if the miner is paused at the * This function will give a #GError if the miner is paused at the
* time it is called. * time it is called.
* *
* Since: 0.18. * Since: 0.18
**/ **/
void void
tracker_decorator_next (TrackerDecorator *decorator, tracker_decorator_next (TrackerDecorator *decorator,
...@@ -1503,7 +1503,7 @@ tracker_decorator_next (TrackerDecorator *decorator, ...@@ -1503,7 +1503,7 @@ tracker_decorator_next (TrackerDecorator *decorator,
* Returns: (transfer full): a #TrackerDecoratorInfo on success or * Returns: (transfer full): a #TrackerDecoratorInfo on success or
* #NULL on error. Free with tracker_decorator_info_unref(). * #NULL on error. Free with tracker_decorator_info_unref().
* *
* Since: 0.18. * Since: 0.18
**/ **/
TrackerDecoratorInfo * TrackerDecoratorInfo *
tracker_decorator_next_finish (TrackerDecorator *decorator, tracker_decorator_next_finish (TrackerDecorator *decorator,
...@@ -1554,7 +1554,7 @@ decorator_set_class_priority (TrackerDecorator *decorator, ...@@ -1554,7 +1554,7 @@ decorator_set_class_priority (TrackerDecorator *decorator,
* applications that need their content available sooner than the * applications that need their content available sooner than the
* standard time it would take to index content. * standard time it would take to index content.
* *
* Since: 0.18. * Since: 0.18
**/ **/
void void
tracker_decorator_set_priority_rdf_types (TrackerDecorator *decorator, tracker_decorator_set_priority_rdf_types (TrackerDecorator *decorator,
...@@ -1586,7 +1586,7 @@ tracker_decorator_set_priority_rdf_types (TrackerDecorator *decorator, ...@@ -1586,7 +1586,7 @@ tracker_decorator_set_priority_rdf_types (TrackerDecorator *decorator,
* *
* Returns: the URN for #TrackerDecoratorInfo on success or #NULL on error. * Returns: the URN for #TrackerDecoratorInfo on success or #NULL on error.
* *
* Since: 0.18. * Since: 0.18
**/ **/
const gchar * const gchar *
tracker_decorator_info_get_urn (TrackerDecoratorInfo *info) tracker_decorator_info_get_urn (TrackerDecoratorInfo *info)
...@@ -1604,7 +1604,7 @@ tracker_decorator_info_get_urn (TrackerDecoratorInfo *info) ...@@ -1604,7 +1604,7 @@ tracker_decorator_info_get_urn (TrackerDecoratorInfo *info)
* *
* Returns: the URL for #TrackerDecoratorInfo on success or #NULL on error. * Returns: the URL for #TrackerDecoratorInfo on success or #NULL on error.
* *
* Since: 0.18. * Since: 0.18
**/ **/
const gchar * const gchar *
tracker_decorator_info_get_url (TrackerDecoratorInfo *info) tracker_decorator_info_get_url (TrackerDecoratorInfo *info)
...@@ -1625,7 +1625,7 @@ tracker_decorator_info_get_url (TrackerDecoratorInfo *info) ...@@ -1625,7 +1625,7 @@ tracker_decorator_info_get_url (TrackerDecoratorInfo *info)
* *
* Returns: the MIME type for #TrackerDecoratorInfo on success or #NULL on error. * Returns: the MIME type for #TrackerDecoratorInfo on success or #NULL on error.
* *
* Since: 0.18. * Since: 0.18
**/ **/
const gchar * const gchar *
tracker_decorator_info_get_mimetype (TrackerDecoratorInfo *info) tracker_decorator_info_get_mimetype (TrackerDecoratorInfo *info)
...@@ -1643,14 +1643,13 @@ tracker_decorator_info_get_mimetype (TrackerDecoratorInfo *info) ...@@ -1643,14 +1643,13 @@ tracker_decorator_info_get_mimetype (TrackerDecoratorInfo *info)
* information for a URN in Tracker. * information for a URN in Tracker.
* *
* The task object's data (accessible with g_task_get_task_data()) is the * The task object's data (accessible with g_task_get_task_data()) is the
* #TrackerSparqlBuilder that you must populate with the results of the * #TrackerSparqlBuilder. Use tracker_decorator_info_complete() to complete
* metadata extraction. This can also be accessed with * the task instead of using this object.
* tracker_decorator_info_get_sparql().
* *
* Returns: (transfer none): the #GTask for #TrackerDecoratorInfo on * Returns: (transfer none): the #GTask for #TrackerDecoratorInfo on
* success or #NULL if there is no existing #GTask. * success or #NULL if there is no existing #GTask.
* *
* Since: 0.18. * Since: 0.18
**/ **/
GTask * GTask *
tracker_decorator_info_get_task (TrackerDecoratorInfo *info) tracker_decorator_info_get_task (TrackerDecoratorInfo *info)
...@@ -1662,7 +1661,7 @@ tracker_decorator_info_get_task (TrackerDecoratorInfo *info) ...@@ -1662,7 +1661,7 @@ tracker_decorator_info_get_task (TrackerDecoratorInfo *info)
/** /**
* tracker_decorator_info_complete: * tracker_decorator_info_complete:
* @info: a #TrackerDecoratorInfo * @info: a #TrackerDecoratorInfo
* @sparql: SPARQL string * @sparql: (transfer full): SPARQL string
* *
* Completes the task associated to this #TrackerDecoratorInfo. * Completes the task associated to this #TrackerDecoratorInfo.
* Takes ownership of @sparql. * Takes ownership of @sparql.
...@@ -1679,7 +1678,7 @@ tracker_decorator_info_complete (TrackerDecoratorInfo *info, ...@@ -1679,7 +1678,7 @@ tracker_decorator_info_complete (TrackerDecoratorInfo *info,
/** /**
* tracker_decorator_info_complete_error: * tracker_decorator_info_complete_error:
* @info: a #TrackerDecoratorInfo * @info: a #TrackerDecoratorInfo
* @error: An error occurred during SPARQL generation * @error: (transfer full): An error occurred during SPARQL generation
* *
* Completes the task associated to this #TrackerDecoratorInfo, * Completes the task associated to this #TrackerDecoratorInfo,
* returning the given @error happened during SPARQL generation. * returning the given @error happened during SPARQL generation.
......
...@@ -212,7 +212,7 @@ tracker_file_data_provider_file_iface_init (TrackerDataProviderIface *iface) ...@@ -212,7 +212,7 @@ tracker_file_data_provider_file_iface_init (TrackerDataProviderIface *iface)
* Returns: (transfer full): a #TrackerDataProvider which must be * Returns: (transfer full): a #TrackerDataProvider which must be
* unreferenced with g_object_unref(). * unreferenced with g_object_unref().
* *
* Since: 1.2: * Since: 1.2
**/ **/
TrackerDataProvider * TrackerDataProvider *
tracker_file_data_provider_new (void) tracker_file_data_provider_new (void)
......
...@@ -276,7 +276,7 @@ tracker_indexing_tree_class_init (TrackerIndexingTreeClass *klass) ...@@ -276,7 +276,7 @@ tracker_indexing_tree_class_init (TrackerIndexingTreeClass *klass)
* signalled when the tracker_indexing_tree_add() API is * signalled when the tracker_indexing_tree_add() API is
* called. * called.
* *
* Since: 0.14.0 * Since: 0.14
**/ **/
signals[DIRECTORY_ADDED] = signals[DIRECTORY_ADDED] =
g_signal_new ("directory-added", g_signal_new ("directory-added",
...@@ -299,7 +299,7 @@ tracker_indexing_tree_class_init (TrackerIndexingTreeClass *klass) ...@@ -299,7 +299,7 @@ tracker_indexing_tree_class_init (TrackerIndexingTreeClass *klass)
* signalled when the tracker_indexing_tree_remove() API is * signalled when the tracker_indexing_tree_remove() API is
* called. * called.
* *
* Since: 0.14.0 * Since: 0.14
**/ **/
signals[DIRECTORY_REMOVED] = signals[DIRECTORY_REMOVED] =
g_signal_new ("directory-removed", g_signal_new ("directory-removed",
...@@ -321,7 +321,7 @@ tracker_indexing_tree_class_init (TrackerIndexingTreeClass *klass) ...@@ -321,7 +321,7 @@ tracker_indexing_tree_class_init (TrackerIndexingTreeClass *klass)
* calls to tracker_indexing_tree_add()), or anytime an update is * calls to tracker_indexing_tree_add()), or anytime an update is
* requested through tracker_indexing_tree_notify_update(). * requested through tracker_indexing_tree_notify_update().
* *
* Since: 0.14.0 * Since: 0.14
**/ **/
signals[DIRECTORY_UPDATED] = signals[DIRECTORY_UPDATED] =
g_signal_new ("directory-updated", g_signal_new ("directory-updated",
...@@ -378,7 +378,7 @@ tracker_indexing_tree_init (TrackerIndexingTree *tree) ...@@ -378,7 +378,7 @@ tracker_indexing_tree_init (TrackerIndexingTree *tree)
* *
* Returns: a newly allocated #TrackerIndexingTree * Returns: a newly allocated #TrackerIndexingTree
* *
* Since: 0.14.0 * Since: 0.14
**/ **/
TrackerIndexingTree * TrackerIndexingTree *
tracker_indexing_tree_new (void) tracker_indexing_tree_new (void)
...@@ -948,7 +948,7 @@ tracker_indexing_tree_parent_is_indexable (TrackerIndexingTree *tree, ...@@ -948,7 +948,7 @@ tracker_indexing_tree_parent_is_indexable (TrackerIndexingTree *tree,
* *
* Returns: %FALSE if hidden files are indexed, otherwise %TRUE. * Returns: %FALSE if hidden files are indexed, otherwise %TRUE.
* *
* Since: 0.18. * Since: 0.18
**/ **/
gboolean gboolean
tracker_indexing_tree_get_filter_hidden (TrackerIndexingTree *tree) tracker_indexing_tree_get_filter_hidden (TrackerIndexingTree *tree)
...@@ -975,7 +975,7 @@ tracker_indexing_tree_get_filter_hidden (TrackerIndexingTree *tree) ...@@ -975,7 +975,7 @@ tracker_indexing_tree_get_filter_hidden (TrackerIndexingTree *tree)
* To ignore hidden files, @filter_hidden should be %TRUE, otherwise * To ignore hidden files, @filter_hidden should be %TRUE, otherwise
* %FALSE. * %FALSE.
* *
* Since: 0.18. * Since: 0.18
**/ **/
void void
tracker_indexing_tree_set_filter_hidden (TrackerIndexingTree *tree, tracker_indexing_tree_set_filter_hidden (TrackerIndexingTree *tree,
...@@ -1004,7 +1004,7 @@ tracker_indexing_tree_set_filter_hidden (TrackerIndexingTree *tree, ...@@ -1004,7 +1004,7 @@ tracker_indexing_tree_set_filter_hidden (TrackerIndexingTree *tree,
* For example, you can (by default), disable indexing all directories * For example, you can (by default), disable indexing all directories
* using this function. * using this function.
* *
* Since: 0.18. * Since: 0.18
**/ **/
void void
tracker_indexing_tree_set_default_policy (TrackerIndexingTree *tree, tracker_indexing_tree_set_default_policy (TrackerIndexingTree *tree,
...@@ -1032,9 +1032,9 @@ tracker_indexing_tree_set_default_policy (TrackerIndexingTree *tree, ...@@ -1032,9 +1032,9 @@ tracker_indexing_tree_set_default_policy (TrackerIndexingTree *tree,
* (#TRACKER_FILTER_FILE). * (#TRACKER_FILTER_FILE).
* *
* Returns: Either #TRACKER_FILTER_POLICY_DENY or * Returns: Either #TRACKER_FILTER_POLICY_DENY or
* #TRACKER_FILTER_POLICY_ALLOW. * #TRACKER_FILTER_POLICY_ACCEPT.
* *
* Since: 0.18. * Since: 0.18
**/ **/
TrackerFilterPolicy TrackerFilterPolicy
tracker_indexing_tree_get_default_policy (TrackerIndexingTree *tree, tracker_indexing_tree_get_default_policy (TrackerIndexingTree *tree,
...@@ -1137,7 +1137,7 @@ tracker_indexing_tree_get_root (TrackerIndexingTree *tree, ...@@ -1137,7 +1137,7 @@ tracker_indexing_tree_get_root (TrackerIndexingTree *tree,
* %NULL on error. The root is owned by @tree and should not be freed. * %NULL on error. The root is owned by @tree and should not be freed.
* It can be referenced using g_object_ref(). * It can be referenced using g_object_ref().
* *
* Since: 1.2. * Since: 1.2
**/ **/
GFile * GFile *
tracker_indexing_tree_get_master_root (TrackerIndexingTree *tree) tracker_indexing_tree_get_master_root (TrackerIndexingTree *tree)
...@@ -1161,7 +1161,7 @@ tracker_indexing_tree_get_master_root (TrackerIndexingTree *tree) ...@@ -1161,7 +1161,7 @@ tracker_indexing_tree_get_master_root (TrackerIndexingTree *tree)
* *
* Returns: %TRUE if @file matches the URL canonically, otherwise %FALSE. * Returns: %TRUE if @file matches the URL canonically, otherwise %FALSE.
* *
* Since: 1.2. * Since: 1.2
**/ **/
gboolean gboolean
tracker_indexing_tree_file_is_root (TrackerIndexingTree *tree, tracker_indexing_tree_file_is_root (TrackerIndexingTree *tree,
......
...@@ -57,6 +57,7 @@ struct _TrackerIndexingTree { ...@@ -57,6 +57,7 @@ struct _TrackerIndexingTree {
* @directory_added: Called when a directory is added. * @directory_added: Called when a directory is added.
* @directory_removed: Called when a directory is removed. * @directory_removed: Called when a directory is removed.
* @directory_updated: Called when a directory is updated. * @directory_updated: Called when a directory is updated.
* @child_updated: Called when a file inside a directory is updated.
* @padding: Reserved for future API improvements. * @padding: Reserved for future API improvements.
* *
* Class for the #TrackerIndexingTree. * Class for the #TrackerIndexingTree.
......
...@@ -49,7 +49,7 @@ G_BEGIN_DECLS ...@@ -49,7 +49,7 @@ G_BEGIN_DECLS
* used and this flag makes sure the directory is given a priority * used and this flag makes sure the directory is given a priority
* over other directories queued. * over other directories queued.
* @TRACKER_DIRECTORY_FLAG_NO_STAT: For cases where the content being * @TRACKER_DIRECTORY_FLAG_NO_STAT: For cases where the content being
* crawled by the #TrackerEnumerator is not local (e.g. it's on a * crawled by the enumerator is not local (e.g. it's on a
* server somewhere), use the #TRACKER_DIRECTORY_FLAG_NO_STAT flag. * server somewhere), use the #TRACKER_DIRECTORY_FLAG_NO_STAT flag.
* The default is to use stat() and assume we're mining a local or * The default is to use stat() and assume we're mining a local or
* mounted file system. * mounted file system.
......
...@@ -320,7 +320,7 @@ static guint signals[LAST_SIGNAL] = { 0, }; ...@@ -320,7 +320,7 @@ static guint signals[LAST_SIGNAL] = { 0, };
* *
* Returns: the #GQuark used for the domain of a #GError. * Returns: the #GQuark used for the domain of a #GError.
* *
* Since: 1.2. * Since: 1.2
**/ **/
G_DEFINE_QUARK (TrackerMinerFSError, tracker_miner_fs_error) G_DEFINE_QUARK (TrackerMinerFSError, tracker_miner_fs_error)
...@@ -2442,7 +2442,7 @@ check_file_parents (TrackerMinerFS *fs, ...@@ -2442,7 +2442,7 @@ check_file_parents (TrackerMinerFS *fs,
* Tells the filesystem miner to check and index a file at * Tells the filesystem miner to check and index a file at
* a given priority, this file must be part of the usual * a given priority, this file must be part of the usual
* crawling directories of #TrackerMinerFS. See * crawling directories of #TrackerMinerFS. See
* tracker_miner_fs_directory_add(). * tracker_indexing_tree_add().
* *
* Since: 0.10 * Since: 0.10
**/ **/
......
...@@ -72,6 +72,10 @@ struct _TrackerMinerFS { ...@@ -72,6 +72,10 @@ struct _TrackerMinerFS {
* a file's attributes changes, for example, the mtime. * a file's attributes changes, for example, the mtime.
* @finished_root: Called when all resources on a particular root URI * @finished_root: Called when all resources on a particular root URI
* have been processed. * have been processed.
* @remove_file: Called when a file is removed.
* @remove_children: Called when children have been removed.
* @move_file: Called when a file has moved.
* @filter_event: Called to filter the event happening to a file.
* @padding: Reserved for future API improvements. * @padding: Reserved for future API improvements.
* *
* Prototype for the abstract class, @process_file must be implemented * Prototype for the abstract class, @process_file must be implemented
...@@ -125,7 +129,7 @@ typedef struct { ...@@ -125,7 +129,7 @@ typedef struct {
* Possible errors returned when calling creating new objects based on * Possible errors returned when calling creating new objects based on
* the #TrackerMinerFS type and other APIs available with this class. * the #TrackerMinerFS type and other APIs available with this class.
* *
* Since: 1.2. * Since: 1.2
**/ **/
typedef enum { typedef enum {
TRACKER_MINER_FS_ERROR_INIT, TRACKER_MINER_FS_ERROR_INIT,
......
...@@ -38,7 +38,7 @@ G_BEGIN_DECLS ...@@ -38,7 +38,7 @@ G_BEGIN_DECLS
* The name of the D-Bus interface to use for all data miners that * The name of the D-Bus interface to use for all data miners that
* inter-operate with Tracker. * inter-operate with Tracker.
* *
* Since: 0.8. * Since: 0.8
**/ **/
#define TRACKER_MINER_DBUS_INTERFACE "org.freedesktop.Tracker1.Miner" #define TRACKER_MINER_DBUS_INTERFACE "org.freedesktop.Tracker1.Miner"
...@@ -50,7 +50,7 @@ G_BEGIN_DECLS ...@@ -50,7 +50,7 @@ G_BEGIN_DECLS
* example and would show up on D-Bus under * example and would show up on D-Bus under
* "org.freedesktop.Tracker1.Miner.Files". * "org.freedesktop.Tracker1.Miner.Files".
* *
* Since: 0.8. * Since: 0.8
**/ **/
#define TRACKER_MINER_DBUS_NAME_PREFIX "org.freedesktop.Tracker1.Miner." #define TRACKER_MINER_DBUS_NAME_PREFIX "org.freedesktop.Tracker1.Miner."
...@@ -62,7 +62,7 @@ G_BEGIN_DECLS ...@@ -62,7 +62,7 @@ G_BEGIN_DECLS
* example and would show up on D-Bus under * example and would show up on D-Bus under
* "/org/freedesktop/Tracker1/Miner/Files". * "/org/freedesktop/Tracker1/Miner/Files".
* *
* Since: 0.8. * Since: 0.8
**/ **/
#define TRACKER_MINER_DBUS_PATH_PREFIX "/org/freedesktop/Tracker1/Miner/" #define TRACKER_MINER_DBUS_PATH_PREFIX "/org/freedesktop/Tracker1/Miner/"
...@@ -78,7 +78,7 @@ G_BEGIN_DECLS ...@@ -78,7 +78,7 @@ G_BEGIN_DECLS
* *
* Used as the domain for any #GErrors reported by @TrackerMiner objects. * Used as the domain for any #GErrors reported by @TrackerMiner objects.
* *
* Since: 0.8. * Since: 0.8
**/ **/
#define TRACKER_MINER_ERROR_DOMAIN "TrackerMiner" #define TRACKER_MINER_ERROR_DOMAIN "TrackerMiner"
...@@ -88,7 +88,7 @@ G_BEGIN_DECLS ...@@ -88,7 +88,7 @@ G_BEGIN_DECLS
* Returns the @GQuark used for #GErrors and for @TrackerMiner * Returns the @GQuark used for #GErrors and for @TrackerMiner
* implementations. This calls tracker_miner_error_quark(). * implementations. This calls tracker_miner_error_quark().
* *
* Since: 0.8. * Since: 0.8
**/ **/
#define TRACKER_MINER_ERROR tracker_miner_error_quark() #define TRACKER_MINER_ERROR tracker_miner_error_quark()
......
...@@ -44,7 +44,7 @@ ...@@ -44,7 +44,7 @@
* a connection is valid to retrieve data or not. The miner data extraction * a connection is valid to retrieve data or not. The miner data extraction
* still must be dictated through the #TrackerMiner vmethods. * still must be dictated through the #TrackerMiner vmethods.
* *
* Since: 0.18. * Since: 0.18
**/ **/
typedef struct _TrackerMinerOnlinePrivate TrackerMinerOnlinePrivate; typedef struct _TrackerMinerOnlinePrivate TrackerMinerOnlinePrivate;
...@@ -158,7 +158,7 @@ tracker_miner_online_class_init (TrackerMinerOnlineClass *klass) ...@@ -158,7 +158,7 @@ tracker_miner_online_class_init (TrackerMinerOnlineClass *klass)
* Return values of #TRUE from this signal indicate whether a * Return values of #TRUE from this signal indicate whether a
* #TrackerMiner should resume indexing or not upon ::connected. * #TrackerMiner should resume indexing or not upon ::connected.
* *
* Since: 0.18.0 * Since: 0.18
**/ **/
signals[CONNECTED] = signals[CONNECTED] =
g_signal_new ("connected", g_signal_new ("connected",
...@@ -176,7 +176,7 @@ tracker_miner_online_class_init (TrackerMinerOnlineClass *klass) ...@@ -176,7 +176,7 @@ tracker_miner_online_class_init (TrackerMinerOnlineClass *klass)
* the ::disconnected signal is emitted when a specific @type of * the ::disconnected signal is emitted when a specific @type of
* network becomes disconnected. * network becomes disconnected.
* *
* Since: 0.18.0 * Since: 0.18
**/ **/
signals[DISCONNECTED] = signals[DISCONNECTED] =
g_signal_new ("disconnected", g_signal_new ("disconnected",
...@@ -392,7 +392,7 @@ miner_online_initable_iface_init (GInitableIface *iface) ...@@ -392,7 +392,7 @@ miner_online_initable_iface_init (GInitableIface *iface)
* *
* Returns: a #TrackerNetworkType on success or #TRACKER_NETWORK_TYPE_NONE on error. * Returns: a #TrackerNetworkType on success or #TRACKER_NETWORK_TYPE_NONE on error.
* *
* Since: 0.18. * Since: 0.18
**/ **/
TrackerNetworkType TrackerNetworkType
tracker_miner_online_get_network_type (TrackerMinerOnline *miner) tracker_miner_online_get_network_type (TrackerMinerOnline *miner)
......
...@@ -58,7 +58,7 @@ struct _TrackerMinerOnline { ...@@ -58,7 +58,7 @@ struct _TrackerMinerOnline {
* *
* Virtual methods that can be overridden. * Virtual methods that can be overridden.
* *
* Since: 0.18. * Since: 0.18
**/ **/
struct _TrackerMinerOnlineClass { struct _TrackerMinerOnlineClass {
TrackerMinerClass parent_class; TrackerMinerClass parent_class;
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment