From 843bf42aa65aaa25b356e7b3d8733a117b8f01a4 Mon Sep 17 00:00:00 2001 From: Guido van Rossum Date: Mon, 29 Apr 2019 05:49:30 -0700 Subject: [PATCH] Add initial 'whatsnew' section for PEP 570 (GH-12942) --- Doc/whatsnew/3.8.rst | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/Doc/whatsnew/3.8.rst b/Doc/whatsnew/3.8.rst index 90ff72f67f..225faf8c0b 100644 --- a/Doc/whatsnew/3.8.rst +++ b/Doc/whatsnew/3.8.rst @@ -83,6 +83,31 @@ See :pep:`572` for a full description. .. TODO: Emily will sprint on docs at PyCon US 2019. +Positional-only parameters +-------------------------- + +There is new syntax (``/``) to indicate that some function parameters +must be specified positionally (i.e., cannot be used as keyword +arguments). This is the same notation as shown by ``help()`` for +functions implemented in C (produced by Larry Hastings' "Argument +Clinic" tool). Example:: + + def pow(x, y, z=None, /): + r = x**y + if z is not None: + r %= z + return r + +Now ``pow(2, 10)`` and ``pow(2, 10, 17)`` are valid calls, but +``pow(x=2, y=10)`` and ``pow(2, 10, z=17)`` are invalid. + +See :pep:`570` for a full description. + +(Contributed by Pablo Galindo in :issue:`36540`.) + +.. TODO: Pablo will sprint on docs at PyCon US 2019. + + Parallel filesystem cache for compiled bytecode files ----------------------------------------------------- -- 2.50.1