From c3ffc1a2497e41b232d4e3d4da220381cb3c0371 Mon Sep 17 00:00:00 2001
From: Nirbheek Chauhan <nirbheek@centricular.com>
Date: Sat, 2 Jun 2018 02:44:59 +0530
Subject: docs: Add a release notes snippet about FeatureNew

---
 docs/markdown/snippets/feature_new.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 docs/markdown/snippets/feature_new.md

(limited to 'docs/markdown/snippets')

diff --git a/docs/markdown/snippets/feature_new.md b/docs/markdown/snippets/feature_new.md
new file mode 100644
index 0000000..7480634
--- /dev/null
+++ b/docs/markdown/snippets/feature_new.md
@@ -0,0 +1,32 @@
+## Feature detection based on meson_version in project()
+
+Meson will now print a `WARNING:` message during configuration if you use
+a function or a keyword argument that was added in a meson version that's newer
+than the version specified inside `project()`. For example:
+
+```meson
+project('featurenew', meson_version: '>=0.43')
+
+cdata = configuration_data()
+cdata.set('FOO', 'bar')
+message(cdata.get_unquoted('FOO'))
+```
+
+This will output:
+
+```
+The Meson build system
+Version: 0.47.0.dev1
+Source dir: C:\path\to\srctree
+Build dir: C:\path\to\buildtree
+Build type: native build
+Project name: featurenew
+Project version: undefined
+Build machine cpu family: x86_64
+Build machine cpu: x86_64
+WARNING: Project targetting '>=0.43' but tried to use feature introduced in '0.44.0': get_unquoted
+Message: bar
+Build targets in project: 0
+Minimum version of features used:
+0.44.0: {'get_unquoted'}
+```
-- 
cgit v1.1