[issue19202] Additions to function docs: reduce and itertools.

2013-10-12 Thread Raymond Hettinger
Changes by Raymond Hettinger raymond.hettin...@gmail.com: -- assignee: docs@python - rhettinger ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue19202 ___

[issue19202] Additions to function docs: reduce and itertools.

2013-10-12 Thread Raymond Hettinger
Raymond Hettinger added the comment: Almost all of these make the docs worse and should not be applied. The purpose of the equivalent code is simply to make the documentation clearer, not to show all the ways it could have been done. I do think Georg's reduce() equivalent should be added

[issue19202] Additions to function docs: reduce and itertools.

2013-10-12 Thread Georg Brandl
Georg Brandl added the comment: What do you think of the two references added to the itertools docs? -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue19202 ___

[issue19202] Additions to function docs: reduce and itertools.

2013-10-12 Thread Raymond Hettinger
Raymond Hettinger added the comment: The reference from accumulate() to reduce() may be useful. I'm opposed to most of the other equivalents and cross-references. They bloat the docs without adding value. Terry is right in saying that the equivalent for enumerate() is better as a basic loop

[issue19202] Additions to function docs: reduce and itertools.

2013-10-12 Thread Georg Brandl
Georg Brandl added the comment: I agree. Will prepare a patch to the reduce() doc. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue19202 ___ ___

[issue19202] Additions to function docs: reduce and itertools.

2013-10-12 Thread Georg Brandl
Changes by Georg Brandl ge...@python.org: Added file: http://bugs.python.org/file32063/reduce_equiv.diff ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue19202 ___

[issue19202] Additions to function docs: reduce and itertools.

2013-10-12 Thread Roundup Robot
Roundup Robot added the comment: New changeset 3b6401c27e39 by Raymond Hettinger in branch '3.3': Issue #19202: Add cross-reference and a rough code equivalent http://hg.python.org/cpython/rev/3b6401c27e39 -- nosy: +python-dev ___ Python tracker

[issue19202] Additions to function docs: reduce and itertools.

2013-10-12 Thread Raymond Hettinger
Raymond Hettinger added the comment: Thanks Georg. -- resolution: - fixed status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue19202 ___

[issue19202] Additions to function docs: reduce and itertools.

2013-10-11 Thread Terry J. Reedy
Terry J. Reedy added the comment: I think the reduce equivalent given by Georg would be excellent. I think the enumerate equivalent already given is fine because I think equivalents should use basic syntax (for loops), not something that might be more obscure. -- nosy: +terry.reedy