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

Comece pela definição de print_topics em Lib/cmd.py#L346, pela documentação de Cmd e por sua declaração no typeshed. Revise o PR vinculado gh-134539 e as questões não resolvidas sobre cmdlen, nomenclatura e tipagem antes de decidir o comportamento público pretendido. Considera-se concluído quando o comportamento acordado e o uso dos parâmetros estiverem documentados, e a anotação do typeshed tiver sido tratada, se necessário.