Features currently marked for deprecation

Note

We have a separate list of all features that have been fully deprecated, with the version they were removed.

Native C++ API

Deprecated Remove Feature name Upgrade suggestion and comments
1.3.1 1.5.0 Xapian::ErrorHandler We feel the current ErrorHandler API doesn’t work at the right level (it only works in Enquire, whereas you should be able to handle errors at the Database level too) and we can’t find any evidence that people are actually using it. So we’ve made the API a no-op and marked it as deprecated. The hope is to replace it with something better thought out, probably during the 1.4.x release series. There’s some further thoughts at https://trac.xapian.org/ticket/3#comment:8
1.3.2 1.5.0 Xapian::Auto::open_stub() Use the constructor with Xapian::DB_BACKEND_STUB flag (new in 1.3.2) instead.
1.3.2 1.5.0 Xapian::Chert::open() Use the constructor with Xapian::DB_BACKEND_CHERT flag (new in 1.3.2) instead.
1.3.3 1.5.0 Xapian::QueryParser::set_max_wildcard_expansion() Use Xapian::QueryParser::set_max_expansion() instead.
1.3.4 1.5.0 Xapian::Compactor methods set_block_size(), set_renumber(), set_multipass(), set_compaction_level(), set_destdir(), add_source()` and ``compact(). Use the Xapian::Database::compact() method instead. The Xapian::Compact is now just a subclassable functor class to allow access to progress messages and control over merging of user metadata.
1.3.5 1.5.0 Xapian::PostingSource public variables Use the respective getter and setter methods instead, added in 1.3.5 and 1.2.23.
1.3.5 1.5.0 Xapian::InMemory::open() Use the constructor with Xapian::DB_BACKEND_INMEMORY flag (new in 1.3.5) instead.
1.3.6 1.5.0 Xapian::WritableDatabase::flush() Use Xapian::WritableDatabase::commit() instead (available since 1.1.0).
1.3.6 1.5.0 Subclassing Xapian::ValueRangeProcessor Subclass Xapian::RangeProcessor instead, and return a Xapian::Query from operator()().
1.3.6 1.5.0 Subclassing Xapian::DateValueRangeProcessor Subclass Xapian::DateRangeProcessor instead, and return a Xapian::Query from operator()().
1.3.6 1.5.0 Subclassing Xapian::NumberValueRangeProcessor Subclass Xapian::NumberRangeProcessor instead, and return a Xapian::Query from operator()().
1.3.6 1.5.0 Subclassing Xapian::StringValueRangeProcessor Subclass Xapian::RangeProcessor instead (which includes equivalent support for prefix/suffix checking), and return a Xapian::Query from operator()().
1.3.6 1.5.0 Xapian::QueryParser::add_valuerangeprocessor() Use Xapian::QueryParser::add_rangeprocessor() instead, with a Xapian::RangeProcessor object instead of a Xapian::ValueRangeProcessor object.

Bindings

Deprecated Remove Language Feature name Upgrade suggestion and comments
1.2.5 1.5.0 Python MSet.items Iterate the MSet object itself instead.
1.2.5 1.5.0 Python ESet.items Iterate the ESet object itself instead.

Omega

Deprecated Remove Feature name Upgrade suggestion and comments
1.2.4 1.5.0 omindex command line long option --preserve-nonduplicates. Renamed to --no-delete, which works in 1.2.4 and later.
1.2.5 1.5.0 $set{spelling,true} Use $set{flag_spelling_suggestion,true} instead.