Build documentation with hotdoc
[platform/upstream/gstreamer.git] / meson.build
1 project('All GStreamer modules', 'c',
2   version : '1.17.0.1',
3   meson_version : '>= 0.48.0',
4   default_options : ['buildtype=debugoptimized'])
5
6 gst_version = '>= @0@'.format(meson.project_version())
7 gst_branch = 'master'
8
9 glib_req = '>= 2.40.0'
10
11 build_system = build_machine.system()
12 cc = meson.get_compiler('c')
13
14 documented_projects = ''
15 # Make it possible to use msys2 built zlib which fails
16 # when not using the mingw toolchain as it uses unistd.h
17 if not meson.is_subproject() and cc.get_id() == 'msvc'
18   uname = find_program('uname', required: false)
19   if uname.found()
20     ret = run_command(uname, '-o')
21     if ret.returncode() == 0 and ret.stdout().to_lower() == 'msys'
22       ret = run_command(uname, '-r')
23       # The kernel version returned by uname is actually the msys version
24       if ret.returncode() == 0 and ret.stdout().startswith('2')
25         # If a system zlib is found, disable UNIX features in zlib.h and zconf.h
26         if cc.find_library('z').found()
27           add_global_arguments('-DZ_SOLO', language: 'c')
28         endif
29       endif
30     endif
31   endif
32 endif
33
34 # Ordered list of subprojects (dict has no ordering guarantees)
35 subprojects = [
36   ['gstreamer', {'build-hotdoc': true}],
37   ['gst-plugins-base', {'build-hotdoc': true}],
38   ['gst-plugins-good', {'build-hotdoc': true}],
39   ['libnice', { 'option': get_option('libnice'), 'match_gst_version': false}],
40   ['gst-plugins-bad', { 'option': get_option('bad'), 'build-hotdoc': true }],
41   ['gst-plugins-ugly', { 'option': get_option('ugly'), 'build-hotdoc': true }],
42   ['gst-libav', { 'option': get_option('libav'), 'build-hotdoc': true }],
43   ['gst-rtsp-server', { 'option': get_option('rtsp_server'), 'build-hotdoc': true }],
44   ['gst-devtools', { 'option': get_option('devtools'), 'build-hotdoc': true }],
45   ['gst-integration-testsuites', { 'option': get_option('devtools') }],
46   ['gst-editing-services', { 'option': get_option('ges'), 'build-hotdoc': true }],
47   ['gstreamer-vaapi', { 'option': get_option('vaapi'), 'build-hotdoc': true }],
48   ['gst-omx', { 'option': get_option('omx'), 'build-hotdoc': true, }],
49   ['gstreamer-sharp', { 'option': get_option('sharp') }],
50   ['pygobject', { 'option': get_option('python'), 'match_gst_version': false }],
51   ['gst-python', { 'option': get_option('python') }],
52 ]
53
54 python3 = import('python').find_installation()
55 symlink = '''
56 import os
57
58 os.symlink(os.path.join('@1@', 'subprojects', '@0@'),
59   os.path.join('@1@', '@0@'))
60 '''
61
62 if build_system == 'windows'
63   subproject('win-flex-bison-binaries')
64   subproject('win-nasm')
65 endif
66
67 subproject('orc', required: get_option('orc'))
68
69 subprojects_names = []
70 all_plugins = []
71 foreach sp : subprojects
72   project_name = sp[0]
73   build_infos = sp[1]
74   is_required = build_infos.get('option', true)
75   match_gst_version = build_infos.get('match_gst_version', true)
76
77   if match_gst_version
78     subproj = subproject(project_name, version: gst_version, required: is_required)
79   else
80     subproj = subproject(project_name, required: is_required)
81   endif
82
83   if subproj.found()
84     if build_infos.has_key('build-hotdoc', default: false)
85       foreach plugin: subproj.get_variable('plugins')
86         all_plugins += plugin.full_path()
87       endforeach
88       if documented_projects != ''
89         documented_projects += ','
90       endif
91
92       documented_projects += project_name
93     endif
94     documented_projects  += project_name
95
96     subprojects_names += [project_name]
97     cmdres = run_command(python3, '-c', symlink.format(project_name, meson.current_source_dir()))
98     if cmdres.returncode() == 0
99       message('Created symlink to ' + project_name)
100     endif
101   endif
102 endforeach
103
104 foreach custom_subproj: get_option('custom_subprojects').split(',')
105     if custom_subproj != ''
106         message ('Adding custom subproject ' + custom_subproj)
107         subproject(custom_subproj)
108         subprojects_names += [custom_subproj]
109     endif
110 endforeach
111
112 if build_machine.system() == 'windows'
113   message('Disabling hotdoc while building on Windows')
114 else
115   hotdoc_p = find_program('hotdoc', required : get_option('doc'))
116   if hotdoc_p.found()
117     if documented_projects != ''
118         subproject('gst-docs', default_options: 'built_subprojects=' + documented_projects)
119       message('Gst docs subprojects: ' + documented_projects)
120     endif
121   else
122     message('Not building documentation as hotdoc was not found')
123   endif
124 endif
125
126 message('Building subprojects: ' + ', '.join(subprojects_names))
127 setenv = find_program('gst-uninstalled.py')
128 run_target('uninstalled', command : [setenv, '--builddir=@0@'.format(meson.build_root()),
129            '--srcdir=@0@'.format(meson.source_root())])
130
131 update = find_program('git-update')
132 run_target('git-update', command : [update])
133 run_target('update', command : [update,
134     '--builddir=@0@'.format(meson.current_build_dir())])