After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 708331 - Document debug levels and debugging techniques
Document debug levels and debugging techniques
Status: RESOLVED OBSOLETE
Product: GStreamer
Classification: Platform
Component: documentation
unspecified
Other Linux
: Normal enhancement
: git master
Assigned To: GStreamer Maintainers
GStreamer Maintainers
Depends on:
Blocks:
 
 
Reported: 2013-09-18 21:35 UTC by piotr5
Modified: 2018-11-03 11:03 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description piotr5 2013-09-18 21:35:50 UTC
first off, is there any difference between the environment var GST_DEBUG and the commandline-option --gst-debug? if not then this should be mentioned. but the major issue here is that man-page merely mentions the possibility to increase debug level, and suggests to use --gst-debug-help to get more info. this way that option gets too little emphasis, which is strange for a tool that's supposed to be merely a sandbox for testing out pipelines. there certainly are parts that can be debugged and that do not depend on whatever external plugins. please make a choice of the most useful debug options and put them into the man-page with the GST_DEBUG or --gst-debug info. it's good to see some examples for gst-launch usage, but for a programmer more interesting would be to also see examples for how to learn more about what is happening under the hood. maybe also a section called troubleshooting could be added. there frequently asked questions could be addressed with some fitting debug-levels. in other words, please put more emphasis on the possibility of debugging within the man-page. at least to me, now that I know of this possibility, gst isn't as frightening a beast as it was before...
Comment 1 Sebastian Dröge (slomo) 2013-09-23 10:30:47 UTC
Do you have any suggestions how this could be added, maybe also provide a patch to the manpage? :)
Comment 2 Tim-Philipp Müller 2016-04-11 16:56:42 UTC
I'm not really sure what to do with this.

It sounds more like a general 'Please document debugging techniques' wishlist.

I don't think this stuff belongs on the gst-launch man page, it's more general.
Comment 3 GStreamer system administrator 2018-11-03 11:03:12 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/gstreamer/gst-docs/issues/3.