GNOME Bugzilla – Bug 697920
Some of (at least) -base/gst-libs/gst/audio/audio-format.h misses out on html documentation
Last modified: 2013-04-17 08:49:35 UTC
https://www.google.com/search?q=GST_AUDIO_CAPS_MAKE reveals no documentation for GST_AUDIO_CAPS_MAKE() (though it does show numerous examples). This is defined in gst-plugins-base/gst-libs/gst/audio/audio-format.h, which is included in gst-plugins-base/gst-libs/gst/audio/audio.h. Looking at http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-gstaudio.html, it seems that some definitions from audio-format.h are documented here (for example, the GstAudioFormat enum, and all(?) functions), while others are not. Without having a clue or being systematic, it seems as if gtk-doc gave up on #defines at around line 273.
It's not that gtk-doc "gave up", but either the macro is not listed in the docs/libs/gst-plugins-base-sections.txt file, or there's no gtk-doc chunk for it in the code. commit e96ca66c36f86cf6edd5723fa2f69d8aa222466d Author: Tim-Philipp Müller <tim@centricular.net> Date: Wed Apr 17 09:23:20 2013 +0100 docs: add some more audio macros