doc: Add librygel-db to apidocs

Signed-off-by: Jens Georg <mail@jensge.org>

4 files changed, 137 insertions, 1 deletions

diff --git a/doc/reference/Makefile.am b/doc/reference/Makefile.am
index 66fbb692..0acd3572 100644
--- a/doc/reference/Makefile.am
+++ b/doc/reference/Makefile.am
@@ -1,4 +1,4 @@
-SUBDIRS = librygel-core librygel-renderer librygel-server
+SUBDIRS = librygel-core librygel-renderer librygel-server librygel-db
 
 if HAVE_GSTREAMER
 SUBDIRS += librygel-renderer-gst
diff --git a/doc/reference/librygel-db/Makefile.am b/doc/reference/librygel-db/Makefile.am
new file mode 100644
index 00000000..d4af81f4
--- /dev/null
+++ b/doc/reference/librygel-db/Makefile.am
@@ -0,0 +1,26 @@
+RYGEL_DOCBUILD_MODULE = rygel-db
+if ENABLE_VALADOC
+
+include $(top_srcdir)/common.am
+include $(top_srcdir)/src/librygel-db/filelist.am
+
+# Note that LIBRYGEL_DB_NONVAPI_SOURCE_FILES all (should) use the internal keyword
+# so they are not shown as part of the public API.
+VALA_SOURCE_FILES = $(LIBRYGEL_DB_VAPI_SOURCE_FILES) \
+		$(LIBRYGEL_DB_NONVAPI_SOURCE_FILES)
+
+VALA_SOURCE_FILES_WITH_PATHS = $(addprefix $(top_srcdir)/src/librygel-db/, $(VALA_SOURCE_FILES))
+
+RYGEL_DOCBUILD_VALADOC_FLAGS = \
+	$(LIBRYGEL_DB_DEPS_VALAFLAGS) \
+	$(RYGEL_COMMON_LIBRYGEL_CORE_VALAFLAGS) \
+	$(RYGEL_COMMON_BUILD_CONFIG_VALAFLAGS)
+
+
+RYGEL_DOCBUILD_EXTRA_GTKDOC_OPTIONS =
+endif
+
+include $(top_srcdir)/doc/reference/doc-build.am
+
+
+
diff --git a/doc/reference/librygel-db/gtkdoc/librygel-db-docs.xml b/doc/reference/librygel-db/gtkdoc/librygel-db-docs.xml
new file mode 100644
index 00000000..53301064
--- /dev/null
+++ b/doc/reference/librygel-db/gtkdoc/librygel-db-docs.xml
@@ -0,0 +1,48 @@
+<?xml version="1.0"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+  <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
+]>
+<book id="index">
+  <bookinfo>
+    <title>librygel-db Reference Manual</title>
+    <releaseinfo>
+      for librygel-db 2.0.
+      The latest version of this documentation can be found on-line at
+      <ulink role="online-location" url="http://developer.gnome.org/librygel-db/index.html">http://developer.gnome.org/librygel-db/</ulink>.
+    </releaseinfo>
+  </bookinfo>
+
+  <!-- This is hand written: -->
+  <preface id="overview">
+    <title>Overview</title>
+    <xi:include href="overview.xml"/>
+  </preface>
+
+  <!-- These are generated: -->
+  <chapter id="api-main-list-c">
+    <title>librygel-db API Reference</title>
+    <xi:include href="xml/sql-function.xml"/>
+    <xi:include href="xml/database-cursor.xml"/>
+    <xi:include href="xml/database.xml"/>
+    <xi:include href="xml/sql-operator.xml"/>
+  </chapter>
+
+  <chapter id="object-tree">
+    <title>Object Hierarchy</title>
+     <xi:include href="xml/tree_index.sgml"/>
+  </chapter>
+
+  <index id="api-index-full">
+    <title>API Index</title>
+    <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
+  </index>
+
+  <index id="deprecated-api-index" role="deprecated">
+    <title>Index of deprecated API</title>
+    <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
+  </index>
+
+  <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
+</book>
diff --git a/doc/reference/librygel-db/gtkdoc/overview.xml b/doc/reference/librygel-db/gtkdoc/overview.xml
new file mode 100644
index 00000000..0a826355
--- /dev/null
+++ b/doc/reference/librygel-db/gtkdoc/overview.xml
@@ -0,0 +1,62 @@
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
+]>
+
+<section id="overview">
+
+<para>
+librygel-db is part of the <ulink url="http://rygel-project.org/">Rygel</ulink> project.
+</para>
+
+<para>
+librygel-db is a small wrapper around SQLite3 used in several plugin implementations.
+</para>
+
+<para>
+librygel-db is licensed under the GNU Lesser General Public License (LGPL).
+</para>
+
+<sect1>
+<title>Basic Usage</title>
+<para>
+Include the header:
+</para>
+<para>
+<programlisting>
+#include &lt;rygel-db.h&gt;
+</programlisting>
+</para>
+
+<para>
+If your source file is program.c, you can compile it with:
+</para>
+<para>
+<command>
+gcc program.cc -o program `pkg-config --cflags --libs rygel-db-2.6`
+</command>
+</para>
+
+<para>
+Alternatively, if using autoconf, use the following in configure.ac:
+</para>
+<para>
+<programlisting>
+PKG_CHECK_MODULES([DEPS], [rygel-db-2.6])
+</programlisting>
+</para>
+
+<para>
+Then use the generated DEPS_CFLAGS and DEPS_LIBS variables in the project Makefile.am files. For example:
+</para>
+<para>
+<programlisting>
+program_CPPFLAGS = $(DEPS_CFLAGS)
+program_LDADD = $(DEPS_LIBS)
+</programlisting>
+</para>
+
+</sect1>
+
+</section>