| 1 |
On Sun, Jan 19, 2014 at 02:46:36PM -0800, Alec Warner wrote: |
| 2 |
> On Sun, Jan 19, 2014 at 2:45 PM, Alexander Berntsen <alexander@××××××.net>wrote: |
| 3 |
> > On 19/01/14 22:22, Sebastian Luther wrote: |
| 4 |
> > > The usual doc string style used in portage is: |
| 5 |
> > > |
| 6 |
> > > """ text """ |
| 7 |
> > > |
| 8 |
> > > Please use that for new functions. Also make sure you don't use |
| 9 |
> > > spaces to indent the last """. |
| 10 |
> > |
| 11 |
> > As mentioned by Mike in another thread, we should use PEP 257[0]. I |
| 12 |
> > will convert old code to conform to this... sometime... soon... (I |
| 13 |
> > promise!) |
| 14 |
> > |
| 15 |
> > So if new patches could just do that right away, that would be neat. |
| 16 |
> |
| 17 |
> Does pylint or pyflakes point out if you mess it up? |
| 18 |
> |
| 19 |
> Automation for the win. |
| 20 |
|
| 21 |
As of Emacs 24.3.1, fill-paragraph (M-q) in python-mode will |
| 22 |
automatically format your docstring like this (which is how the |
| 23 |
space-indented-""" snuck into my v1 ;). Not as nice as an independent |
| 24 |
checker, but still useful automation. |
| 25 |
|
| 26 |
Cheers, |
| 27 |
Trevor |
| 28 |
|
| 29 |
-- |
| 30 |
This email may be signed or encrypted with GnuPG (http://www.gnupg.org). |
| 31 |
For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy |
Archives