diff options
author | Brad King <brad.king@kitware.com> | 2024-09-12 17:34:01 (GMT) |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2024-09-13 12:19:57 (GMT) |
commit | 3898e53e82abc59efc7a09feaadef2daf5af7174 (patch) | |
tree | 1bcc30eb29fdd156bea8dbd8c635ed4ccc064e1d /Help/command | |
parent | d67519fce8ba955d871f253fca1741c27b486a33 (diff) | |
download | CMake-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.rst | 5 |
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. |