烈火建站学院文档 SourceInsight固然在windows下面分析源代码很但方便,但是我的工作平台是linux,linux下面也需要经常对代码进行分析和检索,我试用过多种分析工具,最后还是确定使用lxr,通过参考一位台湾朋友t@c发表的一篇名为
Technical Writing’s Rule Of Thumb + Local Web based Code Cross Reference (eg. LXR clone)
的文章得以在我的工作计算机ubuntu 8.04和家用计算机ubuntu 8.10上搭建成功,谨在此向t@c仁兄致敬。
现在我把原文略加修改(原文为繁体中文,若干专有名词与大陆不同,作者使用的内核代码为2.6.24,我自己的是2.6.26)后转述如下:
01) LXRng依赖许多package,因此需要安装相关软件,使用如下命令:
$ sudo aptitude install git-core postgresql-8.3 postgresql-client-8.3 libxapian15 libsearch-xapian-perl apache2 libapache2-mod-perl2 libcgi-simple-perl libcgi-ajax-perl libhtml-parser-perl libtemplate-perl libterm-progressbar-perl libdevel-size-perl libdbd-pg-perl ctags
2) 数据库增加有用最大权限的使用者帐号,指令为:
$ sudo -i
$ su – postgres
$ createuser user # Answer “yes” when asked about superprivileged access
$ exit
$ exit
3) 建立数据库,并将http服务器使用者设定为数据库的一般使用者,因此在建立www-data帐号遇到的问题全部回答”N”,指令为:
$ createdb lxrng
$ createuser www-data
4) 由LXR的repository取得LXRng,指令为:
$ cd ~
$ git-clone git://lxr.linux.no/git/lxrng.git
5) 启动LXRng设定,指令为:
$ cd ~/lxrng
$ cp lxrng.conf-dist lxrng.conf
$ vim lxrng.conf
6) 将以下字符串注释掉
use LXRng::Repo::Git;
my $gitrepo = LXRng::Repo::Git
->new(‘/var/lib/lxrng/repos/linux-2.6/.git’,
release_re => qr/^v[^-]*$/,
author_timestamp => 0);
my $search = LXRng::Search::Xapian->new(‘/var/lib/lxrng/text-db/linux-2.6’);
7) 新增加以下新的字符串,指令为:
use LXRng::Repo::Plain;
my $plainrepo = LXRng::Repo::Plain->new(‘/home/user/src/linux-source’); [11]
my $search = LXRng::Search::Xapian->new(‘/home/user/src/linux-source-2.6.26-textdb’); [12]
8) 修改下列字符串:postgresq
‘repository’ => $gitrepo, –改为–> ‘repository’ => $plainrepo,
‘base_url’ => ‘http://lxr-test.linpro.no/lxr’, –改为–> ‘base_url’ => ‘http://localhost/lxr’, [13]
‘cache’ => ‘/var/lib/lxrng/cache’, –改为–> ‘cache’ => ‘/home/user/lxrng/cache’, [14]
‘ver_list’ => [$gitrepo->allversions], –改为–> ‘ver_list’ => [‘v2.6.26’],
‘ver_default’ => ‘v2.6.20.3’, –改为–> ‘ver_default’ => ‘v2.6.26’,
9) save&quite(emacs or vim in this example)
10) 下载Linux kernel source code并将目录设置为7)8)中设定好的目录相符合
$ mkdir ~/src
$ cp linux-2.6.26.tar.gz ~/src
$ cd ~/src
$ tar -xzvf linux-2.6.26.tar.gz
$ mkdir linux-source
$ mkdir linux-source/v2.6.26
$ mv linux-source-2.6.26/* linux-source/v2.6.26
$ mkdir linux-source-2.6.26-textdb
$ mkdir ~/lxrng/cache
$ chmod 777 ~/lxrng/cache -R
$ chmod 777 ~/lxrng/webroot -R
$ make -C ~/lxrng/webroot/.static/gfx
11) 生成Linux-2.6.26的XR,指令为:
$ cd ~/lxrng
$ ./lxr-db-admin linux –init
$ ./lxr-genxref linux
12) 设置Apache2
$ cp apache2-site.conf-dist-mod_perl apache2-site.conf
$ sudo ln -s ~/lxrng/apache2-site.conf /etc/apache2/sites-enabled/010-lxrng
$ vim apache2-site.conf
将所有”@@LXRROOT@@”替换成”/home/user/lxrng”
将”@@LXRURL@@”替换成”lxr”
13) 重新启动Apache2
$ sudo /etc/init.d/apache2 reload
14) 使用浏览器打开http://localhost/lxr即可进行代码检索。
如果要更换domain name,可将现有的”localhost”改为”somewhere.com”,只需要将”lxrng.conf”中的”base_url”替换之后再执行./lxr-genxref linux即可,这次的执行时间十分短,因为XR都已经存在,现在即可使用浏览器打开新的网址”http://somewhere.com/lxr”检索代码。至此,配置完毕,希望对大家有用。