From: Ville Korhonen Date: Thu, 2 Sep 2021 16:03:22 +0000 (+0000) Subject: [doc] Reword sentinel object summary in dataclasses (GH-27792) X-Git-Tag: v3.11.0a1~274 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=767a17f35a581da664ac8cf5d67281da9485eebf;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 --- diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst index de7dfae15ebd..a7144094c684 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: