diff options
author | Georg Brandl <georg@python.org> | 2012-06-24 16:09:40 (GMT) |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2012-06-24 16:09:40 (GMT) |
commit | 03b9ad05d664ba7b4f6038db2d213f47821a63a9 (patch) | |
tree | cad21126167d4057ec1aaae02d1974ed081f37c6 /Doc/library/shutil.rst | |
parent | 96acb73dd586bff63324186ff4b3b99175db050e (diff) | |
download | cpython-03b9ad05d664ba7b4f6038db2d213f47821a63a9.zip cpython-03b9ad05d664ba7b4f6038db2d213f47821a63a9.tar.gz cpython-03b9ad05d664ba7b4f6038db2d213f47821a63a9.tar.bz2 |
Add a single versionadded for a whole section instead of repeating for every function.
Diffstat (limited to 'Doc/library/shutil.rst')
-rw-r--r-- | Doc/library/shutil.rst | 22 |
1 files changed, 4 insertions, 18 deletions
diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst index 1460d60..267c96b 100644 --- a/Doc/library/shutil.rst +++ b/Doc/library/shutil.rst @@ -306,7 +306,7 @@ Directory and files operations .. _shutil-copytree-example: copytree example -:::::::::::::::: +~~~~~~~~~~~~~~~~ This example is the implementation of the :func:`copytree` function, described above, with the docstring omitted. It demonstrates many of the other functions @@ -370,6 +370,8 @@ Another example that uses the *ignore* argument to add a logging call:: Archiving operations -------------------- +.. versionadded:: 3.2 + High-level utilities to create and read compressed and archived files are also provided. They rely on the :mod:`zipfile` and :mod:`tarfile` modules. @@ -397,8 +399,6 @@ provided. They rely on the :mod:`zipfile` and :mod:`tarfile` modules. *logger* must be an object compatible with :pep:`282`, usually an instance of :class:`logging.Logger`. - .. versionadded:: 3.2 - .. function:: get_archive_formats() @@ -415,8 +415,6 @@ provided. They rely on the :mod:`zipfile` and :mod:`tarfile` modules. You can register new formats or provide your own archiver for any existing formats, by using :func:`register_archive_format`. - .. versionadded:: 3.2 - .. function:: register_archive_format(name, function, [extra_args, [description]]) @@ -429,15 +427,11 @@ provided. They rely on the :mod:`zipfile` and :mod:`tarfile` modules. *description* is used by :func:`get_archive_formats` which returns the list of archivers. Defaults to an empty list. - .. versionadded:: 3.2 - .. function:: unregister_archive_format(name) Remove the archive format *name* from the list of supported formats. - .. versionadded:: 3.2 - .. function:: unpack_archive(filename[, extract_dir[, format]]) @@ -452,8 +446,6 @@ provided. They rely on the :mod:`zipfile` and :mod:`tarfile` modules. and see if an unpacker was registered for that extension. In case none is found, a :exc:`ValueError` is raised. - .. versionadded:: 3.2 - .. function:: register_unpack_format(name, extensions, function[, extra_args[, description]]) @@ -471,15 +463,11 @@ provided. They rely on the :mod:`zipfile` and :mod:`tarfile` modules. *description* can be provided to describe the format, and will be returned by the :func:`get_unpack_formats` function. - .. versionadded:: 3.2 - .. function:: unregister_unpack_format(name) Unregister an unpack format. *name* is the name of the format. - .. versionadded:: 3.2 - .. function:: get_unpack_formats() @@ -497,13 +485,11 @@ provided. They rely on the :mod:`zipfile` and :mod:`tarfile` modules. You can register new formats or provide your own unpacker for any existing formats, by using :func:`register_unpack_format`. - .. versionadded:: 3.2 - .. _shutil-archiving-example: Archiving example -::::::::::::::::: +~~~~~~~~~~~~~~~~~ In this example, we create a gzip'ed tar-file archive containing all files found in the :file:`.ssh` directory of the user:: |