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.man.txt
          +++ new/usr/src/tools/scripts/webrev.1onbld.man.txt
↓ open down ↓ 7 lines elided ↑ open up ↑
   8    8  SYNOPSIS
   9    9         webrev [ common-options ]
  10   10  
  11   11         webrev [ common-options ] file-list-file | -
  12   12  
  13   13         webrev [ common-options ] -w wx-file
  14   14  
  15   15  
  16   16  DESCRIPTION
  17   17         webrev builds a set of HTML files suitable for performing code review
  18      -       of source changes in a web browser.  It supports Mercurial, Git and
  19      -       Subversion repositories.  At its most basic, usage is:
       18 +       of source changes in a web browser.  It supports Git and Subversion
       19 +       repositories.  At its most basic, usage is:
  20   20                 $ webrev
  21   21  
  22   22         In which case webrev attempts to figure out the list of files for
  23   23         review.  If that fails, or if more control over the set of files is
  24   24         needed, a file list may be specified.  webrev also attempts to deduce a
  25   25         basis for comparison (interchangeably called the parent, but see SCM
  26   26         INTERACTIONS below).  A basis for comparison is needed in order to
  27   27         determine the differences introduced by the code changes under review.
  28   28  
  29   29         By default, webrev creates a webrev directory in the workspace
↓ open down ↓ 50 lines elided ↑ open up ↑
  80   80         and child workspaces respectively.  To manually specify the basis for
  81   81         comparison, use the -p option or specify the CODEMGR_PARENT variable in
  82   82         either the file list or the environment.
  83   83  
  84   84  
  85   85     Discovering the SCM in use.
  86   86         webrev makes use of which_scm(1ONBLD) to determine the SCM in use for a
  87   87         given workspace.
  88   88  
  89   89  
  90      -   Mercurial
  91      -       In the case of Mercurial webrev will attempt to use the output from the
  92      -       hg(1) "hg root" command to identify the workspace root, and the "hg
  93      -       path default" command to identify the parent workspace.
  94      -
  95      -
  96   90     Git
  97   91         In the case of Git webrev will attempt to use the output from the
  98   92         git(1) "git rev-parse --git-dir" command to identify the workspace
  99   93         root, and will attempt to use the remote branch which the current
 100   94         branch is tracking as the parent, if none is specified 'origin/master'
 101   95         will be used.
 102   96  
 103   97         The parent specified when using git is, in all cases, a git 'tree-ish'
 104   98         and never an actual git repository, remote or otherwise.  Anything
 105   99         specifiable to git as a tree-ish should, similarly, be specifiable as a
↓ open down ↓ 255 lines elided ↑ open up ↑
 361  355         For the nested directory case it is necessary to specify the full
 362  356         target:
 363  357  
 364  358                $ webrev -D -t \
 365  359                     ssh://user@cr.opensolaris.org:foo/bar/bugfix.onnv
 366  360  
 367  361         This will remove just the bugfix.onnv directory.
 368  362  
 369  363  
 370  364  SEE ALSO
 371      -       hg(1), git(1), ssh_config(4), svn(1), which_scm(1ONBLD)
      365 +       git(1), ssh_config(4), svn(1), which_scm(1ONBLD)
 372  366  
 373  367  
 374  368  ACKNOWLEDGEMENTS
 375  369         Acknowledgements to Rob Thurlow, Mike Eisler, Lin Ling, Rod Evans, Mike
 376  370         Kupfer, Greg Onufer, Glenn Skinner, Oleg Larin, David Robinson, Matthew
 377  371         Cross, David L. Paktor, Neal Gafter, John Beck, Darren Moffat, Norm
 378  372         Shulman, Bill Watson, Pedro Rubio and Bill Shannon for valuable
 379  373         feedback and insight in building webrev.
 380  374  
 381  375         Have fun!
 382  376                   Brent Callaghan  11/28/96
 383  377  
 384  378  
 385  379  
 386  380  
 387  381                                  March 27, 2016                  WEBREV(1ONBLD)
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX