Document `RotatingFileHandler.shouldRollover()` and `TimedRotatingFileHandler.shouldRollover()`

[AllenSH12]

Documentation

The RotatingFileHandler and TimedRotatingFileHandler do not document the shouldRollover method that they both implement.

Linked PRs

• gh-134817: Documents [Timed]RotatingFileHandler shouldRollover methods #134818
• [3.14] gh-134817: Document [Timed]RotatingFileHandler shouldRollover method (GH-134818) #134823
• [3.13] gh-134817: Document [Timed]RotatingFileHandler shouldRollover method (GH-134818) #134824
• gh-134817: Restore accidentally deleted line in documentation. #141013
• [3.14] gh-134817: Restore accidentally deleted line in documentation. (GH-141013) #141016
• [3.13] gh-134817: Restore accidentally deleted line in documentation. (GH-141013) #141017

[monkeyman192]

The commit(s) associated with this change removed some existing documentation:

3.12: https://docs.python.org/3.12/library/logging.handlers.html#logging.handlers.TimedRotatingFileHandler.getFilesToDelete
3.13: https://docs.python.org/3.13/library/logging.handlers.html#logging.handlers.TimedRotatingFileHandler.getFilesToDelete
(and same with 3.14)

I can see that the associated PR's deleted a line they shouldn't have...