debian/notmuch
1
0
Fork 0
mirror of https://git.notmuchmail.org/git/notmuch synced 2024-11-22 02:48:08 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

fix sphinx compile-time warnings

Browse source 
no changes to the code, only makes compiling the docs smoother
as some rsT syntax errors were fixed
This commit is contained in:
Patrick Totzke 2011-12-05 21:12:35 +00:00 committed by Sebastian Spaeth
parent 4292b1197d
commit 12ebf87947
4 changed files with 67 additions and 53 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
bindings/python/docs/source/index.rst
View file

@ -138,10 +138,10 @@ More information on specific topics can be found on the following pages:
.. method:: __len__()
.. warning:: :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))`.
.. warning::
: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
----------------------------------------
@ -205,10 +205,11 @@ More information on specific topics can be found on the following pages:
.. method:: __len__
.. warning:: :meth:`__len__` was removed in version 0.6 as it
exhausted the iterator and broke list(Tags()). Use
:meth:`len(list(msgs))` instead if you need to know the
number of tags.
.. warning::
:meth:`__len__` was removed in version 0.6 as it exhausted the iterator and broke
list(Tags()). Use :meth:`len(list(msgs))` instead if you need to know the number of
tags.
.. automethod:: __str__

53
bindings/python/notmuch/database.py
View file

@ -40,16 +40,19 @@ class Database(object):
:exc:`XapianError` as the underlying database has been
modified. Close and reopen the database to continue working with it.
.. note:: Any function in this class can and will throw an
:exc:`NotInitializedError` if the database was not
intitialized properly.
.. note::
.. note:: Do remember that as soon as we tear down (e.g. via `del
db`) this object, all underlying derived objects such as
queries, threads, messages, tags etc will be freed by the
underlying library as well. Accessing these objects will lead
to segfaults and other unexpected behavior. See above for
more details.
Any function in this class can and will throw an
:exc:`NotInitializedError` if the database was not intitialized
properly.
.. note::
Do remember that as soon as we tear down (e.g. via `del db`) this
object, all underlying derived objects such as queries, threads,
messages, tags etc will be freed by the underlying library as well.
Accessing these objects will lead to segfaults and other unexpected
behavior. See above for more details.
"""
_std_db_path = None
"""Class attribute to cache user's default database"""
@ -253,9 +256,7 @@ class Database(object):
neither begin nor end necessarily flush modifications to disk.
:returns: :attr:`STATUS`.SUCCESS or raises
:exception: :exc:`NotmuchError`:
:attr:`STATUS`.XAPIAN_EXCEPTION
:exception: :exc:`NotmuchError`: :attr:`STATUS`.XAPIAN_EXCEPTION
Xapian exception occurred; atomic section not entered.
*Added in notmuch 0.9*"""
@ -295,7 +296,9 @@ class Database(object):
"""Returns a :class:`Directory` of path,
(creating it if it does not exist(?))
.. warning:: This call needs a writeable database in
.. warning::
This call needs a writeable database in
:attr:`Database.MODE`.READ_WRITE mode. The underlying library will
exit the program if this method is used on a read-only database!
@ -459,10 +462,11 @@ class Database(object):
def find_message_by_filename(self, filename):
"""Find a message with the given filename
.. warning:: This call needs a writeable database in
.. warning::
This call needs a writeable database in
:attr:`Database.MODE`.READ_WRITE mode. The underlying library will
exit the program if this method is used on a read-only
database!
exit the program if this method is used on a read-only database!
:returns: If the database contains a message with the given
filename, then a class:`Message:` is returned. This
@ -791,10 +795,12 @@ class Directory(object):
and know that it only needs to add files if the mtime of the
directory and files are newer than the stored timestamp.
.. note:: :meth:`get_mtime` function does not allow the caller
to distinguish a timestamp of 0 from a non-existent
timestamp. So don't store a timestamp of 0 unless you are
comfortable with that.
.. note::
:meth:`get_mtime` function does not allow the caller to
distinguish a timestamp of 0 from a non-existent timestamp. So
don't store a timestamp of 0 unless you are comfortable with
that.
:param mtime: A (time_t) timestamp
:returns: Nothing on success, raising an exception on failure.
@ -928,13 +934,16 @@ class Filenames(object):
def __len__(self):
"""len(:class:`Filenames`) returns the number of contained files
.. note:: As this iterates over the files, we will not be able to
.. note::
As this iterates over the files, we will not be able to
iterate over them again! So this will fail::
#THIS FAILS
files = Database().get_directory('').get_child_files()
if len(files) > 0: # this 'exhausts' msgs
# next line raises NotmuchError(:attr:`STATUS`.NOT_INITIALIZED)!!!
# next line raises
# NotmuchError(:attr:`STATUS`.NOT_INITIALIZED)
for file in files: print file
"""
if self._files_p is None:

25
bindings/python/notmuch/message.py
View file

@ -128,10 +128,12 @@ class Messages(object):
"""Return the unique :class:`Tags` in the contained messages
:returns: :class:`Tags`
:exceptions: :exc:`NotmuchError` STATUS.NOT_INITIALIZED if not inited
:exceptions: :exc:`NotmuchError` STATUS.NOT_INITIALIZED if not init'ed
.. note:: :meth:`collect_tags` will iterate over the messages and
therefore will not allow further iterations.
.. note::
:meth:`collect_tags` will iterate over the messages and therefore
will not allow further iterations.
"""
if self._msgs is None:
raise NotmuchError(STATUS.NOT_INITIALIZED)
@ -359,14 +361,15 @@ class Message(object):
"""Gets all direct replies to this message as :class:`Messages`
iterator
.. note:: This call only makes sense if 'message' was
ultimately obtained from a :class:`Thread` object, (such as
by coming directly from the result of calling
:meth:`Thread.get_toplevel_messages` or by any number of
subsequent calls to :meth:`get_replies`). If this message was
obtained through some non-thread means, (such as by a call
to :meth:`Query.search_messages`), then this function will
return `None`.
.. note::
This call only makes sense if 'message' was ultimately obtained from
a :class:`Thread` object, (such as by coming directly from the
result of calling :meth:`Thread.get_toplevel_messages` or by any
number of subsequent calls to :meth:`get_replies`). If this message
was obtained through some non-thread means, (such as by a call to
:meth:`Query.search_messages`), then this function will return
`None`.
:returns: :class:`Messages` or `None` if there are no replies to
this message.

11
bindings/python/notmuch/tag.py
View file

@ -113,11 +113,12 @@ class Tags(object):
def __str__(self):
"""The str() representation of Tags() is a space separated list of tags
.. note:: As this iterates over the tags, we will not be able
to iterate over them again (as in retrieve them)! If
the tags have been exhausted already, this will raise a
:exc:`NotmuchError` STATUS.NOT_INITIALIZED on
subsequent attempts.
.. note::
As this iterates over the tags, we will not be able to iterate over
them again (as in retrieve them)! If the tags have been exhausted
already, this will raise a :exc:`NotmuchError`
STATUS.NOT_INITIALIZED on subsequent attempts.
"""
return " ".join(self)