From ec616c2aa5584d116116713f5b0286e428bb9b45 Mon Sep 17 00:00:00 2001 From: Sander Sweers Date: Sun, 27 May 2018 22:33:15 +0200 Subject: [PATCH] configure_file: Add release snippet for encoding keyword --- docs/markdown/snippets/configure_file_encoding.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 docs/markdown/snippets/configure_file_encoding.md diff --git a/docs/markdown/snippets/configure_file_encoding.md b/docs/markdown/snippets/configure_file_encoding.md new file mode 100644 index 000000000..808217785 --- /dev/null +++ b/docs/markdown/snippets/configure_file_encoding.md @@ -0,0 +1,12 @@ +## New encoding keyword for configure_file + +Add a new keyword to [`configure_file()`](#Reference-manual.md#configure_file) +that allows the developer to specify the input and output file encoding. + +If the file encoding of the input is not UTF-8 meson can crash (see #1542). +A crash as with UTF-16 is the best case and the worst meson will silently +corrupt the output file for example with ISO-2022-JP. For additional details +see pull request #3135. + +The new keyword defaults to UTF-8 and the documentation strongly suggest to +convert the file to UTF-8 when possible.