gh-134538: Add link to shutil.rmtree example in function docs (GH-135540)

(cherry picked from commit e9b647dd30d22cef465972d898a34c4b1bb6615d)

Co-authored-by: alexey semenyuk <alexsemenyuk88@gmail.com>

diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst
index 3572bfbabd064ea25069610ed0245367cba034ad..221b257e0925c2043e8ec0c70910370f85771a9f 100644 (file)
--- a/Doc/library/shutil.rst
+++ b/Doc/library/shutil.rst
@@ -327,6 +327,10 @@ Directory and files operations
    The deprecated *onerror* is similar to *onexc*, except that the third
    parameter it receives is the tuple returned from :func:`sys.exc_info`.
 
+   .. seealso::
+      :ref:`shutil-rmtree-example` for an example of handling the removal
+      of a directory tree that contains read-only files.
+
    .. audit-event:: shutil.rmtree path,dir_fd shutil.rmtree
 
    .. versionchanged:: 3.3