[doc] os.listdir and os.path.join inconsistent on empty path

Open
#61,745 12 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
25/100
Issue type
Documentation
Clarity
Needs clarification
Activity status
Stale
Tech stack
python
Domain
documentation

Research direction

Start by reading the migrated BPO issue 17545 and the referenced issue17545.patch, since no CPython source file or test is named. Determine the intended documentation change from that patch and the discussion, then verify the updated os.listdir and os.path.join documentation covers the empty-path behavior consistently.

Written by the indexing model from the issue text.

Description

3.10 3.8 (EOL) 3.9 (EOL) docs easy stdlib type-bug
BPO 17545
Nosy @ncoghlan, @bitdancer
Files
  • issue17545.patch
    		•

    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 = None
created_at = <Date 2013-03-25.16:26:53.421>
labels = ['easy', 'type-bug', '3.8', '3.9', '3.10', 'library', 'docs']
title = '[doc] os.listdir and os.path.join inconsistent on empty path'
updated_at = <Date 2020-11-25.10:55:07.339>
user = 'https://bugs.python.org/babou'

    bugs.python.org fields:

    activity = <Date 2020-11-25.10:55:07.339>
actor = 'iritkatriel'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation', 'Library (Lib)']
creation = <Date 2013-03-25.16:26:53.421>
creator = 'babou'
dependencies = []
files = ['30367']
hgrepos = []
issue_num = 17545
keywords = ['easy']
message_count = 12.0
messages = ['185207', '185209', '185212', '185297', '185299', '187783', '187788', '189401', '189689', '189773', '189988', '193704']
nosy_count = 6.0
nosy_names = ['ncoghlan', 'r.david.murray', 'docs@python', 'Thomas Fenzl', 'babou', 'woparry']
pr_nums = []
priority = 'normal'
resolution = None
stage = 'needs patch'
status = 'open'
superseder = None
type = 'behavior'
url = 'https://bugs.python.org/issue17545'
versions = ['Python 3.8', 'Python 3.9', 'Python 3.10']

    Linked PRs
    • gh-145338
    Dominant language
    Python
    Stars
    77.2k
    Forks
    36k
    Avg merge
    1d 9h
    Merged PRs (30d)
    558

    Contributor guide

    Open the contributing guide

    First steps

    1. Read the whole issue, then the project's contributing guide.
    2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
    3. Fork the repository and make your change on a branch.
    4. Open a pull request that references the issue number.

    More from python/cpython

    All issues in python/cpython

    Similar issues

    More Python issues

    Get new issues in your inbox

    A short digest of beginner-friendly GitHub issues.