REVU-Tools
What is REVU-Tools
REVU-Tools is a set of scripts used on REVU to automate the reviewing process.
It is included in the REVU SVN, and distributed on http://revu.tauware.de/~raphink .
For a guide to reviewing Debian packages, you can refer to MOTU/Packages/Reviewing.
How to use it
On REVU, only REVU admins can run these tools. If you are not a REVU admin, ask one to run it on the package you want to review.
If you are a review admin, wanting to review a $package updated on $date, and $url is the url of the $upstream tarball, run
cd /var/revu/revu1-incoming/$package-$date wget $url revu-report
This will generate report files in the current directory, that will appear on the REVU interface.
revu-report detects the dsc, the orig and the upstream tarball automagically. If there are several dsc files in the directory and/or several files that could be upstream tarballs, you'll have to run:
cd /var/revu/revu1-incoming/$package-$date wget $url revu-report $tarball $dscfile
Since version 0.3, revu-orig uses uscan to take advantage of debian/watch files in the package and get the upstream tarball automagically. Therefore, it is not necessary to download the upstream tarball anymore in many cases, just run :
cd /var/revu/revu1-incoming/$package-$date revu-report
If files are missing to generate the report and there is no debian/watch, then it will be said so in the report, and you can get the upstream tarball manually and run the command again.
The main file to look at is REVU_report, that gathers most of the useful informations gotten from the scripts :
- Whether there is a usable debian/watch file in the package ;
- Whether the is a new upstream tarball available ;
- Whether the package is a Debian-native (no orig.tar.gz + diff.gz) ;
- Whether the package FTBFS ;
- Whether the upstream tarball has been changed or repacked ;
Whether debuild && debuild -S -sa generates files in diff.gz outside of debian/ ;
- Whether lintian and linda are happy about the package.
Since version 0.3.1, REVU-tools have been made into a REVU-independant deb package, available in Dapper (universe) . This package is made to work on any system, but might require to adjust some settings in the scripts. In particular, you might want to change PBUILDERNAME in /etc/revu-tools.conf (most users want "sudo pbuilder", on REVU it's "pbuilder-dapper") to have it fit with your settings. You'll obviously need a working pbuilder to use REVU-Tools on your machine.