[issue16503] Unclear documentation regarding apply(), 'extended call syntax'

[Zachary Ware]

New submission from Zachary Ware:

(Reported by Kevin Leeds on docs at 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?

----------
assignee: docs at python
components: Documentation
files: arbitraryargs_2.7.patch
keywords: patch
messages: 175894
nosy: docs at python, zach.ware
priority: normal
severity: normal
status: open
title: Unclear documentation regarding apply(), 'extended call syntax'
versions: Python 2.7
Added file: http://bugs.python.org/file28029/arbitraryargs_2.7.patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16503>
_______________________________________