gnome-shell/docs/reference/shell/meson.build

private_headers = [
  'gactionmuxer.h',
  'gactionobservable.h',
  'gactionobserver.h',
  'shell-network-agent.h',
  'shell-recorder-src.h'
]

if not enable_recorder
  private_headers += 'shell-recorder.h'
endif

exclude_directories = [
  'calendar-server',
  'hotplug-sniffer',
  'st',
  'tray'
]

ifaces = [
  ['org.gnome.Shell.Screenshot', 'org.gnome.Shell.Screenshot.xml'],
  ['org.gnome.ShellSearchProvider', 'org.gnome.Shell.SearchProvider.xml'],
  ['org.gnome.ShellSearchProvider2', 'org.gnome.Shell.SearchProvider2.xml']
]
foreach iface : ifaces
  custom_target(iface[0] + ' docs',
    input: '../../../data/@0@.xml'.format(iface[0]),
    output: 'doc-gen-' + iface[1],
    command: [
      'gdbus-codegen',
      '--interface-prefix=@0@.'.format(iface),
      '--generate-docbook', 'doc-gen',
      '--output-directory', '@OUTDIR@',
      '@INPUT@'
    ],
    build_by_default: true
  )
endforeach

configure_file(
  input: 'version.xml.in',
  output: 'version.xml',
  configuration: version_conf
)

gnome.gtkdoc('shell',
  main_sgml: 'shell-docs.sgml',
  src_dir: [
    join_paths(meson.source_root(), 'src'),
    join_paths(meson.build_root(), 'src')
  ],
  scan_args: [
    '--ignore-headers=' + ' '.join(private_headers + exclude_directories)
  ],
  install: true
)