New submission from Matthias Bussonnier email@example.com:
Do the following at a Python prompt:
>>> help() Welcome to Python 3.8's help utility! [...]SNIP help> symbols Here is a list of the punctuation symbols which Python assigns special meaning to. Enter any symbol to get more help. != + <= __ " += <> ` """ , == b" % - > b' %= -= >= f" & . >> f' &= ... >>= j ' / @ r" ''' // J r' ( //= [ u" ) /= \ u' * : ] | ** < ^ |= **= << ^= ~ *= <<= _
Oh no ! Our favorite
:= is missing :-(
assignee: docs@python components: Documentation messages: 343813 nosy: docs@python, mbussonn priority: normal severity: normal status: open title: Assignment expression operator (walrus) not in built-in help() versions: Python 3.8, Python 3.9
Mark Dickinson firstname.lastname@example.org added the comment:
Looks like that list could do with some attention:
Terry J. Reedy email@example.com added the comment:
The augmented assignment symbol, like that for plain assignment, is not, properly speaking, an operator. But it definitely is a symbol that needs to be documented.
Generally update the help symbol list.
Document :=, assignment expression, in the regular docs, but I found nothing.
':=' should be on https://docs.python.org/3.8/genindex-Symbols.html just ':(colon)'.
'expression' should be listed under 'assignment on https://docs.python.org/3.8/genindex-A.html
I think 'assignment' should be listed under 'expression' on https://docs.python.org/3.8/genindex-E.html
I could not find anything in the expressions chapter.
nosy: +terry.reedy title: Assignment expression operator (walrus) not in built-in help() -> Assignment expression symbol (walrus) not in built-in help()
Guido van Rossum firstname.lastname@example.org added the comment:
We might get more help with this issue if the process of updating the help() output were better documented. I recently looked into what it would take to add "FSTRINGS" to the "topics" list, and it's quite complicated -- I only persevered after stepping through pydoc.help() using pdb. I wrote up a few tips in issue41045.