Where are list methods documented?

Nick Coghlan ncoghlan at iinet.net.au
Tue Feb 1 20:56:35 EST 2005


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   |   ncoghlan at email.com   |   Brisbane, Australia
---------------------------------------------------------------
             http://boredomandlaziness.skystorm.net



More information about the Python-list mailing list