Undocumented Cmd method print_topics

Documentation

When exploring the Cmd Python library, I realized that there is no documentation for print_topics method.

I only realized the missing documentation because I noticed that print_topics method has an unused parameter called cmdlen, and I couldn't figure out if it is actually useful for something.
I could also notice that on typeshed it is typed as Any, even though it seems to be only used as an int.

Extra doubts:

Maybe print_topics should be renamed to _print_topics or we should document how to use it properly?
Also, is that cmdlen parameter really needed?

I am willing to contribute with that, but I don't know which type of issue I should open to report an unused param.

Links:

• Cmd documentation: https://docs.python.org/3.13/library/cmd.html
• Cdm.print_topics definition: https://github.com/python/cpython/blob/main/Lib/cmd.py#L346
• typeshed: https://github.com/python/typeshed/blob/main/stdlib/cmd.pyi#L45

Linked PRs

• gh-134539

Commencez par la définition de print_topics dans Lib/cmd.py#L346, la documentation de Cmd et sa déclaration typeshed. Examinez la PR liée gh-134539 ainsi que les questions non résolues concernant cmdlen, le nommage et le typage avant de décider du comportement public attendu. Le travail est terminé lorsque le comportement convenu et l’utilisation des paramètres sont documentés, et que l’annotation typeshed a été traitée si nécessaire.