Path: csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!feeder.erje.net!eu.feeder.erje.net!news.albasani.net!rt.uk.eu.org!newsfeed.xs4all.nl!newsfeed2.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.004 X-Spam-Evidence: '*H*': 0.99; '*S*': 0.00; 'english.': 0.04; 'from:addr:yahoo.co.uk': 0.04; 'arguments': 0.09; 'lawrence': 0.09; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'subject:None': 0.09; 'language.': 0.14; 'accepts': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'subject:key': 0.16; 'language': 0.16; 'wrote:': 0.18; 'bit': 0.19; 'header:User- Agent:1': 0.23; 'refers': 0.24; 'sort': 0.25; 'header:X -Complaints-To:1': 0.27; 'header:In-Reply-To:1': 0.27; 'dec': 0.30; 'url:python': 0.33; 'fri,': 0.33; 'plain': 0.33; 'method': 0.36; 'url:org': 0.36; 'two': 0.37; 'list': 0.37; 'url:library': 0.38; 'to:addr:python-list': 0.38; 'pm,': 0.38; 'to:addr:python.org': 0.39; 'received:org': 0.40; 'url:3': 0.61; 'simply': 0.61; 'our': 0.64; 'here': 0.66; 'believe': 0.68; '20,': 0.68; 'subject': 0.69; 'repeat': 0.74; '2013': 0.98 X-Injected-Via-Gmane: http://gmane.org/ To: python-list@python.org From: Mark Lawrence Subject: Re: sort(*, key=None, reverse=None) Date: Sat, 21 Dec 2013 07:24:30 +0000 References: Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Gmane-NNTP-Posting-Host: host-78-147-30-118.as13285.net User-Agent: Mozilla/5.0 (Windows NT 6.1; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 In-Reply-To: X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.15 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: 22 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1387610689 news.xs4all.nl 2962 [2001:888:2000:d::a6]:53026 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:62469 On 21/12/2013 07:20, Devin Jeanpierre wrote: > On Fri, Dec 20, 2013 at 11:16 PM, Mark Lawrence wrote: >> The subject refers to the list sort method given here >> http://docs.python.org/3/library/stdtypes.html#list. I believe that the >> "*," bit is simply a typo, given that the docs also state "sort() accepts >> two arguments that can only be passed by keyword". Am I correct? > > It's good practice in technical writing to repeat yourself: once in > the formal spec, and once in plain english. I don't see why this would > be a typo. > > -- Devin > So what is it actually saying? -- My fellow Pythonistas, ask not what our language can do for you, ask what you can do for our language. Mark Lawrence