Re: Proposal to extend PEP 257 (New Documentation String Spec)

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	<georger.silva@gmail.com>
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 <georger.silva@gmail.com>
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> <CAPTjJmoYnwVsh=SZ84CoZ3+88MDzOY-guq9QaLrXezSYnBEJpw@mail.gmail.com>
In-Reply-To	<CAPTjJmoYnwVsh=SZ84CoZ3+88MDzOY-guq9QaLrXezSYnBEJpw@mail.gmail.com>
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 <python-list.python.org>
List-Unsubscribe	<http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive	<http://mail.python.org/pipermail/python-list>
List-Post	<mailto:python-list@python.org>
List-Help	<mailto:python-list-request@python.org?subject=help>
List-Subscribe	<http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups	comp.lang.python
Message-ID	<mailman.1069.1310744677.1164.python-list@python.org> (permalink)
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

Show key headers only | View raw

Em sexta-feira, 15 de julho de 2011 04:13:43, Chris Angelico escreveu:
> On Fri, Jul 15, 2011 at 9:02 AM, rantingrick<rantingrick@gmail.com>  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

Back to comp.lang.python | Previous | Next — Previous in thread | Find similar | Unroll thread

Thread

Proposal to extend PEP 257 (New Documentation String Spec) rantingrick <rantingrick@gmail.com> - 2011-07-14 16:02 -0700
  Re: Proposal to extend PEP 257 (New Documentation String Spec) Ben Finney <ben+python@benfinney.id.au> - 2011-07-15 10:24 +1000
  Re: Proposal to extend PEP 257 (New Documentation String Spec) Michael Hrivnak <mhrivnak@hrivnak.org> - 2011-07-15 02:00 -0400
  Re: Proposal to extend PEP 257 (New Documentation String Spec) Chris Angelico <rosuav@gmail.com> - 2011-07-15 17:13 +1000
    Re: Proposal to extend PEP 257 (New Documentation String Spec) rantingrick <rantingrick@gmail.com> - 2011-07-15 11:56 -0700
      Re: Proposal to extend PEP 257 (New Documentation String Spec) Chris Angelico <rosuav@gmail.com> - 2011-07-16 09:16 +1000
        Re: Proposal to extend PEP 257 (New Documentation String Spec) rantingrick <rantingrick@gmail.com> - 2011-07-16 08:32 -0700
          Re: Proposal to extend PEP 257 (New Documentation String Spec) Chris Angelico <rosuav@gmail.com> - 2011-07-17 02:25 +1000
          Re: Proposal to extend PEP 257 (New Documentation String Spec) Andrew Berg <bahamutzero8825@gmail.com> - 2011-07-16 18:03 -0500
            Re: Proposal to extend PEP 257 (New Documentation String Spec) rantingrick <rantingrick@gmail.com> - 2011-07-16 16:25 -0700
              Re: Proposal to extend PEP 257 (New Documentation String Spec) Chris Angelico <rosuav@gmail.com> - 2011-07-17 09:45 +1000
          Re: Proposal to extend PEP 257 (New Documentation String Spec) Andrew Berg <bahamutzero8825@gmail.com> - 2011-07-16 18:44 -0500
      Re: Proposal to extend PEP 257 (New Documentation String Spec) Michael Hrivnak <mhrivnak@hrivnak.org> - 2011-07-16 15:23 -0400
        Re: Proposal to extend PEP 257 (New Documentation String Spec) Steven D'Aprano <steve+comp.lang.python@pearwood.info> - 2011-07-17 13:10 +1000
          Re: Proposal to extend PEP 257 (New Documentation String Spec) Tim Chase <python.list@tim.thechases.com> - 2011-07-17 06:11 -0500
            Re: Proposal to extend PEP 257 (New Documentation String Spec) rantingrick <rantingrick@gmail.com> - 2011-07-17 10:30 -0700
      Re: Proposal to extend PEP 257 (New Documentation String Spec) Chris Angelico <rosuav@gmail.com> - 2011-07-17 09:09 +1000
  Re: Proposal to extend PEP 257 (New Documentation String Spec) George Rodrigues da Cunha Silva <georger.silva@gmail.com> - 2011-07-15 12:44 -0300

csiph-web