在Sun/Oracle工作了N(>12)年后，对webrev工具甚为喜欢，因为其易用性确实非常好。幸运的是，有工程师将webrev工具放到了GitHub上，而且支持git。下面给出使用webrev工具创建代码比对网页的全过程。当然，首先得保证代码管理工具git在Linux(我用的是Ubuntu14.04)上已经就位和已经安装了ksh，因为webrev工具是基于ksh实现的。
第1步：Clone webrev from here（https://github.com/joyent/webrev）
veli$ cd /var/tmp
veli$ git clone https://github.com/joyent/webrev.git
Cloning into 'webrev'...
remote: Counting objects: 27, done.
remote: Total 27 (delta 0), reused 0 (delta 0), pack-reused 27
Unpacking objects: 100% (27/27), done.
Checking connectivity... done.
veli$ tree webrev
webrev
├── bin
│ ├── wdiff
│ ├── webrev
│ └── which_scm
├── etc
│ ├── its.conf
│ └── its.reg
└── README.md
第2步：Add webrev/bin to PATH
veli$ export PATH=/var/tmp/webrev/bin:$PATH
veli$ type webrev
webrev is /var/tmp/webrev/bin/webrev
第3步：Set up apache2
veli$ sudo apt-get install apache2
veli$ sudo service apache2 status
veli$ cd /var/www/html && sudo ln -s /var/tmp t
veli$ sudo vim /etc/apache2/apache2.conf # add "ServerName localhost:80"
veli$ sudo service apache2 restart
第4步：clone my source code and update something
veli$ git clone https://github.com/idorax/vCodeHub.git
Cloning into 'vCodeHub'...
remote: Counting objects: 359, done.
remote: Compressing objects: 100% (100/100), done.
remote: Total 359 (delta 58), reused 0 (delta 0), pack-reused 254
Receiving objects: 100% (359/359), 7.85 MiB | 1.61 MiB/s, done.
Resolving deltas: 100% (164/164), done.
Checking connectivity... done.
Now update a file,
veli$ cd /var/tmp/sandbox/vCodeHub/sharpsword/c
veli$ vi sudorax.c
第5步：commit changes
veli$ git commit -a
05/14/2017: demo to use webrev
# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
# On branch master
# Your branch is up-to-date with 'origin/master'.
#
# Changes to be committed:
# modified: sudorax.c
#
veli$ git show
commit eb08966d562c03abbe538615a60b0ba648c9cadf
Author: Vector Li <idorax@126.com>
Date: Sun May 14 11:29:11 2017 +0800
05/14/2017: demo to use webrev
diff --git a/sharpsword/c/sudorax.c b/sharpsword/c/sudorax.c
index 3f334c5..4645870 100644
--- a/sharpsword/c/sudorax.c
+++ b/sharpsword/c/sudorax.c
@@ -46,12 +46,9 @@ typedef unsigned long uint32_t;
static uint64_t
power(int32_t n, uint32_t m)
{
- uint32_t i;
uint64_t sum = 1;
-
- for (i = 0; i < m; i++)
+ for (uint32_t i = 0; i < m; i++)
sum *= n;
-
return sum;
}
第6步：create webrev
veli$ webrev
WARNING: codereview(1) not found.
SCM detected: git
File list from: git ... Done.
Workspace: /var/tmp/sandbox/vCodeHub (at eb08966d562c)
Compare against: origin/master (https://github.com/idorax/vCodeHub.git at c64cf7c91ba6)
Output to: /var/tmp/sandbox/webrev
Output Files:
sharpsword/c/sudorax.c
patch cdiffs udiffs wdiffs sdiffs frames old new
Generating PDF: Skipped: no output available
index.html: Done.
第7步: 在firefox里访问webrev
veli$ egrep '127.0.0.1' /etc/hosts
127.0.0.1 localhost
127.0.0.1 idorax
于是访问 http://idorax/t/sandbox/webrev
多么熟悉的web页面，终于出现了！Thank opensolaris, thank illumos!（https://wiki.illumos.org/display/illumos/illumos+Home） 点击Frames,
多么熟悉的代码比对页面，倍感亲切呀。
结束语：能在家里的Linux上用上webrev，实在是太幸福了！