]> git.notmuchmail.org Git - notmuch/blobdiff - bindings/python/docs/source/index.rst
python: Remove Messages().__len__
[notmuch] / bindings / python / docs / source / index.rst
index c90492c8b674ce99a7683c42c8d1fc4f66881548..d58ba97efb391fff9e7cc8b367bcce0c6720b439 100644 (file)
@@ -99,7 +99,11 @@ More information on specific topics can be found on the following pages:
        Sort by message date, newest first.
 
      SORT.MESSAGE_ID
-       Sort by email message ID
+       Sort by email message ID.
+
+     SORT.UNSORTED
+       Do not apply a special sort order (returns results in document id     
+       order). 
 
    .. automethod:: set_sort
 
@@ -123,7 +127,12 @@ More information on specific topics can be found on the following pages:
 
    .. automethod:: collect_tags
 
-   .. automethod:: __len__
+   .. method:: __len__()
+
+   .. note:: :meth:`__len__` was removed in version 0.6 as it exhausted
+       the iterator and broke list(Messages()). Use the
+       :meth:`Query.count_messages` function or use
+       `len(list(msgs))`.
 
 :class:`Message` -- A single message
 ----------------------------------------
@@ -138,6 +147,8 @@ More information on specific topics can be found on the following pages:
 
    .. automethod:: get_filename
 
+   .. automethod:: get_filenames
+
    .. attribute:: FLAG
 
         FLAG.MATCH