From 0e9285845ee37fb24ccced8fbe8ef90c21d096ce Mon Sep 17 00:00:00 2001
From: Benjamin Peterson <benjamin@python.org>
Date: Sat, 28 Mar 2009 19:16:10 +0000
Subject: [PATCH] give os.symlink and os.link() better parameter names #5564

---
 Doc/library/os.rst     | 10 ++++++----
 Doc/library/string.rst |  1 +
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 74fca8a2eaa..bbe3b5c1b9e 100644
--- 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 4c3be4f20eb..40aa07c8f92 100644
--- 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'.