Re: Where are list methods documented?

[Nick Coghlan]

Tim Peters wrote:
2. Built-In Objects 
    2.1 Built-in Functions 
    2.2 Non-essential Built-in Functions 
    2.3 Built-in Types 
        2.3.1 Truth Value Testing 
        2.3.2 Boolean Operations 
        2.3.3 Comparisons 
        2.3.4 Numeric Types 
        2.3.5 Iterator Types 
        2.3.6 Sequence Types 
        2.3.7 Set Types 
        2.3.8 Mapping Types 
        2.3.9 File Objects 
        2.3.10 Other Built-in Types 
        2.3.11 Special Attributes 
    2.4 Built-in Exceptions 
    2.5 Built-in Constants

So, e.g., it doesn't mention floats or dicts by those names either. 
It's well worthwhile to spend some time browsing that entire chapter.
I wonder if adding a small table to the end of the introductory text in Section 
2.3 would help. Something like:

""""
The documentation in this section is written in terms of type categories. The 
table below associates specific builtin types with the most relevant categories.

Type Category      Specific Built-in Types
 Boolean            bool
 Numeric            int, long, float, complex
 Iterator           N/A
 Sequence           tuple
 String Sequence    str, unicode
 Mutable Sequence   list
 Set                set, frozenset
 Mapping            dict
 File               file
"""
Cheers,
Nick.
--
Nick Coghlan   |   [EMAIL PROTECTED]   |   Brisbane, Australia
---------------------------------------------------------------
            http://boredomandlaziness.skystorm.net
--
http://mail.python.org/mailman/listinfo/python-list