allocators: Integrate into the documentation

diff --git a/docs/libs/Makefile.am b/docs/libs/Makefile.am
index 12850611ddffec377bd54e3bdc6aeb5018dddbcd..54126f82a1e4eb999725ea510d5e65145f18bed9 100644 (file)
--- a/docs/libs/Makefile.am
+++ b/docs/libs/Makefile.am
@@ -57,6 +57,7 @@ extra_files =
 # contains GtkObjects/GObjects and you want to document signals and properties.
 GTKDOC_CFLAGS = $(GST_PLUGINS_BASE_CFLAGS) $(GST_BASE_CFLAGS)
 GTKDOC_LIBS = \
+       $(top_builddir)/gst-libs/gst/allocators/libgstallocators-@GST_API_VERSION@.la \
        $(top_builddir)/gst-libs/gst/audio/libgstaudio-@GST_API_VERSION@.la \
        $(top_builddir)/gst-libs/gst/fft/libgstfft-@GST_API_VERSION@.la \
        $(top_builddir)/gst-libs/gst/rtp/libgstrtp-@GST_API_VERSION@.la \

diff --git a/docs/libs/gst-plugins-base-libs-docs.sgml b/docs/libs/gst-plugins-base-libs-docs.sgml
index 828debad2c358d804fd119533a560c5c783e3b75..78cc3d5de3c863117655f2f5ac788a7b3b0036a5 100644 (file)
--- a/docs/libs/gst-plugins-base-libs-docs.sgml
+++ b/docs/libs/gst-plugins-base-libs-docs.sgml
@@ -21,6 +21,16 @@
     </para>
     <xi:include href="compiling.sgml" />
 
+    <chapter id="gstreamer-allocators">
+      <title>Allocators Library</title>
+      <para>
+        This library should be linked to by getting cflags and libs from
+        <filename>gstreamer-plugins-base-&GST_API_VERSION;.pc</filename> and adding
+        <filename>-lgstallocators-&GST_API_VERSION;</filename> to the library flags.
+      </para>
+      <xi:include href="xml/gstdmabuf.xml" />
+    </chapter>
+
     <chapter id="gstreamer-app">
       <title>App Library</title>
       <para>

diff --git a/docs/libs/gst-plugins-base-libs-sections.txt b/docs/libs/gst-plugins-base-libs-sections.txt
index ecc787c0c8d4ef309df79d64f4eeda1244a9e1ca..d5d196af18940ac09563634be37e7d9e394b6ce3 100644 (file)
--- a/docs/libs/gst-plugins-base-libs-sections.txt
+++ b/docs/libs/gst-plugins-base-libs-sections.txt
@@ -1,3 +1,17 @@
+# allocators
+
+<SECTION>
+<FILE>gstdmabuf</FILE>
+<TITLE>dmabuf</TITLE>
+<INCLUDE>gst/allocators/gstdmabuf.h</INCLUDE>
+gst_dmabuf_allocator_alloc
+gst_dmabuf_allocator_obtain
+gst_dmabuf_memory_get_fd
+gst_is_dmabuf_memory
+<SUBSECTION Standard>
+<SUBSECTION Private>
+</SECTION>
+
 # app
 <SECTION>
 <FILE>gstappsrc</FILE>

diff --git a/gst-libs/gst/allocators/gstdmabuf.c b/gst-libs/gst/allocators/gstdmabuf.c
index d6194d54adc49550a1b32a807cc8ad275276772f..a822acf4353dca9de4d693f287824448bc40b517 100644 (file)
--- a/gst-libs/gst/allocators/gstdmabuf.c
+++ b/gst-libs/gst/allocators/gstdmabuf.c
@@ -22,6 +22,13 @@
 
 #include "gstdmabuf.h"
 
+/**
+ * SECTION:gstdmabuf
+ * @short_description: Memory wrapper for Linux dmabuf memory
+ * @see_also: #GstMemory
+ *
+ */
+
 #ifdef HAVE_MMAP
 #include <sys/mman.h>
 #include <unistd.h>