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.

classification
Title: Unclear documentation regarding apply(), 'extended call syntax'
Type: Stage: resolved
Components: Documentation Versions: Python 2.7
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: ezio.melotti Nosy List: docs@python, ezio.melotti, python-dev, zach.ware
Priority: normal Keywords: patch

Created on 2012-11-18 17:35 by zach.ware, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
arbitraryargs_2.7.patch zach.ware, 2012-11-18 17:35 Add link to deprecation warning review
Messages (4)
msg175894 - (view) Author: Zachary Ware (zach.ware) * (Python committer) Date: 2012-11-18 17:35
(Reported by Kevin Leeds on docs@python.org)

The documentation for the apply() built-in function in 2.7 says that it is deprecated and to use "extended call syntax" instead.  There is no mention of "extended call syntax" anywhere else in the docs.  The simplest solution I can see is in the attached patch; it merely adds a link to the tutorial section about arbitrary argument lists within the deprecation warning.  I wonder though if the wording should be changed to something more findable.  What is the common wording of *args and **kwargs usage?
msg175907 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2012-11-18 19:23
New changeset 7efa0d66b1a0 by Ezio Melotti in branch '2.7':
#16503: clarify "apply" docs.
http://hg.python.org/cpython/rev/7efa0d66b1a0
msg175908 - (view) Author: Ezio Melotti (ezio.melotti) * (Python committer) Date: 2012-11-18 19:24
It should be clearer now.
msg175915 - (view) Author: Zachary Ware (zach.ware) * (Python committer) Date: 2012-11-18 20:03
Looks good to me, thank you Ezio!
History
Date User Action Args
2022-04-11 14:57:38adminsetgithub: 60707
2012-11-18 20:04:19zach.waresetstatus: open -> closed
resolution: fixed
2012-11-18 20:03:54zach.waresetstatus: closed -> open
type: enhancement ->
resolution: fixed -> (no value)
messages: + msg175915
2012-11-18 19:24:59ezio.melottisetstatus: open -> closed

type: enhancement
assignee: docs@python -> ezio.melotti

nosy: + ezio.melotti
messages: + msg175908
resolution: fixed
stage: resolved
2012-11-18 19:23:57python-devsetnosy: + python-dev
messages: + msg175907
2012-11-18 17:35:16zach.warecreate