summaryrefslogtreecommitdiff
path: root/docs/markdown/Gnome-module.md
AgeCommit message (Collapse)Author
2023-09-09gnome.mkenum_simple(): Fix include path when header is in subdirXavier Claessens
It was generating #include with the basename of every header file. That assumes that every directory where there are headers are also included into search path when compiling the .c file. Change to use path relative to current subdir, which can be both in build or source directory. That means that we assume that when the .c file is compiled, the target has a include_directories pointing to the directory where gnome.mkenum_simple() has been called, which is generally '.' and added automatically. Also fix type annotation to only allow str and File sources, other types have never been working, it would require to iterate over custom target outputs, etc. Fixes: #7582
2023-05-23docs: gnome: mention that compile_resources adds dependencies by defaultPablo Correa Gómez
It is not very clear from the documentation that the dependencies in the resource file are added as default dependencies to the target.
2023-04-26Add env kwarg to gnome.generate_gir().Volker Weißmann
Fixes #384
2022-09-28gnome: add support for update-mime-databasePaolo Borelli
Fixes https://github.com/mesonbuild/meson/issues/10865
2022-01-31gnome: add documentation for new kwargsEli Schwartz
This was forgotten in commit bc8c938148a55910dd1bd454fc3c5e8ab7477baa -- sorry!
2022-01-15gnome.genmarshal: restore the ability to pass sources as Files objectsEli Schwartz
It used to support: - a single string - an array of anything And as long as CustomTarget supported it too, everything worked fine. So, a `files('foo')` worked but a `files('foo')[0]` did not, which is silly... and it's not exactly terrible to use files() here, the input is literally a list of source files. Fixes building gnome-terminal Fixes #9827 Test updated by Nirbheek Chauhan <nirbheek@centricular.com>
2022-01-02docs: Update yelp documentation to reflect what it is actually doingPablo Correa Gómez
2021-12-07gnome/genmarshal: Add missing kwargs to permittedKwargsDylan Baker
There are thee arguments that are passed directly to CustomTarget which are not in the permittedKwargs: depends, depend_files, and build_always. The first two are obviously generically useful, as they allow creating correct ordering. The latter, not so much. Since it was an error to pass it, we'll just delete it.
2021-12-06gnome module: document and fix install_dir x3, by allowing false *_gir and ↵Eli Schwartz
*_typelib generate_gir forces building both the typelib and gir, and some people only want one or the other (probably only the typelib?) which means flagging the other as install_dir: false in the same way custom_target supports. As this always worked, albeit undocumented, make sure it keeps working. It's pretty reasonable to allow, anyway. Fixes https://github.com/mesonbuild/meson/pull/9484#issuecomment-980131791
2021-12-01gnome module: document that yelp(languages: ...) is deprecatedEli Schwartz
If you use it, we emit a warning telling you to use LINGUAS instead. So we should warn people in the documentation as well. Fixes #9495
2021-11-08modules/gnome: use typed_kwargs for compile_resourcesDylan Baker
2021-10-07modules/gnome: deprecate yelp variadic sourcesDylan Baker
Yelp currently can take sources two different ways, the first is via variadic arguments, the second is by a keyword argument. If the keyword is passed then the variadic arguments are silently ignored, which is obviously not ideal. Fortunately the variadic form was never documented, and is likely not in wide use. This patch fixes it by deprecating the variadic form, and warning if both are passed. It does not change behavior as someone may be relying on it.
2021-10-03docs: Fix broken linksDaniel Mensinger
2021-06-23gnome: add update_desktop_database to post_install()Xavier Claessens
2021-02-05gnome: Add post_install() methodXavier Claessens
Various GNOME projects have scripts that does similar task, better do it directly in meson. This ensures it's done correctly regarding usage of subprojects and pkg-config. See for example this gtk bug: https://gitlab.gnome.org/GNOME/gtk/-/issues/3626. Fixes: #8268
2021-01-30Rewrap long text lines in docs. [skip ci]Jussi Pakkanen
2020-06-18docs: replaced `ninja` with appropriate `meson` commands [skip ci]TheQwertiest
2020-06-16gnome: Add fatal_warnings kwarg to generate_gir()Xavier Claessens
Fixes: #7130
2020-06-13Tweak gnome.gtkdoc() documentation for clarity and grammarJon Turney
2020-06-12docs: remove duplicated entry for gnome.generate_gir() documentation [skip ci]坂本 貴史
The documentation of gnome.generate_gir() has duplicated entry for dependencies parameter. As a fix, this patch removes the entry added recently. Fixes: 893d101fff01 ("gnome: Add header kwarg to generate_gir()") Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>
2019-10-19docs: Fix some incorrect links [skip ci]Anton Leontiev
2019-07-16gtkdoc: Add 'check' kwarg (#5591)Xavier Claessens
* gtkdoc: Add 'check' kwarg This runs gtkdoc-check in meson tests. Also reorganize the gtkdoc test because we cannot reliably build multiple doc into the same directory. Not all files generated by gtk-doc are prefixed with the target name.
2018-11-20docs: Add missing `namespace` parameter documentation [skip ci]Iñigo Martínez
Although the `namespace` parameter was implemented in 0.37, its documentation is still missing. It has been added to the `gtkdoc`'s documentation.
2018-09-21gnome: add support for `module_version`Marco Trevisan (Treviño)
gtk-doc for autotools has the concept of module version, that is used to define the module install path and the devhelp2 basename. Add a `module_version` parameter to gnome.gtkdoc to replicate the same behavior. Updated the test checking that the install_dir is properly computed (if not passed), and that the .devhelp2 file has proper name. https://gitlab.gnome.org/GNOME/gtk-doc/blob/GTK_DOC_1_29/buildsystems/autotools/gtk-doc.make#L269
2018-09-21docs, Gnome-module: document include_directories in gtkdocMarco Trevisan (Treviño)
This parameter is supported for some time but has never been documented.
2018-09-17gnome.gtkdoc: Add new c_args parameterIñigo Martínez
gtkdoc-scangobj also accepts compiler arguments. In the same way that include_directories includes directories, the new c_args parameter also appends compiler arguments.
2018-08-09gnome.generate_gir: support generating gir for multiple librariesMathieu Duponchelle
Fixes #3688
2018-07-11docs: Minor clarifications of gnome.compile_resourcesTingPing
This was causing confusion for a user about the fact any directory can be passed
2018-06-08gdbus_codegen: Support --c-generate-autocleanupRobert Ancell
2018-06-07gdbus_codegen: Support arbitrary extra argumentsRobert Ancell
2018-04-20docs: Update gnome.gdbus-codegen docsNirbheek Chauhan
2018-04-11gdbus_codegen: Return 2 targets when docbook is disabledNirbheek Chauhan
Also document this behaviour, test it, and fix the return value from the module -- we create one target and return it thrice to the build file
2018-04-11gnome: Split header and code targets in gdbus_codegen()Iñigo Martínez
The development version of `glib` (2.55.2) has acquired support for generating gdbus header and source code files separately. This allows dependencies to be more fine grained on those targets depending only on the header.
2018-03-07Gnome-module.md: Add information about output files to mkenums()Eduardo Lima (Etrunko)
[skip ci]
2018-02-13Add an example for gresourceDaniel Foré
2017-12-13Enable re-compilation of GNOME gschema files if they have changed.Michael James Gratton
* mesonbuild/modules/gnome.py (GnomeModule.compile_schemas): Allow the depend_files kwarg. * docs/markdown/Gnome-module.md: Add docs for new kwarg (and the only other one that is permitted).
2017-10-08gnome: g-ir-scanner accepts multiple symbol-prefix argumentsRico Tzschichholz
2017-10-05docs: Use consistent whitespace for gnome kwargsTingPing
2017-10-01gnome: Add header kwarg to generate_gir()Patrick Griffis
This is a commonly used flag so lets make it more obvious.
2017-09-12gnome: Docbook generation for gdbus_codegen()Iñigo Martínez
Add new 'docbook' argument which generates Docbook documentation for each D-Bus interface. The docbook argument will be used as prefix in `PREFIX`-NAME.xml pattern, and NAME will be replaced by the D-Bus interfaces.
2017-09-04gnome.gdbus_codegen(): Add annotations keywordPatrick Griffis
Fixes #2123
2017-08-21Rewrapped and alphabetized the Gnome module.Jussi Pakkanen
2017-08-14gnome: add mkenums_simple()Tim-Philipp Müller
99% of all mkenums uses in C libraries use the same basic template, so add a mkenums_simple() function that takes care of everything for us based on that template. Features: - optional function declaration decorator such as GLIB_AVAILABLE - optional extra header prefix (e.g. for include needed for decorator) - optional extra body prefix (e.g. for additional includes) - optional function name prefix (e.g. to add leading underscores) Fixes issue #1384
2017-08-13gnome: add 'ignore_headers' to permitted kwarg list for gnome.gtkdoc()Tim-Philipp Müller
2017-07-23Document the newly added gnome.genmarshal() argumentEmmanuele Bassi
2017-07-17gnome.gtkdoc: Handle absolute install_dirs correctlyNirbheek Chauhan
Must prepend DESTDIR in case it's absolute. Also document that by default it is relative to the gtk-doc html directory.
2017-06-22docs: Fix version referencePatrick Griffis
2017-06-10gnome.yelp(): Default symlink_media to truePatrick Griffis
2017-06-08Document that the gnome.generate_vapi() function can install the .vapiSam Thursfield
2017-06-07Document the mkdb_args argument for gnome.gtkdoc()Emmanuele Bassi
Include the newly added argument.