summaryrefslogtreecommitdiffstats
path: root/Help/command
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2024-09-12 17:34:01 (GMT)
committerBrad King <brad.king@kitware.com>2024-09-13 12:19:57 (GMT)
commit3898e53e82abc59efc7a09feaadef2daf5af7174 (patch)
tree1bcc30eb29fdd156bea8dbd8c635ed4ccc064e1d /Help/command
parentd67519fce8ba955d871f253fca1741c27b486a33 (diff)
downloadCMake-3898e53e82abc59efc7a09feaadef2daf5af7174.zip
CMake-3898e53e82abc59efc7a09feaadef2daf5af7174.tar.gz
CMake-3898e53e82abc59efc7a09feaadef2daf5af7174.tar.bz2
execute_process: Document and test ENCODING default
The default was originally AUTO in commit 2ed473b3b8 (execute_process: Add ENCODING option for Windows child process output, 2016-11-23, v3.8.0-rc1~232^2) but was changed back to NONE by commit 07c3380a6e (execute_process: Restore no-decoding default behavior, 2017-02-13, v3.8.0-rc2~26^2) for CMake 3.8. Later it was accidentally changed back to AUTO by commit b783e62533 (cmExecuteProcessCommand: Port to cmArgumentParser, 2019-03-25, v3.15.0-rc1~270^2) in CMake 3.15 but the documentation was not updated. Document the current default, AUTO, and add a test case to verify it. Issue: #26262
Diffstat (limited to 'Help/command')
-rw-r--r--Help/command/execute_process.rst5
1 files changed, 4 insertions, 1 deletions
diff --git a/Help/command/execute_process.rst b/Help/command/execute_process.rst
index c02dbba..2591dba 100644
--- a/Help/command/execute_process.rst
+++ b/Help/command/execute_process.rst
@@ -140,12 +140,15 @@ Options:
``NONE``
Perform no decoding. This assumes that the process output is encoded
in the same way as CMake's internal encoding (UTF-8).
- This is the default.
+
+ This was the default in CMake 3.14 and older.
``AUTO``
Use the current active console's codepage or if that isn't
available then use ANSI.
+ This is the default since CMake 3.15.
+
``ANSI``
Use the ANSI codepage.