diff options
author | Thibault Saunier <thibault.saunier@osg.samsung.com> | 2017-01-16 11:26:16 -0300 |
---|---|---|
committer | Thibault Saunier <thibault.saunier@osg.samsung.com> | 2017-01-27 16:36:38 -0300 |
commit | a87b4551a6090663a1714f263d4e20fe75eb46ca (patch) | |
tree | 4367eb5b3027851743c464bd159abb6c7325f694 /gst/gstregistry.c | |
parent | 76f049bc49fc6fc56ca19d64749cfbe2f601c3c9 (diff) |
Port gtk-doc comments to their equivalent markdown syntax
Modernizing our documentation and preparing a possible move to hotdoc.
This commits also adds missing @title metadatas to all SECTIONs
Diffstat (limited to 'gst/gstregistry.c')
-rw-r--r-- | gst/gstregistry.c | 57 |
1 files changed, 19 insertions, 38 deletions
diff --git a/gst/gstregistry.c b/gst/gstregistry.c index f16d2ebea0..cc094e3eef 100644 --- a/gst/gstregistry.c +++ b/gst/gstregistry.c @@ -23,6 +23,7 @@ /** * SECTION:gstregistry + * @title: GstRegistry * @short_description: Abstract base class for management of #GstPlugin objects * @see_also: #GstPlugin, #GstPluginFeature * @@ -44,48 +45,28 @@ * * On startup, plugins are searched for in the plugin search path. The following * locations are checked in this order: - * <itemizedlist> - * <listitem> - * <para>location from --gst-plugin-path commandline option.</para> - * </listitem> - * <listitem> - * <para>the GST_PLUGIN_PATH environment variable.</para> - * </listitem> - * <listitem> - * <para>the GST_PLUGIN_SYSTEM_PATH environment variable.</para> - * </listitem> - * <listitem> - * <para>default locations (if GST_PLUGIN_SYSTEM_PATH is not set). Those - * default locations are: - * <filename>$XDG_DATA_HOME/gstreamer-$GST_API_VERSION/plugins/</filename> - * and <filename>$prefix/libs/gstreamer-$GST_API_VERSION/</filename>. - * <ulink url="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html"> - * <filename>$XDG_DATA_HOME</filename></ulink> defaults to - * <filename>$HOME/.local/share</filename>. - * </para> - * </listitem> - * </itemizedlist> + * + * * location from --gst-plugin-path commandline option. + * * the GST_PLUGIN_PATH environment variable. + * * the GST_PLUGIN_SYSTEM_PATH environment variable. + * * default locations (if GST_PLUGIN_SYSTEM_PATH is not set). + * Those default locations are: + * `$XDG_DATA_HOME/gstreamer-$GST_API_VERSION/plugins/` + * and `$prefix/libs/gstreamer-$GST_API_VERSION/`. + * [$XDG_DATA_HOME](http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html) defaults to + * `$HOME/.local/share`. + * * The registry cache file is loaded from - * <filename>$XDG_CACHE_HOME/gstreamer-$GST_API_VERSION/registry-$ARCH.bin</filename> - * (where - * <ulink url="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html"> - * <filename>$XDG_CACHE_HOME</filename></ulink> defaults to - * <filename>$HOME/.cache</filename>) or the file listed in the GST_REGISTRY + * `$XDG_CACHE_HOME/gstreamer-$GST_API_VERSION/registry-$ARCH.bin` + * (where $XDG_CACHE_HOME defaults to `$HOME/.cache`) or the file listed in the `GST_REGISTRY` * env var. One reason to change the registry location is for testing. * * For each plugin that is found in the plugin search path, there could be 3 * possibilities for cached information: - * <itemizedlist> - * <listitem> - * <para>the cache may not contain information about a given file.</para> - * </listitem> - * <listitem> - * <para>the cache may have stale information.</para> - * </listitem> - * <listitem> - * <para>the cache may have current information.</para> - * </listitem> - * </itemizedlist> + * + * * the cache may not contain information about a given file. + * * the cache may have stale information. + * * the cache may have current information. * * In the first two cases, the plugin is loaded and the cache updated. In * addition to these cases, the cache may have entries for plugins that are not @@ -97,7 +78,7 @@ * checked to make sure the information is minimally valid. If not, the entry is * simply dropped. * - * <emphasis role="bold">Implementation notes:</emphasis> + * ## Implementation notes: * * The "cache" and "registry" are different concepts and can represent * different sets of plugins. For various reasons, at init time, the cache is |