[Bug 709262] New: GstStructure's documentation incorrectly warns that empty strings don't work in any GstStructure

[GStreamer (bugzilla.gnome.org)]

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

           Summary: GstStructure's documentation incorrectly warns that
                    empty strings don't work in any GstStructure
    Classification: Platform
           Product: GStreamer
           Version: 1.2.0
        OS/Version: All
            Status: UNCONFIRMED
          Severity: minor
          Priority: Normal
         Component: gstreamer (core)
        AssignedTo: gstreamer-bugs at lists.freedesktop.org
        ReportedBy: stewart at eh.org
         QAContact: gstreamer-bugs at lists.freedesktop.org
     GNOME version: ---


The documentation at the top of gst/gststructure.c claims that empty strings do
not work as property values in GstStructures.  It should say that empty strings
do not work only when the GstStructure is a TAGLIST.

There was a brief time when the statement was true, but it was quickly fixed by 
change 7bf3554228f52e06e465fc02d31ac4b1b267ff7d in July 2009, but the comment
was never fixed.

The warning about empty and NULL probably ought to be added to gst/gsttaglist.c
as well, at the place where it also warns about values needing to be valid
UTF-8.

Affects 0.10.x and 1.0.x codelines as well as 1.2.0

-- 
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.