aboutsummaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)AuthorFilesLines
2024-10-17Update release notes for 1.6.0.Aditya Vidyadhar Kamath1-0/+7
Closes: #13773.
2024-10-11cargo: Document that cargo subprojects is an experimental featureXavier Claessens2-0/+14
2024-10-11Add options for standard parameter for nvc and nvc++Kevin Meagher1-0/+6
fixes #13271
2024-10-05docs: Add windres to cross-compiling exampleandy59951-0/+1
2024-10-04docs: Mention that rust edition/standard 2018 or later should be usedDylan Baker1-1/+3
As the 2018 standard changes the way rust handles externs, and is the first edition that allows `--extern crate=path` to completely replace (in all but a few corner cases) the use of `extern crate` in the rust files.
2024-10-02Document the .kernel() and .subsystem() methodsDylan Baker1-0/+21
Which were added in Meson 1.2, but don't have entires in the reference manual.
2024-10-02docs: Use examples for build_machine.cpu() that genuinely existSimon McVittie1-1/+1
Previously, the documentation said that the CPU name might be amd64, but in fact x86_64 (AMD64) machines are detected as x86_64 in both cpu() and cpu_family() during native builds. Reference: https://buildd.debian.org/status/fetch.php?pkg=libglvnd&arch=amd64&ver=1.7.0-1%2Bb1&stamp=1714222481&raw=0 Instead, mention the only common case for more-specific CPU names other than 32-bit x86, namely 32-bit ARM. On Debian's autobuilders (which are running 32-bit user-space on a 64-bit-capable CPU), native builds genuinely do present as `armv8l`: https://buildd.debian.org/status/fetch.php?pkg=libglvnd&arch=armhf&ver=1.7.0-1%2Bb1&stamp=1714223924&raw=0 On other machines, they might be some older CPU functionality level. At the time of writing, cpu() *can* return amd64 when using `meson env2mfile` on Debian systems, but I think that's a bug in env2mfile (#13742). Signed-off-by: Simon McVittie <smcv@debian.org>
2024-10-01Add a simple reproducibility test command.Jussi Pakkanen2-0/+43
2024-09-29docs: update the Visual Studio guide for the post-0.59 era with automatic vsenvEli Schwartz1-3/+11
For many years now, meson hasn't required manually entering a Visual Studio command prompt but has autodetected it. This confuses some readers of this outdated documentation into thinking it is much harder than it is.
2024-09-24linkers: basic support for the 'zig cc' linkerAndrei Alexeyev2-0/+19
2024-09-24qt module: allow has_tools to specify which tools to checkPierre Lamot2-0/+15
This allows checking for tools that may not be available in older version of qt or avoiding requesting tools that may not be necessary for a given project Co-authored-by: Nirbheek Chauhan <nirbheek@centricular.com>
2024-09-21add doc snippetunknown1-0/+3
2024-09-21add descriptionunknown1-0/+28
2024-09-21Document get_variable(system)unknown3-3/+11
2024-09-19Fix typosspaette3-4/+4
2024-09-14Fix various incorrect uses of `its` vs `it's`.Andrew McNulty1-2/+2
These errors can make reading comments and documentation unnecessarily confusing for users and contributors who do not speak English as their first language.
2024-09-12add epiphanyspaette1-0/+1
2024-09-11Fix typosspaette11-12/+12
2024-09-11Harmonize d_import_dirs and include_directories behavior.Andrew McNulty1-2/+5
This commit harmonizes the handling of `d_import_dirs` and `include_directories`. The treatment of `d_import_dirs` was also different depending on the context: in `declare_dependency` it was treated like the `include_directories`, but in `build_target` et al, it had special treatment. With this commit, they are all treated by the same function. The documentation has been updated to reflect this. Fixes #12742
2024-09-06alias_target with both_libs builds bothCharles Brunet4-0/+41
2024-09-06auto select static or shared when linking both_libraries togetherCharles Brunet2-0/+10
2024-09-06add default_both_libraries core optionCharles Brunet2-0/+15
2024-09-04docs: Update descriptions of `host_machine.system()` about WindowsLIU Hao1-2/+2
There are two environments on Windows: * When invoked in a Cygwin or MSYS2 MSYS shell, `host_machine.system()` returns `cygwin`. * When invoked in a MSYS2 MINGW32/MINGW64/UCRT64/CLANG64/etc., `host_machine.system()` returns `windows`.
2024-09-03fix a typoyehor1-1/+1
2024-08-30Feature checks: fall back to reporting insufficiently portable featuresEli Schwartz1-0/+29
When projects do not specify a minimum meson version, we used to avoid giving them the benefit of the Feature checks framework. Instead: - warn for features that were added after the most recent semver bump, since they aren't portable to the range of versions people might use these days - warn for features that were deprecated before the upcoming semver bump, i.e. all deprecated features, since they aren't portable to upcoming semver-compatible versions people might be imminently upgrading to
2024-08-30Extend MESON_TESTTHREADS usageMarek Pikuła1-0/+4
Previously, setting `MESON_TESTTHREADS` to a number lower than 1 resulted in unexpected behavior. This commit introduces test for negative value (with fallback to 1), and fallback to core count in case it is set to 0. It improves experience in job-matrix type of CI workflows, where some jobs within the matrix require single job execution, whereas others can default to taking core count as the job count. Signed-off-by: Marek Pikuła <m.pikula@partner.samsung.com>
2024-08-27Allow external programs in test()'s 'args' parameterDavid Gibson2-1/+11
Although it's not especially common, there are certainly cases where it's useful to pass the path to an external program to a test program. Fixes: https://github.com/mesonbuild/meson/issues/3552 Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
2024-08-12docs: fix a few grammar and formatting issuesDmitry V. Levin3-4/+4
2024-08-05docs: fix example for feature.requireMarvin Scholz1-1/+1
The example incorrectly uses `then` after the if condition, which is incorrect meson syntax as meson does not support a `then` keyword.
2024-08-04docs: document prefer_static effect on dependency()Sertonix1-1/+3
Ref https://github.com/mesonbuild/meson/pull/9603
2024-07-28add initial support for llvm-flangH. Vetinari3-3/+13
2024-07-22docs: make tutorial compatible with GLib versions older than 2.74LegStrong1-0/+4
2024-07-18Link include_directories to implicit_include_directoriesEnrico Zini1-1/+3
2024-07-15cmake: Only propagate interface link flags in depJonathon Anderson1-0/+8
CMake has two target properties, LINK_OPTIONS and INTERFACE_LINK_OPTIONS. The former is for link flags that apply only to the target (PRIVATE). The latter is used for link flags that propagate to dependents (PUBLIC or INTERFACE). Meson currently propagates all flags, PUBLIC and PRIVATE, as part of the generated dependency() which causes problems when some of the private flags are highly disruptive, e.g. `-Wl,--version-script`. Tease apart the two kinds of link flags and, for non-static libraries, only propagate the PUBLIC/INTERFACE flags and not the PRIVATE ones.
2024-07-12docs: mention cython_args in cython reference docsNathan Goldbaum2-0/+14
2024-07-11docs: Add some commas to subdir_done() descriptionWill Thompson1-2/+2
It's subjective but I think that breaking the sentences in this way makes them easier to follow.
2024-07-11docs: Fix typo in subdir_done() descriptionWill Thompson1-3/+3
2024-07-10docs: explain not to use extern crate in Rust codeAlyssa Ross1-0/+18
2024-07-10Release 1.5.0 time.1.5.0Jussi Pakkanen21-187/+215
2024-07-05Revert "Clarify mutable objects usage"Eli Schwartz3-22/+5
This reverts commit 9f02d0a3e5a5ffc82256391c244b1af38e41ef78. It turns out that this does introduce a behavioral change in existing users of ConfigurationData, which it wasn't supposed to (it was supposed to preserve behavior there, and add a new *warning* for EnvironmentVariables). This breaks projects such as pulseaudio, libvirt, and probably more. Roll back the change and try again after 1.5.0 is released. Fixes: #13372
2024-06-26Update Users.md entry for fossil-libMichael Gene Brockus (Dreamer)1-1/+1
2024-06-23find_program: add a kwarg to specify custom version argumentDudemanguy2-1/+20
When trying to get the version of a program, meson was previously hardcoded to run the binary with `--version`. This does work with the vast majority of programs, but there are a few outliers (e.g. ffmpeg) which have an unusual argument for printing out the version. Support these programs by introducing a version_argument kwarg in find_program which allows users to override `--version` with whatever the custom argument for printing the version may be for the program.
2024-06-17Add meson test --max-linesDaan De Meyer2-0/+14
Let's allow users to configure how many lines are shown at most when a test fails.
2024-06-14cargo: Load Cargo.lockXavier Claessens2-0/+10
Cargo.lock is essentially identical to subprojects/*.wrap files. When a (sub)project has a Cargo.lock file this allows automatic fallback for its cargo dependencies.
2024-06-10Add note about meson-python and installation pathEmil Melnikov2-1/+11
New people that want to use Meson for building Python extensions most probably will read Python module docs first. Direct them to meson-python and suggest to set `python.install_env=auto`.
2024-05-31Explain how to add preprocessor defines in FAQ.mdEmil Melnikov1-0/+13
See https://github.com/mesonbuild/meson/issues/6269 for the discussion. Co-authored-by: Eli Schwartz <eschwartz93@gmail.com>
2024-05-26docs: Update GIMP meson adoptionBruno1-1/+1
The master branch isn't in experimental state anymore.
2024-05-22unify listing for FSCL to point to allMichael Gene Brockus1-12/+1
2024-05-15docs: fix description of cpp_eh=noneEli Schwartz1-5/+5
We changed the behavior in #6116 but did not change the docs as well. Fixes #8233
2024-05-15Merge pull request #11421 from mon/ti-armclangJussi Pakkanen1-0/+3
Basic support for TI Arm Clang toolchain