[issue45393] help() on operator precedence has confusing entries "await" "x" and "not" "x"

[Zackery Spytz]

Zackery Spytz  added the comment:

I have created a patch for this issue.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue45393] help() on operator precedence has confusing entries "await" "x" and "not" "x"

[Zackery Spytz]

Change by Zackery Spytz :


--
keywords: +patch
nosy: +ZackerySpytz
nosy_count: 5.0 -> 6.0
pull_requests: +29415
stage:  -> patch review
pull_request: https://github.com/python/cpython/pull/31246

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue45393] help() on operator precedence has confusing entries "await" "x" and "not" "x"

[Serhiy Storchaka]

Serhiy Storchaka  added the comment:

In past we could backport some simple documentation fixes to security-only 
branches. But currently only the release manager of the corresponded version 
has permission to commit to these branches, and we do not want to disturb them 
for such minor cause.

I concur with analysis of Zachary. All options look good to me.

--
nosy: +serhiy.storchaka

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue45393] help() on operator precedence has confusing entries "await" "x" and "not" "x"

[Max]

Max  added the comment:

option 1 looks most attractive to me (and will also look most attractive in the 
rendering, IMHO -- certainly better than "await" "x", in any case).

P.S.: OK, thanks for explanations concerning 3.6 - 3.8. I do understand that it 
won't be fixed for these versions (not certain why not if possible at no cost), 
but I do not understand why these labels must be removed. The bug does exist 
but should simply be considered as "nofix" for these versions (or not), given 
that it's not in the "security" category. The fact that it won't be fixed, for 
whatever reason, should not mean that it should not be listed as existing, 
there.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue45393] help() on operator precedence has confusing entries "await" "x" and "not" "x"

[Zachary Ware]

Zachary Ware  added the comment:

Correct; 3.7 and 3.8 are both in security-fix-only maintenance mode; their 
documentation is no longer updated unless a security-related fix causes a 
significant change in behavior that needs to be documented.

As far as fixing this issue, we have a few options.  The cause is that the 
source for these rows looks like ':keyword:`await` ``x``', which basically 
produces two inline code blocks with a non-code space between, which the 
pydoc-topics renderer renders as two separately quoted words.

Option 1: Replace ':keyword:`await` ``x``' with `:keyword:`await x `.  
This keeps the link to the `await` anchor, but extends it across the ' x' bit.  
The pydoc rendering is '"await x"'.

Option 2: Replace ':keyword:`await` ``x``' with '``await x``.  This also gives 
the pydoc rendering of '"await x"', but loses the link to the `await` anchor, 
which I would rather not do.

Option 3: As option 2, but also replace 'Await' in the description column with 
a link to the `await` anchor.  This breaks from how other keywords in the table 
are linked.

Option 4: Adjust the pydoc-topics renderer to smush together consecutive inline 
code blocks.  This might cause some issues elsewhere.

--
nosy: +zach.ware
versions:  -Python 3.7, Python 3.8

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue45393] help() on operator precedence has confusing entries "await" "x" and "not" "x"

[Vedran Čačić]

Vedran Čačić  added the comment:

I guess those old versions were removed because they are "frozen", that is, not 
receiving doc fixes anymore.

--
nosy: +veky

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue45393] help() on operator precedence has confusing entries "await" "x" and "not" "x"

[Max]

Max  added the comment:

Thanks for fixing the typo, didn't knnow how to do that when I spotted it (I'm 
new to this). 
You also removed Python version 3.6, 3.7, 3.8, however, I just tested on 
pythonanywhere,
>>> sys.version
'3.7.0 (default, Aug 22 2018, 20:50:05) \n[GCC 5.4.0 20160609]'
So I can confirm that the bug *is* there on 3.7 (so I put this back in the list 
- unless it was removed in a later 3.7.x (to you mean that?) and put back in 
later versions...?)
It is also on the Python 3.9.7 I'm running on my laptop, so I'd greatly be 
surprised if it were not present on the other two versions you also removed.

--
versions: +Python 3.7, Python 3.8

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue45393] help() on operator precedence has confusing entries "await" "x" and "not" "x"

[Serhiy Storchaka]

Change by Serhiy Storchaka :


--
title: help() on operator precedence has confusing entries "avait" "x" and 
"not" "x" -> help() on operator precedence has confusing entries "await" "x" 
and "not" "x"
versions:  -Python 3.6, Python 3.7, Python 3.8

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com