Popen misleading documentation

[hvbtup]

Documentation

It took me hours that I made an error in the code. However, this error was probably the result of an unfortunate formatting in the docs.

The documentation for subprocess.Popen reads:

If given, startupinfo will be a STARTUPINFO object, which is passed to the underlying CreateProcess function. creationflags, if given, can be one or more of the following flags ...

I suggest to start the documentation for creationflags in a new paragraph instead:

If given, startupinfo will be a STARTUPINFO object, which is passed to the underlying CreateProcess function.

creationflags, if given, can be one or more of the following flags ...

I mixed up options for creationflags and startupinfo in my code.

Linked PRs

• gh-114913: Add newline to subprocess doc #114941
• [3.12] gh-114913: Add newline to subprocess doc (GH-114941) #114942
• [3.11] gh-114913: Add newline to subprocess doc (GH-114941) #114943

[terryjreedy]

After looking at the doc, I agree that creationflags is a separate topic from startupinfo. Given that this doc discusses each parameter or related parameters in separate paragraphs, these should be separate also.