Chapter 1. Installation

Table of Contents

Installing the Emacs Lisp files
Setting up refdb-mode
Customizing refdb-mode
Invoking refdb-mode
Using refdb-mode with NTEmacs

Installing refdb-mode is not much different from installing other Emacs extensions. It is assumed that you have a basic understanding of the Emacs configuration and directory layout. For further information about this topic, please consult the GNU Emacs manual.


First of all you need GNU Emacs itself. Emacs is available prepackaged for most contemporary operating systems, or it can be obtained as a source tarball from the GNU site. You also need a working installation of RefDB. You need at least the clients on the same computer that will run refdb-mode. If you access the application server refdbd on a remote server, you can build the required tools on your computer by configuring RefDB with the --disable-server switch.

The RefDB clients must be fully operational on your computer. If you can't run the RefDB clients manually, refdb-mode won't be able to do it either. This means in particular that your client configuration files (~/.refdbarc, ~/.refdbcrc, and ~/.refdbibrc) must be set up properly, including a valid username/password combo. refdb-mode cannot ask for the password interactively (aside from the fact that this would be annoying), so this must be set in your configuration file. Please refer to the RefDB manual for further instructions

The bibliography data conversion relies on the external bibutils tools.