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.

Author cheryl.sabella
Recipients Denton-L, cheryl.sabella, docs@python, mrabarnett, orsenthil, terry.reedy
Date 2019-02-12.22:32:24
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1550010744.28.0.000499006477221.issue35155@roundup.psfhosted.org>
In-reply-to
Content
I don't think there is anything specifically defined for a placeholder.  However, looking at the current urllib.request documentation, there are 2 places that use the ``<name>_`` method for a placeholder - <protocol>.proxy and <scheme>.proxy, with the latter explaining what <scheme> means.

> By default, ProxyHandler uses the environment variables named <scheme>_proxy, where <scheme> is the URL scheme involved.

That line was added by Georg Brandl (granted it was part of converting all the docs), which would lead me to believe that is the accepted way to do it.

Also, the argument clinic how-to has the following:
> The length of the string will be passed in to the impl function, just after the string parameter, as a parameter named ``<parameter_name>_length``.

I'll make a comment on the PR too.
History
Date User Action Args
2019-02-12 22:32:24cheryl.sabellasetrecipients: + cheryl.sabella, terry.reedy, orsenthil, mrabarnett, docs@python, Denton-L
2019-02-12 22:32:24cheryl.sabellasetmessageid: <1550010744.28.0.000499006477221.issue35155@roundup.psfhosted.org>
2019-02-12 22:32:24cheryl.sabellalinkissue35155 messages
2019-02-12 22:32:24cheryl.sabellacreate