aboutsummaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)AuthorFilesLines
2022-04-24Remove deprecated python3 module.Jussi Pakkanen2-51/+6
2022-04-24docs: Remove deprecated meson.source_root() from localisation page exampleSimon Arlott1-3/+1
Meson already supplies the same value
2022-04-21Allow deprecating an option for a new oneXavier Claessens2-0/+31
2022-04-20vcs_tag: handle non-str / non-file argumentsKirill Isakov1-1/+3
This makes vcs_tag behave like other commands so it accepts not only string and file arguments, but also exe, custom_tgt, and external_program.
2022-04-20vcs_tag: document the already supported file argKirill Isakov1-1/+3
2022-04-19docs: Add documentation on pkgconfig.relocatableFredrik Salomonsson2-0/+39
- Documentation for the pkgconfig.relocatable module option in Builtin-options. Gives an explanation on what it does, usefulness and what error that can occur when using it. - Add pkgconfig.relocatable release snippet. Similar to the documentation in Builtin-options. Just a bit more brief. - Add Pkgconfig to DataTests.test_builtin_options_documented in the docs unit tests.
2022-04-15Add note in docs that multiline f-strings are not supportedPeter Lesslie1-2/+5
Companion to https://github.com/mesonbuild/meson/pull/10284
2022-04-14docs: make upload target depend on building the docsEli Schwartz1-0/+1
Manually running hotdoc's upload command does not guarantee the docs have actually been built.
2022-04-12Update Zrythm entry in Users.mdalex-tee1-1/+1
Fixed broken link and updated outdated description.
2022-04-07docs: YAML: Add `arg_flattening: false` where requiredDaniel Mensinger12-0/+27
2022-04-07docs: refman: Add `arg_flattening` supportDaniel Mensinger8-8/+27
2022-04-07docs: Document argument flatteningDaniel Mensinger1-0/+48
2022-04-07docs: Fix [[true]] --> `true`Daniel Mensinger1-2/+2
2022-04-03Document and test env vars a bit betterJohn Ericson1-6/+6
2022-04-01docs: fix inaccurate description of command targetsEli Schwartz2-2/+2
It isn't possible to have one target depend on a run_target, because those produce no outputs and are always out of date. But the docs didn't specify which types of target are valid here. Correct the docs to align with the implementation. Fixes #10198
2022-03-31docs: note that find_program accepts file objectsEli Schwartz1-4/+6
This was implemented in commit 280346da3ac5904ec097afe89ef45ad34bd4a173 but never properly documented (it predated the version-controlled docs).
2022-03-31docs: correct documentation of shared_library soversionsEli Schwartz1-2/+2
We have always accepted an int here as an alternative to a string, but the initial documentation thought it was only a string.
2022-03-30Add new debug() functionMarvin Scholz2-0/+19
Adds a new debug() function that can be used in the meson.build to log messages to the meson-log.txt that will not be printed to stdout when configuring the project.
2022-03-27Fix typoÖnder Görmez1-1/+1
2022-03-27docs: add missing docs for new pkgconfig featureEli Schwartz1-1/+2
Added in commit 6240920c213fb76b4e4be8b6b59ae3346cbbcf77 and documented in release notes but not in module docs.
2022-03-24Make compilers list per subprojectXavier Claessens2-1/+7
Previously subprojects inherited languages already added by main project, or any previous subproject. This change to have a list of compilers per interpreters, which means that if a subproject does not add 'c' language it won't be able to compile .c files any more, even if main project added the 'c' language. This delays processing list of compilers until the interpreter adds the BuildTarget into its list of targets. That way the interpreter can add missing languages instead of duplicating that logic into BuildTarget for the cython case.
2022-03-22Fix missing ' in custom_target docsrusty-snake1-2/+2
2022-03-22docs/rust: fix markdown titleDylan Baker1-1/+1
VSCode is perfectly happy with the trailing `---`, hotdoc only likes `...` apparently.
2022-03-22interpreter: Make compiler options per-subprojectXavier Claessens2-0/+15
2022-03-22Add ability to add resources to jarsTristan Partin2-0/+38
Previously Meson lacked the ability to add resources to jar files. Fixes #9945
2022-03-21Prepare the 0.62.0 release.0.62.0Jussi Pakkanen33-371/+410
2022-03-20docs: fix incorrect default for test is_parallelEli Schwartz1-1/+1
In the original RefMan 2.0 implementation, this incorrectly started claiming that the default is false. Fixes #10155
2022-03-15Revert "devenv: Set PYTHONPATH where we install python modules"Eli Schwartz2-15/+0
This reverts commit 79c6075b560dbf1c3e4e0b30f1c472dc2086421e. # Conflicts: # docs/markdown/snippets/devenv.md # mesonbuild/modules/python.py # test cases/unit/91 devenv/test-devenv.py PYTHONPATH cannot be reliably determined. The standard use case for installing python modules with Meson is mixed pure sources (at least `__init__.py`) and compiled extension_modules or configured files. Unfortunately that doesn't actually work because python will not load the same package hierarchy from two different directories, one a source directory and one a (mandatory) out of tree build directory. (It kind of can, but you need to do what this test case accidentally stumbled upon, which is namespace packages. Namespace packages are a very specific use case and you are NOT SUPPOSED to use them outside that use case, so people are not going to use them just to circumvent Meson devenv stuff as that would have negative install-time effects.) Adding PYTHONPATH anyway will just lead to documentation commitments which we cannot actually uphold, and confusing issues at time of use because some imports *will* work... and some will *not*. The end result will be a half-created tree of modules which just doesn't work together at all, but because it partially works, users attempting to debug it will spend time wondering why parts of it do import. For any case where the automatic devenv would work correctly, it will also work correctly to use `meson.add_devenv()` a single time, which is very easy to manually get correct and doesn't provide any significant value to automate. In the long run, an uninstalled python package environment will require "editable installs" support.
2022-03-13Merge pull request #9339 from dcbaker/submit/structured_sourcesJussi Pakkanen6-1/+108
Structured Sources
2022-03-09Add new env2mfile command.Jussi Pakkanen2-0/+69
2022-03-09Move dataonly pkgconfig file to datadir/pkgconfigTristan Partin1-0/+4
dataonly files are architecture independent (lib vs lib64 for example). Fixes #9902
2022-03-09install: Add --strip optionXavier Claessens1-0/+5
2022-03-08Revert "Add new env2cross command."Eli Schwartz1-40/+0
This reverts commit e257a870fe5e676c55a2282b0e7fc9be34bba2ac. The PR adding this command had infinitely hanging CI, and now that it is merged to master we cannot get any CI on any PR to succeed.
2022-03-08Add new env2cross command.Jussi Pakkanen1-0/+40
2022-03-07docs: add forgotten documentation for the new openssl dependencyEli Schwartz2-0/+17
2022-03-07docs: document the rust_crate_type build_target keywordDylan Baker1-0/+20
2022-03-07Add support for rust proc-macro cratesDylan Baker1-0/+16
2022-03-07docs: Add a document on using Rust in MesonDylan Baker2-0/+57
This is hardly complete, but it's a start.
2022-03-07docs: Add docs for structured_sourcesDylan Baker4-1/+51
2022-03-06find_program: add a version() method to match the one for dependenciesEli Schwartz2-0/+13
It is often useful to check the found version of a program without checking whether you can successfully find `find_program('foo', required: false, version: '>=XXX')`
2022-03-06i18n.merge_file: do not disable in the absence of gettext toolsEli Schwartz1-0/+15
Disabling targets because the tools used to build them aren't available is a pretty suspicious thing to do. Users who want this are probably, in general, advised to check themselves whether it is possible to build those targets with find_program(..., required: false) The i18n.gettext() invocation is a bit unusual because the product of running it is non-critical files, specifically, translation catalogs. If users don't have the tools needed to build them, they may not be able to use them either, because perhaps they have NLS disabled on their platform or it's difficult to put it in the bootstrap path. So, for this reason, it was made non-fatal and the message catalogs are just not created, and the resulting build is still perfectly usable *unless* you want to use it in another language, at which point it "works" but the text is all inscrutable to the end user, and that's a feature of the target platform. That's an acceptable tradeoff for translation catalogs. It is NOT an acceptable tradeoff for merge_file, which produces desktop files or MIME database catalogs or other files which have crucial roles to perform, without which the software in question simply doesn't work at all. In such cases, this just fails to install crucial files, users report bugs to the project in question, and the project adds `find_program('xgettext')` to guarantee the hard error due to lack of confidence in Meson. Fixes #6165 Fixes #8436
2022-03-06wayland module: Allow building both client and server sidesXavier Claessens1-12/+20
- Change `scope` kwarg to `public` boolean default to false. - Change `side` kwarg to `client` and `server` booleans. - Document returned values - Aggregate in a single unit test because have lots of small tests increases CI time. Fixes: #10040.
2022-03-04[skip ci] fix syntax typoDarren Ng1-1/+1
2022-03-04Add modules kwarg to JNI system depTristan Partin2-3/+24
This allows someone to link against libjvm.so and libjawt.so.
2022-03-03add release snippet for declare_dependencyRemi Thebault1-0/+14
2022-03-03Document D features in `declare_dependency`Remi Thebault1-0/+17
2022-03-02document and raise an error for disallowed combination of install_headers argsEli Schwartz1-2/+5
It makes no sense to specify both: - install_dir, which overrides the -Dincludedir= builtin option - subdir, which suffixes the -Dincludedir= builtin option We've always silently ignored the subdir in this case, which is really surprising if someone actually passed it and expected it to do something. We also confusingly didn't say anything in the documentation about it. Document that the options are incompatible, and explicitly check to see if they are both passed -- if so, raise an error message pointing out that only install_dir should be used. Fixes #10046
2022-03-02Rename JDK system dep to JNITristan Partin3-8/+28
JNI is a more apt name because it currently only supports the JNI. I also believe that CMake uses the terminology JNI here as well. JNI is currently the only way to interact with the JVM through native code, but there is a project called "Project Panama" which aims to be another way for native code to interact with the JVM.
2022-03-01Deprecate java.generate_native_header() in favor of ↵Tristan Partin2-1/+80
java.generate_native_headers() After implementing a much more extensive Java native module than what currently exists in the tests, I found shortcomings. 1. You need to be able to pass multiple Java files. 2. Meson needs more information to better track the generated native headers. 3. Meson wasn't tracking the header files generated from inner classes. This new function should fix all the issues the old function had with room to grow should more functionality need to be added. What I implemented here in this new function is essentially what I have done in the Heterogeneous-Memory Storage Engine's Java bindings.
2022-02-28Allow setting method/separator in environment() and meson.add_devenv()Xavier Claessens3-3/+64