[PATCH 6/9] python: Update Database.get_directory documentation

diff --git a/dc/f2ada11fad2924eff956cc92c987df06dd92ac b/dc/f2ada11fad2924eff956cc92c987df06dd92ac
new file mode 100644 (file)
index 0000000..a15a465
--- /dev/null
+++ b/dc/f2ada11fad2924eff956cc92c987df06dd92ac
@@ -0,0 +1,103 @@
+Return-Path: <amdragon@mit.edu>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id B0DA7431FC2\r
+       for <notmuch@notmuchmail.org>; Thu, 17 May 2012 21:13:54 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.7\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
+       tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id o1EvSH-N1yBr for <notmuch@notmuchmail.org>;\r
+       Thu, 17 May 2012 21:13:53 -0700 (PDT)\r
+Received: from dmz-mailsec-scanner-3.mit.edu (DMZ-MAILSEC-SCANNER-3.MIT.EDU\r
+       [18.9.25.14])\r
+       by olra.theworths.org (Postfix) with ESMTP id D7F69431FAE\r
+       for <notmuch@notmuchmail.org>; Thu, 17 May 2012 21:13:52 -0700 (PDT)\r
+X-AuditID: 1209190e-b7fd86d0000008b4-3b-4fb5cc8000ce\r
+Received: from mailhub-auth-4.mit.edu ( [18.7.62.39])\r
+       by dmz-mailsec-scanner-3.mit.edu (Symantec Messaging Gateway) with SMTP\r
+       id 2D.37.02228.08CC5BF4; Fri, 18 May 2012 00:13:52 -0400 (EDT)\r
+Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
+       by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id q4I4Dq1x009479; \r
+       Fri, 18 May 2012 00:13:52 -0400\r
+Received: from drake.mit.edu\r
+       (209-6-116-242.c3-0.arl-ubr1.sbo-arl.ma.cable.rcn.com\r
+       [209.6.116.242]) (authenticated bits=0)\r
+       (User authenticated as amdragon@ATHENA.MIT.EDU)\r
+       by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id q4I4DomE026789\r
+       (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
+       Fri, 18 May 2012 00:13:51 -0400 (EDT)\r
+Received: from amthrax by drake.mit.edu with local (Exim 4.77)\r
+       (envelope-from <amdragon@mit.edu>)\r
+       id 1SVEZa-0000zC-Q0; Fri, 18 May 2012 00:13:50 -0400\r
+From: Austin Clements <amdragon@MIT.EDU>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH 6/9] python: Update Database.get_directory documentation\r
+Date: Fri, 18 May 2012 00:13:39 -0400\r
+Message-Id: <1337314423-3702-7-git-send-email-amdragon@mit.edu>\r
+X-Mailer: git-send-email 1.7.10\r
+In-Reply-To: <1337314423-3702-1-git-send-email-amdragon@mit.edu>\r
+References: <1337314423-3702-1-git-send-email-amdragon@mit.edu>\r
+X-Brightmail-Tracker:\r
+ H4sIAAAAAAAAA+NgFtrEIsWRmVeSWpSXmKPExsUixG6nrttwZqu/wY41QhbXb85kdmD0eLbq\r
+       FnMAYxSXTUpqTmZZapG+XQJXxp/OXWwFTzkrHl/4xdTAuJe9i5GTQ0LARKL1yxEoW0ziwr31\r
+       bF2MXBxCAvsYJXrm97NDOBsYJRpPbGKBcO4zSbz8dJ0VwpnFKPH+7WQ2kH42AQ2JbfuXM4LY\r
+       IgLSEjvvzgYq4uBgFlCT+NOlAhIWFvCQOHv2FiuIzSKgKvFj0z5mEJtXwF5iw5k7rBBnyEs8\r
+       vd/HBtLKKeAgMe14NEhYCKjk34VmlgmM/AsYGVYxyqbkVunmJmbmFKcm6xYnJ+blpRbpGuvl\r
+       ZpbopaaUbmIEBQ2nJN8Oxq8HlQ4xCnAwKvHw7piz1V+INbGsuDL3EKMkB5OSKO/3k0AhvqT8\r
+       lMqMxOKM+KLSnNTiQ4wSHMxKIryy3UA53pTEyqrUonyYlDQHi5I4r5rWOz8hgfTEktTs1NSC\r
+       1CKYrAwHh5IE76bTQI2CRanpqRVpmTklCGkmDk6Q4TxAwzNBaniLCxJzizPTIfKnGBWlxHl3\r
+       gyQEQBIZpXlwvbCofsUoDvSKMO8EkCoeYEKA634FNJgJaHBZ7iaQwSWJCCmpBkbf+Tnfv/GL\r
+       v9ywR4jF5bi7RM6kv5oqr9SruZTsZlv+0d8+52LwxEnrZV91X3aoZlDbWHUva1+Y8sVer4DO\r
+       JNeYybVvjheH2bP7tJfsVXS8MDemQ2odZxv/+V9t15POdquo/3TkNtl36Pb1vl4J/4f9Qe9T\r
+       b36buOfbdDvGHOmurynv4/8qyiqxFGckGmoxFxUnAgCCp9eLxQIAAA==\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Fri, 18 May 2012 04:13:55 -0000\r
+\r
+notmuch_database_get_directory no longer returns an error for\r
+read-only databases, so remove ReadOnlyDatabaseError from the list of\r
+get_directory exceptions.\r
+---\r
+ bindings/python/notmuch/database.py |    3 ---\r
+ 1 file changed, 3 deletions(-)\r
+\r
+diff --git a/bindings/python/notmuch/database.py b/bindings/python/notmuch/database.py\r
+index 797554d..ff89818 100644\r
+--- a/bindings/python/notmuch/database.py\r
++++ b/bindings/python/notmuch/database.py\r
+@@ -346,7 +346,6 @@ class Database(object):\r
+ \r
+     def get_directory(self, path):\r
+         """Returns a :class:`Directory` of path,\r
+-        (creating it if it does not exist(?))\r
+ \r
+         :param path: An unicode string containing the path relative to the path\r
+               of database (see :meth:`get_path`), or else should be an absolute\r
+@@ -354,8 +353,6 @@ class Database(object):\r
+         :returns: :class:`Directory` or raises an exception.\r
+         :raises: :exc:`FileError` if path is not relative database or absolute\r
+                  with initial components same as database.\r
+-        :raises: :exc:`ReadOnlyDatabaseError` if the database has not been\r
+-                 opened in read-write mode\r
+         """\r
+         self._assert_db_is_initialized()\r
+ \r
+-- \r
+1.7.10\r
+\r