posixpath and friends have uses that should be documented

[OG7]

BPO	1718017
Nosy	@birkenfeld

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2009-04-05.10:41:19.319>
created_at = <Date 2007-05-13.06:21:50.000>
labels = ['type-feature', 'docs']
title = 'posixpath and friends have uses that should be documented'
updated_at = <Date 2009-04-05.10:41:19.316>
user = 'https://bugs.python.org/OG7'

bugs.python.org fields:

activity = <Date 2009-04-05.10:41:19.316>
actor = 'georg.brandl'
assignee = 'none'
closed = True
closed_date = <Date 2009-04-05.10:41:19.319>
closer = 'georg.brandl'
components = ['Documentation']
creation = <Date 2007-05-13.06:21:50.000>
creator = 'OG7'
dependencies = []
files = []
hgrepos = []
issue_num = 1718017
keywords = []
message_count = 3.0
messages = ['32002', '32003', '85475']
nosy_count = 3.0
nosy_names = ['nnorwitz', 'georg.brandl', 'OG7']
pr_nums = []
priority = 'low'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue1718017'
versions = ['Python 2.7']

[OG7]

At this page: http://docs.python.org/lib/module-os.html

It should be suggested that the modules: posixpath, macpath, ntpath, os2emxpath are available on all platforms to handle the path conventions of that platform. The current phrasing, along with the documentation for each of these modules, does not imply that.

In particular, posixpath is useful to handle the URI path conventions in http://tools.ietf.org/html/rfc2396 , for example handling repeated slashes and references to .. and .

[nnorwitz]

Gabriel, could you try to work up a patch which demonstrates what you would like changed? It would be great if you could do this against the latex source in Doc/lib/libos.tex (presumably). If you don't know latex, that's ok, even a plain text patch would help a lot.

Thanks!

[birkenfeld]

Should be covered with r71216.