docs/reference/gio/meson.build

   1 if get_option('with-docs') != 'no'
   2   subdir('xml')
   3
   4   ignore_headers = [
   5     'fam',
   6     'fen',
   7     'gdbus-2.0',
   8     'gvdb',
   9     'inotify',
  10     'kqueue',
  11     'libasyncns',
  12     'tests',
  13     'win32',
  14     'xdgmime',
  15     'gappinfoprivate.h',
  16     'gapplicationimpl.h',
  17     'gasynchelper.h',
  18     'gcontenttypeprivate.h',
  19     'gcontextspecificgroup.h',
  20     'gcredentialsprivate.h',
  21     'gdbus-daemon-generated.h',
  22     'gdbusactiongroup-private.h',
  23     'gdbusauth.h',
  24     'gdbusauthmechanismanon.h',
  25     'gdbusauthmechanismexternal.h',
  26     'gdbusauthmechanism.h',
  27     'gdbusauthmechanismsha1.h',
  28     'gdbusdaemon.h',
  29     'gdbusprivate.h',
  30     'gdelayedsettingsbackend.h',
  31     'gdummyfile.h',
  32     'gdummyproxyresolver.h',
  33     'gdummytlsbackend.h',
  34     'gfileattribute-priv.h',
  35     'gfileinfo-priv.h',
  36     'ghttpproxy.h',
  37     'giomodule-priv.h',
  38     'gioprivate.h',
  39     'giowin32-priv.h',
  40     'glocaldirectorymonitor.h',
  41     'glocalfileenumerator.h',
  42     'glocalfile.h',
  43     'glocalfileinfo.h',
  44     'glocalfileinputstream.h',
  45     'glocalfileiostream.h',
  46     'glocalfilemonitor.h',
  47     'glocalfileoutputstream.h',
  48     'glocalvfs.h',
  49     'gmountprivate.h',
  50     'gnativevolumemonitor.h',
  51     'gnetworkingprivate.h',
  52     'gnetworkmonitorbase.h',
  53     'gnetworkmonitornetlink.h',
  54     'gnetworkmonitornm.h',
  55     'gnotificationbackend.h',
  56     'gnotification-private.h',
  57     'gpollfilemonitor.h',
  58     'gregistrysettingsbackend.h',
  59     'gresourcefile.h',
  60     'gsettingsbackendinternal.h',
  61     'gsettings-mapping.h',
  62     'gsettingsschema-internal.h',
  63     'gsocketinputstream.h',
  64     'gsocketoutputstream.h',
  65     'gsocks4aproxy.h',
  66     'gsocks4proxy.h',
  67     'gsocks5proxy.h',
  68     'gsubprocesslauncher-private.h',
  69     'gthreadedresolver.h',
  70     'gunionvolumemonitor.h',
  71     'gunixmount.h',
  72     'gunixresolver.h',
  73     'gunixvolume.h',
  74     'gunixvolumemonitor.h',
  75     'gwin32appinfo.h',
  76     'gwin32inputstream.h',
  77     'gwin32mount.h',
  78     'gwin32outputstream.h',
  79     'gwin32registrykey.h',
  80     'gwin32resolver.h',
  81     'gwin32volumemonitor.h',
  82     'thumbnail-verify.h',
  83     'xdp-dbus.h',
  84   ]
  85   # FIXME: More win32 headers were added to fix building gio-scan
  86
  87   # FIXME: ExampleAnimal docs aren't built
  88
  89   docpath = join_paths(glib_datadir, 'gtk-doc', 'html')
  90   version_conf = configuration_data()
  91   version_conf.set('VERSION', meson.project_version())
  92   configure_file(
  93     input: 'version.xml.in',
  94     output: 'version.xml',
  95     configuration: version_conf
  96   )
  97
  98   gnome.gtkdoc('gio',
  99     main_xml : 'gio-docs.xml',
 100     namespace : 'g',
 101     gobject_typesfile : 'gio.types',
 102     mode : 'none',
 103     dependencies : [libgio_dep, libgobject_dep, libglib_dep],
 104     src_dir : 'gio',
 105     scan_args : [
 106       '--rebuild-types',
 107       '--deprecated-guards=G_DISABLE_DEPRECATED',
 108       '--ignore-decorators=G_GNUC_WARN_UNUSED_RESULT',
 109       '--ignore-headers=' + ' '.join(ignore_headers),
 110     ],
 111     content_files : [
 112       'overview.xml',
 113       'migrating-posix.xml',
 114       'migrating-gnome-vfs.xml',
 115       'migrating-gconf.xml',
 116       'migrating-gdbus.xml',
 117       'gio-querymodules.xml',
 118       'glib-compile-schemas.xml',
 119       'glib-compile-resources.xml',
 120       'gapplication.xml',
 121       'gsettings.xml',
 122       'gresource.xml',
 123       'gdbus.xml',
 124       'gdbus-codegen.xml',
 125     ],
 126     expand_content_files : [
 127       'overview.xml',
 128       'migrating-posix.xml',
 129       'migrating-gnome-vfs.xml',
 130       'migrating-gconf.xml',
 131       'migrating-gdbus.xml',
 132       'gdbus-codegen.xml',
 133     ],
 134     html_assets : [
 135       'gvfs-overview.png',
 136       'menu-example.png',
 137       'menu-model.png',
 138     ],
 139     fixxref_args: [
 140       '--html-dir=' + docpath,
 141       '--extra-dir=' + join_paths(meson.current_build_dir(), '../glib/html'),
 142       '--extra-dir=' + join_paths(meson.current_build_dir(), '../gobject/html'),
 143     ],
 144     install: true
 145   )
 146 endif
 147
 148
 149 if get_option('with-man') != 'no' and xsltproc.found()
 150   manpages = ['gapplication', 'gio-querymodules', 'glib-compile-schemas',
 151               'glib-compile-resources', 'gsettings', 'gresource', 'gdbus',
 152               'gio', 'gdbus-codegen']
 153   foreach page : manpages
 154     custom_target(page + '-man',
 155       input: page + '.xml',
 156       output: page + '.1',
 157       command: xsltproc_command,
 158       install: true,
 159       install_dir: man1_dir)
 160   endforeach
 161 endif