[issue2761] Doc: built-in callables and map

[Terry J. Reedy]

New submission from Terry J. Reedy <tjreedy at udel.edu>:

StdLibMan Built-in Functions

I believe that at one time this section only contained functions.
But this has not been true since at least 2.2.

Please add "and Classes" to the title and first sentence.
Possibly add "('callables')" after "and classes" in the sentence to
introduce the generic term.  This would at least slightly help the
sometimes confusion between 'function' as specific class and as generic
callable.

This change also applies to 2.6 (and earlier, but oh, well...).

3.0 entry for map() (now a class!) in this section.  Please add
"With multiple iterables, stops when the shortest iterable is exhausted"
.  (Copied from map.__doc__.)

What's New in 3.0: Stumbling Blocks: map entry: Add same sentence or
similar.  I only checked help(map) and discovered the change because of
reading about itertools.imap and knowing that 3.0 map was derived?
copied? from that.

----------
assignee: georg.brandl
components: Documentation
messages: 66228
nosy: georg.brandl, tjreedy
severity: normal
status: open
title: Doc: built-in callables and map
type: behavior
versions: Python 3.0

__________________________________
Tracker <report at bugs.python.org>
<http://bugs.python.org/issue2761>
__________________________________