This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Add separate match and case doc to pydoc
Type: enhancement Stage:
Components: Library (Lib) Versions:
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: Nosy List: duckboycool
Priority: normal Keywords:

Created on 2022-03-15 02:10 by duckboycool, last changed 2022-04-11 14:59 by admin.

Messages (1)
msg415217 - (view) Author: Duck (duckboycool) Date: 2022-03-15 02:10
Currently pydoc (and therefore things like the interactive help prompt) do not have documentation for the soft-keywords "match" and "case".

```
help> match
No Python documentation found for 'match'.
Use help() to get the interactive help utility.
Use help(str) for help on the str class.
```

I think that it would make sense for both of these prompts to give the docs for the match statement (https://docs.python.org/3/reference/compound_stmts.html#the-match-statement) similar to the other compound statements.

The "compound" doc already contains the match statement documentation, but is unnecessarily long at over 48000 characters, and is only accessed by the unhelpful named for this purpose "LOOPING" prompt. As soft keywords, they also might be best added in a separate section in "keywords" (and potentially with "_", although this already refers to "PRIVATENAMES" and is in "symbols").

A standalone match and case doc is not currently present in the Lib/pydoc_data/topics.py file automatically generated from documentation, and would need to be added in some way to do this.
History
Date User Action Args
2022-04-11 14:59:57adminsetgithub: 91177
2022-03-15 02:10:46duckboycoolcreate