The LXR project web-site
Information on this site comes from the LXR developers and is maintained as close as possible to the current version.
April 21, 2013 •
LXR version 1.2 RELEASED!
Improves parsing reliability, corrects bugs in Java and HTML.
Don't forget to download the companion User's Manual.
March 8, 2013 • JAVA users: please read the "Known bugs" page, a bug affecting you has been detected.
January 26, 2013 •
LXR version 1.1 RELEASED!
Configuration procedure slightly changed, experimental Mercurial support, some display enhancements: read doc/CHANGES.
You are strongly encouraged to download the new User's Manual.
November 24, 2012 • Demos fixed: difference markup and CVS operational. See limitations down in home page. CVS snapshot taken on Nov. 24th.
October 31, 2012 • New tip on how to disable free-text search engine.
September 30, 2012 •
LXR version 1.0 RELEASED!
New configuration procedure: you are encouraged to load the comprehensive user's manual from the "doc" section of the download page.
Many features added, indexing performance improved.
August 4, 2012 • Advance notice: future release 1.0 cannot keep Perl 5.8 compatibility, You are invited to upgrade Perl to version 5.10 at least. If you cannot upgrade, you'll be stuck with LXR 0.11.1.
July 31, 2012 • Beta version of manual for LXR 1.0 released for comment and eventual new features before official public release of software. See English home page.
June 16, 2012 • SWISH-E users: please read the "Known bugs" page, two bugs affecting you have been detected.
March 27, 2012 • LXR version 0.11.1 released to fix a bug happening when LXR cannot load proper tree configuration and tries to print an error message.
March 21, 2012 •
LXR version 0.11 RELEASED!
Comprehensive manuals available in English and French in the "doc" section of the download page.
The installation instructions of this site have also been updated to reflect this latest version.
March 14, 2012 •
User manual for release 0.11 now frozen.
Available in English and French through the "beta" documentation link
on the index page for both languages.
REMINDER: this site can be browsed in English and French.
For other languages, contribution is welcome; contact the administrator.
March 1, 2012 • Help wanted! Click on the little flags under LXR logo (only from the start page).
February 5, 2012 • Beta user manual for release 0.11 uploaded. Available through the "beta" documentation link on this page.
January 27, 2012 •
Demo upgraded to use 0.11-beta version.
Default view is still 0.10.
To display 0.11-beta, select from the menu.
This demo offers two trees: LXR is the traditional way of displaying plain files (releases 0.9.8 to 0.10, plus 0.11-beta, are loaded); LXR/CVS shows everything from LXR debut in CVS snapshot taken on January 26th, 2012.
January 18, 2012 • Installation steps: web server configuration procedure updated to fix a Perl/Apache compatibility problem. LXR was not operational when Apache was configured with "MPM Worker". The fix should correct it. If that does not work, please report.
January 12, 2012 •
The long awaited User manual is available.
It reflects features in 0.10 release.
Please help improve the documentation by reporting any inaccuracy or error through the forum or mailing list.
January 4, 2012 •
A user reported a bug present in releases 0.10 and 0.10.1
which prevents proper functionning of free-text search.
Release 0.10.2 has been issued to fix the problem.
IMPORTANT - DO NOT DOWNLOAD RELEASES 0.10 OR 0.10.1 - IMPORTANT
January 3, 2012 • Release 0.10.1 fixes a syntax-compatibility problem per user request. It is backward compatible with older Perl interpreters.
December 28, 2011 •
Release 0.10 available for download. Users are encouraged
to update to this version since it corrects many bugs,
offers more langage support and brings new features.
Have a look at the demo.
December 27, 2011 •
Demo operational again!
Malfunction was caused a) by a syntax problem due to the old version of SourceForge's Perl interpreter, b) by a bug related to "search" script.
NOTE: click on the "Change" button after you select another version in the drop-down menu for the change to take effect.
Have a good navigation!
December 27, 2011 •
Demo LXR has been switched to 0.10,
but SourceForge configuration is a bit peculiar
(old Perl interpreter, missing system free-text search engine,
security oriented directory structure, launching of time-consuming
tools forbidden in Web mode, ...).
Consequently, this demo is a bit unstable
for instance, you cannot change the displayed file version from
the links unless you fiddle manually the URL
(remove the %24 sequence).
The problem is under close investigation.
December 26, 2011 • Release 0.10 is available in the demo for browsing. However genxref has not been run against it, consequently you have no croos-references (temporarily).
December 18, 2011 • The advanced configuration topic now reflects the features of the upcoming 0.10 release. Some are not applicable to current 0.9.10.
October 9, 2011 • Important notice about unofficial copies of this site in the "typographical conventions" page.
October 3, 2011 • Added clarification on multi-tree configuration.
July 23, 2011 • New troubleshooting page; please give feed back to improve it.
June 25, 2011 • Demo operational again!
June 24, 2011 • Clarification in installation, presentation enhancement.
June 12, 2011 • Release 0.9.10 available for download. Users are encouraged to update to this version since it corrects a serious bug.
May 29, 2011 •
Release 0.9.10 will be issued before mid-June to correct bug 3278970
causing out-of-sync conditions in strings.
No other feature announced for 0.10 should be considered operational.
April 4, 2011 •
LXR browsing demonstration on the LXR tree itself now possible!
Get a taste of the buttons-and-menus interface.
Also, alpha version of 0.9.10 manual available.
LXR is a general purpose source code indexer and cross-referencer that provides web-based browsing of source code with links to the definition and usage of any identifier. It supports a wide choice of languages.
LXR used to stand for "Linux Cross-Referencer" but it has proved generic enough to be able to cross reference any project beyond the Linux kernel.
It is based on stock web technology (meaning its output is regular HTML), so the display client may be freely chosen from the available web browsers. It was a design choice not to use Java or any other client-side scripting language to minimise dependencies and system requirements.
People frequently ask for the difference between LXR and LXRng (available from http://lxr.linux.no). LXRng is an experimental fork from LXR to explore other technologies. It is based on ajax and depends on many CPAN packages. It makes heavy use of scripting, meaning the computing load is shared between the server and the client.
On the server side, any web server with CGI-script capability should do nicely.
LXR is a valuable tool to keep a synthetic eye on a project during development. It is also very useful to study source-code from scratch. In this case, your learning curve is very steep.
This is a step-by-step How to install LXR guide for the latest release. Follow these links for previous releases: 0.11, 0.9.x and 0.10.x. For older releases, read INSTALL file that ships with the software.
What to do when something goes wrong?
Not yet "online", this link leads you to a nice Error-404 page instead!
The "stable" documentation is available for download on the project site
Please report any inaccuracy, error or misunderstanding on the project site (forum is suited for comments, errors should be filed in the bug tracker and you may even ask for feature request if a topic is missing)
Releases 0.9.8 to 1.2.0 can be displayed and compared.
This demo exhibits two tree-variants:
Due to SourceForge restrictions, it is only a snapshot. The date when it was taken is shown as the path root.
Since SourceForge's Perl is 5.8.8, LXR engines 1.0 and higher cannot be used. You will not see the latest improvements and features.
SourceForge has a complex configuration where some support tools are removed from web servers to improve security. Consequently, some LXR features do not work as expected (e.g. annotations in file display under CVS).
See the project site on SourceForge or have a look at the old project site.
The developers can be reached through the forum or the trackers.
Unless otherwise stated, all material (source, text, pictures, …) are open source
Page last modified on 2013-04-25