os.path.expanduser documentation wrt. empty $HOME

[calvin]

BPO	1193849
Nosy	@birkenfeld, @birkenfeld, @rhettinger
Files	expanduser-doc.diff

^{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 = 'https://github.com/birkenfeld'
closed_at = <Date 2005-08-24.07:28:00.000>
created_at = <Date 2005-05-02.15:02:43.000>
labels = ['docs']
title = 'os.path.expanduser documentation wrt. empty $HOME'
updated_at = <Date 2005-08-24.07:28:00.000>
user = 'https://bugs.python.org/calvin'

bugs.python.org fields:

activity = <Date 2005-08-24.07:28:00.000>
actor = 'georg.brandl'
assignee = 'georg.brandl'
closed = True
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2005-05-02.15:02:43.000>
creator = 'calvin'
dependencies = []
files = ['1693']
hgrepos = []
issue_num = 1193849
keywords = []
message_count = 4.0
messages = ['25202', '25203', '25204', '25205']
nosy_count = 4.0
nosy_names = ['georg.brandl', 'georg.brandl', 'rhettinger', 'calvin']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue1193849'
versions = ['Python 2.4']

[calvin]

If $HOME is unset, an initial "~" should not be
expanded according to the documentation. But instead it
somehow is expanded, perhaps through the pwd module:

$ env -u HOME python -c "import os.path; print
os.path.expanduser('~/foo')"
/home/calvin/foo

The result should be "~/foo" instead of "/home/calvin/foo".

I suggest adjusting the documentation to state the also
a single "~" is looked up in the pwd module, not only
"~user".

[birkenfeld]

Logged In: YES
user_id=1188172

Attached a patch which fixes the docs. Okay to checkin?

[rhettinger]

Logged In: YES
user_id=80475

Strike the comma before the final "or".

After you post this, put a note on your todo list to check
its appearance in the HTML docs whenever Fred runs an update:

http://www.python.org/dev/doc/devel/

[birkenfeld]

Logged In: YES
user_id=1188172

Okay, committed as Doc/lib/libposixpath.py 1.42, 1.40.2.2.