[Python-Dev] [bpo-35155] Requesting a review

Terry Reedy tjreedy at udel.edu
Tue Feb 12 15:24:03 EST 2019

On 2/12/2019 5:14 AM, Denton Liu wrote:
> Hello all,
> A couple months back, I reported bpo-35155[1] and I submitted a PR for
> consideration[2]. After a couple of reviews, it seems like progress has
> stalled. Would it be possible for someone to review this?
> Thanks,
> Denton
> [1]: https://bugs.python.org/issue35155
> [2]: https://github.com/python/cpython/pull/10313

The problem is that the urllib.request doc has several 
'placeholder-literal' and 'literal-placeholder' constructs where 
'literal' is text that the user *must copy* while 'placeholder' is text 
that the user *must replace* with one of several strings, with no 
evident indication of which is which.  (The constructs indicate possible 
allowed names of user-supplied functions.)  The only issue to me is how 
to indicate in the .rst source (and resulting html) that 'placeholder' 
is a placeholder and not a literal.

Terry Jan Reedy

More information about the Python-Dev mailing list