luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-10-31 19:46:16 +01:00
Code Issues Packages Projects Releases Wiki Activity
2aed76fc94
glib/docs/reference/gobject/meson.build

71 lines
1.7 KiB
Meson
Raw Normal View History

Meson: Add missing options and conform to naming guidelines https://bugzilla.gnome.org/show_bug.cgi?id=790837
2017-11-28 16:44:04 +01:00
if get_option('gtk_doc')
meson: Build all docs
2016-12-07 11:28:33 +01:00
subdir('xml')
ignore_headers = [
'tests',
'gatomicarray.h',
docs: Ignore some generated header files Signed-off-by: Philip Withnall <withnall@endlessm.com>
2018-11-23 14:27:04 +01:00
'gobject_probes.h',
meson: Build all docs
2016-12-07 11:28:33 +01:00
'gobject_trace.h',
Define enum types for Unicode enums We want to stop shipping PangoScript in pango, so we need a replacement for the type that used to be provided by pango.
2018-11-19 21:10:09 +01:00
'gtype-private.h',
build: Rename gobjectenumtypes.[ch] to glib-enumtypes.[ch] To reflect the fact that they contain the GObject types for various enums defined in libglib. See https://gitlab.gnome.org/GNOME/glib/merge_requests/481#note_451086. Signed-off-by: Philip Withnall <withnall@endlessm.com> Helps: GNOME/gobject-introspection#267
2019-03-04 12:12:59 +01:00
'glib-enumtypes.h',
Fix symbol visibility macros on Windows There is currently no `dllimport` attribute on any of our function, which prevents MSVC to optimize function calls. To fix that issue, we need to redeclare all our visibility macros for each of our libraries, because when compiling e.g. GIO code, we need dllimport in GLIB headers and dllexport in GIO headers. That means they cannot use the same GLIB_AVAILABLE_* macro. Since that's a lot of boilerplate to copy/paste after each version bump, this MR generate all those macros using a python script. Also simplify the meson side by using `gnu_symbol_visibility : 'hidden'` keyword argument instead of passing the cflag manually. This leaves only API index to add manually into glib-docs.xml when bumping GLib version. That file cannot be generated because Meson does not allow passing a buit file to gnome.gtkdoc()'s main_xml kwarg unfortunately.
2022-10-03 16:36:04 +02:00
'gobject-visibility.h',
meson: Build all docs
2016-12-07 11:28:33 +01:00
]
docpath = join_paths(glib_datadir, 'gtk-doc', 'html')
version_conf = configuration_data()
version_conf.set('GLIB_VERSION', meson.project_version())
configure_file(
input: 'version.xml.in',
output: 'version.xml',
configuration: version_conf
)
Meson: Fix build of gtkdoc This requires change added in Meson 0.44.0 https://bugzilla.gnome.org/show_bug.cgi?id=786796
2017-11-10 02:35:45 +01:00
gtkdocincl = include_directories('.')
meson: Build all docs
2016-12-07 11:28:33 +01:00
gnome.gtkdoc('gobject',
main_xml : 'gobject-docs.xml',
namespace : 'g',
mode : 'none',
dependencies : [libgobject_dep, libglib_dep],
Meson: Fix build of gtkdoc This requires change added in Meson 0.44.0 https://bugzilla.gnome.org/show_bug.cgi?id=786796
2017-11-10 02:35:45 +01:00
include_directories : [gtkdocincl],
meson: Match upstream gtkdoc changes
2016-12-09 19:51:41 +01:00
src_dir : 'gobject',
Fix symbol visibility macros on Windows There is currently no `dllimport` attribute on any of our function, which prevents MSVC to optimize function calls. To fix that issue, we need to redeclare all our visibility macros for each of our libraries, because when compiling e.g. GIO code, we need dllimport in GLIB headers and dllexport in GIO headers. That means they cannot use the same GLIB_AVAILABLE_* macro. Since that's a lot of boilerplate to copy/paste after each version bump, this MR generate all those macros using a python script. Also simplify the meson side by using `gnu_symbol_visibility : 'hidden'` keyword argument instead of passing the cflag manually. This leaves only API index to add manually into glib-docs.xml when bumping GLib version. That file cannot be generated because Meson does not allow passing a buit file to gnome.gtkdoc()'s main_xml kwarg unfortunately.
2022-10-03 16:36:04 +02:00
scan_args : [
'--ignore-decorators=' + '|'.join(ignore_decorators.replace('GLIB', 'GOBJECT')),
doc: Remove gobject.types since gtkdoc-scan rebuild it anyway I'm not sure why gobject.cI was needed but that looks like hack around old gtkdoc bug. Works fine without it.
2018-06-27 17:12:01 +02:00
'--rebuild-types',
meson: Build all docs
2016-12-07 11:28:33 +01:00
'--ignore-headers=' + ' '.join(ignore_headers),
],
content_files : [
'glib-mkenums.xml',
'glib-genmarshal.xml',
'gobject-query.xml',
'tut_gobject.xml',
'tut_gsignal.xml',
'tut_gtype.xml',
'tut_howto.xml',
'tut_intro.xml',
'tut_tools.xml'
],
html_assets : [
'images/glue.png'
],
fixxref_args: [
'--html-dir=' + docpath,
Meson: doc: fix cross references
2018-09-23 22:01:48 +02:00
'--extra-dir=' + join_paths('gobject', '..', 'glib', 'html'),
meson: Build all docs
2016-12-07 11:28:33 +01:00
],
doc: Run gtkdoc-check with unit tests This has the side effect of always rebuilding the doc at each build when gtk_doc option is enabled (not by default). Most importantly, this will enable doc check on our CI.
2019-07-09 21:51:32 +02:00
install: true,
check: true,
meson: Build all docs
2016-12-07 11:28:33 +01:00
)
endif
Meson: Add missing options and conform to naming guidelines https://bugzilla.gnome.org/show_bug.cgi?id=790837
2017-11-28 16:44:04 +01:00
if get_option('man')
meson: Detect with-docs and with-man automatically By default, only build man pages and gtk-doc if the build-deps were found. To force-enable, pass -Dwith-docs=yes and -Dwith-man=yes. Also use a foreach loop for man pages instead of listing them all manually
2017-03-21 12:08:47 +01:00
manpages = ['glib-mkenums', 'glib-genmarshal', 'gobject-query']
foreach page : manpages
custom_target(page + '-man',
input: page + '.xml',
output: page + '.1',
command: xsltproc_command,
install: true,
install_dir: man1_dir)
endforeach
meson: Build all docs
2016-12-07 11:28:33 +01:00
endif
Reference in New Issue Copy Permalink