Kaydet (Commit) 32e4a58c authored tarafından Nick Coghlan's avatar Nick Coghlan

Issue #13237: Fix formatting error - the legacy shell commands weren't meant to…

Issue #13237: Fix formatting error - the legacy shell commands weren't meant to be under the Notes heading
üst 69ce0d86
...@@ -880,41 +880,8 @@ Replacing functions from the :mod:`popen2` module ...@@ -880,41 +880,8 @@ Replacing functions from the :mod:`popen2` module
all platforms or past Python versions. 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 Legacy Shell Invocation Functions
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ---------------------------------
This module also provides the following legacy functions from the 2.x This module also provides the following legacy functions from the 2.x
``commands`` module. These operations implicitly invoke the system shell and ``commands`` module. These operations implicitly invoke the system shell and
...@@ -953,3 +920,35 @@ handling consistency are valid for these functions. ...@@ -953,3 +920,35 @@ handling consistency are valid for these functions.
Availability: UNIX. 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.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment