context: Return a non-const GstStructure to make code simpler and update docs

diff --git a/gst/gstcontext.c b/gst/gstcontext.c
index 3d63fb4..8f45590 100644 (file)
--- a/gst/gstcontext.c
+++ b/gst/gstcontext.c
@@ -168,12 +168,13 @@ gst_context_new (void)
  * Access the structure of the context.
  *
  * Returns: (transfer none): The structure of the context. The structure is
- * still owned by the context, which means that you should not modify it,
- * free it and that the pointer becomes invalid when you free the context.
+ * still owned by the context, which means that you should not modify it unless
+ * the context is writable, and should not free it and that the pointer becomes
+ * invalid when you free the context.
  *
  * Since: 1.2
  */
-const GstStructure *
+GstStructure *
 gst_context_get_structure (GstContext * context)
 {
   g_return_val_if_fail (GST_IS_CONTEXT (context), NULL);

diff --git a/gst/gstcontext.h b/gst/gstcontext.h
index 61e9180..4c3699c 100644 (file)
--- a/gst/gstcontext.h
+++ b/gst/gstcontext.h
@@ -145,8 +145,7 @@ gst_context_replace (GstContext **old_context, GstContext *new_context)
 
 GstContext *    gst_context_new (void) G_GNUC_MALLOC;
 
-const GstStructure *
-                gst_context_get_structure       (GstContext *context);
+GstStructure *  gst_context_get_structure       (GstContext *context);
 
 G_END_DECLS