[tracker/tracker-0.12] libtracker-miner: Improve docs for tracker_miner_manager_pause_for_process()

[Martyn James Russell <mr src gnome org>]

commit 644233cc88dcd339a0e3c88232b75b317917e868
Author: Martyn Russell <martyn lanedo com>
Date:   Wed Sep 21 14:16:39 2011 +0100

    libtracker-miner: Improve docs for tracker_miner_manager_pause_for_process()
    
    When finalizing the manager, it will resume the pause. The tracker-control
    utility was demonstrating this. Let people calling it know.

 src/libtracker-miner/tracker-miner-manager.c |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)
---
diff --git a/src/libtracker-miner/tracker-miner-manager.c b/src/libtracker-miner/tracker-miner-manager.c
index e84e606..65f59c8 100644
--- a/src/libtracker-miner/tracker-miner-manager.c
+++ b/src/libtracker-miner/tracker-miner-manager.c
@@ -904,6 +904,10 @@ tracker_miner_manager_pause (TrackerMinerManager *manager,
  * where the calling process has a risk of crashing without resuming
  * the pause.
  *
+ * NOTE: If you call g_object_unref() on the @manager before you
+ * intend to resume the pause and it finalizes, it will automatically
+ * resume.
+ *
  * Returns: %TRUE if the miner was paused successfully, otherwise
  * %FALSE.
  *