[PATCH 2/3] core: updated grl_media_source_cancel() documentation

[Guillaume Emont <gemont igalia com>]

---
 src/grl-media-source.c |   13 ++++++++-----
 1 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/src/grl-media-source.c b/src/grl-media-source.c
index 088fb1e..f0ac763 100644
--- a/src/grl-media-source.c
+++ b/src/grl-media-source.c
@@ -2053,15 +2053,18 @@ grl_media_source_supported_operations (GrlMetadataSource *metadata_source)
 /**
  * grl_media_source_cancel:
  * @source: a media source
- * @operation_id: the identifier of the running operation
+ * @operation_id: the identifier of the running operation, as returned by the
+ * function that started it
  *
  * Cancel a running method.
  *
- * Every method has a operation identifier, which is set as parameter in the
- * callback. The running operation can be cancel then.
- *
  * The derived class must implement the cancel vmethod in order to
- * honor the request.
+ * honor the request correctly. Alternatively, the operation will be considered
+ * as cancelled once it has finished.
+ *
+ * In all cases, if this function is called on an ongoing operation, the
+ * corresponding callback will eventually be called with the error
+ * @GRL_CORE_ERROR_OPERATION_CANCELLED set.
  *
  * Since: 0.1.1
  */
-- 
1.7.1