summaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
authorArun Isaac2020-02-15 19:25:30 +0530
committerArun Isaac2020-02-15 19:34:29 +0530
commit9a1bfc6980fb492149ad795330f0d5b17a3b59cf (patch)
tree54a017fb98582e2c5f1160c08411df58aaa60e98 /README.org
downloadguile-xapian-9a1bfc6980fb492149ad795330f0d5b17a3b59cf.tar.gz
guile-xapian-9a1bfc6980fb492149ad795330f0d5b17a3b59cf.tar.lz
guile-xapian-9a1bfc6980fb492149ad795330f0d5b17a3b59cf.zip
First commit.
Diffstat (limited to 'README.org')
-rw-r--r--README.org64
1 files changed, 64 insertions, 0 deletions
diff --git a/README.org b/README.org
new file mode 100644
index 0000000..ca961d2
--- /dev/null
+++ b/README.org
@@ -0,0 +1,64 @@
+#+TITLE: guile-xapian
+#+OPTIONS: *:nil
+
+guile-xapian provides Guile bindings for [[https://xapian.org][Xapian]], a search engine
+library. Xapian is a highly adaptable toolkit which allows developers
+to easily add advanced indexing and search facilities to their own
+applications. It has built-in support for several families of
+weighting models and also supports a rich set of boolean query
+operators.
+
+Once these bindings are sufficiently mature, they will be merged with
+[[https://github.com/xapian/xapian/tree/master/xapian-bindings][xapian-bindings]]. This will involve creating more complete
+Scheme-friendly wrapping of the Xapian library, writing test cases and
+documentation.
+
+There is no proper documentation yet. See the examples in the source
+tree. Also see [[https://getting-started-with-xapian.readthedocs.io/en/latest/index.html][Getting Started with Xapian]] which describes the Python
+bindings.
+
+* Usage
+
+Drop into a development environment.
+
+#+BEGIN_SRC sh
+guix environment -l guix.scm
+#+END_SRC
+
+Bootstrap autotools, then configure and make.
+
+#+BEGIN_SRC sh
+./bootstrap.sh
+./configure
+make
+#+END_SRC
+
+Try out the examples.
+
+First, let's index data in examples/100-objects.sexp creating a
+Xapian database at /tmp/db.
+
+#+BEGIN_SRC sh
+./pre-inst-env guile -s examples/index.scm examples/100-objects.sexp /tmp/db
+#+END_SRC
+
+Then, we may run searches on the database. Shown below are a few
+example searches.
+
+#+BEGIN_SRC sh
+./pre-inst-env guile -s examples/search.scm /tmp/db watch
+./pre-inst-env guile -s examples/search.scm /tmp/db Dent watch
+./pre-inst-env guile -s examples/search.scm /tmp/db title:sunwatch
+./pre-inst-env guile -s examples/search.scm /tmp/db description:\"leather case\" AND title:sundial
+#+END_SRC
+
+* Contributing
+
+Feedback, suggestions, feature requests and bug reports are all
+welcome. Please write to me at [[mailto:arunisaac@systemreboot.net][arunisaac@systemreboot.net]].
+
+* License
+
+guile-xapian is free software released under the terms of the [[https://www.gnu.org/licenses/gpl-3.0.html][GNU
+General Public License]], either version 2 of the License, or (at your
+option) any later version.