[3.14] gh-141127: Clarify os.symlink() documentation for argument order (GH-141144...

gh-141127: Clarify os.symlink() documentation for argument order (GH-141144)
(cherry picked from commit 7ae440f262c99ba9a3327237f83c9290dc963028)

Co-authored-by: Chilla Kalyan <127284726+chillakalyan@users.noreply.github.com>

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index aa1027453282728060ec0de46b348b0fcc936409..4286e94ddb6c72163b642142ef3c583992702253 100644 (file)
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -3505,6 +3505,9 @@ features:
 
    Create a symbolic link pointing to *src* named *dst*.
 
+   The *src* parameter refers to the target of the link (the file or directory being linked to),
+   and *dst* is the name of the link being created.
+
    On Windows, a symlink represents either a file or a directory, and does not
    morph to the target dynamically.  If the target is present, the type of the
    symlink will be created to match. Otherwise, the symlink will be created