New submission from Tilman Vogel <tilman.vo...@gmail.com>:

I donot understand this sentence:

"dirs_exist_ok dictates whether to raise an exception in case dst or any 
missing parent directory already exists."

How can a "missing parent directory already exist"?

My understanding would be that an existing `dst` would be OK (and copied into) 
but missing parent directories are just the ones above `dst` that also don't 
exist. 

Until 3.7, missing parent directories were documented to be auto-created 
(`mkdir -p`-style) according to the documentation ("The destination directory, 
named by dst, must not already exist; it will be created as well as missing 
parent directories."). Was this feature really removed? If not, then this part 
was accidentally (?) dropped from documentation?

What am I missing? I think, the documentation should be amended to make that 
clear.

----------
assignee: docs@python
components: Documentation
messages: 395315
nosy: docs@python, tilman.vogel
priority: normal
severity: normal
status: open
title: Unclear documentation for shutil.copytree()
type: enhancement
versions: Python 3.10, Python 3.8, Python 3.9

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue44347>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to