gh-82151: Update and improve urlsplit docstring

[pranavchoudhary-tech]

This PR supersedes and finishes the work started in #18631 by @idomic.

It applies the final wording changes requested by the maintainers in the original PR review to clarify the urlsplit return components.

Closes #82151.

• Issue: urllib.parse docstrings incomplete #82151

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #33452453 | 📁 Comparing 1df22ec against main (548c731)

  🔍 Preview build  

13 files changed · ± 13 modified

± Modified

• library/dialog.html
• library/http.cookiejar.html
• library/http.server.html
• library/imaplib.html
• library/internet.html
• library/re.html
• library/tkinter.html
• library/tkinter.ttk.html
• library/urllib.parse.html
• library/urllib.robotparser.html
• and 3 more...

[orsenthil]

LGTM.

This will close the long discussions in the referenced issue, and follows the recommendation from that thread.

[miss-islington-app]

Thanks @pranavchoudhary-tech for the PR, and @orsenthil for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14, 3.15.
🐍🍒⛏🤖

[miss-islington-app]

Sorry, @pranavchoudhary-tech and @orsenthil, I could not cleanly backport this to 3.14 due to a conflict.
Please backport using cherry_picker on command line.

cherry_picker ad54b91b9fa4c5d12f155bb09138dff21a2bdec3 3.14

[bedevere-app]

GH-153154 is a backport of this pull request to the 3.15 branch.

[miss-islington-app]

Sorry, @pranavchoudhary-tech and @orsenthil, I could not cleanly backport this to 3.13 due to a conflict.
Please backport using cherry_picker on command line.

cherry_picker ad54b91b9fa4c5d12f155bb09138dff21a2bdec3 3.13

[bedevere-app]

GH-153155 is a backport of this pull request to the 3.14 branch.

[bedevere-app]

GH-153156 is a backport of this pull request to the 3.13 branch.

[orsenthil]

@pranavchoudhary-tech , do you know why the CLA is not showing up in the branches ? Could you please make sure they are signed.

Thank you.

[pranavchoudhary-tech]

Hi @orsenthil! Thank you for merging this! Regarding the CLA, my CLA is signed (which is why the main PR check passed). It looks like the backport branches failed for the older versions due to a merge conflict (as noted by miss-islington), rather than a CLA issue. If any backport PRs are failing a CLA check, it might be because the original author (@idomic) who I co-authored with hasn't signed it for those specific branches, though it passed on main. Let me know if you'd like me to manually backport these using cherry_picker and resolve the conflicts!

[pranavchoudhary-tech]

@orsenthil @StanFromIreland Update: I realized the issue was because I force-pushed a minor tweak from a different machine and that secondary email wasn't linked to my CLA. I have just signed the CLA for that email! The CLA checks should be green now. Apologies for the confusion!