[doc] Upgrade the generated documentation with tox -e docs

Author: Pierre-Sassoulas

doc/user_guide/checkers/extensions.rst

@@ -77,6 +77,10 @@ Code Style checker Messages
 :consider-using-namedtuple-or-dataclass (R6101): *Consider using namedtuple or dataclass for dictionary values*
   Emitted when dictionary values can be replaced by namedtuples or dataclass
   instances.
+:prefer-typing-namedtuple (R6105): *Prefer 'typing.NamedTuple' over 'collections.namedtuple'*
+  'typing.NamedTuple' uses the well-known 'class' keyword with type-hints for
+  readability (it's also faster as it avoids an internal exec call). Disabled
+  by default!
 :consider-using-assignment-expr (R6103): *Use '%s' instead*
   Emitted when an if assignment is directly followed by an if statement and
   both can be combined by using an assignment expression ``:=``. Requires

doc/user_guide/checkers/features.rst

@@ -398,8 +398,7 @@ Dataclass checker Messages
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 :invalid-field-call (E3701): *Invalid usage of field(), %s*
   The dataclasses.field() specifier should only be used as the value of an
-  assignment within a dataclass, or within the make_dataclass() function. This
-  message can't be emitted when using Python < 3.7.
+  assignment within a dataclass, or within the make_dataclass() function.
 
 
 Design checker
@@ -1238,6 +1237,10 @@ Typecheck checker Messages
 :unsubscriptable-object (E1136): *Value '%s' is unsubscriptable*
   Emitted when a subscripted value doesn't support subscription (i.e. doesn't
   define __getitem__ method or __class_getitem__ for a class).
+:kwarg-superseded-by-positional-arg (W1117): *%r will be included in %r since a positional-only parameter with this name already exists*
+  Emitted when a function is called with a keyword argument that has the same
+  name as a positional-only parameter and the function contains a keyword
+  variadic parameter dict.
 :keyword-arg-before-vararg (W1113): *Keyword argument before variable positional arguments list in the definition of %s function*
   When defining a keyword argument before variable positional arguments, one
   can end up in having multiple values passed for the aforementioned parameter

doc/user_guide/configuration/all-options.rst

@@ -233,7 +233,7 @@ Standard Checkers
 
    confidence = ["HIGH", "CONTROL_FLOW", "INFERENCE", "INFERENCE_FAILURE", "UNDEFINED"]
 
-   disable = ["raw-checker-failed", "bad-inline-option", "locally-disabled", "file-ignored", "suppressed-message", "useless-suppression", "deprecated-pragma", "use-implicit-booleaness-not-comparison-to-string", "use-implicit-booleaness-not-comparison-to-zero", "use-symbolic-message-instead", "consider-using-augmented-assign"]
+   disable = ["raw-checker-failed", "bad-inline-option", "locally-disabled", "file-ignored", "suppressed-message", "useless-suppression", "deprecated-pragma", "use-implicit-booleaness-not-comparison-to-string", "use-implicit-booleaness-not-comparison-to-zero", "use-symbolic-message-instead", "consider-using-augmented-assign", "prefer-typing-namedtuple"]
 
    enable = []
 

doc/user_guide/messages/messages_overview.rst

@@ -262,6 +262,7 @@ All messages in the warning category:
    warning/invalid-overridden-method
    warning/isinstance-second-argument-not-valid-type
    warning/keyword-arg-before-vararg
+   warning/kwarg-superseded-by-positional-arg
    warning/logging-format-interpolation
    warning/logging-fstring-interpolation
    warning/logging-not-lazy
@@ -508,6 +509,7 @@ All messages in the refactor category:
    refactor/no-else-return
    refactor/no-self-use
    refactor/no-staticmethod-decorator
+   refactor/prefer-typing-namedtuple
    refactor/property-with-parameters
    refactor/redefined-argument-from-local
    refactor/redefined-variable-type