René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Clarify os.path.join documentation","articleBody":"https://docs.python.org/3/library/os.path.html#os.path.join\r\n\r\n\u003e On Windows, the drive letter is not reset when an absolute path component (e.g., r'\\foo') is encountered. If a component contains a drive letter, all previous components are thrown away and the drive letter is reset. Note that since there is a current directory for each drive, os.path.join(\"c:\", \"foo\") represents a path relative to the current directory on drive C: (c:foo), not c:\\foo.\r\n\r\nThere are a couple potential issues here.\r\n\r\nFirst, it should be \"drive\", not \"drive letter\":\r\n```\r\n\u003e\u003e\u003e ntpath.join(\"thrownaway\", \"//host/computer/dir\", \"/asdf\")  # unc is not a letter\r\n'//host/computer/asdf'\r\n```\r\n\r\nSecond, it should be \"if a component is from a different drive or an absolute path, all previous components are thrown away and the drive is reset\":\r\n```\r\n\u003e\u003e\u003e ntpath.join(\"C:\", \"foo\", \"C:\", \"bar\")  # previous components are not thrown away\r\n'C:foo\\\\bar'\r\n\u003e\u003e\u003e ntpath.join(\"C:\", \"foo\", \"D:\", \"bar\")\r\n'D:bar'\r\n```\r\n\r\nThird, as a nit, maybe \"component\" should be replaced with \"segment\", since arguments can contain path separators. This would improve consistency with the pathlib docs.\r\n\r\ncc @barneygale @JelleZijlstra \r\n\r\nThese came up in https://github.com/python/cpython/pull/100782\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-100811\n* gh-100843\n* gh-100844\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/hauntsaninja","@type":"Person","name":"hauntsaninja"},"datePublished":"2023-01-06T01:08:41.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/100783/cpython/issues/100783"}