aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown
AgeCommit message (Collapse)AuthorFilesLines
3 daysAdd swift_module_name target argumentHEADmasterKatalin Rebhan1-0/+9
Allows explicitly setting the Swift module name. By default, this is set to the target name, which we might want to change for various reasons, for example when it isn't a valid module name, or when building two targets with the same module name (e.g. a host and native variant).
4 daysAdd suffix function to the fs moduleJouke Witteveen2-1/+18
4 daysAdd -parse-as-library to Swift library targetsKatalin Rebhan1-0/+8
6 daysDocs: standardize between list and array as arrayDylan Baker4-6/+6
When arrays were added they were called arrays. Because the are implemented with Python lists, that language started leaking into talking about Meson types. This is confusing. I've attempted, as much as possible, to move to using one name, array. I picked array because 1) It's the original name used, and 2) what Meson has are more properly arrays as they have a fixed length, while a critical property of lists are the ability to link and unlink them. There are a couple of places where the list language has leaked into the names of keyword arguments. I have not made any attempt to change those, I don't know if it's that useful or not.
7 daysclang-tidy: run tool only on source files participating in targetsSahnvour1-0/+5
clang-tidy can't be ran as is on every source file and header
9 daysinterpreter: Add a flatten() method to arraysDylan Baker1-0/+5
This allows users to do two things, flatten potentially nested arrays themselves, and, to safely convert types that may be an array to not an array. ```meson x = [meson.get_external_property('may_be_array)].flatten() ``` ```meson x = ['a', ['b', 'c']] assert(x.flatten() == ['a', 'b', 'c']) ```
10 dayswrap: Print deprecation warnings when using wrapdb v1Xavier Claessens1-0/+5
10 daysrust: add rust_dynamic_std optionPaolo Bonzini2-0/+8
As an initial implementation, simply adding "-C prefer-dynamic" works for binary crates (as well as dylib and proc-macro that already used it). In the future this could be extended to other crate types. For more information see the comment in the changed file, as well as https://github.com/mesonbuild/meson/issues/8828 and https://github.com/mesonbuild/meson/issues/14215. Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
10 daysdocs: document new behavior of yielding optionsPaolo Bonzini1-0/+4
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2025-07-07docs: document order in which options are appliedPaolo Bonzini1-21/+38
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2025-06-23docs: Document Swift/C++ interoperability featureAlbert Tang1-0/+13
2025-06-17docs: use backticks for envvarsSam James1-3/+3
2025-06-17docs: fix formatting of pkg_config_libdir propertySam James1-1/+1
2025-06-09modules/gnome: Allow to generate markdown and reStructuredText dbus docCorentin Noël1-2/+5
gdbus-docgen supports reStructuredText output since 2.71.1 and markdown since 2.75.2, allow to simply generate it.
2025-06-05swift: Pass C base compile options to swiftcKatalin Rebhan1-0/+8
2025-06-05docs: Update docs for eldKushal Pal2-0/+7
Update reference table for eld Mention eld support in release notes Signed-off-by: Kushal Pal <kushpal@qti.qualcomm.com>
2025-05-22Use two hashes in snippet.Jussi Pakkanen1-1/+1
2025-05-22docs: Add response files entryL. E. Segovia1-0/+8
See https://github.com/mesonbuild/meson/pull/14391
2025-05-19docs: Note that debug=false does not define NDEBUGPaul Caprioli1-0/+4
2025-05-15docs: mention masm support in release notesZephyr Lykos1-0/+8
2025-05-14docs: gender neutral pronouns for "the user"nasso2-10/+10
2025-05-08Update Getting-meson_zh.mdDaniel1-1/+1
Sync with the English version
2025-05-06Add license keyword to pkgconfig generateCharles Brunet2-0/+7
Fixes #14270.
2025-05-05cmake: include_directories() returns an arrayPaolo Bonzini1-2/+2
See the way that it is created: dir_node = assign(dir_var, function(include_directories, tgt.includes)) sys_node = assign(sys_var, function(include_directories, tgt.sys_includes, {is_system: True})) inc_node = assign(inc_var, array([id_node(dir_var), id_node(sys_var)])) Due to incorrect documentation, commit 1f4bb3737 ("modules/cmake: Make fully type safe", 2025-04-02) added an incorrect assertion. Fix both. Fixes: #14530 Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2025-05-05docs/users: drop + from GTKDylan Baker1-1/+1
This reflects the upstream project, which dropped the + in 2020
2025-05-05docs/users: Trim down only to highly notable projectsDylan Baker1-127/+4
This removes a lot of projects from our list of users, unless they are very notable.
2025-05-05docs/users: remove "not default" from XserverDylan Baker1-1/+1
2025-05-05docs/users: Split notable organizations from individual projectsDylan Baker1-35/+24
Some of the projects listed are part of larger umbrella organizations, which have many project using Meson. Instead of listing every single project from them, list the organization itself and a couple of major projects (if we have any listed) from those organizations.
2025-05-03docs: disambiguate exe_wrapperAndy MacGregor1-0/+16
As of this commit, meson has three different pathways to set an exe_wrapper field. exe_wrapper set through `meson test --wrapper` CLI arg or `add_test_setup()` meson function argument are treated equally. Only one wrapper through either of these routes may be set though. The exe_wrapper field set in the cross file is handled separately internally in mtest.py, and holds a little more consequence over meson test behavior than the other two fields. Perhaps a future version of meson should treat these fields equally and explicitly document how they are combined. For now, I think its a better first step to document current behavior to generate discussion about how exactly the future version should behave.
2025-05-01docs: Update link to rust-analyzer docsM Henning1-1/+1
2025-04-29docs: fix markup in release notesBenjamin Gilbert1-1/+1
2025-04-28Add release notes for 1.8 that I forgot.Jussi Pakkanen15-112/+134
2025-04-23docs: users: list is for notable meson adopteesSam James1-7/+6
We don't want churn with thie list for every project someone creates that uses Meson. Change the intro to say we want notable projects and link to a GitHub search for 'meson.build' files for people who want further examples to consider.
2025-04-20document android_exe_type in release notesPaolo Bonzini1-0/+10
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2025-04-20document c_std=c2y in release notesPaolo Bonzini1-0/+4
2025-04-20document improvements to Objective-C and Objective-C++Paolo Bonzini1-0/+8
2025-04-20document -Dswift_std in release notesPaolo Bonzini1-0/+4
2025-04-20add wayland stabilisation to release notesPaolo Bonzini1-0/+4
2025-04-20fix typoPaolo Bonzini1-1/+1
2025-04-20move "since 1.8.0" for rust.doctest to the right placePaolo Bonzini1-2/+2
2025-04-16environment: handle all iOS variants as xnuPaolo Bonzini1-0/+2
All of iOS, tvOS, visionOS, watchOS use the XNU kernel. Report that and also make them return true for is_darwin() which is really more like "is_xnu()". Co-authored-by: Russell Keith-Magee <russell@keith-magee.com> Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2025-04-09Add documentation for compiler.has_define to user guideWill Ayd1-0/+12
2025-04-09New xgettext method for i18n moduleCharles Brunet2-0/+59
This method call xgettext to extract translatable string from source files into a .pot translation template. It differs from a plain CustomTarget in three ways: - It accepts build targets as sources, and automatically resolves source files from those build targets; - It detects command lines that are too long, and writes, at config time, the list of source files into a text file to be consumed by the xgettext command; - It detects dependencies between pot extraction targets, based on the dependencies between source targets.
2025-04-07Fix documentation typosEmil Berg7-9/+9
2025-04-07Fix link to "Building Fancy DMG Images on Mac OS X"Heikki Rauhala1-1/+1
2025-04-06Add C# to home page supported language listEmil Berg1-1/+1
2025-04-06docs: say '--wrapper', not '--wrap' for testsSam James1-3/+3
We document --wrapper and --wrap works only by expanding it automatically to --wrapper as it is unambiguous.
2025-04-04rust: add external objects to the link command linePaolo Bonzini1-0/+4
Because rustc does not support extract_objects, QEMU creates a static library with all the C objects. It then passes this static library as link_whole, together with another static library containing general purpose utility functions which is passed as link_with. However, this is brittle because the two have a circular dependency and they cannot be merged because of the link_whole/link_with difference. While lld seems to have the --start-group/--end-group semantics automatically, ld.bfd can fail if these options are needed. This can cause difference between distros depending on how Rust is packaged (e.g. Ubuntu 22.04 and Debian bookworm seem to use ld.bfd). The simplest solution is for Meson to implement "objects:" properly for Rust. Then QEMU can use the same internal dependency objects that it already has in place for C programs. Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2025-04-02docs: fix default for mformat sort_files optionBenjamin Gilbert1-1/+1
sort_files has always defaulted to true. Fixes: 2b37101998c8 ("meson format command")
2025-04-02mtest: set VALGRIND_OPTS to fail tests on errorsSam James1-0/+6
We currently suggest that users run `meson test --wrapper valgrind`, but this doesn't do what one might expect: Valgrind doesn't error out on violations/issues it detects. In the past, we had special handling for Valgrind in tests, see 1f76b76a84cb635f764ecbd2b77aaba1d375d72b but it was later dropped in 951262d7590343ffa9730666c427ad9d708a9fb6. This is similar to what we do for {A,UB,M}SAN_OPTIONS to give sensible behaviour that users expect out-of-the-box. Only do this if we see 'valgrind' in the wrapper command to avoid polluting logs. We may want to do that for the sanitizers variables in future too. Note that we're not adding --exit-on-first-error=yes here, as there may be several issues in an application, or a test may be rather slow, and so on. But --error-exitcode=1 to simply make Valgrind's exit status reflect whether an error was found is uncontroversial. Bug: https://github.com/mesonbuild/meson/issues/4727 Bug: https://github.com/mesonbuild/meson/issues/1105 Bug: https://github.com/mesonbuild/meson/issues/1175 Bug: https://github.com/mesonbuild/meson/issues/13745