summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJan Alexander Steffens (heftig) <jan.steffens@gmail.com>2017-02-16 01:24:48 +0100
committerVictor Toso <me@victortoso.com>2017-02-21 08:34:32 +0100
commitc5eac4907f9a99280064aa001485f9696f5ebe10 (patch)
tree16ab91a422ef6b814cdfdd99a7266a22613a9544 /doc
parenta0f3f0be1374458328f73d89e5dbb711009a0fb7 (diff)
downloadgrilo-c5eac4907f9a99280064aa001485f9696f5ebe10.tar.gz
build: Improve docs and introspection
https://bugzilla.gnome.org/show_bug.cgi?id=778612
Diffstat (limited to 'doc')
-rw-r--r--doc/grilo/Makefile.am12
-rw-r--r--doc/grilo/meson.build10
-rw-r--r--doc/grilo/writing-apps.xml10
3 files changed, 26 insertions, 6 deletions
diff --git a/doc/grilo/Makefile.am b/doc/grilo/Makefile.am
index 11ce422..4f2ed61 100644
--- a/doc/grilo/Makefile.am
+++ b/doc/grilo/Makefile.am
@@ -74,6 +74,18 @@ IGNORE_HFILES=config.h \
# e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
HTML_IMAGES=
+program_listings = \
+ configuring-plugins.c \
+ browsing.c \
+ searching.c \
+ multivalues.c \
+ efficient-metadata-resolution.c
+
+%.c: $(top_srcdir)/examples/%.c
+ cp -f $< $@
+
+html-build.stamp: $(program_listings)
+
# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
# e.g. content_files=running.sgml building.sgml changes-2.0.sgml
content_files=overview.xml \
diff --git a/doc/grilo/meson.build b/doc/grilo/meson.build
index 299c28b..e86c678 100644
--- a/doc/grilo/meson.build
+++ b/doc/grilo/meson.build
@@ -11,7 +11,10 @@ types = configure_file(input : 'grilo.types',
gnome.gtkdoc('grilo',
main_sgml: 'grilo-docs.sgml',
- src_dir: join_paths(meson.source_root(), 'src'),
+ src_dir: [
+ join_paths(meson.source_root(), 'src'),
+ join_paths(meson.source_root(), 'libs'),
+ ],
dependencies: libgrl_dep,
gobject_typesfile: types,
install: true,
@@ -22,5 +25,10 @@ gnome.gtkdoc('grilo',
'quick-start.xml',
'writing-apps.xml',
'overview.xml',
+ join_paths(meson.source_root(), 'examples', 'configuring-plugins.c'),
+ join_paths(meson.source_root(), 'examples', 'browsing.c'),
+ join_paths(meson.source_root(), 'examples', 'searching.c'),
+ join_paths(meson.source_root(), 'examples', 'multivalues.c'),
+ join_paths(meson.source_root(), 'examples', 'efficient-metadata-resolution.c'),
]
)
diff --git a/doc/grilo/writing-apps.xml b/doc/grilo/writing-apps.xml
index 3f8a86b..a301d28 100644
--- a/doc/grilo/writing-apps.xml
+++ b/doc/grilo/writing-apps.xml
@@ -397,7 +397,7 @@
application:
</para>
<programlisting role="C">
- <xi:include href="../../examples/configuring-plugins.c"
+ <xi:include href="configuring-plugins.c"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude"/>
</programlisting>
@@ -418,7 +418,7 @@
content from a particular media source (a similar approach
can be used for searching content instead of browsing):</para>
<programlisting role="C">
- <xi:include href="../../examples/browsing.c"
+ <xi:include href="browsing.c"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude"/>
</programlisting>
@@ -473,7 +473,7 @@
content by text from a particular media source (Jamendo
in this example):</para>
<programlisting role="C">
- <xi:include href="../../examples/searching.c"
+ <xi:include href="searching.c"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude"/>
</programlisting>
@@ -538,7 +538,7 @@
to illustrate how to use it:
</para>
<programlisting role="C">
- <xi:include href="../../examples/multivalues.c"
+ <xi:include href="multivalues.c"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude"/>
</programlisting>
@@ -637,7 +637,7 @@
be an acceptable delay.
</para>
<programlisting role="C">
- <xi:include href="../../examples/efficient-metadata-resolution.c"
+ <xi:include href="efficient-metadata-resolution.c"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude"/>
</programlisting>