aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/snippets/string_format.md10
-rw-r--r--docs/yaml/elementary/str.yml4
2 files changed, 14 insertions, 0 deletions
diff --git a/docs/markdown/snippets/string_format.md b/docs/markdown/snippets/string_format.md
new file mode 100644
index 0000000..fa33617
--- /dev/null
+++ b/docs/markdown/snippets/string_format.md
@@ -0,0 +1,10 @@
+## Unified message(), str.format() and f-string formatting
+
+They now all support the same set of values: strings, integers, bools, options,
+dictionaries and lists thereof.
+
+- Feature options (i.e. enabled, disabled, auto) were not previously supported
+ by any of those functions.
+- Lists and dictionaries were not previously supported by f-string.
+- str.format() allowed any type and often resulted in printing the internal
+ representation which is now deprecated.
diff --git a/docs/yaml/elementary/str.yml b/docs/yaml/elementary/str.yml
index 7748121..83ab3dd 100644
--- a/docs/yaml/elementary/str.yml
+++ b/docs/yaml/elementary/str.yml
@@ -14,6 +14,10 @@ methods:
See [the Meson syntax entry](Syntax.md#string-formatting) for more
information.
+
+ *Since 1.3.0* values other than strings, integers, bools, options,
+ dictionaries and lists thereof are deprecated. They were previously printing
+ the internal representation of the raw Python object.
example: |
```meson
template = 'string: @0@, number: @1@, bool: @2@'