en/LXR 2.4 Core Installation

Download the LXR tarball if you haven't already done that.

Decide where you want LXR installed.
- If you just want to see how LXR behaves against your user-private tree, you might as well install LXR in your home directory at ~/lxr/.
- If you want to offer LXR service system-wide, you must install it in a public directory. In this guide, we will use /usr/local/share/lxr/.
  Access to this directory may require root privilege.
This directory will be called LXR root directory.
Expand the tarball We will suppose the tarball has been downloaded in your Download directory:
- Private installation: $ cd $ tar -zxf ~/Download/lxr-x.y.z.tgz
- System-wide installation: $ cd /usr/local/share $ tar -zxf ~/Download/lxr-x.y.z.tgz
Enter the LXR root directory You might want to rename this directory to get rid of the release version in its name. $ mv lxr-x.y.z lxr From the commands above, you are one level above the LXR directory. To enter: $ cd lxr

The tools installation page mentioned version requirements for the auxiliary tools needed by LXR. Now that LXR has been copied, you can test them for Perl and ctags with:

$ ./genxref --checkonly ERROR: could not open configuration file lxr.conf ‣[ OK ] Perl version ... 5.14.2 Parameter 'ectagsbin' not defined - trying to find ctags ‣ctags found at /usr/bin/ctags ‣[ OK ] ctags version ... 5.8 Parameter 'glimpsebin' not defined - trying to find glimpse ‣glimpse found at /usr/local/bin/glimpse ‣Checked: glimpse version ... 4.18.5 Parameter 'glimpseindex' not defined - trying to find glimpseindex ‣glimpseindex found at /usr/local/bin/glimpseindexg ‣Checked: glimpseindex version ... 4.18.5 Parameter 'swishbin' not defined - trying to find swish-e swish-e not found, `command -v swish-e` returned a null string genxref stopped without indexing by --checkonly option

Since LXR is not yet configured, you get various Parameter xxx not defined warnings. Ignore them.
This command blindly checks the existence of both Glimpse and Swish-e. One of the tests should return a not found result.
Read carefully the lines checked with a small triangle (‣) about version levels and tool locations. The small triangle, the underline and the background have been added here to draw your attention on the relevant lines. These decorations do not display on the real computer output.

You're done. You must now configure your copy.