"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.
* add a paragraph to document this kwarg in detail
* update docstring in the source accordingly
(cherry picked from commit f33e2c8)
Co-authored-by: Jack DeVries <email@example.com>
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
The text was updated successfully, but these errors were encountered: