[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [ff-cvs] fenfire/org/fenfire fenpdf/importpdf.py swamp/G...
From: |
Tuomas Lukka |
Subject: |
Re: [ff-cvs] fenfire/org/fenfire fenpdf/importpdf.py swamp/G... |
Date: |
Sat, 6 Sep 2003 20:43:13 +0300 |
User-agent: |
Mutt/1.5.4i |
On Sat, Sep 06, 2003 at 05:47:52PM +0300, Benja Fallenstein wrote:
> Tuomas Lukka wrote:
> >On Sat, Sep 06, 2003 at 04:07:12PM +0300, Benja Fallenstein wrote:
> >
> >>Tuomas J. Lukka wrote:
> >>
> >>>+ def w(s):
> >>>+ """Add a string to the output.
> >>>+ """
> >>
> >>Why newline before """?
> >
> >
> >Python convention: easier to add more text later. It's in some PEP, I
> >think.
>
> Not in PEP 257, at least:
>
> http://www.python.org/peps/pep-0257.html#one-line-docstrings
>
> One-liners are for really obvious cases. They should really fit on
> one line. For example::
>
> def kos_root():
> """Return the pathname of the KOS root directory."""
> global _kos_root
> if _kos_root: return _kos_root
Hmm, couldn't find it anywhere.
I prefer the extra newline but no "official" reason, then.
Tuomas