Add hyperlinks to the docs of some os.path functions (issue #16552).

This commit is contained in:
Chris Jerdonek 2012-11-25 20:35:23 -08:00
parent b1cc6aa2df
commit 55b4cfb992
1 changed files with 9 additions and 6 deletions

View File

@ -35,15 +35,17 @@ write files see :func:`open`, and for accessing the filesystem see the
.. function:: abspath(path)
Return a normalized absolutized version of the pathname *path*. On most
platforms, this is equivalent to ``normpath(join(os.getcwd(), path))``.
platforms, this is equivalent to calling the function :func:`normpath` as
follows: ``normpath(join(os.getcwd(), path))``.
.. versionadded:: 1.5.2
.. function:: basename(path)
Return the base name of pathname *path*. This is the second half of the pair
returned by ``split(path)``. Note that the result of this function is different
Return the base name of pathname *path*. This is the second element of the
pair returned by passing *path* to the function :func:`split`. Note that
the result of this function is different
from the Unix :program:`basename` program; where :program:`basename` for
``'/foo/bar/'`` returns ``'bar'``, the :func:`basename` function returns an
empty string (``''``).
@ -58,8 +60,8 @@ write files see :func:`open`, and for accessing the filesystem see the
.. function:: dirname(path)
Return the directory name of pathname *path*. This is the first half of the
pair returned by ``split(path)``.
Return the directory name of pathname *path*. This is the first element of
the pair returned by passing *path* to the function :func:`split`.
.. function:: exists(path)
@ -276,7 +278,8 @@ write files see :func:`open`, and for accessing the filesystem see the
*path* is empty, both *head* and *tail* are empty. Trailing slashes are
stripped from *head* unless it is the root (one or more slashes only). In
all cases, ``join(head, tail)`` returns a path to the same location as *path*
(but the strings may differ).
(but the strings may differ). Also see the functions :func:`dirname` and
:func:`basename`.
.. function:: splitdrive(path)