GNOME Bugzilla – Bug 668081
Wrong playbin2 doc about DVD URIs
Last modified: 2012-03-04 20:56:52 UTC
Created attachment 205431 [details] [review]
git patch for playbin2 doc
The playbin2 documentation needs some modification: about DVD support, it states that "In future ways might be added to specify the device as part of the URI, but at the time of writing this is not possible yet." and gives as example
"gst-launch -v playbin uri=dvd://1
This will play back title 1 of a DVD in your disc drive (assuming the drive is detected automatically by the plugin)."
However, the resindvd element uses the following syntax: dvd://[path/to/device]. Then, both the explanation and the example are wrong. Running the example code will not work, since there is (usually) no DVD device named "1".
Side remark: the command line examples given in the playbin2 page http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-plugins/html/gst-plugins-base-plugins-playbin2.html use playbin as element.
The attached git patch addresses these issues.
If that URI scheme is accepted, depends a lot on the plugin installed. It will work with resindvd, but not with dvdreadsrc, for example. Hence left the original blurb there, slightly modified.
Author: Olivier Aubert <firstname.lastname@example.org>
Date: Tue Jan 17 10:54:48 2012 +0100
docs: fix playbin2 documentation about DVD URIs
and playbin => playbin2 in example pipelines.
Wouldn't the 1.0 release be the right time to settle on a common syntax for DVD URIs for all DVD-related plugins? It would solve this issue, and most importantly avoid that playbin users have to care about the underlying plugin.
It is in fact related to #668083 which is tagged on [resindvd] but would apply equally to any DVD plugin.
yes, patches welcome.