Path: csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!gegeweb.org!de-l.enfer-du-nord.net!feeder2.enfer-du-nord.net!feeder.news-service.com!newsfeed.xs4all.nl!newsfeed5.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.044 X-Spam-Evidence: '*H*': 0.91; '*S*': 0.00; 'python': 0.08; 'received:209.85.160.174': 0.09; 'received:mail- gy0-f174.google.com': 0.09; 'programmer': 0.11; 'am,': 0.13; 'wrote:': 0.15; 'docstrings': 0.16; 'hammer': 0.16; 'rantingrick': 0.16; 'subject:PEP': 0.16; 'tighter': 0.16; 'folks': 0.16; 'url:blog': 0.16; 'header:In-Reply-To:1': 0.22; 'received:192.168.1.100': 0.23; 'format,': 0.25; "i'm": 0.27; 'sort': 0.28; 'fri,': 0.28; 'gis': 0.29; 'skip:- 30': 0.30; 'programmers': 0.31; 'chris': 0.32; 'too': 0.32; 'message- id:@gmail.com': 0.32; 'to:addr:python-list': 0.34; 'header:User- Agent:1': 0.34; 'received:209.85.160': 0.34; 'things': 0.34; 'functions.': 0.37; 'received:192': 0.38; 'received:google.com': 0.38; 'received:209.85': 0.38; 'subject:: ': 0.38; 'george': 0.38; 'received:192.168.1': 0.39; 'to:addr:python.org': 0.39; 'received:209': 0.40; 'your': 0.60; 'url:net': 0.61; 'stop': 0.61; 'mandate': 0.67; 'refusing': 0.67; 'cunha': 0.84; 'julho': 0.84; 'lord': 0.91; 'slip': 0.91; 'subject:Proposal': 0.93 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:subject:references :in-reply-to:content-type:content-transfer-encoding; bh=eb+ek4fVg2JdZSzaT055i0pwqgniLesTkpahzglQfb0=; b=jpophBshRXS/q888MVK1QCJxaL9Mwtx40bOWj+UMAhyWHPiV3RSIkpdVgvtGfPYqN4 8Coy+W8xdwb/2RKqKlsJbEXSernMji2aPCLDCaN7RA7C1X3tHkWHc3iNT143kW16Hnz1 +pNdoD2u67cHt89Aqg9PE8U5Rxe5eQ5VdbkIw= Date: Fri, 15 Jul 2011 12:44:14 -0300 From: George Rodrigues da Cunha Silva User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:5.0) Gecko/20110624 Thunderbird/5.0 MIME-Version: 1.0 To: python-list@python.org Subject: Re: Proposal to extend PEP 257 (New Documentation String Spec) References: <120629e8-3b37-4e8c-a472-cd361de15de4@g9g2000yqb.googlegroups.com> In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit 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: 26 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1310744677 news.xs4all.nl 23944 [2001:888:2000:d::a6]:46174 X-Complaints-To: abuse@xs4all.nl Xref: x330-a1.tempe.blueboxinc.net comp.lang.python:9554 Em sexta-feira, 15 de julho de 2011 04:13:43, Chris Angelico escreveu: > On Fri, Jul 15, 2011 at 9:02 AM, rantingrick wrote: >> Too many folks >> are refusing to document properly and so i will take this time to >> hammer out a spec. > > The tighter you squeeze your fist, Lord Rick, the more star > programmers will slip through your fingers. > > Make it so docstrings HAVE to be in a particular format, and people > will stop writing docstrings. Make it so Python functions HAVE to have > docstrings, and people will stop writing Python functions. > > ChrisA I'm with Chris. If you mandate this sort of things on the programmer this will just go downhill. George -- -------------------------------- George Rodrigues da Cunha Silva Desenvolvedor GIS http://geoprocessamento.net http://blog.geoprocessamento.net