[Bug 793011] GstAdapter: Improve documentation for gst_adapter_available()

[GStreamer (GNOME Bugzilla)]

https://bugzilla.gnome.org/show_bug.cgi?id=793011

--- Comment #5 from Alicia Boya García <aboya at igalia.com> ---
(In reply to Tim-Philipp Müller from comment #4)
> I find it hard to believe that anyone could be confused after reading the
> actual description of both functions and return values side by side
> ("Returns: number of bytes available in adapter" vs "Returns: number of
> bytes that are available in adapter without expensive operations"), but it's
> always possible to make things clearer of course :)

As Sebastian always says... everything is obvious once you know it.

I changed the first phrase to say "that can be retrieved in a single map
operation" instead of "immediately available" because it's not necessarily
clear what immediately would mean there. Hopefully the next phrase makes it
clear. Do you have a suggestion on a clearer phrasing?

-- 
You are receiving this mail because:
You are the QA Contact for the bug.
You are the assignee for the bug.