I am open to adding the missing documentation/ updating the CLI to use argparse for a help section. I came across this while looking into #131178, so it might be possible to add tests and update the CLI at the same time if this proposal is acceptable.

In my opinion, this is a good idea. I also think that we can add better CLI tools for arg parsing (like argparse).

CC @hugovk

we also don't have help messages for many other CLI modules that parse flags themselves or use legacy modules to implement cli

I wrote about it here: #93096 (comment)

as already said (in comment) this makes the behavior implicit maybe it's worth opening a new issue to add help flags to each module

Interestingly, the CLI has been part of the module since it was added in 2003 for Python 2.3 and hasn't changed (beyond print and whitespace): 246d847

In my opinion, this is a good idea. I also think that we can add better CLI tools for arg parsing (like argparse).

Fine by me too.

@Harry-Lees Would you like to open a PR?