From: Pablo Galindo <Pablogsal@gmail.com>
Date: Wed, 8 Jan 2020 13:00:14 +0000 (+0000)
Subject: bpo-39233: Update positional-only section in the glossary (GH-17874)
X-Git-Tag: v3.9.0a3~121
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9a669d58e8cb586fba38c84d5b631cd8a95d0c0c;p=thirdparty%2FPython%2Fcpython.git

bpo-39233: Update positional-only section in the glossary (GH-17874)



https://bugs.python.org/issue39233
---

diff --git a/Doc/glossary.rst b/Doc/glossary.rst
index 9ce0357f1cb4..6189cb045049 100644
--- a/Doc/glossary.rst
+++ b/Doc/glossary.rst
@@ -824,9 +824,11 @@ Glossary
       .. _positional-only_parameter:
 
       * :dfn:`positional-only`: specifies an argument that can be supplied only
-        by position.  Python has no syntax for defining positional-only
-        parameters.  However, some built-in functions have positional-only
-        parameters (e.g. :func:`abs`).
+        by position. Positional-only parameters can be defined by including a
+        ``/`` character in the parameter list of the function definition after
+        them, for example *posonly1* and *posonly2* in the following::
+
+           def func(posonly1, posonly2, /, positional_or_keyword): ...
 
       .. _keyword-only_parameter: