[Bug 667689] New: gststructure: clarify _get docs about the returned reference

[GStreamer (bugzilla.gnome.org)]

https://bugzilla.gnome.org/show_bug.cgi?id=667689
  GStreamer | gstreamer (core) | unspecified

           Summary: gststructure: clarify _get docs about the returned
                    reference
    Classification: Platform
           Product: GStreamer
           Version: unspecified
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: Normal
         Component: gstreamer (core)
        AssignedTo: gstreamer-bugs at lists.freedesktop.org
        ReportedBy: vincent.penquerch at collabora.co.uk
         QAContact: gstreamer-bugs at lists.freedesktop.org
     GNOME version: ---


gststructure: clarify _get docs about the returned reference

I was confused by these docs. To me, "you will acquire your own
reference" means "you need to call _ref yourself", whereas what
the code does it give you an already reffed pointer.

Test code shows that a ref is indeed returned (at least for caps,
which is what I tested). I think this is a lot clearer, but then
I'm not a native English speaker so maybe I'm missing a subtlety
here, so I'll put that up for comments before pushing.

-- 
Configure bugmail: https://bugzilla.gnome.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.