Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > comp.lang.python > #39729

Re: Should Docstrings include RFC citations? - And are non PEP257 syntaxes frowned upon?

From Terry Reedy <tjreedy@udel.edu>
Subject Re: Should Docstrings include RFC citations? - And are non PEP257 syntaxes frowned upon?
Date 2013-02-23 21:51 -0500
References <CAO+9iGcYXo2bZr-vGUwd_Nouj6287efpu_OGQ9cq32MY0Z4FXg@mail.gmail.com>
Newsgroups comp.lang.python
Message-ID <mailman.2392.1361674308.2939.python-list@python.org> (permalink)

Show all headers | View raw


On 2/23/2013 1:14 PM, Alec Taylor wrote:
> PEP257 defines docstring syntax,

It suggest a docstring format, which is not religiously followed even in 
the stdlib. It explicitly disclaims being 'the law'. Do what works for you.


-- 
Terry Jan Reedy

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


Thread

Re: Should Docstrings include RFC citations? - And are non PEP257 syntaxes frowned upon? Terry Reedy <tjreedy@udel.edu> - 2013-02-23 21:51 -0500

csiph-web