From 700be18f11ea3639a226321d6d3d839f9055b394 Mon Sep 17 00:00:00 2001 From: David Schleef Date: Mon, 25 Mar 2013 18:11:54 -0700 Subject: [PATCH] Update docs for gst_pad_create_stream_id_printf() To indicate that format strings should be alpha sortable. --- gst/gstutils.c | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/gst/gstutils.c b/gst/gstutils.c index daf1ba8..5df5df8 100644 --- a/gst/gstutils.c +++ b/gst/gstutils.c @@ -3699,6 +3699,10 @@ gst_pad_create_stream_id_printf (GstPad * pad, GstElement * parent, * handler interface should ideally generate a unique, deterministic * stream-id manually instead. * + * Since stream IDs are sorted alphabetically, any numbers in the + * stream ID should be printed with a fixed number of characters, + * preceded by 0's, such as by using the format %%03u instead of %%u. + * * Returns: A stream-id for @pad. g_free() after usage. */ gchar * -- 2.7.4