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 |