@@ -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-
916883Legacy Shell Invocation Functions
917- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
884+ ---------------------------------
918885
919886This 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