aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorNirbheek Chauhan <nirbheek@centricular.com>2018-12-13 20:05:29 +0530
committerNirbheek Chauhan <nirbheek@centricular.com>2018-12-13 20:06:31 +0530
commit99e77cf48dccb7bc01cf02e38b85f61bebfc22cf (patch)
tree45524fbd50150ddb7e902dcee9c8b19f5bfcc39c /docs
parent261ab9b2140005d4f7e42118ccb6598fa5b7f15d (diff)
downloadmeson-99e77cf48dccb7bc01cf02e38b85f61bebfc22cf.zip
meson-99e77cf48dccb7bc01cf02e38b85f61bebfc22cf.tar.gz
meson-99e77cf48dccb7bc01cf02e38b85f61bebfc22cf.tar.bz2
docs: Consistently use the same heading level in release notes [skip ci]
Otherwise some headings are much too large.
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/Release-notes-for-0.38.0.md24
-rw-r--r--docs/markdown/Release-notes-for-0.43.0.md14
-rw-r--r--docs/markdown/Release-notes-for-0.45.0.md3
3 files changed, 21 insertions, 20 deletions
diff --git a/docs/markdown/Release-notes-for-0.38.0.md b/docs/markdown/Release-notes-for-0.38.0.md
index 741c349..cbd8fff 100644
--- a/docs/markdown/Release-notes-for-0.38.0.md
+++ b/docs/markdown/Release-notes-for-0.38.0.md
@@ -3,11 +3,11 @@ title: Release 0.38
short-description: Release notes for 0.38
...
-# Uninstall target
+## Uninstall target
Meson allows you to uninstall an install step by invoking the uninstall target. This will remove all files installed as part of install. Note that this does not restore the original files. This also does not undo changes done by custom install scripts (because they can do arbitrary install operations).
-# Support for arbitrary test setups
+## Support for arbitrary test setups
Sometimes you need to run unit tests with special settings. For example under Valgrind. Usually this requires extra command line options for the tool. This is supported with the new *test setup* feature. For example to set up a test run with Valgrind, you'd write this in a `meson.build` file:
@@ -23,11 +23,11 @@ This tells Meson to run tests with Valgrind using the given options and multiply
$ mesontest --setup=valgrind
```
-# Intel C/C++ compiler support
+## Intel C/C++ compiler support
As usual, just set `CC=icc CXX=icpc` and Meson will use it as the C/C++ compiler. Currently only Linux is supported.
-# Get values from configuration data objects
+## Get values from configuration data objects
Now it is possible to query values stored in configuration data objects.
@@ -38,7 +38,7 @@ cdata.get('nokey', 'default') # returns 'default'
cdata.get('nokey') # halts with an error
```
-# Python 3 module support
+## Python 3 module support
Building Python 3 extension modules has always been possible, but it is now even easier:
@@ -49,7 +49,7 @@ pylib = py3_mod.extension_module('modname',
dependencies : py3_dep)
```
-# Default options to subprojects
+## Default options to subprojects
Projects can specify overriding values for subprojects' `default_options` when invoking a subproject:
@@ -60,23 +60,23 @@ dependency('some-dep', fallback : ['some_subproject', 'some_dep'], default_optio
The effect is the same as if the default options were written in the subproject's `project` call.
-# Set targets to be built (or not) by default
+## Set targets to be built (or not) by default
Build targets got a new keyword `build_by_default` which tells whether the target should be built by default when running e.g. `ninja`. Custom targets are not built by default but other targets are. Any target that is tagged as installed or to be built always is also built by default, regardless of the value of this keyword.
-# Add option to mesonconf to wipe cached data.
+## Add option to mesonconf to wipe cached data.
Meson caches the results of dependency lookups. Sometimes these may get out of sync with the system state. Mesonconf now has a `--clearcache` option to clear these values so they will be re-searched from the system upon next compile.
-# Can specify file permissions and owner when installing data
+## Can specify file permissions and owner when installing data
The new `install_mode` keyword argument can be used to specify file permissions and uid/gid of files when doing the install. This allows you to, for example, install suid root scripts.
-# `has_header()` checks are now faster
+## `has_header()` checks are now faster
When using compilers that implement the [`__has_include()` preprocessor macro](https://clang.llvm.org/docs/LanguageExtensions.html#include-file-checking-macros), the check is now ~40% faster.
-# Array indexing now supports fallback values
+## Array indexing now supports fallback values
The second argument to the array [`.get()`](Reference-manual.md#array-object) function is now returned if the specified index could not be found
```meson
@@ -86,6 +86,6 @@ array.get(4) # this will give an error about invalid index
array.get(4, 0) # this will return `0`
```
-# Silent mode for Mesontest
+## Silent mode for Mesontest
The Meson test executor got a new argument `-q` (and `--quiet`) that suppresses all output of successful tests. This makes interactive usage nicer because only errors are printed.
diff --git a/docs/markdown/Release-notes-for-0.43.0.md b/docs/markdown/Release-notes-for-0.43.0.md
index 7702f3c..0ca66ae 100644
--- a/docs/markdown/Release-notes-for-0.43.0.md
+++ b/docs/markdown/Release-notes-for-0.43.0.md
@@ -3,7 +3,7 @@ title: Release 0.43
short-description: Release notes for 0.43
...
-# Portability improvements to Boost Dependency
+## Portability improvements to Boost Dependency
The Boost dependency has been improved to better detect the various ways to
install boost on multiple platforms. At the same time the `modules` semantics
@@ -14,12 +14,12 @@ used to specify libraries that require linking.
This is a breaking change and the fix is to remove all modules that aren't
found.
-# Generator learned capture
+## Generator learned capture
Generators can now be configured to capture the standard output. See
`test cases/common/98 gen extra/meson.build` for an example.
-# Can index CustomTarget objects
+## Can index CustomTarget objects
The `CustomTarget` object can now be indexed like an array. The resulting
object can be used as a source file for other Targets, this will create a
@@ -43,7 +43,7 @@ exec = executable(
)
```
-# Can override executables in the cross file
+## Can override executables in the cross file
The cross file can now be used for overriding the result of
`find_program`. As an example if you want to find the `objdump`
@@ -63,7 +63,7 @@ objdump, you can specify the `native` keyword like this:
native_objdump = find_program('objdump', native : true)
```
-# Easier handling of supported compiler arguments
+## Easier handling of supported compiler arguments
A common pattern for handling multiple desired compiler arguments, was to
test their presence and add them to an array one-by-one, e.g.:
@@ -91,7 +91,7 @@ warning_flags = [ ... ]
flags = cc.get_supported_arguments(warning_flags)
```
-# Better support for shared libraries in non-system paths
+## Better support for shared libraries in non-system paths
Meson has support for prebuilt object files and static libraries.
This release adds feature parity to shared libraries that are either
@@ -114,7 +114,7 @@ mydep = declare_dependency(include_directories : include_directories('.'),
Then you can use the dependency object in the same way as any other.
-# wrap-svn
+## wrap-svn
The [Wrap dependency system](Wrap-dependency-system-manual.md) now
supports [Subversion](https://subversion.apache.org/) (svn). This
diff --git a/docs/markdown/Release-notes-for-0.45.0.md b/docs/markdown/Release-notes-for-0.45.0.md
index 19d65b8..2b67f9b 100644
--- a/docs/markdown/Release-notes-for-0.45.0.md
+++ b/docs/markdown/Release-notes-for-0.45.0.md
@@ -176,7 +176,8 @@ defined in it.
## Can use custom targets as Windows resource files
The `compile_resources()` function of the `windows` module can now be used on custom targets as well as regular files.
-# Can promote dependencies with wrap command
+
+## Can promote dependencies with wrap command
The `promote` command makes it easy to copy nested dependencies to the top level.