2c/b612ba6f115b685c35a2e0dec24311ad0b187e

   1 Return-Path: <patricktotzke@googlemail.com>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id 69BA6429E25\r
   6         for <notmuch@notmuchmail.org>; Mon,  5 Dec 2011 14:36:13 -0800 (PST)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.799\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.799 tagged_above=-999 required=5\r
  12         tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
  13         FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
  14 Received: from olra.theworths.org ([127.0.0.1])\r
  15         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  16         with ESMTP id iX4HOmQjQFVd for <notmuch@notmuchmail.org>;\r
  17         Mon,  5 Dec 2011 14:36:12 -0800 (PST)\r
  18 Received: from mail-ee0-f53.google.com (mail-ee0-f53.google.com\r
  19  [74.125.83.53])        (using TLSv1 with cipher RC4-SHA (128/128 bits))        (No client\r
  20  certificate requested) by olra.theworths.org (Postfix) with ESMTPS id\r
  21  B9837431FB6    for <notmuch@notmuchmail.org>; Mon,  5 Dec 2011 14:36:11 -0800\r
  22  (PST)\r
  23 Received: by eekb57 with SMTP id b57so1139093eek.26\r
  24         for <notmuch@notmuchmail.org>; Mon, 05 Dec 2011 14:36:10 -0800 (PST)\r
  25 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
  26         d=googlemail.com; s=gamma;\r
  27         h=message-id:content-type:mime-version:content-transfer-encoding:to\r
  28         :from:subject:date;\r
  29         bh=I7+j0Zv6DOPfC59TdiqbqAKMN+83rWfz0yI22MQJvaM=;\r
  30         b=x1NDwu+U7yZ6B4vZLNE+Xal2x6kq9d2M3ZeMDdOhbeURA6KhSzSQH0D41EFps7VcNg\r
  31         dwj25l1mE3EIRrPp3SNfysxo3t+4L1xr6mRXSuLUaU2HEKLqYMZ0kp5h/IxIfSCE7u14\r
  32         aa6/gzaZz6AmMmvh3vTIJJ8Kw14ry/6GlNOIc=\r
  33 Received: by 10.14.11.23 with SMTP id 23mr1497962eew.242.1323124570510;\r
  34         Mon, 05 Dec 2011 14:36:10 -0800 (PST)\r
  35 Received: from localhost (cpc1-sgyl2-0-0-cust548.18-2.cable.virginmedia.com.\r
  36         [82.41.10.37])\r
  37         by mx.google.com with ESMTPS id z54sm63921659eeh.5.2011.12.05.14.36.08\r
  38         (version=TLSv1/SSLv3 cipher=OTHER);\r
  39         Mon, 05 Dec 2011 14:36:09 -0800 (PST)\r
  40 Message-ID: <4edd4759.ce7d0e0a.38e2.79bb@mx.google.com>\r
  41 Content-Type: text/plain; charset="utf-8"\r
  42 MIME-Version: 1.0\r
  43 Content-Transfer-Encoding: quoted-printable\r
  44 To: notmuch@notmuchmail.org\r
  45 From: Patrick Totzke <patricktotzke@googlemail.com>\r
  46 Subject: [python] documentation & TODO list\r
  47 Date: Mon, 05 Dec 2011 22:36:06 +0000\r
  48 X-BeenThere: notmuch@notmuchmail.org\r
  49 X-Mailman-Version: 2.1.13\r
  50 Precedence: list\r
  51 List-Id: "Use and development of the notmuch mail system."\r
  52         <notmuch.notmuchmail.org>\r
  53 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  54         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  55 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  56 List-Post: <mailto:notmuch@notmuchmail.org>\r
  57 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  58 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  59         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  60 X-List-Received-Date: Mon, 05 Dec 2011 22:36:13 -0000\r
  61 \r
  62 \r
  63 Hi!\r
  64 \r
  65 This is mainly directed towards Sebastian, but a broader audience can't hur=\r
  66 t.\r
  67 \r
  68 These are the things I noticed when going through the code today:\r
  69 1) in filenames.py,  __str__ of Filenames: should the return value be\r
  70    '\n'.join(self._files)? alternatively, define __iter__ to make this obje=\r
  71 ct\r
  72    behave as iterator.\r
  73 2) in message.py:  tags_to_maildir_flags and maildir_flags_to_tags never re=\r
  74 turn a\r
  75    :class:`STATUS` as advertised.\r
  76 3) unicode stuff alredy patched..\r
  77 \r
  78 I would like to see up-to-date API docs online, even if only the\r
  79 version string changed.\r
  80 Sebastian suggested using readthedocs.org for building and hosting APIdocs.\r
  81 I tested this recently for alot and it looks quite promising.\r
  82 A simple http get and their build-host checks out the new sources from git =\r
  83 and builds\r
  84 them. This could be easily integrated into notmuch the release process.\r
  85 Comments on this?\r
  86 \r
  87 Lastly, does anyone have an opinion on how to share a TODO list/issue track=\r
  88 er\r
  89 for the bindings? I'm OK with github, we could move all this to the list\r
  90 and use David's nmbug..\r
  91 \r
  92 Cheers,\r
  93 /Patrick\r
  94 \r