The LXR root directory contains various subdirectories
and the core LXR components:
- doc/:
documentation directory where you find INSTALL, LICENSE
and other important information
- lib/:
LXR private library
- lxrconf.d/:
your configuration playground
This directory will soon contain customised configuration files.
This is where you should copy any LXR-provided template file
before editing it.
- LXRimages/:
"standard" LXR graphic stuff
- scripts/:
a collection of shell scripts automating some installation steps
- templates/:
a collection of prototype configuration files and
HTML fragments for page composition
- tests/
This legacy directory used to contain test cases.
It is now a separately downloadable package.
- diff, genxref, ident, search,
source and robots.txt:
LXR commands and the bot-protection file
The preliminary configuration step tailors some template files
and stores them in lxrconf.d/.
Run the following command:
$ ./scripts/initial-config.sh
*** Initial phase configurator for LXR ($Revision: 1.3 $) ***
Configure for single/multiple trees? [S/m] >
Answer s (or just hit "return") for single tree configuration.
Answer m to manage several independent source-trees.
Answer is case-insentitive:
s
and S
are equivalent.
The script continues:
Your LXR root directory is: /usr/local/share/lxr
It can also be /home/xxx/lxr according to your choice
in the previous step.
templates directory now protected read-only
File .htaccess written in your LXR root directory
--- List content with 'more .htaccess'
.htaccess (note the initial dot) is an Apache configuration file.
The list command is given for the technically curious.
File apache2-require.pl written in lxrconf.d directory
File apache-lxrserver.conf written in lxrconf.d directory
File lighttpd-lxrserver.conf written in lxrconf.d directory
Prototype lxr.conf written in lxrconf.d directory
The name of your LXR root directory is set in all these files,
as well as the location of ctags, glimpse,
glimpseindex and swish-e.
If something goes wrong, an error message is printed:
***Error: ctags not installed!
***Error: glimpseindex not installed with glimpse!
***Error: neither glimpse nor swish-e installed!
***Error: both glimpse and swish-e installed!
Manually edit lxr.conf to comment out one of them
The first three errors mean you did not install one of the required tools.
Go back to step 1.
The last error expresses LXR inability to choose between
glimpse and swish-e
which were both found on your computer.
You need to manually update lxr.conf in a later step.
Finally, the script lists lxrconf.d/ directory content.