Message-ID: <4edd4759.ce7d0e0a.38e2.79bb@mx.google.com>
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
To: notmuch@notmuchmail.org
From: Patrick Totzke <patricktotzke@googlemail.com>
Subject: [python] documentation & TODO list
Date: Mon, 05 Dec 2011 22:36:06 +0000
Precedence: list


Hi!

This is mainly directed towards Sebastian, but a broader audience can't hur=
t.

These are the things I noticed when going through the code today:
1) in filenames.py,  __str__ of Filenames: should the return value be
   '\n'.join(self._files)? alternatively, define __iter__ to make this obje=
ct
   behave as iterator.
2) in message.py:  tags_to_maildir_flags and maildir_flags_to_tags never re=
turn a
   :class:`STATUS` as advertised.
3) unicode stuff alredy patched..

I would like to see up-to-date API docs online, even if only the
version string changed.
Sebastian suggested using readthedocs.org for building and hosting APIdocs.
I tested this recently for alot and it looks quite promising.
A simple http get and their build-host checks out the new sources from git =
and builds
them. This could be easily integrated into notmuch the release process.
Comments on this?

Lastly, does anyone have an opinion on how to share a TODO list/issue track=
er
for the bindings? I'm OK with github, we could move all this to the list
and use David's nmbug..

Cheers,
/Patrick