Re: [ff-cvs] fenfire/org/fenfire fenpdf/importpdf.py swamp/G...

[Benja Fallenstein]

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
            ...

- Benja