= What is REVU-Tools =

REVU-Tools is a set of scripts which can be used to automate the reviewing process.

For a guide to reviewing Debian packages, you can refer to [[MOTU/Packages/Reviewing]].

UPDATE: THIS IS NOT USED BY REVU ANYMORE, BUT CAN STILL BE INSTALLED FOR PERSONAL USE.

= 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.

{{attachment:IconsPage/IconNote.png}} 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
}}}


{{attachment:IconsPage/IconHint2.png}}  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.


{{attachment:IconsPage/IconHint2.png}}  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.


---- 
[[CategoryMOTU]]