[docs] [issue23164] "pydoc filter" documentation restrictive

[Eric O. LEBIGOT]

New submission from Eric O. LEBIGOT:

The pydoc documentation for filter reads:

    filter(function or None, sequence) -> list, tuple, or string
    
    Return those items of sequence for which function(item) is true.  If
    function is None, return the items that are true.  If sequence is a tuple
    or string, return the same type, else return a list.

It would be nicer to know (e.g. when offline and with no local access to the HTML documentation) that filter() can actually be used more generally with an iterable:

    filter(function or None, **iterable**) -> list, tuple, or string
    
    Return those items of **iterable** for which…

----------
assignee: docs at python
components: Documentation
messages: 233416
nosy: docs at python, lebigot
priority: normal
severity: normal
status: open
title: "pydoc filter" documentation restrictive
type: enhancement
versions: Python 2.7

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