\begin{funcdesc}{copytree}{src, dst\optional{, symlinks}}
Recursively copy an entire directory tree rooted at \var{src}. The
destination directory, named by \var{dst}, must not already exist;
- it will be created. Individual files are copied using
- \function{copy2()}. If \var{symlinks} is true, symbolic links in
+ it will be created as well as missing parent directories.
+ Permissions and times of directories are copied with \function{copystat()},
+ individual files are copied using \function{copy2()}.
+ If \var{symlinks} is true, symbolic links in
the source tree are represented as symbolic links in the new tree;
if false or omitted, the contents of the linked files are copied to
the new tree. If exception(s) occur, an Error is raised
The source code for this should be considered an example rather than
a tool.
-\versionchanged[Error is raised if any exceptions occur during copying,
-rather than printing a message]{2.3}
+
+ \versionchanged[Error is raised if any exceptions occur during copying,
+ rather than printing a message]{2.3}
+
+ \versionchanged[Create intermediate directories needed to create \var{dst},
+ rather than raising an error. Copy permissions and times of directories using
+ \function{copystat()}]{2.5}
+
\end{funcdesc}
\begin{funcdesc}{rmtree}{path\optional{, ignore_errors\optional{, onerror}}}