diff options
author | Nick Coghlan <ncoghlan@gmail.com> | 2011-11-08 11:50:58 (GMT) |
---|---|---|
committer | Nick Coghlan <ncoghlan@gmail.com> | 2011-11-08 11:50:58 (GMT) |
commit | 32e4a58c0656d1f3a6415cd099bf1e531bc37c01 (patch) | |
tree | abb53ca3f8d8793036a711150991810de56f5b3d /Doc | |
parent | 69ce0d86029041ffd04438a321248cfa8158b9a8 (diff) | |
download | cpython-32e4a58c0656d1f3a6415cd099bf1e531bc37c01.zip cpython-32e4a58c0656d1f3a6415cd099bf1e531bc37c01.tar.gz cpython-32e4a58c0656d1f3a6415cd099bf1e531bc37c01.tar.bz2 |
Issue #13237: Fix formatting error - the legacy shell commands weren't meant to be under the Notes heading
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/library/subprocess.rst | 67 |
1 files changed, 33 insertions, 34 deletions
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst index 311dfd2..19a29cb 100644 --- a/Doc/library/subprocess.rst +++ b/Doc/library/subprocess.rst @@ -880,41 +880,8 @@ Replacing functions from the :mod:`popen2` module all platforms or past Python versions. -Notes ------ - -.. _converting-argument-sequence: - -Converting an argument sequence to a string on Windows -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -On Windows, an *args* sequence is converted to a string that can be parsed -using the following rules (which correspond to the rules used by the MS C -runtime): - -1. Arguments are delimited by white space, which is either a - space or a tab. - -2. A string surrounded by double quotation marks is - interpreted as a single argument, regardless of white space - contained within. A quoted string can be embedded in an - argument. - -3. A double quotation mark preceded by a backslash is - interpreted as a literal double quotation mark. - -4. Backslashes are interpreted literally, unless they - immediately precede a double quotation mark. - -5. If backslashes immediately precede a double quotation mark, - every pair of backslashes is interpreted as a literal - backslash. If the number of backslashes is odd, the last - backslash escapes the next double quotation mark as - described in rule 3. - - Legacy Shell Invocation Functions -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +--------------------------------- This module also provides the following legacy functions from the 2.x ``commands`` module. These operations implicitly invoke the system shell and @@ -953,3 +920,35 @@ handling consistency are valid for these functions. Availability: UNIX. + +Notes +----- + +.. _converting-argument-sequence: + +Converting an argument sequence to a string on Windows +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +On Windows, an *args* sequence is converted to a string that can be parsed +using the following rules (which correspond to the rules used by the MS C +runtime): + +1. Arguments are delimited by white space, which is either a + space or a tab. + +2. A string surrounded by double quotation marks is + interpreted as a single argument, regardless of white space + contained within. A quoted string can be embedded in an + argument. + +3. A double quotation mark preceded by a backslash is + interpreted as a literal double quotation mark. + +4. Backslashes are interpreted literally, unless they + immediately precede a double quotation mark. + +5. If backslashes immediately precede a double quotation mark, + every pair of backslashes is interpreted as a literal + backslash. If the number of backslashes is odd, the last + backslash escapes the next double quotation mark as + described in rule 3. |