[sympy] Re: docstrings

2008-05-24 Thread Ondrej Certik
On Sat, May 24, 2008 at 2:03 PM, Vinzent Steinberg <[EMAIL PROTECTED]> wrote: > > In sympy different ways to write docstrings are used. Maybe there > shold be a convention (for which a test could be added). > > Different variants: > > This one used in sympy often: > """Docstring. > """ > > I perso

[sympy] Re: docstrings

2008-05-24 Thread Robert Kern
On Sat, May 24, 2008 at 7:21 AM, Ondrej Certik <[EMAIL PROTECTED]> wrote: > For one-liners: > > "Docstring." I hate this whenever I see it. My eyes are trained to see """-quoted strings under defs as docstrings. In any case, one-liners should rarely stay one-liners. Don't give docstring contribut

[sympy] Re: docstrings

2008-05-25 Thread Felix Kaiser
On Saturday 24 May 2008 23:31:12 Robert Kern wrote: > On Sat, May 24, 2008 at 7:21 AM, Ondrej Certik <[EMAIL PROTECTED]> wrote: > > For one-liners: > > > > "Docstring." > > I hate this whenever I see it. My eyes are trained to see """-quoted > strings under defs as docstrings. In any case, one-lin

[sympy] Re: docstrings

2008-05-25 Thread Ondrej Certik
On Sun, May 25, 2008 at 10:02 AM, Felix Kaiser <[EMAIL PROTECTED]> wrote: > > On Saturday 24 May 2008 23:31:12 Robert Kern wrote: >> On Sat, May 24, 2008 at 7:21 AM, Ondrej Certik <[EMAIL PROTECTED]> wrote: >> > For one-liners: >> > >> > "Docstring." >> >> I hate this whenever I see it. My eyes ar

[sympy] Re: docstrings

2008-05-25 Thread Felix Kaiser
On Sunday 25 May 2008 10:44:27 Ondrej Certik wrote: > On Sun, May 25, 2008 at 10:02 AM, Felix Kaiser <[EMAIL PROTECTED]> wrote: > > On Saturday 24 May 2008 23:31:12 Robert Kern wrote: > >> On Sat, May 24, 2008 at 7:21 AM, Ondrej Certik <[EMAIL PROTECTED]> wrote: > >> > For one-liners: > >> > > >>