From a6d088ba3d840f0a60325429a6eae4b38ea0f1ad Mon Sep 17 00:00:00 2001 From: Jussi Pakkanen Date: Fri, 23 Dec 2022 18:13:14 +0200 Subject: [PATCH] Created release note page for 1.0.0. --- docs/markdown/Release-notes-for-1.0.0.md | 85 +++++++++++++++++++ .../compiler_prefix_property_array.md | 18 ---- docs/markdown/snippets/cxx_warn_args_dtor.md | 3 - docs/markdown/snippets/devenv.md | 15 ---- docs/markdown/snippets/java_native_headers.md | 4 - docs/markdown/snippets/rust_bindgen_deps.md | 5 -- .../snippets/rust_bindgen_str_include.md | 4 - .../snippets/rust_module_stabilized.md | 3 - docs/markdown/snippets/str_in.md | 11 --- .../snippets/warning_level_everything.md | 5 -- docs/sitemap.txt | 1 + 11 files changed, 86 insertions(+), 68 deletions(-) create mode 100644 docs/markdown/Release-notes-for-1.0.0.md delete mode 100644 docs/markdown/snippets/compiler_prefix_property_array.md delete mode 100644 docs/markdown/snippets/cxx_warn_args_dtor.md delete mode 100644 docs/markdown/snippets/devenv.md delete mode 100644 docs/markdown/snippets/java_native_headers.md delete mode 100644 docs/markdown/snippets/rust_bindgen_deps.md delete mode 100644 docs/markdown/snippets/rust_bindgen_str_include.md delete mode 100644 docs/markdown/snippets/rust_module_stabilized.md delete mode 100644 docs/markdown/snippets/str_in.md delete mode 100644 docs/markdown/snippets/warning_level_everything.md diff --git a/docs/markdown/Release-notes-for-1.0.0.md b/docs/markdown/Release-notes-for-1.0.0.md new file mode 100644 index 000000000..cc29d16d7 --- /dev/null +++ b/docs/markdown/Release-notes-for-1.0.0.md @@ -0,0 +1,85 @@ +--- +title: Release 1.0.0 +short-description: Release notes for 1.0.0 +... + +# New features + +Meson 1.0.0 was released on 23 December 2022 +## Compiler check functions `prefix` kwargs accepts arrays + +The `prefix` kwarg that most compiler check functions support +now accepts an array in addition to a string. The elements of the +array will be concatenated separated by a newline. + +This makes it more readable to write checks that need multiple headers +to be included: + +```meson +cc.check_header('GL/wglew.h', prefix : ['#include ', '#include ']) +``` + +instead of + +```meson +cc.check_header('GL/wglew.h', prefix : '#include \n#include ']) +``` + +## Flags removed from cpp/objcpp warning level 1 + +`-Wnon-virtual-dtor` is no longer implied by `meson setup -Dwarning_level=1`. + +## Developer environment improvements + +When cross compiling, the developer environment now sets all environment +variables for the HOST machine. It now also sets `QEMU_LD_PREFIX` to the +`sys_root` value from cross file if property is defined. That means that cross +compiled executables can often be run transparently on the build machine, for +example when cross compiling for aarch64 linux from x86_64 linux. + +A new argument `--workdir` has been added, by default it is set to build +directory. For example, `meson devenv -C builddir --workdir .` can be used to +remain in the current dir (often source dir) instead. + +`--dump` now prints shell commands like `FOO="/prepend/path:$FOO:/append/path"`, +using the literal `$FOO` instead of current value of `FOO` from environment. +This makes easier to evaluate those expressions in a different environment. + +## Deprecate `java.generate_native_headers`, rename to `java.native_headers` + +The functions operate in the exact same way. The new name matches more with +Meson function name styling. + +## rust.bindgen accepts a dependency argument + +The `bindgen` method of the `rust` module now accepts a dependencies argument. +Any include paths in these dependencies will be passed to the underlying call to +`clang`, and the call to `bindgen` will correctly depend on any generatd sources. + +## String arguments to the rust.bindgen include_directories argument + +Most other cases of include_directories accept strings as well as +`IncludeDirectory` objects, so lets do that here too for consistency. + +## The Rust module is stable + +Mesa is using the rust module in production, so it's time to mark it as stable. + +## `in` operator for strings + +`in` and `not in` operators now works on strings, in addition to arrays and +dictionaries. + +``` +fs = import('fs') +if 'something' in fs.read('somefile') + # True +endif +``` + +## `warning-level=everything` option + +The new `everything` value for the built-in `warning_level` enables roughly all applicable compiler warnings. +For clang and MSVC, this simply enables `-Weverything` or `/Wall`, respectively. +For GCC, meson enables warnings approximately equivalent to `-Weverything` from clang. + diff --git a/docs/markdown/snippets/compiler_prefix_property_array.md b/docs/markdown/snippets/compiler_prefix_property_array.md deleted file mode 100644 index 75b7156af..000000000 --- a/docs/markdown/snippets/compiler_prefix_property_array.md +++ /dev/null @@ -1,18 +0,0 @@ -## Compiler check functions `prefix` kwargs accepts arrays - -The `prefix` kwarg that most compiler check functions support -now accepts an array in addition to a string. The elements of the -array will be concatenated separated by a newline. - -This makes it more readable to write checks that need multiple headers -to be included: - -```meson -cc.check_header('GL/wglew.h', prefix : ['#include ', '#include ']) -``` - -instead of - -```meson -cc.check_header('GL/wglew.h', prefix : '#include \n#include ']) -``` diff --git a/docs/markdown/snippets/cxx_warn_args_dtor.md b/docs/markdown/snippets/cxx_warn_args_dtor.md deleted file mode 100644 index fb35c36a6..000000000 --- a/docs/markdown/snippets/cxx_warn_args_dtor.md +++ /dev/null @@ -1,3 +0,0 @@ -## Flags removed from cpp/objcpp warning level 1 - -`-Wnon-virtual-dtor` is no longer implied by `meson setup -Dwarning_level=1`. diff --git a/docs/markdown/snippets/devenv.md b/docs/markdown/snippets/devenv.md deleted file mode 100644 index b385203d4..000000000 --- a/docs/markdown/snippets/devenv.md +++ /dev/null @@ -1,15 +0,0 @@ -## Developer environment improvements - -When cross compiling, the developer environment now sets all environment -variables for the HOST machine. It now also sets `QEMU_LD_PREFIX` to the -`sys_root` value from cross file if property is defined. That means that cross -compiled executables can often be run transparently on the build machine, for -example when cross compiling for aarch64 linux from x86_64 linux. - -A new argument `--workdir` has been added, by default it is set to build -directory. For example, `meson devenv -C builddir --workdir .` can be used to -remain in the current dir (often source dir) instead. - -`--dump` now prints shell commands like `FOO="/prepend/path:$FOO:/append/path"`, -using the literal `$FOO` instead of current value of `FOO` from environment. -This makes easier to evaluate those expressions in a different environment. diff --git a/docs/markdown/snippets/java_native_headers.md b/docs/markdown/snippets/java_native_headers.md deleted file mode 100644 index 0c5df0976..000000000 --- a/docs/markdown/snippets/java_native_headers.md +++ /dev/null @@ -1,4 +0,0 @@ -## Deprecate `java.generate_native_headers`, rename to `java.native_headers` - -The functions operate in the exact same way. The new name matches more with -Meson function name styling. diff --git a/docs/markdown/snippets/rust_bindgen_deps.md b/docs/markdown/snippets/rust_bindgen_deps.md deleted file mode 100644 index 0e8ebef62..000000000 --- a/docs/markdown/snippets/rust_bindgen_deps.md +++ /dev/null @@ -1,5 +0,0 @@ -## rust.bindgen accepts a dependency argument - -The `bindgen` method of the `rust` module now accepts a dependencies argument. -Any include paths in these dependencies will be passed to the underlying call to -`clang`, and the call to `bindgen` will correctly depend on any generatd sources. diff --git a/docs/markdown/snippets/rust_bindgen_str_include.md b/docs/markdown/snippets/rust_bindgen_str_include.md deleted file mode 100644 index 2a42951ab..000000000 --- a/docs/markdown/snippets/rust_bindgen_str_include.md +++ /dev/null @@ -1,4 +0,0 @@ -## String arguments to the rust.bindgen include_directories argument - -Most other cases of include_directories accept strings as well as -`IncludeDirectory` objects, so lets do that here too for consistency. diff --git a/docs/markdown/snippets/rust_module_stabilized.md b/docs/markdown/snippets/rust_module_stabilized.md deleted file mode 100644 index e80d5c6ed..000000000 --- a/docs/markdown/snippets/rust_module_stabilized.md +++ /dev/null @@ -1,3 +0,0 @@ -## The Rust module is stable - -Mesa is using the rust module in production, so it's time to mark it as stable. diff --git a/docs/markdown/snippets/str_in.md b/docs/markdown/snippets/str_in.md deleted file mode 100644 index abcb8bdc0..000000000 --- a/docs/markdown/snippets/str_in.md +++ /dev/null @@ -1,11 +0,0 @@ -## `in` operator for strings - -`in` and `not in` operators now works on strings, in addition to arrays and -dictionaries. - -``` -fs = import('fs') -if 'something' in fs.read('somefile') - # True -endif -``` diff --git a/docs/markdown/snippets/warning_level_everything.md b/docs/markdown/snippets/warning_level_everything.md deleted file mode 100644 index 5558cf509..000000000 --- a/docs/markdown/snippets/warning_level_everything.md +++ /dev/null @@ -1,5 +0,0 @@ -## `warning-level=everything` option - -The new `everything` value for the built-in `warning_level` enables roughly all applicable compiler warnings. -For clang and MSVC, this simply enables `-Weverything` or `/Wall`, respectively. -For GCC, meson enables warnings approximately equivalent to `-Weverything` from clang. diff --git a/docs/sitemap.txt b/docs/sitemap.txt index 6f4f58eab..4494afe0f 100644 --- a/docs/sitemap.txt +++ b/docs/sitemap.txt @@ -88,6 +88,7 @@ index.md Wrap-best-practices-and-tips.md Shipping-prebuilt-binaries-as-wraps.md Release-notes.md + Release-notes-for-1.0.0.md Release-notes-for-0.64.0.md Release-notes-for-0.63.0.md Release-notes-for-0.62.0.md