(original) (raw)

changeset: 73447:7545f4fb450c branch: 3.2 user: Nick Coghlan ncoghlan@gmail.com date: Tue Nov 08 21:50:58 2011 +1000 files: Doc/library/subprocess.rst description: Issue #13237: Fix formatting error - the legacy shell commands weren't meant to be under the Notes heading diff -r d3b159c43ee8 -r 7545f4fb450c Doc/library/subprocess.rst --- a/Doc/library/subprocess.rst Tue Nov 08 21:39:07 2011 +1000 +++ b/Doc/library/subprocess.rst Tue Nov 08 21:50:58 2011 +1000 @@ -880,41 +880,8 @@ 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 @@ 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. /ncoghlan@gmail.com