Path: csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!selfless.tophat.at!newsfeed.xs4all.nl!newsfeed6.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail Return-Path: X-Original-To: python-list@python.org Delivered-To: python-list@mail.python.org X-Spam-Status: OK 0.000 X-Spam-Evidence: '*H*': 1.00; '*S*': 0.00; 'subject:" ': 0.03; 'rejected': 0.04; 'classes.': 0.05; 'received:verizon.net': 0.07; 'terry': 0.07; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:80.91.229.12': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'received:lo.gmane.org': 0.09; 'tracker,': 0.09; 'wrote:': 0.15; '(before': 0.16; 'eliminated': 0.16; 'finney': 0.16; 'reedy': 0.16; 'subject:() ': 0.16; 'looked': 0.16; 'pm,': 0.16; '>>>': 0.16; 'subject:list': 0.16; 'subject:skip:d 10': 0.17; 'jan': 0.19; '(which': 0.20; "haven't": 0.21; 'subject:not': 0.21; '(but': 0.22; "aren't": 0.22; 'header :In-Reply-To:1': 0.22; 'expanded': 0.23; 'section.': 0.23; 'index': 0.25; 'expect': 0.25; 'writes:': 0.25; 'function': 0.26; 'helpful': 0.26; 'generic': 0.29; 'classes': 0.30; 'types.': 0.30; 'class': 0.31; 'proposed': 0.32; 'does': 0.32; 'to:addr:python- list': 0.34; 'header:X-Complaints-To:1': 0.34; 'header:User- Agent:1': 0.34; 'functions.': 0.37; 'but': 0.37; 'could': 0.37; 'received:org': 0.38; 'subject:: ': 0.38; 'patch': 0.38; 'steven': 0.38; 'think': 0.38; 'case,': 0.38; 'header:Mime-Version:1': 0.39; 'to:addr:python.org': 0.39; 'called': 0.40; 'table': 0.40; 'basis': 0.62; 'full': 0.63; 'believe': 0.66; 'exact': 0.69; 'subject:should': 0.84; 'chapter.': 0.91; 'subject:place': 0.91 X-Injected-Via-Gmane: http://gmane.org/ To: python-list@python.org From: Terry Reedy Subject: Re: list(), tuple() should not place at "Built-in functions" in documentation Date: Thu, 14 Jul 2011 23:00:16 -0400 References: <4e1f989e$0$29990$c3e8da3$5496439d@news.astraweb.com> <87ipr4b9bu.fsf@benfinney.id.au> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: quoted-printable X-Gmane-NNTP-Posting-Host: pool-74-109-121-73.phlapa.fios.verizon.net User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.2.18) Gecko/20110616 Lightning/1.0b2 Thunderbird/3.1.11 In-Reply-To: <87ipr4b9bu.fsf@benfinney.id.au> X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.12 Precedence: list List-Id: General discussion list for the Python programming language List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Newsgroups: comp.lang.python Message-ID: Lines: 40 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1310698830 news.xs4all.nl 23846 [2001:888:2000:d::a6]:43151 X-Complaints-To: abuse@xs4all.nl Xref: x330-a1.tempe.blueboxinc.net comp.lang.python:9502 On 7/14/2011 9:51 PM, Ben Finney wrote: > Steven D'Aprano writes: > >> Inside wrote: >> >>> As telling in the subject,because "list" and "tuple" aren't functions= ,they >>> are types.Is that right? At one time (before 2.2), they were functions and not classes. >> >> Yes they are types. But they can still be used as functions. Does it m= atter? > > As a newcomer to the documentation I looked fruitlessly in the table of= > contents for a section that would contain the built-in types. =E2=80=9C= Built-in > functions=E2=80=9D was eliminated for the reason the OP states. > > I think it matters. (But I haven't proposed a documentation patch for i= t.) I once proposed, I believe on the tracker, that 'built-in functions' be=20 expanded to 'built-in function and classes'. That was rejected on the=20 basis that people would then expect the full class documentation that is = in the 'built-in types' section (which could now be called the=20 built-isssn classes section. A more exact title would be 'built-in callables', but that would be even = less helpful to newcomers. Callables are functions in the generic sense. In any case, the new index makes it easy to see what is in that chapter. --=20 Terry Jan Reedy