docs/reference/gobject/meson.build

   1 if get_option('gtk_doc')
   2   subdir('xml')
   3
   4   ignore_headers = [
   5     'tests',
   6     'gatomicarray.h',
   7     'gobject_trace.h',
   8     'gtype-private.h'
   9   ]
  10
  11   ignore_decorators = [
  12     'GLIB_VAR',
  13     'G_GNUC_INTERNAL',
  14     'G_GNUC_WARN_UNUSED_RESULT',
  15     'GLIB_AVAILABLE_IN_ALL',
  16     'GLIB_AVAILABLE_IN_2_26',
  17     'GLIB_AVAILABLE_IN_2_28',
  18     'GLIB_AVAILABLE_IN_2_30',
  19     'GLIB_AVAILABLE_IN_2_32',
  20     'GLIB_AVAILABLE_IN_2_34',
  21     'GLIB_AVAILABLE_IN_2_36',
  22     'GLIB_AVAILABLE_IN_2_38',
  23     'GLIB_AVAILABLE_IN_2_40',
  24     'GLIB_AVAILABLE_IN_2_42',
  25     'GLIB_AVAILABLE_IN_2_44',
  26     'GLIB_AVAILABLE_IN_2_46',
  27     'GLIB_AVAILABLE_IN_2_48',
  28     'GLIB_AVAILABLE_IN_2_50',
  29     'GLIB_AVAILABLE_IN_2_52',
  30     'GLIB_AVAILABLE_IN_2_54',
  31     'GLIB_AVAILABLE_IN_2_56',
  32     'GLIB_DEPRECATED_IN_2_26',
  33     'GLIB_DEPRECATED_IN_2_26_FOR',
  34     'GLIB_DEPRECATED_IN_2_28',
  35     'GLIB_DEPRECATED_IN_2_28_FOR',
  36     'GLIB_DEPRECATED_IN_2_30',
  37     'GLIB_DEPRECATED_IN_2_30_FOR',
  38     'GLIB_DEPRECATED_IN_2_32',
  39     'GLIB_DEPRECATED_IN_2_32_FOR',
  40     'GLIB_DEPRECATED_IN_2_34',
  41     'GLIB_DEPRECATED_IN_2_34_FOR',
  42     'GLIB_DEPRECATED_IN_2_36',
  43     'GLIB_DEPRECATED_IN_2_36_FOR',
  44     'GLIB_DEPRECATED_IN_2_38',
  45     'GLIB_DEPRECATED_IN_2_38_FOR',
  46     'GLIB_DEPRECATED_IN_2_40',
  47     'GLIB_DEPRECATED_IN_2_40_FOR',
  48     'GLIB_DEPRECATED_IN_2_42',
  49     'GLIB_DEPRECATED_IN_2_42_FOR',
  50     'GLIB_DEPRECATED_IN_2_44',
  51     'GLIB_DEPRECATED_IN_2_44_FOR',
  52     'GLIB_DEPRECATED_IN_2_46',
  53     'GLIB_DEPRECATED_IN_2_46_FOR',
  54     'GLIB_DEPRECATED_IN_2_48',
  55     'GLIB_DEPRECATED_IN_2_48_FOR',
  56     'GLIB_DEPRECATED_IN_2_50',
  57     'GLIB_DEPRECATED_IN_2_50_FOR',
  58     'GLIB_DEPRECATED_IN_2_52',
  59     'GLIB_DEPRECATED_IN_2_52_FOR',
  60     'GLIB_DEPRECATED_IN_2_54',
  61     'GLIB_DEPRECATED_IN_2_54_FOR',
  62     'GLIB_DEPRECATED_IN_2_56',
  63     'GLIB_DEPRECATED_IN_2_56_FOR',
  64   ]
  65
  66   docpath = join_paths(glib_datadir, 'gtk-doc', 'html')
  67   version_conf = configuration_data()
  68   version_conf.set('GLIB_VERSION', meson.project_version())
  69   configure_file(
  70     input: 'version.xml.in',
  71     output: 'version.xml',
  72     configuration: version_conf
  73   )
  74
  75   gtkdocincl = include_directories('.')
  76
  77   gnome.gtkdoc('gobject',
  78     main_xml : 'gobject-docs.xml',
  79     namespace : 'g',
  80     gobject_typesfile : join_paths(meson.current_source_dir(), 'gobject.types'),
  81     mode : 'none',
  82     dependencies : [libgobject_dep, libglib_dep],
  83     include_directories : [gtkdocincl],
  84     src_dir : 'gobject',
  85     scan_args : [
  86       '--deprecated-guards=G_DISABLE_DEPRECATED',
  87       '--ignore-decorators=' + '|'.join(ignore_decorators),
  88       '--ignore-headers=' + ' '.join(ignore_headers),
  89     ],
  90     content_files : [
  91       'glib-mkenums.xml',
  92       'glib-genmarshal.xml',
  93       'gobject-query.xml',
  94       'tut_gobject.xml',
  95       'tut_gsignal.xml',
  96       'tut_gtype.xml',
  97       'tut_howto.xml',
  98       'tut_intro.xml',
  99       'tut_tools.xml'
 100     ],
 101     html_assets : [
 102       'images/glue.png'
 103     ],
 104     fixxref_args: [
 105       '--html-dir=' + docpath,
 106       '--extra-dir=' + join_paths(meson.current_build_dir(), '../glib/html'),
 107     ],
 108     install: true
 109   )
 110 endif
 111
 112 if get_option('man')
 113   manpages = ['glib-mkenums', 'glib-genmarshal', 'gobject-query']
 114   foreach page : manpages
 115     custom_target(page + '-man',
 116       input: page + '.xml',
 117       output: page + '.1',
 118       command: xsltproc_command,
 119       install: true,
 120       install_dir: man1_dir)
 121   endforeach
 122 endif