root / tags / 1.0.8 / xapian-core / include / xapian.h

Revision 10547, 3.7 kB (checked in by olly, 8 months ago)

Backport change from trunk:
include/xapian.h: Fix misplaced comment. Tweak doxygen comments for
version functions to be more consistent with others.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1/** @file xapian.h
2 *  @brief Public interfaces for the Xapian library.
3 */
4// Copyright (C) 2003,2004,2005,2007 Olly Betts
5//
6// This program is free software; you can redistribute it and/or modify
7// it under the terms of the GNU General Public License as published by
8// the Free Software Foundation; either version 2 of the License, or
9// (at your option) any later version.
10//
11// This program is distributed in the hope that it will be useful,
12// but WITHOUT ANY WARRANTY; without even the implied warranty of
13// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14// GNU General Public License for more details.
15//
16// You should have received a copy of the GNU General Public License
17// along with this program; if not, write to the Free Software
18// Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
19
20#ifndef XAPIAN_INCLUDED_XAPIAN_H
21#define XAPIAN_INCLUDED_XAPIAN_H
22
23// Set defines for library version and check C++ ABI versions match.
24#include <xapian/version.h>
25
26// Types
27#include <xapian/types.h>
28
29// Exceptions
30#include <xapian/error.h>
31#include <xapian/errorhandler.h>
32
33// Access to databases, documents, etc.
34#include <xapian/database.h>
35#include <xapian/dbfactory.h>
36#include <xapian/document.h>
37#include <xapian/positioniterator.h>
38#include <xapian/postingiterator.h>
39#include <xapian/termiterator.h>
40#include <xapian/valueiterator.h>
41
42// Indexing
43#include <xapian/termgenerator.h>
44
45// Searching
46#include <xapian/enquire.h>
47#include <xapian/expanddecider.h>
48#include <xapian/query.h>
49#include <xapian/queryparser.h>
50#include <xapian/sorter.h>
51
52// Stemming
53#include <xapian/stem.h>
54
55// Unicode support
56#include <xapian/unicode.h>
57
58// ELF visibility annotations for GCC.
59#include <xapian/visibility.h>
60
61#include <xapian/deprecated.h>
62
63// Functions returning library version:
64
65namespace Xapian {
66/** Report the version string of the library which the program is linked with.
67 *
68 * This may be different to the version compiled against (given by
69 * XAPIAN_VERSION) if shared libraries are being used.
70 */
71XAPIAN_VISIBILITY_DEFAULT
72const char * version_string();
73
74/** For compatibility with Xapian 0.9.5 and earlier.
75 *
76 * @deprecated This function is now deprecated, use Xapian::version_string()
77 * instead.
78 */
79XAPIAN_VISIBILITY_DEFAULT
80XAPIAN_DEPRECATED(const char * xapian_version_string());
81
82/** Report the major version of the library which the program is linked to.
83 *
84 * This may be different to the version compiled against (given by
85 * XAPIAN_MAJOR_VERSION) if shared libraries are being used.
86 */
87XAPIAN_VISIBILITY_DEFAULT
88int major_version();
89
90/** For compatibility with Xapian 0.9.5 and earlier.
91 *
92 * @deprecated This function is now deprecated, use Xapian::major_version()
93 * instead.
94 */
95XAPIAN_VISIBILITY_DEFAULT
96XAPIAN_DEPRECATED(int xapian_major_version());
97
98/** Report the minor version of the library which the program is linked to.
99 *
100 * This may be different to the version compiled against (given by
101 * XAPIAN_MINOR_VERSION) if shared libraries are being used.
102 */
103XAPIAN_VISIBILITY_DEFAULT
104int minor_version();
105
106/** For compatibility with Xapian 0.9.5 and earlier.
107 *
108 * @deprecated This function is now deprecated, use Xapian::minor_version()
109 * instead.
110 */
111XAPIAN_VISIBILITY_DEFAULT
112XAPIAN_DEPRECATED(int xapian_minor_version());
113
114/** Report the revision of the library which the program is linked to.
115 *
116 * This may be different to the version compiled against (given by
117 * XAPIAN_REVISION) if shared libraries are being used.
118 */
119XAPIAN_VISIBILITY_DEFAULT
120int revision();
121
122/** For compatibility with Xapian 0.9.5 and earlier.
123 *
124 * @deprecated This function is now deprecated, use Xapian::revision()
125 * instead.
126 */
127XAPIAN_VISIBILITY_DEFAULT
128XAPIAN_DEPRECATED(int xapian_revision());
129}
130
131#endif /* XAPIAN_INCLUDED_XAPIAN_H */
Note: See TracBrowser for help on using the browser.