notmuch/lib/notmuch.h, branch 0.3.1

lib: Ensure notmuch_query_search_messages returns NULL on an exception.

2010-04-24T14:27:50Z

Previously, this function may have segfaulted immediately after reporting the exception.

lib: Document that notmuch_query_count_messages may return 0 if an exception occurs

2010-04-24T14:27:50Z

This isn't a behavioral change---just a calrification in the documentation.

lib: Audit all notmuch_database call for Xapian exception handling.

2010-04-24T14:27:50Z

Our current approach is for top-level entry poitns in the library to have try/catch blocks that catch any Xapian exception and print a message. Add a few missing blocks and fix up the documentation.

query.cc: allow to return query results unsorted

2010-04-21T23:06:05Z

Previously, we always sorted the returned results by some string value, (newest-to-oldest by default), however in some cases (as when applying tags to a search result) we are not interested in any special order. This introduces a NOTMUCH_SORT_UNSORTED value that does just that. It is not used at the moment anywhere in the code. Signed-off-by: Sebastian Spaeth

Fix typo in notmuch.h documentation regarding database open modes

2010-04-13T15:39:10Z

Reviewed-by: Carl Worth : The original proposal for having different open modes used the name WRITABLE. I didn't like that name, (easy to misspell as WRITEABLE even for native English speakers). So we renamed it to READ_WRITE immediately, but apparently some of the documentation held the old name for a while.

lib: Handle "*" as a query string to match all messages.

2010-04-10T00:43:58Z

This seems like a generally useful thing to support, (but the previous support through an empty string was not convenient for some users, (such as the command-line client).

Clarify documentation of notmuch_database_add_message.

2010-03-31T20:31:10Z

For the case of adding a file that already exist, (with the same filename). In this case, nothing will happen to the database, but that wasn't clear before.

Fix a few documentation typos in notmuch.h

2010-03-09T18:32:58Z

Fix a few documentation typos in notmuch.h Signed-off-by: Fernando Carrijo

Update documentation of notmuch_query_create

2010-03-09T18:29:38Z

Commit cd467caf renamed notmuch_query_search to notmuch_query_search_messages. Commit 1ba3d46f created notmuch_query_search_threads. We better keep the docs of notmuch_query_create consistent with those changes. Signed-off-by: Fernando Carrijo Edited-by: Carl Worth to explicitly list the full name of each function being referenced.

lib: Document what move_to_next does at the end of the list.

2010-03-09T17:24:45Z

Explicitly mention that there's an invalid position after the last item in the list.