Harmonize parameter names in the time module documentation and docstrings

[serhiy-storchaka]

@StanFromIreland noticed in the review of GH-155513 that the parameter names in the time module documentation differ from the names used in the docstrings.

function	Doc/library/time.rst	docstring
asctime	asctime([t])	asctime([tuple])
ctime	ctime([secs])	ctime(seconds)
gmtime	gmtime([secs])	gmtime([seconds])
localtime	localtime([secs])	localtime([seconds])
mktime	mktime(t)	mktime(tuple)
sleep	sleep(secs)	sleep(seconds)
strftime	strftime(format[, t])	strftime(format[, tuple])

All these parameters are positional-only, so the names are not part of the API, but they should not contradict each other.

After GH-155513 they are no longer just a text in the docstring: asctime, ctime, gmtime, localtime and mktime get a real signature, and the METH_O mktime and sleep no longer report the generic ($self, object, /). time_tuple is used there instead of tuple, which shadows a builtin.

There are also two inconsistencies inside the docstrings themselves: the seconds argument of ctime is optional, and the format argument of strptime is optional (it defaults to "%a %b %d %H:%M:%S %Y"), but neither is shown in brackets.

Linked PRs

• gh-155787: Harmonize parameter names in the time module documentation and docstrings #155790
• [3.15] gh-155787: Harmonize parameter names in the time module documentation and docstrings (GH-155790) #155804
• [3.14] gh-155787: Harmonize parameter names in the time module documentation and docstrings (GH-155790) #155806
• [3.13] gh-155787: Harmonize parameter names in the time module documentation and docstrings (GH-155790) #155807
• Harmonize parameter names in time module documentation (gh-155787) #155818

[SparshGarg999]

Proposed Plan to Harmonize time Module Parameter Names in Documentation and Docstrings

Docstring signatures and Doc/library/time.rst currently use inconsistent parameter names for functions like ctime, gmtime, localtime, and sleep (secs vs seconds, t vs tuple).

Fix:
Update parameter names in Doc/library/time.rst and C module docstrings to use consistent, descriptive parameter naming across all time utility functions.