Docs: `filecmp.cmpfiles` parameters documented as `dir1`/`dir2` but named `a`/`b`

[fedonman]

Documentation

The documented signature of filecmp.cmpfiles names its first two parameters dir1 and dir2:

.. function:: cmpfiles(dir1, dir2, common, shallow=True)

   Compare the files in the two directories *dir1* and *dir2* whose names are
   given by *common*.

However, the actual parameters are named a and b (Lib/filecmp.py):

def cmpfiles(a, b, common, shallow=True):

As a result the documented keyword names do not work — calling filecmp.cmpfiles(dir1=..., dir2=..., common=...) raises TypeError, while filecmp.cmpfiles(a=..., b=..., common=...) succeeds.

The documentation should be updated to use the real parameter names a and b.

Linked PRs

• gh-153899: Fix documented parameter names for filecmp.cmpfiles #153900
• [3.15] gh-153899: Fix documented parameter names for filecmp.cmpfiles (GH-153900) #153910
• [3.14] gh-153899: Fix documented parameter names for filecmp.cmpfiles (GH-153900) #153911
• [3.13] gh-153899: Fix documented parameter names for filecmp.cmpfiles (GH-153900) #153912