Print this page
9001 cdm is useless, remove it
9002 webrev should know how to get the git user name
Reviewed by: Yuri Pankov <yuri.pankov@nexenta.com>
Reviewed by: Joshua M. Clulow <jmc@joyent.com>

Split Close
Expand all
Collapse all
          --- old/usr/src/tools/scripts/webrev.1onbld
          +++ new/usr/src/tools/scripts/webrev.1onbld
↓ open down ↓ 42 lines elided ↑ open up ↑
  43   43  [
  44   44  .I common-options
  45   45  ]
  46   46  .B -w
  47   47  .I wx-file
  48   48  
  49   49  .SH DESCRIPTION
  50   50  .B webrev
  51   51  builds a set of HTML files suitable for performing code review of
  52   52  source changes in a web browser.
  53      -It supports Mercurial, Git and Subversion repositories.
       53 +It supports Git and Subversion repositories.
  54   54  At its most basic, usage is:
  55   55  .nf
  56   56          $ webrev
  57   57  .fi
  58   58  
  59   59  In which case \fBwebrev\fR attempts to figure out the list of files
  60   60  for review.  If that fails, or if more control
  61   61  over the set of files is needed, a \fIfile list\fR may be specified.
  62   62  \fBwebrev\fR also attempts to deduce a
  63   63  .I basis for comparison
↓ open down ↓ 69 lines elided ↑ open up ↑
 133  133  To manually specify the basis for comparison, use the -p option or
 134  134  specify the \fBCODEMGR_PARENT\fR variable in either the file list or
 135  135  the environment.
 136  136  
 137  137  .SS Discovering the SCM in use.
 138  138  .B webrev
 139  139  makes use of
 140  140  .BR which_scm (1ONBLD)
 141  141  to determine the SCM in use for a given workspace.
 142  142  
 143      -.SS Mercurial
 144      -In the case of Mercurial \fBwebrev\fR will attempt to use the output
 145      -from the
 146      -.BR hg (1)
 147      -"hg root" command to identify the workspace root, and the
 148      -"hg path default" command to identify the parent workspace.
 149      -
 150  143  .SS Git
 151  144  In the case of Git \fBwebrev\fR will attempt to use the output from the
 152  145  .BR git (1)
 153  146  "git rev-parse --git-dir" command to identify the workspace root, and will
 154  147  attempt to use the remote branch which the current branch is tracking as the
 155  148  parent, if none is specified 'origin/master' will be used.
 156  149  
 157  150  The parent specified when using git is, in all cases, a git 'tree-ish' and
 158  151  never an actual git repository, remote or otherwise.  Anything specifiable to
 159  152  git as a tree-ish should, similarly, be specifiable as a parent for webrev.
↓ open down ↓ 269 lines elided ↑ open up ↑
 429  422  For the nested directory case it is necessary to specify the full target:
 430  423  .IP
 431  424  .nf
 432  425  \f(CW$ webrev -D -t \\
 433  426          ssh://user@cr.opensolaris.org:foo/bar/bugfix.onnv
 434  427  .fi
 435  428  .PP
 436  429  This will remove just the \fIbugfix.onnv\fR directory.
 437  430  
 438  431  .SH SEE ALSO
 439      -.BR hg "(1),"
 440  432  .BR git "(1),"
 441  433  .BR ssh_config "(4),"
 442  434  .BR svn "(1),"
 443  435  .BR which_scm "(1ONBLD)"
 444  436  
 445  437  .SH ACKNOWLEDGEMENTS
 446  438  Acknowledgements to Rob Thurlow, Mike Eisler, Lin Ling,
 447  439  Rod Evans, Mike Kupfer, Greg Onufer, Glenn Skinner,
 448  440  Oleg Larin, David Robinson, Matthew Cross, David L. Paktor,
 449  441  Neal Gafter, John Beck, Darren Moffat, Norm Shulman, Bill Watson,
 450  442  Pedro Rubio and Bill Shannon for valuable feedback and insight in
 451  443  building webrev.
 452  444  
 453  445  Have fun!
 454  446  .br
 455  447  .nf
 456  448                  Brent Callaghan  11/28/96
 457  449  .fi
 458  450  
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX