diff options
author | Brian Schubert <brianm.schubert@gmail.com> | 2024-02-16 22:04:17 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2024-02-16 22:04:17 (GMT) |
commit | 318f2190bc93796008b0a4241243b0851b418436 (patch) | |
tree | 1293a9b75c7f7a7f957da1490eabd2c5d9af60ca /Doc | |
parent | 8b776e0f41d7711f3e2be2435bf85f2d5fa6e009 (diff) | |
download | cpython-318f2190bc93796008b0a4241243b0851b418436.zip cpython-318f2190bc93796008b0a4241243b0851b418436.tar.gz cpython-318f2190bc93796008b0a4241243b0851b418436.tar.bz2 |
docs: Add glossary term references to shutil docs (#115559)
Add glossary term references to shutil docs
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/library/shutil.rst | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst index ff8c9a1..f388375 100644 --- a/Doc/library/shutil.rst +++ b/Doc/library/shutil.rst @@ -39,7 +39,7 @@ Directory and files operations .. function:: copyfileobj(fsrc, fdst[, length]) - Copy the contents of the file-like object *fsrc* to the file-like object *fdst*. + Copy the contents of the :term:`file-like object <file object>` *fsrc* to the file-like object *fdst*. The integer *length*, if given, is the buffer size. In particular, a negative *length* value means to copy the data without looping over the source data in chunks; by default the data is read in chunks to avoid uncontrolled memory @@ -52,7 +52,7 @@ Directory and files operations Copy the contents (no metadata) of the file named *src* to a file named *dst* and return *dst* in the most efficient way possible. - *src* and *dst* are path-like objects or path names given as strings. + *src* and *dst* are :term:`path-like objects <path-like object>` or path names given as strings. *dst* must be the complete target file name; look at :func:`~shutil.copy` for a copy that accepts a target directory path. If *src* and *dst* @@ -94,7 +94,7 @@ Directory and files operations .. function:: copymode(src, dst, *, follow_symlinks=True) Copy the permission bits from *src* to *dst*. The file contents, owner, and - group are unaffected. *src* and *dst* are path-like objects or path names + group are unaffected. *src* and *dst* are :term:`path-like objects <path-like object>` or path names given as strings. If *follow_symlinks* is false, and both *src* and *dst* are symbolic links, :func:`copymode` will attempt to modify the mode of *dst* itself (rather @@ -113,7 +113,7 @@ Directory and files operations Copy the permission bits, last access time, last modification time, and flags from *src* to *dst*. On Linux, :func:`copystat` also copies the "extended attributes" where possible. The file contents, owner, and - group are unaffected. *src* and *dst* are path-like objects or path + group are unaffected. *src* and *dst* are :term:`path-like objects <path-like object>` or path names given as strings. If *follow_symlinks* is false, and *src* and *dst* both |