<feed xmlns='http://www.w3.org/2005/Atom'>
<title>notmuch/bindings/ruby, branch 0.28.4</title>
<subtitle>thread-based email index, search, and tagging</subtitle>
<id>https://git.notmuchmail.org/git/notmuch/atom?h=0.28.4</id>
<link rel='self' href='https://git.notmuchmail.org/git/notmuch/atom?h=0.28.4'/>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/'/>
<updated>2017-08-23T10:38:37Z</updated>
<entry>
<title>database: add n_d_index_file (deprecates n_d_add_message)</title>
<updated>2017-08-23T10:38:37Z</updated>
<author>
<name>Daniel Kahn Gillmor</name>
<email>dkg@fifthhorseman.net</email>
</author>
<published>2017-08-17T23:14:25Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=b10ce6bc23002d48916b1b2f375480e7540e3164'/>
<id>urn:sha1:b10ce6bc23002d48916b1b2f375480e7540e3164</id>
<content type='text'>
We need a way to pass parameters to the indexing functionality on the
first index, not just on reindexing.  The obvious place is in
notmuch_database_add_message.  But since modifying the argument list
would break both API and ABI, we needed a new name.

I considered notmuch_database_add_message_with_params(), but the
functionality we're talking about doesn't always add a message.  It
tries to index a specific file, possibly adding a message, but
possibly doing other things, like adding terms to an existing message,
or failing to deal with message objects entirely (e.g. because the
file didn't contain a message).

So i chose the function name notmuch_database_index_file.

I confess i'm a little concerned about confusing future notmuch
developers with the new name, since we already have a private
_notmuch_message_index_file function, and the two do rather different
things.  But i think the added clarity for people linking against the
future libnotmuch and the capacity for using index parameters makes
this a worthwhile tradeoff.  (that said, if anyone has another name
that they strongly prefer, i'd be happy to go with it)

This changeset also adjusts the tests so that we test whether the new,
preferred function returns bad values (since the deprecated function
just calls the new one).

We can keep the deprecated n_d_add_message function around as long as
we like, but at the next place where we're forced to break API or ABI
we can probably choose to drop the name relatively safely.

NOTE: there is probably more cleanup to do in the ruby and go bindings
to complete the deprecation directly.  I don't know those languages
well enough to attempt a fix; i don't know how to test them; and i
don't know the culture around those languages about API additions or
deprecations.
</content>
</entry>
<entry>
<title>Use rooted paths in .gitignore files</title>
<updated>2017-08-18T22:42:35Z</updated>
<author>
<name>Vladimir Panteleev</name>
<email>notmuch@thecybershadow.net</email>
</author>
<published>2017-08-17T00:41:10Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=ca4688e103c644fa383108a79668e8e0b4dbe262'/>
<id>urn:sha1:ca4688e103c644fa383108a79668e8e0b4dbe262</id>
<content type='text'>
A leading / in paths in a .gitignore file matches the beginning of the
path, meaning that for patterns without slashes, git will match files
only in the current directory as opposed to in any subdirectory.

Prefix relevant paths with / in .gitignore files, to prevent
accidentally ignoring files in subdirectories and possibly slightly
improve the performance of "git status".
</content>
</entry>
<entry>
<title>lib: replace deprecated n_q_count_threads with status returning version</title>
<updated>2017-03-22T11:35:07Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2017-02-26T21:21:35Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=3721bd45d72e50436ee760b03ae533d49bbb8724'/>
<id>urn:sha1:3721bd45d72e50436ee760b03ae533d49bbb8724</id>
<content type='text'>
This function was deprecated in notmuch 0.21.  We re-use the name for
a status returning version, and deprecate the _st name.
</content>
</entry>
<entry>
<title>lib: replace deprecated n_q_count_messages with status returning version</title>
<updated>2017-03-22T11:35:07Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2017-02-26T21:21:34Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=5ce8e0b11b40f733e6231d2067764e76717a341a'/>
<id>urn:sha1:5ce8e0b11b40f733e6231d2067764e76717a341a</id>
<content type='text'>
This function was deprecated in notmuch 0.21.  We re-use the name for
a status returning version, and deprecate the _st name. One or two
remaining uses of the (removed) non-status returning version fixed at
the same time
</content>
</entry>
<entry>
<title>lib: replace deprecated n_q_search_messages with status returning version</title>
<updated>2017-03-22T11:35:07Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2017-02-26T21:21:32Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=86cbd215eb67d7b996c977352a50e70c101cb641'/>
<id>urn:sha1:86cbd215eb67d7b996c977352a50e70c101cb641</id>
<content type='text'>
This function was deprecated in notmuch 0.21.  We re-use the name for
a status returning version, and deprecate the _st name.
</content>
</entry>
<entry>
<title>lib: replace n_query_search_threads with status returning version</title>
<updated>2017-03-22T11:28:09Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2017-02-26T21:21:31Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=1e982de508c39dae7a61403f536df74c180dfb72'/>
<id>urn:sha1:1e982de508c39dae7a61403f536df74c180dfb72</id>
<content type='text'>
This function was deprecated in notmuch 0.21. We finally remove the
deprecated API, and rename the status returning version to the simpler
name. The status returning is kept as a deprecated alias.
</content>
</entry>
<entry>
<title>fix out of tree build</title>
<updated>2017-03-12T12:17:29Z</updated>
<author>
<name>Tomi Ollila</name>
<email>tomi.ollila@iki.fi</email>
</author>
<published>2017-03-12T11:59:13Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=35cdebdad0d41be58a4c705ec48fd1bb51f098eb'/>
<id>urn:sha1:35cdebdad0d41be58a4c705ec48fd1bb51f098eb</id>
<content type='text'>
In addition to use ${srcdir} and deliver ${NOTMUCH_SRCDIR} where needed,
source from ruby bindings had to be copied to the out-of-tree target
directory -- if the source files in source directory were referenced
in build and there were also built object files there, those could have
been considered as target files (and then not found when attempting
to create bindings/ruby/notmuch.so).
</content>
</entry>
<entry>
<title>Use https instead of http where possible</title>
<updated>2016-06-05T11:32:17Z</updated>
<author>
<name>Daniel Kahn Gillmor</name>
<email>dkg@fifthhorseman.net</email>
</author>
<published>2016-06-02T16:26:14Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=6a833a6e83865f6999707cc30768d07e1351c2cb'/>
<id>urn:sha1:6a833a6e83865f6999707cc30768d07e1351c2cb</id>
<content type='text'>
Many of the external links found in the notmuch source can be resolved
using https instead of http.  This changeset addresses as many as i
could find, without touching the e-mail corpus or expected outputs
found in tests.
</content>
</entry>
<entry>
<title>ruby: add bindings for `notmuch_database_get_all_tags`</title>
<updated>2016-05-19T11:02:43Z</updated>
<author>
<name>Ludovic LANGE</name>
<email>ll-notmuchmail@lange.nom.fr</email>
</author>
<published>2016-03-06T11:56:28Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=7e6e23c36e290d4b22b0449766a6ef2107f1ef6c'/>
<id>urn:sha1:7e6e23c36e290d4b22b0449766a6ef2107f1ef6c</id>
<content type='text'>
The Ruby bindings were missing a way to get all the tags of the
database. Now you should be able to access this with the public
instance method `all_tags` of your database object.

Example of use:
    notmuchdb = Notmuch::Database.new path, { :create =&gt; false,
    	:mode =&gt; Notmuch::MODE_READ_ONLY }

    my_tags = notmuchdb.all_tags

    my_tags.each { |tag|
      print tag
    }

    my_tags.destroy!

Amended by db: improve error reporting, add test
</content>
</entry>
<entry>
<title>ruby: use new query_search API</title>
<updated>2015-10-05T22:54:12Z</updated>
<author>
<name>David Bremner</name>
<email>david@tethera.net</email>
</author>
<published>2015-09-27T15:32:03Z</published>
<link rel='alternate' type='text/html' href='https://git.notmuchmail.org/git/notmuch/commit/?id=e8a828b30d099b929d2feab0154e98d06786e92e'/>
<id>urn:sha1:e8a828b30d099b929d2feab0154e98d06786e92e</id>
<content type='text'>
These changes should not be too surprising for users because the
routines were already potentially throwing exceptions.
</content>
</entry>
</feed>
