Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 32e4a58

Browse files
committed
Issue #13237: Fix formatting error - the legacy shell commands weren't meant to be under the Notes heading
1 parent 69ce0d8 commit 32e4a58

1 file changed

Lines changed: 33 additions & 34 deletions

File tree

Doc/library/subprocess.rst

Lines changed: 33 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -880,41 +880,8 @@ Replacing functions from the :mod:`popen2` module
880880
all platforms or past Python versions.
881881

882882

883-
Notes
884-
-----
885-
886-
.. _converting-argument-sequence:
887-
888-
Converting an argument sequence to a string on Windows
889-
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
890-
891-
On Windows, an *args* sequence is converted to a string that can be parsed
892-
using the following rules (which correspond to the rules used by the MS C
893-
runtime):
894-
895-
1. Arguments are delimited by white space, which is either a
896-
space or a tab.
897-
898-
2. A string surrounded by double quotation marks is
899-
interpreted as a single argument, regardless of white space
900-
contained within. A quoted string can be embedded in an
901-
argument.
902-
903-
3. A double quotation mark preceded by a backslash is
904-
interpreted as a literal double quotation mark.
905-
906-
4. Backslashes are interpreted literally, unless they
907-
immediately precede a double quotation mark.
908-
909-
5. If backslashes immediately precede a double quotation mark,
910-
every pair of backslashes is interpreted as a literal
911-
backslash. If the number of backslashes is odd, the last
912-
backslash escapes the next double quotation mark as
913-
described in rule 3.
914-
915-
916883
Legacy Shell Invocation Functions
917-
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
884+
---------------------------------
918885

919886
This module also provides the following legacy functions from the 2.x
920887
``commands`` module. These operations implicitly invoke the system shell and
@@ -953,3 +920,35 @@ handling consistency are valid for these functions.
953920

954921
Availability: UNIX.
955922

923+
924+
Notes
925+
-----
926+
927+
.. _converting-argument-sequence:
928+
929+
Converting an argument sequence to a string on Windows
930+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
931+
932+
On Windows, an *args* sequence is converted to a string that can be parsed
933+
using the following rules (which correspond to the rules used by the MS C
934+
runtime):
935+
936+
1. Arguments are delimited by white space, which is either a
937+
space or a tab.
938+
939+
2. A string surrounded by double quotation marks is
940+
interpreted as a single argument, regardless of white space
941+
contained within. A quoted string can be embedded in an
942+
argument.
943+
944+
3. A double quotation mark preceded by a backslash is
945+
interpreted as a literal double quotation mark.
946+
947+
4. Backslashes are interpreted literally, unless they
948+
immediately precede a double quotation mark.
949+
950+
5. If backslashes immediately precede a double quotation mark,
951+
every pair of backslashes is interpreted as a literal
952+
backslash. If the number of backslashes is odd, the last
953+
backslash escapes the next double quotation mark as
954+
described in rule 3.

0 commit comments

Comments
 (0)