From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Thu, 2 Sep 2021 16:37:55 +0000 (-0700) Subject: [doc] Reword sentinel object summary in dataclasses (GH-27792) X-Git-Tag: v3.10.0rc2~20 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=7aa58f5425189c95927d1620df8d6b0ba57d393a;p=thirdparty%2FPython%2Fcpython.git [doc] Reword sentinel object summary in dataclasses (GH-27792) This sentinel value (`MISSING`) is also used as default value for the `kw_only` parameter introduced in Python 3.10. It's cleaner to simply omit the usage here. Co-authored-by: Łukasz Langa (cherry picked from commit 767a17f35a581da664ac8cf5d67281da9485eebf) Co-authored-by: Ville Korhonen --- diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst index 5da05539c90b..5915bacbcdc4 100644 --- a/Doc/library/dataclasses.rst +++ b/Doc/library/dataclasses.rst @@ -221,10 +221,9 @@ Module contents c.mylist += [1, 2, 3] As shown above, the :const:`MISSING` value is a sentinel object used to - detect if the ``default`` and ``default_factory`` parameters are - provided. This sentinel is used because ``None`` is a valid value - for ``default``. No code should directly use the :const:`MISSING` - value. + detect if some parameters are provided by the user. This sentinel is + used because ``None`` is a valid value for some parameters with + a distinct meaning. No code should directly use the :const:`MISSING` value. The parameters to :func:`field` are: