summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorRichard Hughes <richard@hughsie.com>2016-08-24 12:20:51 +0100
committerRichard Hughes <richard@hughsie.com>2017-05-10 12:44:02 +0100
commit8122b447e5c85a7addfc19827232d5cfe85b4eba (patch)
tree8c277f330485f7e4ad945c048a7e2687e03a3bbc /docs
parentfe18fd82266a0ff1f744d3ae287dc312e09549fa (diff)
downloadappstream-glib-8122b447e5c85a7addfc19827232d5cfe85b4eba.tar.gz
Switch to the meson build system.
Diffstat (limited to 'docs')
-rw-r--r--docs/Makefile.am5
-rw-r--r--docs/api/Makefile.am85
-rw-r--r--docs/api/appstream-glib-docs.xml (renamed from docs/api/appstream-glib-docs.sgml)31
-rwxr-xr-xdocs/api/clean.sh7
-rw-r--r--docs/api/meson.build6
-rw-r--r--docs/api/version.xml.in1
-rw-r--r--docs/meson.build1
7 files changed, 16 insertions, 120 deletions
diff --git a/docs/Makefile.am b/docs/Makefile.am
deleted file mode 100644
index aabe0d2..0000000
--- a/docs/Makefile.am
+++ /dev/null
@@ -1,5 +0,0 @@
-SUBDIRS = \
- api
-
-
--include $(top_srcdir)/git.mk
diff --git a/docs/api/Makefile.am b/docs/api/Makefile.am
deleted file mode 100644
index 1307fa9..0000000
--- a/docs/api/Makefile.am
+++ /dev/null
@@ -1,85 +0,0 @@
-## Process this file with automake to produce Makefile.in
-
-# We require automake 1.6 at least.
-AUTOMAKE_OPTIONS = 1.6
-
-# The name of the module, e.g. 'glib'.
-DOC_MODULE=appstream-glib
-
-# The top-level SGML file.
-DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
-
-# The directory containing the source code. Relative to $(srcdir).
-# gtk-doc will search all .c & .h files beneath here for inline comments
-# documenting the functions and macros.
-DOC_SOURCE_DIR=$(top_srcdir)/libappstream-glib $(top_builddir)/libappstream-glib
-
-# Extra options to pass to gtkdoc-scangobj. Not normally needed.
-SCANGOBJ_OPTIONS=
-
-# Extra options to supply to gtkdoc-scan.
-SCAN_OPTIONS=
-
-# Extra options to supply to gtkdoc-mkdb.
-MKDB_OPTIONS=--sgml-mode --output-format=xml
-
-# Extra options to supply to gtkdoc-mktmpl
-MKTMPL_OPTIONS=
-
-# Extra options to supply to gtkdoc-fixref. Not normally needed.
-FIXXREF_OPTIONS=
-
-# Used for dependencies. The docs will be rebuilt if any of these change.
-HFILE_GLOB=$(top_srcdir)/libappstream-glib/as-*.h
-CFILE_GLOB=$(top_srcdir)/libappstream-glib/as-*.c
-
-# Header files to ignore when scanning.
-IGNORE_HFILES = \
- config.h
-
-# Images to copy into HTML directory.
-#HTML_IMAGES = \
-# spec/pk-transactions-success.png \
-# spec/pk-transactions-trusted.png
-
-# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
-content_files = \
- version.xml
-
-# SGML files where gtk-doc abbrevations (#GtkWidget) are expanded
-# These files must be listed here *and* in content_files
-expand_content_files=
-
-# CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
-# Only needed if you are using gtkdoc-scangobj to dynamically query widget
-# signals and properties.
-AM_CPPFLAGS = \
- $(GLIB_CFLAGS) \
- -I$(top_builddir)/libappstream-glib \
- -I$(top_srcdir)/libappstream-glib \
- $(NULL)
-
-AS_LIBS = $(top_builddir)/libappstream-glib/libappstream-glib.la
-
-GTKDOC_LIBS = \
- $(GLIB_LIBS) \
- $(AS_LIBS)
-
-# This includes the standard gtk-doc make rules, copied by gtkdocize.
-include $(top_srcdir)/gtk-doc.make
-
-CLEANFILES += \
- *.txt \
- *.types \
- *.args \
- *.hierarchy \
- *.interfaces \
- *.prerequisites \
- *.signals \
- *.stamp \
- tmpl
-
-# Other files to distribute
-EXTRA_DIST += version.xml.in
-
--include $(top_srcdir)/git.mk
diff --git a/docs/api/appstream-glib-docs.sgml b/docs/api/appstream-glib-docs.xml
index 602e1b7..15ee4e8 100644
--- a/docs/api/appstream-glib-docs.sgml
+++ b/docs/api/appstream-glib-docs.xml
@@ -1,29 +1,12 @@
<?xml version="1.0"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
-<!ENTITY version SYSTEM "version.xml">
+<!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" xmlns:xi="http://www.w3.org/2003/XInclude">
+<book id="index">
<bookinfo>
<title>AppStream-glib Reference Manual</title>
- <releaseinfo>
- for AppStream-glib &version;
- </releaseinfo>
- <authorgroup>
- <author>
- <firstname>Richard</firstname>
- <surname>Hughes</surname>
- <affiliation>
- <address>
- <email>richard@hughsie.com</email>
- </address>
- </affiliation>
- </author>
- </authorgroup>
- <copyright>
- <year>2014</year>
- <holder>Richard Hughes</holder>
- </copyright>
</bookinfo>
<reference id="libappstream-glib">
@@ -53,12 +36,16 @@
<xi:include href="xml/as-tag.xml"/>
<xi:include href="xml/as-translation.xml"/>
<xi:include href="xml/as-utils.xml"/>
+<!--
<xi:include href="xml/as-version.xml"/>
+-->
</reference>
+<!--
<xi:include href="xml/annotation-glossary.xml">
<xi:fallback />
</xi:include>
+-->
</book>
diff --git a/docs/api/clean.sh b/docs/api/clean.sh
deleted file mode 100755
index c335583..0000000
--- a/docs/api/clean.sh
+++ /dev/null
@@ -1,7 +0,0 @@
-rm -f *.txt
-rm -f *-scan.*
-rm -f *.types
-rm -f html/*
-rm -f tmpl/*
-rm -f xml/*
-
diff --git a/docs/api/meson.build b/docs/api/meson.build
new file mode 100644
index 0000000..16db147
--- /dev/null
+++ b/docs/api/meson.build
@@ -0,0 +1,6 @@
+gnome.gtkdoc(
+ 'appstream-glib',
+ src_dir : join_paths(meson.source_root(), 'libappstream-glib'),
+ main_xml : 'appstream-glib-docs.xml',
+ install : true
+)
diff --git a/docs/api/version.xml.in b/docs/api/version.xml.in
deleted file mode 100644
index d78bda9..0000000
--- a/docs/api/version.xml.in
+++ /dev/null
@@ -1 +0,0 @@
-@VERSION@
diff --git a/docs/meson.build b/docs/meson.build
new file mode 100644
index 0000000..dc2bb41
--- /dev/null
+++ b/docs/meson.build
@@ -0,0 +1 @@
+subdir('api')