copy editing of 1.11 release notes
diff --git a/docs/markdown/snippets/build_target_install_dir.md b/docs/markdown/snippets/build_target_install_dir.md index 0ad5cbe..781073e 100644 --- a/docs/markdown/snippets/build_target_install_dir.md +++ b/docs/markdown/snippets/build_target_install_dir.md
@@ -1,8 +1,10 @@ ## BuildTarget(install_dir) length > 1 replaced with keywords -Build Targets currently support (with limited documentation), passing an array -of more than one element to `install_dir:` (except for in some wrappers), and -will map these additional install_dir's to extra outputs. This is only used by vala, and has been replaced by explicit keyword arguments. +Build targets previously supported (with limited documentation) passing an array +of more than one element to `install_dir:` (except in some wrappers), and +would map these additional `install_dir`s to extra outputs. This was only used by +Vala, and separate explicit keyword arguments are now available that provide +the same functionality. Code like this: ```meson @@ -21,8 +23,9 @@ 'foo', 'foo.vala', install : true, - install_vala_header_dir : get_option('includedir') / 'foo + install_vala_header : get_option('includedir') / 'foo', + install_vala_vapi : true, ) ``` -Note that now you only need to specify values you want to deviate from the default. +Note that the default is `false` for the Vala extra outputs.
diff --git a/docs/markdown/snippets/cargo-workspace-object.md b/docs/markdown/snippets/cargo-workspace-object.md index 1ef7675..895ee3d 100644 --- a/docs/markdown/snippets/cargo-workspace-object.md +++ b/docs/markdown/snippets/cargo-workspace-object.md
@@ -1,13 +1,13 @@ ## Cargo workspace object -Meson now is able to parse the toplevel `Cargo.toml` file of the +Meson is now able to parse the toplevel `Cargo.toml` file of the project when the `workspace()` method of the Rust module is called. This guarantees that features are resolved according to what is in the `Cargo.toml` file, and in fact enables configuration of features for the build. The returned object allows retrieving features and dependencies -for Cargo subprojects, and contains method to build targets +for Cargo subprojects, and contains methods to build targets declared in `Cargo.toml` files. While Cargo subprojects remain experimental, the Meson project will
diff --git a/docs/markdown/snippets/expected_error.md b/docs/markdown/snippets/expected_error.md index 29a77fd..d26bae8 100644 --- a/docs/markdown/snippets/expected_error.md +++ b/docs/markdown/snippets/expected_error.md
@@ -1,5 +1,5 @@ ## Deprecate `should_fail` and rename it to `expected_fail`, also introduce `expected_exitcode` -In 1.11.0 `should_fail` has been renamed to `expected_error`. +In 1.11.0 `should_fail` has been renamed to `expected_fail`. Before 1.11.0, there was no way to positively test a command/binary returning error/non-zero exit code when the used protocol was set to exitcode, so `expected_exitcode` has been introduced to achieve this. Do note that if the exitcode does not match the expected value, GNU skip and exit codes are still valid and the test result may be skip or error. \ No newline at end of file
diff --git a/docs/markdown/snippets/link-early-args.md b/docs/markdown/snippets/link-early-args.md index 10100dd..98ed87f 100644 --- a/docs/markdown/snippets/link-early-args.md +++ b/docs/markdown/snippets/link-early-args.md
@@ -7,7 +7,7 @@ manipulates those. The new `link_early_args` keyword argument passes linker options which -are inserted into the command line before any objects and libraries -allowing applications to use these kinds of linker options with meson. +are inserted into the command line before any objects and libraries, +allowing applications to use these kinds of linker options with Meson. This is currently only supported when using the `ninja` backend.
diff --git a/docs/markdown/snippets/qt-no-debug.md b/docs/markdown/snippets/qt-no-debug.md index 49a6c36..647fe51 100644 --- a/docs/markdown/snippets/qt-no-debug.md +++ b/docs/markdown/snippets/qt-no-debug.md
@@ -1,4 +1,4 @@ -## meson now defines `QT_DEBUG` or `QT_NO_DEBUG` depending on build type +## Meson now defines `QT_DEBUG` or `QT_NO_DEBUG` depending on build type -When using the `qt` meson modules, the `QT_DEBUG` or `QT_NO_DEBUG` preprocessor macro is now set depending on the value of the `debug` built-in meson option. -This mimicks the behavior of `qmake`, and is expected by the `<QtGlobal>` header. +When using the `qt` Meson modules, the `QT_DEBUG` or `QT_NO_DEBUG` preprocessor macro is now set depending on the value of the `debug` built-in Meson option. +This mimics the behavior of `qmake`, and is expected by the `<QtGlobal>` header.
diff --git a/docs/markdown/snippets/rust_compiler_target.md b/docs/markdown/snippets/rust_compiler_target.md index 500fa20..27a4d60 100644 --- a/docs/markdown/snippets/rust_compiler_target.md +++ b/docs/markdown/snippets/rust_compiler_target.md
@@ -1,6 +1,6 @@ ## `compiler_target()` method in the Rust module -A `compiler_target()` that returns the Rust target triple has been added to +A `compiler_target()` method that returns the Rust target triple has been added to the `rust` module. This method can be useful when converting build scripts -making use of the Cargo's `TARGET` and `HOST` environment variables to +making use of Cargo's `TARGET` and `HOST` environment variables to Meson.
diff --git a/docs/markdown/snippets/windows-rc-compile-detect-deps.md b/docs/markdown/snippets/windows-rc-compile-detect-deps.md index acc84c9..a332383 100644 --- a/docs/markdown/snippets/windows-rc-compile-detect-deps.md +++ b/docs/markdown/snippets/windows-rc-compile-detect-deps.md
@@ -5,6 +5,6 @@ Therefore, changes to files included by the `.rc` file did not trigger recompilation of the resource file. -A workaround was added to *meson* by calling the preprocessor on the +A workaround was added to Meson by calling the preprocessor on the `.rc` file to display the included headers and allow ninja to record them as dependencies.
diff --git a/docs/markdown/snippets/windows-rc-compile-implicit-dir.md b/docs/markdown/snippets/windows-rc-compile-implicit-dir.md index fe6d881..c00c318 100644 --- a/docs/markdown/snippets/windows-rc-compile-implicit-dir.md +++ b/docs/markdown/snippets/windows-rc-compile-implicit-dir.md
@@ -1,6 +1,6 @@ ## Added `implicit_include_directories` argument to `windows.compile_resources` [Windows](Windows-module.md) module [compile_resources](Windows-module.md#compile_resources) -now have a `implicit_include_directories` keyword argument to automatically +now has an `implicit_include_directories` keyword argument to automatically add current build and source directories to the included paths when compiling a resource.