Browse Source

Merge topic 'doc-execute_process' into release-3.24

70c26a65b7 Help: Clarify execute_process OS-specific command-line encoding

Acked-by: Kitware Robot <[email protected]>
Merge-request: !7492
Brad King 3 năm trước cách đây
mục cha
commit
66077528f9
1 tập tin đã thay đổi với 9 bổ sung2 xóa
  1. 9 2
      Help/command/execute_process.rst

+ 9 - 2
Help/command/execute_process.rst

@@ -37,8 +37,15 @@ Options:
 ``COMMAND``
  A child process command line.
 
- CMake executes the child process using operating system APIs directly.
- All arguments are passed VERBATIM to the child process.
+ CMake executes the child process using operating system APIs directly:
+
+ * On POSIX platforms, the command line is passed to the
+   child process in an ``argv[]`` style array.
+
+ * On Windows platforms, the command line is encoded as a string such
+   that child processes using ``CommandLineToArgvW`` will decode the
+   original arguments.
+
  No intermediate shell is used, so shell operators such as ``>``
  are treated as normal arguments.
  (Use the ``INPUT_*``, ``OUTPUT_*``, and ``ERROR_*`` options to