en/LXR 0.11 Core Installation

Use of LXR 0.11 is not recommended, unless you cannot upgrade your Perl interpretor to version 5.10 at least.

This release is frozen and still contains bugs which have been corrected in later releases. Only "compatibility" bugs will be accepted.

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 Checking Perl version ... 5.14.2 OK No URL specified - Continuing in checking mode Parameter 'ectagsbin' not defined - trying to find ctags 'ectagsbin' temporarily adjusted to /usr/bin/ctags Manually update lxr.conf for permanent setting Checking ctags version ... 5.8 OK Parameter 'glimpsebin' not defined - trying to find glimpse 'glimpsebin' temporarily adjusted to /usr/local/bin/glimpse Manually update lxr.conf for permanent setting Checking glimpse version ... 4.18.5 Parameter 'glimpseindex' not defined - trying to find glimpseindex 'glimpseindex' temporarily adjusted to /usr/local/bin/glimpseindex Manually update lxr.conf for permanent setting Parameter 'swishbin' not defined - trying to find swish-e swish-e not found, `which swish-e` returned a null string No matching configuration at ./genxref line 273.

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.
This command errors out with the No matching configuration because LXR configuration is not yet defined.
Read carefully the lines about the version levels and tool locations.

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