streams: Extend GstStreamType documentation
authorEdward Hervey <edward@centricular.com>
Thu, 13 Oct 2016 10:03:20 +0000 (12:03 +0200)
committerEdward Hervey <bilboed@bilboed.com>
Thu, 13 Oct 2016 10:04:20 +0000 (12:04 +0200)
Users shouldn't assume it will be a single value since it's a flag.

gst/gststreams.h

index a82d81f..2df1c76 100644 (file)
@@ -48,6 +48,10 @@ G_BEGIN_DECLS
  *
  * #GstStreamType describes a high level classification set for
  * flows of data in #GstStream objects.
+ *
+ * Note that this is a flag, and therefore users should not assume it
+ * will be a single value. Do not use the equality operator for checking
+ * whether a stream is of a certain type.
  */
 typedef enum {
   GST_STREAM_TYPE_UNKNOWN   = 1 << 0,