give os.symlink and os.link() better parameter names #5564

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 74fca8a2eaa9fa2249ad108d1029a731b26ab4f8..bbe3b5c1b9e03518f0334255872021ebe0db5c4c 100644 (file)
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -924,9 +924,10 @@ Files and Directories
    .. versionadded:: 2.3
 
 
-.. function:: link(src, dst)
+.. function:: link(source, link_name)
 
-   Create a hard link pointing to *src* named *dst*. Availability: Unix.
+   Create a hard link pointing to *source* named *link_name*. Availability:
+   Unix.
 
 
 .. function:: listdir(path)
@@ -1246,9 +1247,10 @@ Files and Directories
       Added access to values as attributes of the returned object.
 
 
-.. function:: symlink(src, dst)
+.. function:: symlink(source, link_name)
 
-   Create a symbolic link pointing to *src* named *dst*. Availability: Unix.
+   Create a symbolic link pointing to *source* named *link_name*. Availability:
+   Unix.
 
 
 .. function:: tempnam([dir[, prefix]])

diff --git a/Doc/library/string.rst b/Doc/library/string.rst
index 4c3be4f20eb6b3c3b2f6cb46a510b9332b791b88..40aa07c8f92e9087015a975b62cf61698cb16678 100644 (file)
--- a/Doc/library/string.rst
+++ b/Doc/library/string.rst
@@ -243,6 +243,7 @@ does an index lookup using :func:`__getitem__`.
 Some simple format string examples::
 
    "First, thou shalt count to {0}" # References first positional argument
+   "Bring me a {}"                  # Implicitly references the first positional argument
    "My quest is {name}"             # References keyword argument 'name'
    "Weight in tons {0.weight}"      # 'weight' attribute of first positional arg
    "Units destroyed: {players[0]}"  # First element of keyword argument 'players'.