From: Nick Coghlan <ncoghlan@gmail.com>
Date: Tue, 8 Nov 2011 11:50:58 +0000 (+1000)
Subject: Issue #13237: Fix formatting error - the legacy shell commands weren't meant to be... 
X-Git-Tag: v3.2.3rc1~409
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=32e4a58c0656d1f3a6415cd099bf1e531bc37c01;p=thirdparty%2FPython%2Fcpython.git

Issue #13237: Fix formatting error - the legacy shell commands weren't meant to be under the Notes heading
---

diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index 311dfd2c3eba..19a29cb56193 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.