[Python-Dev] [bpo-35155] Requesting a review
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 and I submitted a PR for
> consideration. After a couple of reviews, it seems like progress has
> stalled. Would it be possible for someone to review this?
> : https://bugs.python.org/issue35155
> : 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