[New-bugs-announce] [issue22062] Fix pathlib.Path.(r)glob doc glitches.

Terry J. Reedy report at bugs.python.org
Fri Jul 25 00:11:02 CEST 2014

New submission from Terry J. Reedy:

1. The pattern argument for .(r)glob must be relative. I think the docstrings and doc should say so. /pattern/relative pattern/

For rglob: '''This is like calling glob() with “**” added in front of the given pattern:'''

2. Currently "glob()" links to the glob module, which does not recognize '**'. It should link to back up to the Pathlib.glob entry, where the effect of '**' is defined. (I don't currently know the markup for that.)

3. I interpret '''“**” added in front of the given pattern:''' to mean '**' + pattern, so that '*.py' would become '***.py'. It actually becomes the equivalent of '**/*.p'. So I think '**' should be either '**/' or 'a "**" component'.

messages: 223902
nosy: pitrou, terry.reedy
priority: normal
severity: normal
stage: needs patch
status: open
title: Fix pathlib.Path.(r)glob doc glitches.
type: behavior
versions: Python 3.4, Python 3.5

Python tracker <report at bugs.python.org>

More information about the New-bugs-announce mailing list