[gcab] docs: improve gtk-doc generation

[Marc-André Lureau <malureau src gnome org>]

commit 31a16b5e3171351399adc0184ad8da7e6392f82f
Author: Marc-André Lureau <marcandre lureau redhat com>
Date:   Mon Jan 6 15:21:46 2020 +0400

    docs: improve gtk-doc generation
    
    Signed-off-by: Marc-André Lureau <marcandre lureau redhat com>

 docs/reference/gcab-docs.sgml    |  4 ++++
 docs/reference/gcab-sections.txt |  2 ++
 docs/reference/meson.build       | 13 +++++++++++++
 3 files changed, 19 insertions(+)
---
diff --git a/docs/reference/gcab-docs.sgml b/docs/reference/gcab-docs.sgml
index 9464366..7570737 100644
--- a/docs/reference/gcab-docs.sgml
+++ b/docs/reference/gcab-docs.sgml
@@ -36,6 +36,10 @@
     <title>Index of new symbols in 1.0</title>
     <xi:include href="xml/api-index-1.0.xml"><xi:fallback /></xi:include>
   </index>
+  <index id="api-index-1-4" role="1.4">
+    <title>Index of new symbols in 1.4</title>
+    <xi:include href="xml/api-index-1.4.xml"><xi:fallback /></xi:include>
+  </index>
 
   <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
 </book>
diff --git a/docs/reference/gcab-sections.txt b/docs/reference/gcab-sections.txt
index 42ec864..36671c0 100644
--- a/docs/reference/gcab-sections.txt
+++ b/docs/reference/gcab-sections.txt
@@ -34,6 +34,8 @@ GCabFile
 gcab_file_get_attributes
 gcab_file_get_date
 gcab_file_set_date
+gcab_file_get_date_time
+gcab_file_set_date_time
 gcab_file_get_extract_name
 gcab_file_get_file
 gcab_file_get_name
diff --git a/docs/reference/meson.build b/docs/reference/meson.build
index 879e9eb..9dfc3fb 100644
--- a/docs/reference/meson.build
+++ b/docs/reference/meson.build
@@ -1,9 +1,22 @@
+glib_prefix = dependency('glib-2.0').get_pkgconfig_variable('prefix')
+glib_docpath = glib_prefix / 'share' / 'gtk-doc' / 'html'
+
+datadir = get_option('prefix') / get_option('datadir')
+docpath = datadir / 'gcab' / 'html'
+
 gnome.gtkdoc(
   'gcab',
   src_dir : [
     join_paths(meson.source_root(), 'libgcab'),
     join_paths(meson.build_root(), 'libgcab'),
   ],
+  ignore_headers : ['decomp.h', 'cabinet.h', 'gcab-priv.h'],
   main_sgml : 'gcab-docs.sgml',
+  fixxref_args: [
+    '--html-dir=@0@'.format(docpath),
+    '--extra-dir=@0@'.format(glib_docpath / 'glib'),
+    '--extra-dir=@0@'.format(glib_docpath / 'gobject'),
+    '--extra-dir=@0@'.format(glib_docpath / 'gio'),
+  ],
   install : true
 )