aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2023-04-10 18:39:03 +0300
committerJussi Pakkanen <jpakkane@gmail.com>2023-04-10 18:39:03 +0300
commit994ba8b5492f05d557fc1b350638f0d76d144777 (patch)
tree69fd5438153853320f5b9fcd9ea7f92e2ab86fa2
parent8fc4649bfe7c0cad389769624e690e4fbf0f186f (diff)
downloadmeson-994ba8b5492f05d557fc1b350638f0d76d144777.zip
meson-994ba8b5492f05d557fc1b350638f0d76d144777.tar.gz
meson-994ba8b5492f05d557fc1b350638f0d76d144777.tar.bz2
Generate relnotes for 1.1.0.
-rw-r--r--docs/markdown/Release-notes-for-1.1.0.md224
-rw-r--r--docs/markdown/snippets/clang_cl_c++20.md3
-rw-r--r--docs/markdown/snippets/coercing_option_values_deprecated.md9
-rw-r--r--docs/markdown/snippets/dep_objects.md5
-rw-r--r--docs/markdown/snippets/devenv.md11
-rw-r--r--docs/markdown/snippets/feature_enable_auto_if.md4
-rw-r--r--docs/markdown/snippets/feature_if_methods.md77
-rw-r--r--docs/markdown/snippets/gen_objects.md6
-rw-r--r--docs/markdown/snippets/license_files_project_info.md5
-rw-r--r--docs/markdown/snippets/licensesdir_option.md4
-rw-r--r--docs/markdown/snippets/meson_install_drop_privs.md16
-rw-r--r--docs/markdown/snippets/meson_install_elevate.md9
-rw-r--r--docs/markdown/snippets/meson_options.md7
-rw-r--r--docs/markdown/snippets/mintro_outputs.md5
-rw-r--r--docs/markdown/snippets/none-backend.md4
-rw-r--r--docs/markdown/snippets/preprocess.md6
-rw-r--r--docs/markdown/snippets/pybind11_dep.md9
-rw-r--r--docs/markdown/snippets/reconfigure.md10
-rw-r--r--docs/markdown/snippets/run_script_dry_run.md8
-rw-r--r--docs/sitemap.txt1
20 files changed, 225 insertions, 198 deletions
diff --git a/docs/markdown/Release-notes-for-1.1.0.md b/docs/markdown/Release-notes-for-1.1.0.md
new file mode 100644
index 0000000..d053948
--- /dev/null
+++ b/docs/markdown/Release-notes-for-1.1.0.md
@@ -0,0 +1,224 @@
+---
+title: Release 1.1.0
+short-description: Release notes for 1.1.0
+...
+
+# New features
+
+Meson 1.1.0 was released on 10 April 2023
+## `clang-cl` now accepts `cpp_std=c++20`
+
+Requires `clang-cl` 13 or later.
+
+## coercing values in the option() function is deprecated
+
+Currently code such as:
+```meson
+option('foo', type : 'boolean', value : 'false')
+```
+works, because Meson coerces `'false'` to `false`.
+
+This should be avoided, and will now result in a deprecation warning.
+
+## New `declare_dependency(objects: )` argument
+
+A new argument to `declare_dependency` makes it possible to add objects
+directly to executables that use an internal dependency, without going
+for example through `link_whole`.
+
+## Dump devenv into file and select format
+
+`meson devenv --dump [<filename>]` command now takes an optional filename argument
+to write the environment into a file instead of printing to stdout.
+
+A new `--dump-format` argument has been added to select which shell format
+should be used. There are currently 3 formats supported:
+- `sh`: Lines are in the format `VAR=/prepend:$VAR:/append`.
+- `export`: Same as `sh` but with extra `export VAR` lines.
+- `vscode`: Same as `sh` but without `$VAR` substitution because they do not
+ seems to be properly supported by vscode.
+
+## Feature objects now have an enable_auto_if method
+
+This performs the opposite task of the disable_auto_if method, enabling the
+feature if the condition is true.
+
+## Add a FeatureOption.enable_if and .disable_if
+
+These are useful when features need to be constrained to pass to [[dependency]],
+as the behavior of an `auto` and `disabled` or `enabled` feature is markedly
+different. consider the following case:
+
+```meson
+opt = get_option('feature').disable_auto_if(not foo)
+if opt.enabled() and not foo
+ error('Cannot enable feat when foo is not also enabled')
+endif
+dep = dependency('foo', required : opt)
+```
+
+This could be simplified to
+```meson
+opt = get_option('feature').disable_if(not foo, error_message : 'Cannot enable feature when foo is not also enabled')
+dep = dependency('foo', required : opt)
+```
+
+For a real life example, here is some code in mesa:
+```meson
+_llvm = get_option('llvm')
+dep_llvm = null_dep
+with_llvm = false
+if _llvm.allowed()
+ dep_llvm = dependency(
+ 'llvm',
+ version : _llvm_version,
+ modules : llvm_modules,
+ optional_modules : llvm_optional_modules,
+ required : (
+ with_amd_vk or with_gallium_radeonsi or with_gallium_opencl or with_clc
+ or _llvm.enabled()
+ ),
+ static : not _shared_llvm,
+ fallback : ['llvm', 'dep_llvm'],
+ include_type : 'system',
+ )
+ with_llvm = dep_llvm.found()
+endif
+if with_llvm
+ ...
+elif with_amd_vk and with_aco_tests
+ error('ACO tests require LLVM, but LLVM is disabled.')
+elif with_gallium_radeonsi or with_swrast_vk
+ error('The following drivers require LLVM: RadeonSI, SWR, Lavapipe. One of these is enabled, but LLVM is disabled.')
+elif with_gallium_opencl
+ error('The OpenCL "Clover" state tracker requires LLVM, but LLVM is disabled.')
+elif with_clc
+ error('The CLC compiler requires LLVM, but LLVM is disabled.')
+else
+ draw_with_llvm = false
+endif
+```
+
+simplified to:
+```meson
+_llvm = get_option('llvm') \
+ .enable_if(with_amd_vk and with_aco_tests, error_message : 'ACO tests requires LLVM') \
+ .enable_if(with_gallium_radeonsi, error_message : 'RadeonSI requires LLVM') \
+ .enable_if(with_swrast_vk, error_message : 'Vulkan SWRAST requires LLVM') \
+ .enable_if(with_gallium_opencl, error_message : 'The OpenCL Clover state trackers requires LLVM') \
+ .enable_if(with_clc, error_message : 'CLC library requires LLVM')
+
+dep_llvm = dependency(
+ 'llvm',
+ version : _llvm_version,
+ modules : llvm_modules,
+ optional_modules : llvm_optional_modules,
+ required : _llvm,
+ static : not _shared_llvm,
+ fallback : ['llvm', 'dep_llvm'],
+ include_type : 'system',
+)
+with_llvm = dep_llvm.found()
+```
+
+## Generated objects can be passed in the `objects:` keyword argument
+
+In previous versions of Meson, generated objects could only be
+passed as sources of a build target. This was confusing, therefore
+generated objects can now be passed in the `objects:` keyword
+argument as well.
+
+## The project function now supports setting the project license files
+
+This goes together with the license name. The license files can be
+automatically installed via [[meson.install_dependency_manifest]],
+or queried via [[meson.project_license_files]].
+
+## A new core directory option "licensedir" is available
+
+This will install a dependency manifest to the specified directory, if none
+is is explicitly set.
+
+## `sudo meson install` now drops privileges when rebuilding targets
+
+It is common to install projects using sudo, which should not affect build
+outputs but simply install the results. Unfortunately, since the ninja backend
+updates a state file when run, it's not safe to run ninja as root at all.
+
+It has always been possible to carefully build with:
+
+```
+ninja && sudo meson install --no-rebuild
+```
+
+Meson now tries to be extra safe as a general solution. `sudo meson install`
+will attempt to rebuild, but has learned to run `ninja` as the original
+(pre-sudo or pre-doas) user, ensuring that build outputs are generated/compiled
+as non-root.
+
+## `meson install` now supports user-preferred root elevation tools
+
+Previously, when installing a project, if any files could not be installed due
+to insufficient permissions the install process was automatically re-run using
+polkit. Now it prompts to ask whether that is desirable, and checks for
+CLI-based tools such as sudo or opendoas or `$MESON_ROOT_CMD`, first.
+
+Meson will no longer attempt privilege elevation at all, when not running
+interactively.
+
+## Support for reading options from meson.options
+
+Support has been added for reading options from `meson.options` instead of
+`meson_options.txt`. These are equivalent, but not using the `.txt` extension
+for a build file has a few advantages, chief among them many tools and text
+editors expect a file with the `.txt` extension to be plain text files, not
+build scripts.
+
+## Redirect introspection outputs to stderr
+
+`meson introspect` used to disable logging to `stdout` to not interfere with generated json.
+It now redirect outputs to `stderr` to allow printing warnings to the console
+while keeping `stdout` clean for json outputs.
+
+## New "none" backend
+
+The `--backend=none` option has been added, to configure a project that has no
+build rules, only install rules. This avoids depending on ninja.
+
+## compiler.preprocess()
+
+Dependencies keyword argument can now be passed to `compiler.preprocess()` to
+add include directories or compiler arguments.
+
+Generated sources such as custom targets are now allowed too.
+
+## New pybind11 custom dependency
+
+`dependency('pybind11')` works with pkg-config and cmake without any special
+support, but did not handle the `pybind11-config` script.
+
+This is useful because the config-tool will work out of the box when pybind11
+is installed, but the pkg-config and cmake files are shoved into python's
+site-packages, which makes it impossible to use in an out of the box manner.
+
+
+## Allow --reconfigure and --wipe of empty builddir
+
+`meson setup --reconfigure builddir` and `meson setup --wipe builddir` are now
+accepting `builddir/` to be empty or containing a previously failed setup attempt.
+Note that in that case previously passed command line options must be repeated
+as only a successful build saves configured options.
+
+This is useful for example with scripts that always repeat all options,
+`meson setup builddir --wipe -Dfoo=bar` will always work regardless whether
+it is a first invocation or not.
+
+## Allow custom install scripts to run with `--dry-run` option
+
+An new `dry_run` keyword is added to `meson.add_install_script()`
+to allow a custom install script to run when meson is invoked
+with `meson install --dry-run`.
+
+In dry run mode, the `MESON_INSTALL_DRY_RUN` environment variable
+is set.
+
diff --git a/docs/markdown/snippets/clang_cl_c++20.md b/docs/markdown/snippets/clang_cl_c++20.md
deleted file mode 100644
index 9abc874..0000000
--- a/docs/markdown/snippets/clang_cl_c++20.md
+++ /dev/null
@@ -1,3 +0,0 @@
-## `clang-cl` now accepts `cpp_std=c++20`
-
-Requires `clang-cl` 13 or later.
diff --git a/docs/markdown/snippets/coercing_option_values_deprecated.md b/docs/markdown/snippets/coercing_option_values_deprecated.md
deleted file mode 100644
index 3621387..0000000
--- a/docs/markdown/snippets/coercing_option_values_deprecated.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## coercing values in the option() function is deprecated
-
-Currently code such as:
-```meson
-option('foo', type : 'boolean', value : 'false')
-```
-works, because Meson coerces `'false'` to `false`.
-
-This should be avoided, and will now result in a deprecation warning.
diff --git a/docs/markdown/snippets/dep_objects.md b/docs/markdown/snippets/dep_objects.md
deleted file mode 100644
index 9208977..0000000
--- a/docs/markdown/snippets/dep_objects.md
+++ /dev/null
@@ -1,5 +0,0 @@
-## New `declare_dependency(objects: )` argument
-
-A new argument to `declare_dependency` makes it possible to add objects
-directly to executables that use an internal dependency, without going
-for example through `link_whole`.
diff --git a/docs/markdown/snippets/devenv.md b/docs/markdown/snippets/devenv.md
deleted file mode 100644
index 3f9ccc3..0000000
--- a/docs/markdown/snippets/devenv.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## Dump devenv into file and select format
-
-`meson devenv --dump [<filename>]` command now takes an optional filename argument
-to write the environment into a file instead of printing to stdout.
-
-A new `--dump-format` argument has been added to select which shell format
-should be used. There are currently 3 formats supported:
-- `sh`: Lines are in the format `VAR=/prepend:$VAR:/append`.
-- `export`: Same as `sh` but with extra `export VAR` lines.
-- `vscode`: Same as `sh` but without `$VAR` substitution because they do not
- seems to be properly supported by vscode.
diff --git a/docs/markdown/snippets/feature_enable_auto_if.md b/docs/markdown/snippets/feature_enable_auto_if.md
deleted file mode 100644
index 5461004..0000000
--- a/docs/markdown/snippets/feature_enable_auto_if.md
+++ /dev/null
@@ -1,4 +0,0 @@
-## Feature objects now have an enable_auto_if method
-
-This performs the opposite task of the disable_auto_if method, enabling the
-feature if the condition is true.
diff --git a/docs/markdown/snippets/feature_if_methods.md b/docs/markdown/snippets/feature_if_methods.md
deleted file mode 100644
index 9d77534..0000000
--- a/docs/markdown/snippets/feature_if_methods.md
+++ /dev/null
@@ -1,77 +0,0 @@
-## Add a FeatureOption.enable_if and .disable_if
-
-These are useful when features need to be constrained to pass to [[dependency]],
-as the behavior of an `auto` and `disabled` or `enabled` feature is markedly
-different. consider the following case:
-
-```meson
-opt = get_option('feature').disable_auto_if(not foo)
-if opt.enabled() and not foo
- error('Cannot enable feat when foo is not also enabled')
-endif
-dep = dependency('foo', required : opt)
-```
-
-This could be simplified to
-```meson
-opt = get_option('feature').disable_if(not foo, error_message : 'Cannot enable feature when foo is not also enabled')
-dep = dependency('foo', required : opt)
-```
-
-For a real life example, here is some code in mesa:
-```meson
-_llvm = get_option('llvm')
-dep_llvm = null_dep
-with_llvm = false
-if _llvm.allowed()
- dep_llvm = dependency(
- 'llvm',
- version : _llvm_version,
- modules : llvm_modules,
- optional_modules : llvm_optional_modules,
- required : (
- with_amd_vk or with_gallium_radeonsi or with_gallium_opencl or with_clc
- or _llvm.enabled()
- ),
- static : not _shared_llvm,
- fallback : ['llvm', 'dep_llvm'],
- include_type : 'system',
- )
- with_llvm = dep_llvm.found()
-endif
-if with_llvm
- ...
-elif with_amd_vk and with_aco_tests
- error('ACO tests require LLVM, but LLVM is disabled.')
-elif with_gallium_radeonsi or with_swrast_vk
- error('The following drivers require LLVM: RadeonSI, SWR, Lavapipe. One of these is enabled, but LLVM is disabled.')
-elif with_gallium_opencl
- error('The OpenCL "Clover" state tracker requires LLVM, but LLVM is disabled.')
-elif with_clc
- error('The CLC compiler requires LLVM, but LLVM is disabled.')
-else
- draw_with_llvm = false
-endif
-```
-
-simplified to:
-```meson
-_llvm = get_option('llvm') \
- .enable_if(with_amd_vk and with_aco_tests, error_message : 'ACO tests requires LLVM') \
- .enable_if(with_gallium_radeonsi, error_message : 'RadeonSI requires LLVM') \
- .enable_if(with_swrast_vk, error_message : 'Vulkan SWRAST requires LLVM') \
- .enable_if(with_gallium_opencl, error_message : 'The OpenCL Clover state trackers requires LLVM') \
- .enable_if(with_clc, error_message : 'CLC library requires LLVM')
-
-dep_llvm = dependency(
- 'llvm',
- version : _llvm_version,
- modules : llvm_modules,
- optional_modules : llvm_optional_modules,
- required : _llvm,
- static : not _shared_llvm,
- fallback : ['llvm', 'dep_llvm'],
- include_type : 'system',
-)
-with_llvm = dep_llvm.found()
-```
diff --git a/docs/markdown/snippets/gen_objects.md b/docs/markdown/snippets/gen_objects.md
deleted file mode 100644
index fecd701..0000000
--- a/docs/markdown/snippets/gen_objects.md
+++ /dev/null
@@ -1,6 +0,0 @@
-## Generated objects can be passed in the `objects:` keyword argument
-
-In previous versions of Meson, generated objects could only be
-passed as sources of a build target. This was confusing, therefore
-generated objects can now be passed in the `objects:` keyword
-argument as well.
diff --git a/docs/markdown/snippets/license_files_project_info.md b/docs/markdown/snippets/license_files_project_info.md
deleted file mode 100644
index 073ba1b..0000000
--- a/docs/markdown/snippets/license_files_project_info.md
+++ /dev/null
@@ -1,5 +0,0 @@
-## The project function now supports setting the project license files
-
-This goes together with the license name. The license files can be
-automatically installed via [[meson.install_dependency_manifest]],
-or queried via [[meson.project_license_files]].
diff --git a/docs/markdown/snippets/licensesdir_option.md b/docs/markdown/snippets/licensesdir_option.md
deleted file mode 100644
index 77ccd0d..0000000
--- a/docs/markdown/snippets/licensesdir_option.md
+++ /dev/null
@@ -1,4 +0,0 @@
-## A new core directory option "licensedir" is available
-
-This will install a dependency manifest to the specified directory, if none
-is is explicitly set.
diff --git a/docs/markdown/snippets/meson_install_drop_privs.md b/docs/markdown/snippets/meson_install_drop_privs.md
deleted file mode 100644
index e08dfc0..0000000
--- a/docs/markdown/snippets/meson_install_drop_privs.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## `sudo meson install` now drops privileges when rebuilding targets
-
-It is common to install projects using sudo, which should not affect build
-outputs but simply install the results. Unfortunately, since the ninja backend
-updates a state file when run, it's not safe to run ninja as root at all.
-
-It has always been possible to carefully build with:
-
-```
-ninja && sudo meson install --no-rebuild
-```
-
-Meson now tries to be extra safe as a general solution. `sudo meson install`
-will attempt to rebuild, but has learned to run `ninja` as the original
-(pre-sudo or pre-doas) user, ensuring that build outputs are generated/compiled
-as non-root.
diff --git a/docs/markdown/snippets/meson_install_elevate.md b/docs/markdown/snippets/meson_install_elevate.md
deleted file mode 100644
index 2ba92e6..0000000
--- a/docs/markdown/snippets/meson_install_elevate.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## `meson install` now supports user-preferred root elevation tools
-
-Previously, when installing a project, if any files could not be installed due
-to insufficient permissions the install process was automatically re-run using
-polkit. Now it prompts to ask whether that is desirable, and checks for
-CLI-based tools such as sudo or opendoas or `$MESON_ROOT_CMD`, first.
-
-Meson will no longer attempt privilege elevation at all, when not running
-interactively.
diff --git a/docs/markdown/snippets/meson_options.md b/docs/markdown/snippets/meson_options.md
deleted file mode 100644
index f9d582a..0000000
--- a/docs/markdown/snippets/meson_options.md
+++ /dev/null
@@ -1,7 +0,0 @@
-## Support for reading options from meson.options
-
-Support has been added for reading options from `meson.options` instead of
-`meson_options.txt`. These are equivalent, but not using the `.txt` extension
-for a build file has a few advantages, chief among them many tools and text
-editors expect a file with the `.txt` extension to be plain text files, not
-build scripts.
diff --git a/docs/markdown/snippets/mintro_outputs.md b/docs/markdown/snippets/mintro_outputs.md
deleted file mode 100644
index cfc7f8c..0000000
--- a/docs/markdown/snippets/mintro_outputs.md
+++ /dev/null
@@ -1,5 +0,0 @@
-## Redirect introspection outputs to stderr
-
-`meson introspect` used to disable logging to `stdout` to not interfere with generated json.
-It now redirect outputs to `stderr` to allow printing warnings to the console
-while keeping `stdout` clean for json outputs.
diff --git a/docs/markdown/snippets/none-backend.md b/docs/markdown/snippets/none-backend.md
deleted file mode 100644
index 766430d..0000000
--- a/docs/markdown/snippets/none-backend.md
+++ /dev/null
@@ -1,4 +0,0 @@
-## New "none" backend
-
-The `--backend=none` option has been added, to configure a project that has no
-build rules, only install rules. This avoids depending on ninja.
diff --git a/docs/markdown/snippets/preprocess.md b/docs/markdown/snippets/preprocess.md
deleted file mode 100644
index c6cdc08..0000000
--- a/docs/markdown/snippets/preprocess.md
+++ /dev/null
@@ -1,6 +0,0 @@
-## compiler.preprocess()
-
-Dependencies keyword argument can now be passed to `compiler.preprocess()` to
-add include directories or compiler arguments.
-
-Generated sources such as custom targets are now allowed too.
diff --git a/docs/markdown/snippets/pybind11_dep.md b/docs/markdown/snippets/pybind11_dep.md
deleted file mode 100644
index ac19701..0000000
--- a/docs/markdown/snippets/pybind11_dep.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## New pybind11 custom dependency
-
-`dependency('pybind11')` works with pkg-config and cmake without any special
-support, but did not handle the `pybind11-config` script.
-
-This is useful because the config-tool will work out of the box when pybind11
-is installed, but the pkg-config and cmake files are shoved into python's
-site-packages, which makes it impossible to use in an out of the box manner.
-
diff --git a/docs/markdown/snippets/reconfigure.md b/docs/markdown/snippets/reconfigure.md
deleted file mode 100644
index b4a2dac..0000000
--- a/docs/markdown/snippets/reconfigure.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## Allow --reconfigure and --wipe of empty builddir
-
-`meson setup --reconfigure builddir` and `meson setup --wipe builddir` are now
-accepting `builddir/` to be empty or containing a previously failed setup attempt.
-Note that in that case previously passed command line options must be repeated
-as only a successful build saves configured options.
-
-This is useful for example with scripts that always repeat all options,
-`meson setup builddir --wipe -Dfoo=bar` will always work regardless whether
-it is a first invocation or not.
diff --git a/docs/markdown/snippets/run_script_dry_run.md b/docs/markdown/snippets/run_script_dry_run.md
deleted file mode 100644
index aee32c7..0000000
--- a/docs/markdown/snippets/run_script_dry_run.md
+++ /dev/null
@@ -1,8 +0,0 @@
-## Allow custom install scripts to run with `--dry-run` option
-
-An new `dry_run` keyword is added to `meson.add_install_script()`
-to allow a custom install script to run when meson is invoked
-with `meson install --dry-run`.
-
-In dry run mode, the `MESON_INSTALL_DRY_RUN` environment variable
-is set.
diff --git a/docs/sitemap.txt b/docs/sitemap.txt
index 4494afe..65c7f69 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.1.0.md
Release-notes-for-1.0.0.md
Release-notes-for-0.64.0.md
Release-notes-for-0.63.0.md