diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/markdown/Adding-new-projects-to-wrapdb.md | 11 | ||||
| -rw-r--r-- | docs/markdown/Cross-compilation.md | 2 | ||||
| -rw-r--r-- | docs/markdown/Reference-manual.md | 22 | ||||
| -rw-r--r-- | docs/markdown/SimpleStart.md | 4 | ||||
| -rw-r--r-- | docs/markdown/Users.md | 1 | ||||
| -rw-r--r-- | docs/markdown/snippets/deprecated_get_cross_property.md | 5 | ||||
| -rw-r--r-- | docs/markdown/snippets/error_msg.md | 4 | ||||
| -rw-r--r-- | docs/markdown/snippets/has_external_property.md | 7 | ||||
| -rw-r--r-- | docs/markdown/snippets/install_man_locale.md | 9 | ||||
| -rw-r--r-- | docs/markdown/snippets/permit_generator_customtarget.md | 4 | ||||
| -rw-r--r-- | docs/markdown/snippets/summary-accepts-features.md | 3 |
11 files changed, 65 insertions, 7 deletions
diff --git a/docs/markdown/Adding-new-projects-to-wrapdb.md b/docs/markdown/Adding-new-projects-to-wrapdb.md index 5bdadfa..a1d2486 100644 --- a/docs/markdown/Adding-new-projects-to-wrapdb.md +++ b/docs/markdown/Adding-new-projects-to-wrapdb.md @@ -62,7 +62,12 @@ provided. ### Request a new repository -Create an issue on the [wrapdb bug +*Note:* you should only do this if you have written the build files +and want to contribute them for inclusion to WrapDB. The maintainers +have only limited reesources and unfortunately can not take requests +to write Meson build definitions for arbitrary projects. + +The submission starts by creating an issue on the [wrapdb bug tracker](https://github.com/mesonbuild/wrapdb/issues) using *Title* and *Description* below as a template. @@ -75,7 +80,9 @@ version: <version_you_have_a_wrap_for> ``` Wait until the new repository or branch is created. A link to the new -repository or branch will be posted in a comment to this issue. +repository or branch will be posted in a comment to this issue. After +this you can createa a merge request in that repository for your build +files. NOTE: Requesting a branch is not necessary. WrapDB maintainer can create the branch and modify the PR accordingly if the project diff --git a/docs/markdown/Cross-compilation.md b/docs/markdown/Cross-compilation.md index d4fb074..4410c03 100644 --- a/docs/markdown/Cross-compilation.md +++ b/docs/markdown/Cross-compilation.md @@ -315,7 +315,7 @@ somekey = 'somevalue' then you can access that using the `meson` object like this: ```meson -myvar = meson.get_cross_property('somekey') +myvar = meson.get_external_property('somekey') # myvar now has the value 'somevalue' ``` diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md index 3693e57..e299be8 100644 --- a/docs/markdown/Reference-manual.md +++ b/docs/markdown/Reference-manual.md @@ -580,6 +580,9 @@ Returns a [disabler object](#disabler-object). Print the argument string and halts the build process. +*(since 0.58.0)* Can take more than one argument that will be separated by +space. + ### environment() ``` meson @@ -1130,6 +1133,11 @@ Accepts the following keywords: format and optionally the owner/uid and group/gid for the installed files. An example value could be `['rwxr-sr-x', 'root', 'root']`. +- `locale` *(since 0.58.0)*: can be used to specify the locale into which the + man page will be installed within the manual page directory tree. + An example manual might be `foo.fr.1` with a locale of `fr`, such + that `{mandir}/{locale}/man{num}/foo.1` becomes the installed file. + *(since 0.49.0)* [manpages are no longer compressed implicitly][install_man_49]. @@ -1353,6 +1361,7 @@ dictionaries does not guarantee ordering. `key` must be string, - an integer, boolean or string - *since 0.57.0* an external program or a dependency +- *since 0.58.0* a feature option - a list of those. `summary()` can be called multiple times as long as the same @@ -1976,9 +1985,9 @@ the following methods. the "native" compiler if we're not. - `get_cross_property(propname, fallback_value)`: - *Consider `get_external_property()` instead*. Returns the given - property from a cross file, the optional fallback_value is returned - if not cross compiling or the given property is not found. + *Deprecated since 0.58.0, use `get_external_property()` instead*. + Returns the given property from a cross file, the optional fallback_value + is returned if not cross compiling or the given property is not found. - `get_external_property(propname, fallback_value, native: true/false)` *(since 0.54.0)*: returns the given property from a native or cross file. @@ -1988,6 +1997,13 @@ the following methods. If `native: false` or not specified, variable is retrieved from the cross-file if cross-compiling, and from the native-file when not cross-compiling. +- `has_external_property(propname, native: true/false)` + *(since 0.58.0)*: checks whether the given property exist in a native or + cross file. The optional `native: true` forces checking for the variable + in the native file, even when cross-compiling. + If `native: false` or not specified, the variable is checked for in the + cross-file if cross-compiling, and in the native-file when not cross-compiling. + - `can_run_host_binaries()` *(since 0.55.0)*: returns true if the build machine can run binaries compiled for the host. This returns true unless you are cross compiling, need a helper to run host binaries, and don't have one. diff --git a/docs/markdown/SimpleStart.md b/docs/markdown/SimpleStart.md index bda532a..2c18dc4 100644 --- a/docs/markdown/SimpleStart.md +++ b/docs/markdown/SimpleStart.md @@ -161,4 +161,6 @@ is put in the `build` subdirectory and can be run directly from there. The project is now ready for development. You can edit the code with any editor and it is rebuilt by going in the `build` subdirectory and -executing the `meson compile` command. +executing the `meson compile` command. If your version of Meson is too +old, you can compile the project by running the command `ninja` +instead. diff --git a/docs/markdown/Users.md b/docs/markdown/Users.md index 616a411..925ff9a 100644 --- a/docs/markdown/Users.md +++ b/docs/markdown/Users.md @@ -121,6 +121,7 @@ format files - [Polari](https://gitlab.gnome.org/GNOME/polari), an IRC client - [qboot](https://github.com/bonzini/qboot), a minimal x86 firmware for booting Linux kernels - [radare2](https://github.com/radare/radare2), unix-like reverse engineering framework and commandline tools (not the default) + - [Rizin](https://rizin.re), Free and Open Source Reverse Engineering Framework - [QEMU](https://qemu.org), a processor emulator and virtualizer - [RxDock](https://gitlab.com/rxdock/rxdock), a protein-ligand docking software designed for high throughput virtual screening (fork of rDock) - [scrcpy](https://github.com/Genymobile/scrcpy), a cross platform application that provides display and control of Android devices connected on USB or over TCP/IP diff --git a/docs/markdown/snippets/deprecated_get_cross_property.md b/docs/markdown/snippets/deprecated_get_cross_property.md new file mode 100644 index 0000000..8e62956 --- /dev/null +++ b/docs/markdown/snippets/deprecated_get_cross_property.md @@ -0,0 +1,5 @@ +## `meson.get_cross_property()` has been deprecated + +It's a pure subset of `meson.get_external_property`, and works strangely in +host == build configurations, since it would be more accurately described as +`get_host_property`. diff --git a/docs/markdown/snippets/error_msg.md b/docs/markdown/snippets/error_msg.md new file mode 100644 index 0000000..a17372f --- /dev/null +++ b/docs/markdown/snippets/error_msg.md @@ -0,0 +1,4 @@ +## `error()` with multiple arguments + +Just like `warning()` and `message()`, `error()` can now take more than one +argument that will be separated by space. diff --git a/docs/markdown/snippets/has_external_property.md b/docs/markdown/snippets/has_external_property.md new file mode 100644 index 0000000..8a815d7 --- /dev/null +++ b/docs/markdown/snippets/has_external_property.md @@ -0,0 +1,7 @@ +## Check if native or cross-file properties exist + +It is now possible to check whether a native property or a cross-file property +exists with `meson.has_external_property('foo')`. This is useful if the +property in question is a boolean and one wants to distinguish between +"set" and "not provided" which can't be done the usual way by passing a +fallback parameter to `meson.get_external_property()` in this particular case. diff --git a/docs/markdown/snippets/install_man_locale.md b/docs/markdown/snippets/install_man_locale.md new file mode 100644 index 0000000..76b7967 --- /dev/null +++ b/docs/markdown/snippets/install_man_locale.md @@ -0,0 +1,9 @@ +## Specify man page locale during installation + +Locale directories can now be passed to `install_man`: + +```meson +# instead of +# install_data('foo.fr.1', install_dir: join_paths(get_option('mandir'), 'fr', 'man1'), rename: 'foo.1')` +install_man('foo.fr.1', locale: 'fr') +``` diff --git a/docs/markdown/snippets/permit_generator_customtarget.md b/docs/markdown/snippets/permit_generator_customtarget.md new file mode 100644 index 0000000..0a5a6b5 --- /dev/null +++ b/docs/markdown/snippets/permit_generator_customtarget.md @@ -0,0 +1,4 @@ +## Allow using generator with CustomTaget or Index of CustomTarget. + +Calling `generator.process()` with either a CustomTaget or Index of CustomTarget +as files is now permitted. diff --git a/docs/markdown/snippets/summary-accepts-features.md b/docs/markdown/snippets/summary-accepts-features.md new file mode 100644 index 0000000..81bf542 --- /dev/null +++ b/docs/markdown/snippets/summary-accepts-features.md @@ -0,0 +1,3 @@ +## `summary()` accepts features + +Build feature options can be passed to `summary()` as the value to be printed. |