Possible Error in "Brief Tour of the Standard Library"

[Pitmaster]

BPO	21554
Nosy	@rhettinger, @bitdancer
Files	stdlib.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 = 'https://github.com/rhettinger'
closed_at = <Date 2014-05-22.22:38:54.121>
created_at = <Date 2014-05-22.17:39:05.489>
labels = ['type-feature', 'docs']
title = 'Possible Error in "Brief Tour of the Standard Library"'
updated_at = <Date 2014-05-22.22:38:54.084>
user = 'https://bugs.python.org/Pitmaster'

bugs.python.org fields:

activity = <Date 2014-05-22.22:38:54.084>
actor = 'rhettinger'
assignee = 'rhettinger'
closed = True
closed_date = <Date 2014-05-22.22:38:54.121>
closer = 'rhettinger'
components = ['Documentation']
creation = <Date 2014-05-22.17:39:05.489>
creator = 'Pitmaster'
dependencies = []
files = ['35318']
hgrepos = []
issue_num = 21554
keywords = ['patch']
message_count = 4.0
messages = ['218904', '218906', '218925', '218926']
nosy_count = 5.0
nosy_names = ['rhettinger', 'r.david.murray', 'docs@python', 'python-dev', 'Pitmaster']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue21554'
versions = ['Python 3.3']

[Pitmaster]

In https://docs.python.org/3/tutorial/stdlib.html, there is an example:

>> import shutil
>> shutil.copyfile('data.db', 'archive.db')
>> shutil.move('/build/executables', 'installdir')

Should it not be:

>>> import shutil
>>> shutil.copyfile('data.db', 'archive.db')
'archive.db'
>>> shutil.move('/build/executables', 'installdir')
'installdir'

? I am run under Windows, so I don't know if the behavior is different than under Linux. Under Windows the destination file and destination directory, respectively, are echoed to stdout.

[bitdancer]

Yes, this is a recent enhancement and the example was not updated to match.

[python-dev]

New changeset e07e347688a0 by Raymond Hettinger in branch '3.4':
bpo-21554: Repair an out-of-date tutorial example to reflect changes in shutil.
http://hg.python.org/cpython/rev/e07e347688a0

[rhettinger]

Fixed.

Thanks for the clear bug report.