git-webrev generates HTML pages showing the differences between commits and/or the working tree (i.e. git-webrev is a kind of diff viewer). git-webrev can also include additional metadata in its HTML output, such as a link(s) to issue(s), link to the target repository etc. git-webrev is a Git port of the OpenJDK Code Tools project webrev.
$ git webrev -h
usage: git webrev [options] [<FILE>]
-r, --rev REV Compare against a specified base revision (alias for --base)
-o, --output DIR Output directory
-u, --username NAME Use specified username instead of 'guessing' one
--upstream URL The URL to the upstream repository
-t, --title TITLE The title of the webrev
-c, --cr CR# Include link to the CR (aka bugid) in the main page
--remote NAME Use specified remote for calculating outgoing changes
--base REV Use specified revision as base for comparison
--head REV Use specified revision as head for comparison
-s, --similarity SIMILARITY Guess renamed files by similarity (0 - 100)
-b, Do not ignore changes in whitespace (always true)
-m, --mercurial Deprecated: force use of mercurial
--json Generate JSON instead of HTML
-C, --no-comments Do not show comments
-N, --no-outgoing Do not compare against remote, use only 'status'
--verbose Turn on verbose output
--debug Turn on debugging output
-v, --version Print the version of this tool
-h, --help Show this help text |
Create a webrev with the outgoing changes for the current branch:
$ git webrev |
Create a webrev with the changes between the worktree and HEAD:
$ git webrev -N |
Create a webrev with the changes between commit C1 to commit C2:
$ git webrev --base=C1 --head=C2 |
Configure the default name of the output directory to be "wdiff":
$ git configure --global webrev.output wdiff |
Configure the username to always be "ehelin":
$ git configure --global webrev.username ehelin |
See GitWebrev.java.