docs/reference/gio/meson.build

   1 if get_option('gtk_doc')
   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     'gnetworkmonitorportal.h',
  56     'gnotificationbackend.h',
  57     'gnotification-private.h',
  58     'gosxappinfo.h',
  59     'gpollfilemonitor.h',
  60     'gproxyresolverportal.h',
  61     'gregistrysettingsbackend.h',
  62     'gresourcefile.h',
  63     'gsettingsbackendinternal.h',
  64     'gsettings-mapping.h',
  65     'gsettingsschema-internal.h',
  66     'gsocketinputstream.h',
  67     'gsocketoutputstream.h',
  68     'gsocks4aproxy.h',
  69     'gsocks4proxy.h',
  70     'gsocks5proxy.h',
  71     'gsubprocesslauncher-private.h',
  72     'gthreadedresolver.h',
  73     'gunionvolumemonitor.h',
  74     'gunixmount.h',
  75     'gunixresolver.h',
  76     'gunixvolume.h',
  77     'gunixvolumemonitor.h',
  78     'gwin32appinfo.h',
  79     'gwin32inputstream.h',
  80     'gwin32mount.h',
  81     'gwin32outputstream.h',
  82     'gwin32registrykey.h',
  83     'gwin32resolver.h',
  84     'gwin32volumemonitor.h',
  85     'thumbnail-verify.h',
  86     'xdp-dbus.h',
  87   ]
  88
  89   ignore_decorators = [
  90     'GLIB_VAR',
  91     'G_GNUC_INTERNAL',
  92     'G_GNUC_WARN_UNUSED_RESULT',
  93     'GLIB_AVAILABLE_IN_ALL',
  94     'GLIB_AVAILABLE_IN_2_26',
  95     'GLIB_AVAILABLE_IN_2_28',
  96     'GLIB_AVAILABLE_IN_2_30',
  97     'GLIB_AVAILABLE_IN_2_32',
  98     'GLIB_AVAILABLE_IN_2_34',
  99     'GLIB_AVAILABLE_IN_2_36',
 100     'GLIB_AVAILABLE_IN_2_38',
 101     'GLIB_AVAILABLE_IN_2_40',
 102     'GLIB_AVAILABLE_IN_2_42',
 103     'GLIB_AVAILABLE_IN_2_44',
 104     'GLIB_AVAILABLE_IN_2_46',
 105     'GLIB_AVAILABLE_IN_2_48',
 106     'GLIB_AVAILABLE_IN_2_50',
 107     'GLIB_AVAILABLE_IN_2_52',
 108     'GLIB_AVAILABLE_IN_2_54',
 109     'GLIB_AVAILABLE_IN_2_56',
 110     'GLIB_DEPRECATED_IN_2_26',
 111     'GLIB_DEPRECATED_IN_2_26_FOR',
 112     'GLIB_DEPRECATED_IN_2_28',
 113     'GLIB_DEPRECATED_IN_2_28_FOR',
 114     'GLIB_DEPRECATED_IN_2_30',
 115     'GLIB_DEPRECATED_IN_2_30_FOR',
 116     'GLIB_DEPRECATED_IN_2_32',
 117     'GLIB_DEPRECATED_IN_2_32_FOR',
 118     'GLIB_DEPRECATED_IN_2_34',
 119     'GLIB_DEPRECATED_IN_2_34_FOR',
 120     'GLIB_DEPRECATED_IN_2_36',
 121     'GLIB_DEPRECATED_IN_2_36_FOR',
 122     'GLIB_DEPRECATED_IN_2_38',
 123     'GLIB_DEPRECATED_IN_2_38_FOR',
 124     'GLIB_DEPRECATED_IN_2_40',
 125     'GLIB_DEPRECATED_IN_2_40_FOR',
 126     'GLIB_DEPRECATED_IN_2_42',
 127     'GLIB_DEPRECATED_IN_2_42_FOR',
 128     'GLIB_DEPRECATED_IN_2_44',
 129     'GLIB_DEPRECATED_IN_2_44_FOR',
 130     'GLIB_DEPRECATED_IN_2_46',
 131     'GLIB_DEPRECATED_IN_2_46_FOR',
 132     'GLIB_DEPRECATED_IN_2_48',
 133     'GLIB_DEPRECATED_IN_2_48_FOR',
 134     'GLIB_DEPRECATED_IN_2_50',
 135     'GLIB_DEPRECATED_IN_2_50_FOR',
 136     'GLIB_DEPRECATED_IN_2_52',
 137     'GLIB_DEPRECATED_IN_2_52_FOR',
 138     'GLIB_DEPRECATED_IN_2_54',
 139     'GLIB_DEPRECATED_IN_2_54_FOR',
 140     'GLIB_DEPRECATED_IN_2_56',
 141     'GLIB_DEPRECATED_IN_2_56_FOR',
 142   ]
 143
 144   # FIXME: More win32 headers were added to fix building gio-scan
 145
 146   # FIXME: ExampleAnimal docs aren't built
 147
 148   docpath = join_paths(glib_datadir, 'gtk-doc', 'html')
 149   version_conf = configuration_data()
 150   version_conf.set('VERSION', meson.project_version())
 151   configure_file(
 152     input: 'version.xml.in',
 153     output: 'version.xml',
 154     configuration: version_conf
 155   )
 156
 157   gnome.gtkdoc('gio',
 158     main_xml : 'gio-docs.xml',
 159     namespace : 'g',
 160     gobject_typesfile : 'gio.types',
 161     mode : 'none',
 162     dependencies : [libgio_dep, libgobject_dep, libglib_dep],
 163     src_dir : 'gio',
 164     scan_args : [
 165       '--rebuild-types',
 166       '--deprecated-guards=G_DISABLE_DEPRECATED',
 167       '--ignore-decorators=' + '|'.join(ignore_decorators),
 168       '--ignore-headers=' + ' '.join(ignore_headers),
 169     ],
 170     content_files : [
 171       'overview.xml',
 172       'migrating-posix.xml',
 173       'migrating-gnome-vfs.xml',
 174       'migrating-gconf.xml',
 175       'migrating-gdbus.xml',
 176       'gio-querymodules.xml',
 177       'glib-compile-schemas.xml',
 178       'glib-compile-resources.xml',
 179       'gapplication.xml',
 180       'gsettings.xml',
 181       'gresource.xml',
 182       'gdbus.xml',
 183       'gdbus-codegen.xml',
 184     ],
 185     expand_content_files : [
 186       'overview.xml',
 187       'migrating-posix.xml',
 188       'migrating-gnome-vfs.xml',
 189       'migrating-gconf.xml',
 190       'migrating-gdbus.xml',
 191       'gdbus-codegen.xml',
 192     ],
 193     html_assets : [
 194       'gvfs-overview.png',
 195       'menu-example.png',
 196       'menu-model.png',
 197     ],
 198     fixxref_args: [
 199       '--html-dir=' + docpath,
 200       '--extra-dir=' + join_paths(meson.current_build_dir(), '../glib/html'),
 201       '--extra-dir=' + join_paths(meson.current_build_dir(), '../gobject/html'),
 202     ],
 203     install: true
 204   )
 205 endif
 206
 207
 208 if get_option('man')
 209   manpages = ['gapplication', 'gio-querymodules', 'glib-compile-schemas',
 210               'glib-compile-resources', 'gsettings', 'gresource', 'gdbus',
 211               'gio', 'gdbus-codegen']
 212   foreach page : manpages
 213     custom_target(page + '-man',
 214       input: page + '.xml',
 215       output: page + '.1',
 216       command: xsltproc_command,
 217       install: true,
 218       install_dir: man1_dir)
 219   endforeach
 220 endif