summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorNick Coghlan <ncoghlan@gmail.com>2011-11-08 11:50:58 (GMT)
committerNick Coghlan <ncoghlan@gmail.com>2011-11-08 11:50:58 (GMT)
commit32e4a58c0656d1f3a6415cd099bf1e531bc37c01 (patch)
treeabb53ca3f8d8793036a711150991810de56f5b3d /Doc
parent69ce0d86029041ffd04438a321248cfa8158b9a8 (diff)
downloadcpython-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.rst67
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.