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.