aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown
diff options
context:
space:
mode:
authorNiklas Claesson <niklas.claesson@cosylab.com>2018-04-14 23:01:56 +0200
committerNirbheek Chauhan <nirbheek.chauhan@gmail.com>2018-04-17 09:55:34 +0000
commitb42dd7df0ab2ec994ed83d39522c25db92231f9f (patch)
tree00d648588f2220fb38f82d682546c8eb558f199d /docs/markdown
parent36aab0f4b2a05a1ae4c8603e57b4c3c684fe8ea8 (diff)
downloadmeson-b42dd7df0ab2ec994ed83d39522c25db92231f9f.zip
meson-b42dd7df0ab2ec994ed83d39522c25db92231f9f.tar.gz
meson-b42dd7df0ab2ec994ed83d39522c25db92231f9f.tar.bz2
Add release snippet
Diffstat (limited to 'docs/markdown')
-rw-r--r--docs/markdown/snippets/more-escape-sequences.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/markdown/snippets/more-escape-sequences.md b/docs/markdown/snippets/more-escape-sequences.md
new file mode 100644
index 0000000..2894079
--- /dev/null
+++ b/docs/markdown/snippets/more-escape-sequences.md
@@ -0,0 +1,17 @@
+## String escape character update
+
+The strings (both single-quoted and triple-quoted) in meson has been taught the
+same set of escape sequences as in Python. It is therefore now possible to use
+arbitrary bytes in strings, like for example NUL (`\0`) and other ASCII control
+characters. See the chapter about *Strings* in *Syntax* for more details.
+
+Potential backwards compatibility issue: Any valid escape sequence according to
+the new rules will be interpreted as an escape sequence instead of the literal
+characters. Previously only single-quote strings supported escape sequences and
+the supported sequences were `\'`, `\\` and `\n`.
+
+The most likely breakage is usage of backslash-n in triple-quoted strings. It
+is now written in the same way as in single-quoted strings: `\\n` instead of
+`\n`. In general it is now recommended to escape any usage of backslash.
+However, backslash-c (`\c`), for example, is still backslash-c because it isn't
+a valid escape sequence.