X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=docs%2Fsource%2Findex.rst;h=4a6c574bdc85a8e1952be76f29b16d8fc8f7b5b2;hp=6d0d5fa3f99165dbb1efb7ecc32b69215e38694d;hb=9058e3d1b55ed35cda2df6426578435934af19de;hpb=144953116e8e95e6cdc3b0fe69ddd16e7a3f1d01 diff --git a/docs/source/index.rst b/docs/source/index.rst index 6d0d5fa3..4a6c574b 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -7,13 +7,13 @@ Welcome to :mod:`cnotmuch`'s documentation =========================================== The :mod:`cnotmuch` module provides an interface to the `notmuch `_ functionality, directly interfacing to a shared notmuch library. -The classes :class:`notmuch.Database`, :class:`notmuch.Query` provide most of the core functionality, returning :class:`notmuch.Messages` and :class:`notmuch.Tags`. +The classes :class:`notmuch.Database`, :class:`notmuch.Query` provide most of the core functionality, returning :class:`notmuch.Threads`, :class:`notmuch.Messages` and :class:`notmuch.Tags`. .. moduleauthor:: Sebastian Spaeth :License: This module is covered under the GNU GPL v3 (or later). -This page contains the main API overview. More information on specific topics can be found on the following pages: (none here yet) +This page contains the main API overview of cnotmuch |release|. Notmuch can be imported as:: @@ -23,9 +23,12 @@ or:: from cnotmuch.notmuch import Query,Database +More information on specific topics can be found on the following pages: + .. toctree:: :maxdepth: 1 + notmuch :mod:`notmuch` -- The Notmuch interface ============================================= @@ -61,6 +64,10 @@ or:: .. automethod:: get_all_tags + .. automethod:: create_query + + .. note:: :meth:`create_query` was broken in release + 0.1 and is fixed since 0.1.1. .. attribute:: Database.MODE @@ -96,12 +103,21 @@ or:: .. automethod:: set_sort + .. attribute:: sort + + Instance attribute :attr:`sort` contains the sort order (see + :attr:`Query.SORT`) if explicitely specified via + :meth:`set_sort`. By default it is set to `None`. + .. automethod:: search_threads .. automethod:: search_messages .. automethod:: count_messages +.. ############################################# +.. currentmodule:: cnotmuch.message + :class:`Messages` -- A bunch of messages ---------------------------------------- @@ -148,6 +164,9 @@ or:: .. automethod:: __str__ +.. ############################################# +.. currentmodule:: cnotmuch.tag + :class:`Tags` -- Notmuch tags ----------------------------- @@ -158,15 +177,46 @@ or:: .. automethod:: __str__ + +.. ############################################# +.. currentmodule:: cnotmuch.thread + :class:`Threads` -- Threads iterator ------------------------------------ -To be implemented +.. autoclass:: Threads + + .. automethod:: __len__ + + .. automethod:: __str__ :class:`Thread` -- A single thread ------------------------------------ -To be implemented +.. autoclass:: Thread + + .. automethod:: get_thread_id + + .. automethod:: get_total_messages + + .. automethod:: get_toplevel_messages + + .. automethod:: get_matched_messages + + .. automethod:: get_authors + + .. automethod:: get_subject + + .. automethod:: get_oldest_date + + .. automethod:: get_newest_date + + .. automethod:: get_tags + + .. automethod:: __str__ + +.. ############################################# +.. currentmodule:: cnotmuch.notmuch :class:`Filenames` -- An iterator over filenames ------------------------------------------------