Virtualization
/
meson
mirror of https://gitlab.com/qemu-project/meson.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Tweak some 0.46 release note language [skip ci]

This commit is contained in:
Nirbheek Chauhan 2018-04-24 08:21:37 +05:30 committed by GitHub
parent 63b4cd5f6d
commit eb6b56216c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 30 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
docs/markdown/Release-notes-for-0.46.0.md
View File

@ -11,6 +11,7 @@ Added the function `subdir_done()`. Its invocation exits the current script at
the point of invocation. All previously invoked build targets and commands are the point of invocation. All previously invoked build targets and commands are
build/executed. All following ones are ignored. If the current script was build/executed. All following ones are ignored. If the current script was
invoked via `subdir()` the parent script continues normally. invoked via `subdir()` the parent script continues normally.
## Log output slightly changed ## Log output slightly changed
The format of some human-readable diagnostic messages has changed in The format of some human-readable diagnostic messages has changed in
@ -38,8 +39,8 @@ cpp_args = ['--cpu=Cortex-M0plus']
A new function `both_libraries()` has been added to build both shared and static A new function `both_libraries()` has been added to build both shared and static
libraries at the same time. Source files will be compiled only once and object libraries at the same time. Source files will be compiled only once and object
files will be reused to build both shared and static libraries, unless files will be reused to build both shared and static libraries, unless
`b_staticpic` user option or `pic` argument are set to false in which case `b_staticpic` user option or `pic:` keyword argument are set to false in which
sources will be compiled twice. case sources will be compiled twice.
The returned `buildtarget` object always represents the shared library. The returned `buildtarget` object always represents the shared library.
@ -56,14 +57,14 @@ result = run_command(cc, '-print-file-name=plugin')
plugin_dev_path = result.stdout().strip() plugin_dev_path = result.stdout().strip()
``` ```
## declare_dependency() supports link_whole ## declare_dependency() now supports `link_whole:`
`declare_dependency()` supports `link_whole` parameter. `declare_dependency()` now supports the `link_whole:` keyword argument which
`link_whole` propagates to build target that uses dependency. transparently works for build targets which use that dependency.
## Old command names are now errors ## Old command names are now errors
Old executable names `mesonintrospect`, `mesonconf`, `mesonrewriter` The old executable names `mesonintrospect`, `mesonconf`, `mesonrewriter`
and `mesontest` have been deprecated for a long time. Starting from and `mesontest` have been deprecated for a long time. Starting from
this version they no longer do anything but instead always error this version they no longer do anything but instead always error
out. All functionality is available as subcommands in the main `meson` out. All functionality is available as subcommands in the main `meson`
@ -78,8 +79,8 @@ form, like `meson` has.
## Recursively extract objects ## Recursively extract objects
`recursive` keyword argument has been added to `extract_all_objects`. When set The `recursive:` keyword argument has been added to `extract_all_objects()`. When set
to `true` it will also return objects passed to the `objects` argument of this to `true` it will also return objects passed to the `objects:` argument of this
target. By default only objects built for this target are returned to maintain target. By default only objects built for this target are returned to maintain
backward compatibility with previous versions. The default will eventually be backward compatibility with previous versions. The default will eventually be
changed to `true` in a future version. changed to `true` in a future version.
@ -89,7 +90,7 @@ lib1 = static_library('a', 'source.c', objects : 'prebuilt.o')
lib2 = static_library('b', objects : lib1.extract_all_objects(recursive : true)) lib2 = static_library('b', objects : lib1.extract_all_objects(recursive : true))
``` ```
## Can override find_program ## Can override find_program()
It is now possible to override the result of `find_program` to point It is now possible to override the result of `find_program` to point
to a custom program you want. The overriding is global and applies to to a custom program you want. The overriding is global and applies to
@ -127,10 +128,10 @@ prog_script = configure_file(input : 'script.sh.in',
meson.override_find_program('mycodegen', prog_script) meson.override_find_program('mycodegen', prog_script)
``` ```
## has_link_argument() and friends ## New functions: has_link_argument() and friends
A new set of methods has been added on compiler objects to test if the linker A new set of methods has been added to [compiler objects](Reference-manual.md#compiler-object)
supports given arguments. to test if the linker supports given arguments.
- `has_link_argument()` - `has_link_argument()`
- `has_multi_link_arguments()` - `has_multi_link_arguments()`
@ -164,12 +165,14 @@ meson.build for them with the dependencies of sdl2 and gl and
immediately try to build it, overwriting any previous meson.build and immediately try to build it, overwriting any previous meson.build and
build directory. build directory.
## install_data() supports rename ## install_data() supports `rename:`
The `rename:` keyword argument is used to change names of the installed
files. Here's how you install and rename the following files:
`rename` parameter is used to change names of the installed files.
In order to install
- `file1.txt` into `share/myapp/dir1/data.txt` - `file1.txt` into `share/myapp/dir1/data.txt`
- `file2.txt` into `share/myapp/dir2/data.txt` - `file2.txt` into `share/myapp/dir2/data.txt`
```meson ```meson
install_data(['file1.txt', 'file2.txt'], install_data(['file1.txt', 'file2.txt'],
rename : ['dir1/data.txt', 'dir2/data.txt'], rename : ['dir1/data.txt', 'dir2/data.txt'],
@ -274,8 +277,9 @@ Now the generated file contains the needed dependencies libraries directly withi
argument. argument.
Projects that install both a static and a shared version of a library should use Projects that install both a static and a shared version of a library should use
the result of `both_libraries` to the pkg config file generator or use the result of [`both_libraries()`](Reference-manual.md#both_libraries) to the
configure_file for more complicated setups. pkg-config file generator or use [`configure_file()`](Reference-manual.md#configure_file)
for more complicated setups.
## Improvements to pkgconfig module ## Improvements to pkgconfig module
@ -294,19 +298,19 @@ pkgconfig.generate(mylib)
## pkgconfig.generate() requires parameters non-string arguments ## pkgconfig.generate() requires parameters non-string arguments
`pkgconfig.generate()` `requires` and `requires_private` parameters `pkgconfig.generate()` `requires:` and `requires_private:` keyword arguments
accept pkgconfig-dependencies and libraries that pkgconfig-files were now accept pkgconfig-dependencies and libraries that pkgconfig-files were
generated for. generated for.
## Generic python module ## Generic python module
This is a revamped and generic (python 2 and 3) version of the python3 Meson now has is a revamped and generic (python 2 and 3) version of the python3
module. With this new interface, projects can now fully specify the version module. With [this new interface](Python-module.md), projects can now fully
of python they want to build against / install sources to, and can do so specify the version of python they want to build against / install sources to,
against multiple major or minor versions in parallel. and can do so against multiple major or minor versions in parallel.
## test now supports depends keyword parameter ## test() now supports the `depends:` keyword argument
Build targets and custom targets can be listed in depends argument of test Build targets and custom targets can be listed in the `depends:` keyword argument
function. These targets will be built before test is run even if they have of test function. These targets will be built before test is run even if they have
`build_by_default : false`. `build_by_default : false`.