Add a manual page for git-cl
The most important git subcommand in depot_tools never had a man page until today. And now "git help cl" and "git cl --help" will work. BUG=695623 Change-Id: Ic0d05fa8d70d2ef6e71d58e0d7d3e7adc4a2fa32 Reviewed-on: https://chromium-review.googlesource.com/447216 Reviewed-by: Robbie Iannucci <iannucci@chromium.org> Commit-Queue: Aaron Gable <agable@chromium.org>changes/16/447216/2
parent
b99bc3e190
commit
96dc085dbe
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,193 @@
|
||||
'\" t
|
||||
.\" Title: git-cl
|
||||
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
|
||||
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
||||
.\" Date: 02/27/2017
|
||||
.\" Manual: Chromium depot_tools Manual
|
||||
.\" Source: depot_tools a6ba28f5
|
||||
.\" Language: English
|
||||
.\"
|
||||
.TH "GIT\-CL" "1" "02/27/2017" "depot_tools a6ba28f5" "Chromium depot_tools Manual"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "NAME"
|
||||
git-cl \- Interact with code reviews on Gerrit and Rietveld
|
||||
.SH "SYNOPSIS"
|
||||
.sp
|
||||
.nf
|
||||
\fIgit cl <subcommand> [options]\fR
|
||||
.fi
|
||||
.sp
|
||||
.SH "DESCRIPTION"
|
||||
.sp
|
||||
git cl is the home of all of the tools for interacting with changelists\&.
|
||||
.sp
|
||||
Run git cl help <subcommand> for a more detailed listing of that command and its options\&.
|
||||
.SH "SUBCOMMANDS"
|
||||
.PP
|
||||
archive
|
||||
.RS 4
|
||||
archives and deletes branches associated with closed changelists
|
||||
.RE
|
||||
.PP
|
||||
baseurl
|
||||
.RS 4
|
||||
gets or sets base\-url for this branch
|
||||
.RE
|
||||
.PP
|
||||
checkout
|
||||
.RS 4
|
||||
checks out a branch associated with a given Rietveld or Gerrit issue
|
||||
.RE
|
||||
.PP
|
||||
comments
|
||||
.RS 4
|
||||
shows or posts review comments for any changelist
|
||||
.RE
|
||||
.PP
|
||||
config
|
||||
.RS 4
|
||||
edits configuration for this tree
|
||||
.RE
|
||||
.PP
|
||||
dcommit
|
||||
.RS 4
|
||||
DEPRECATED: Used to commit the current changelist via git\-svn
|
||||
.RE
|
||||
.PP
|
||||
description
|
||||
.RS 4
|
||||
brings up the editor for the current CL\(cqs description
|
||||
.RE
|
||||
.PP
|
||||
diff
|
||||
.RS 4
|
||||
shows differences between local tree and last upload
|
||||
.RE
|
||||
.PP
|
||||
format
|
||||
.RS 4
|
||||
runs auto\-formatting tools (clang\-format etc\&.) on the diff
|
||||
.RE
|
||||
.PP
|
||||
help
|
||||
.RS 4
|
||||
prints list of commands or help for a specific command
|
||||
.RE
|
||||
.PP
|
||||
issue
|
||||
.RS 4
|
||||
sets or displays the current code review issue number
|
||||
.RE
|
||||
.PP
|
||||
land
|
||||
.RS 4
|
||||
commits the current changelist via git
|
||||
.RE
|
||||
.PP
|
||||
lint
|
||||
.RS 4
|
||||
runs cpplint on the current changelist
|
||||
.RE
|
||||
.PP
|
||||
owners
|
||||
.RS 4
|
||||
interactively find the owners for reviewing
|
||||
.RE
|
||||
.PP
|
||||
patch
|
||||
.RS 4
|
||||
patches in a code review
|
||||
.RE
|
||||
.PP
|
||||
presubmit
|
||||
.RS 4
|
||||
runs presubmit tests on the current changelist
|
||||
.RE
|
||||
.PP
|
||||
set\-close
|
||||
.RS 4
|
||||
closes the issue
|
||||
.RE
|
||||
.PP
|
||||
set\-commit
|
||||
.RS 4
|
||||
sets the commit bit to trigger the Commit Queue
|
||||
.RE
|
||||
.PP
|
||||
status
|
||||
.RS 4
|
||||
show status of changelists
|
||||
.RE
|
||||
.PP
|
||||
tree
|
||||
.RS 4
|
||||
shows the status of the tree
|
||||
.RE
|
||||
.PP
|
||||
try
|
||||
.RS 4
|
||||
triggers try jobs using either BuildBucket or CQ dry run
|
||||
.RE
|
||||
.PP
|
||||
try\-results
|
||||
.RS 4
|
||||
prints info about try jobs associated with current CL
|
||||
.RE
|
||||
.PP
|
||||
upload
|
||||
.RS 4
|
||||
uploads the current changelist to codereview
|
||||
.RE
|
||||
.PP
|
||||
upstream
|
||||
.RS 4
|
||||
prints or sets the name of the upstream branch, if any
|
||||
.RE
|
||||
.PP
|
||||
web
|
||||
.RS 4
|
||||
opens the current CL in the web browser
|
||||
.RE
|
||||
.SH "OPTIONS"
|
||||
.PP
|
||||
\-\-version
|
||||
.RS 4
|
||||
show program\(cqs version number and exit
|
||||
.RE
|
||||
.PP
|
||||
\-h, \-\-help
|
||||
.RS 4
|
||||
show this help message and exit
|
||||
.RE
|
||||
.PP
|
||||
\-v, \-\-verbose
|
||||
.RS 4
|
||||
Use 2 times for more debugging info
|
||||
.RE
|
||||
.SH "CHROMIUM DEPOT_TOOLS"
|
||||
.sp
|
||||
Part of the chromium \fBdepot_tools\fR(7) suite\&. These tools are meant to assist with the development of chromium and related projects\&. Download the tools from \m[blue]\fBhere\fR\m[]\&\s-2\u[1]\d\s+2\&.
|
||||
.SH "NOTES"
|
||||
.IP " 1." 4
|
||||
here
|
||||
.RS 4
|
||||
\%https://chromium.googlesource.com/chromium/tools/depot_tools.git
|
||||
.RE
|
@ -0,0 +1 @@
|
||||
Interact with code reviews on Gerrit and Rietveld
|
@ -0,0 +1,116 @@
|
||||
git-cl(1)
|
||||
=========
|
||||
|
||||
NAME
|
||||
----
|
||||
git-cl -
|
||||
include::_git-cl_desc.helper.txt[]
|
||||
|
||||
SYNOPSIS
|
||||
--------
|
||||
[verse]
|
||||
'git cl <subcommand> [options]'
|
||||
|
||||
DESCRIPTION
|
||||
-----------
|
||||
|
||||
`git cl` is the home of all of the tools for interacting with changelists.
|
||||
|
||||
Run `git cl help <subcommand>` for a more detailed listing of that command
|
||||
and its options.
|
||||
|
||||
SUBCOMMANDS
|
||||
-----------
|
||||
|
||||
archive::
|
||||
archives and deletes branches associated with closed changelists
|
||||
|
||||
baseurl::
|
||||
gets or sets base-url for this branch
|
||||
|
||||
checkout::
|
||||
checks out a branch associated with a given Rietveld or Gerrit issue
|
||||
|
||||
comments::
|
||||
shows or posts review comments for any changelist
|
||||
|
||||
config::
|
||||
edits configuration for this tree
|
||||
|
||||
dcommit::
|
||||
DEPRECATED: Used to commit the current changelist via git-svn
|
||||
|
||||
description::
|
||||
brings up the editor for the current CL's description
|
||||
|
||||
diff::
|
||||
shows differences between local tree and last upload
|
||||
|
||||
format::
|
||||
runs auto-formatting tools (clang-format etc.) on the diff
|
||||
|
||||
help::
|
||||
prints list of commands or help for a specific command
|
||||
|
||||
issue::
|
||||
sets or displays the current code review issue number
|
||||
|
||||
land::
|
||||
commits the current changelist via git
|
||||
|
||||
lint::
|
||||
runs cpplint on the current changelist
|
||||
|
||||
owners::
|
||||
interactively find the owners for reviewing
|
||||
|
||||
patch::
|
||||
patches in a code review
|
||||
|
||||
presubmit::
|
||||
runs presubmit tests on the current changelist
|
||||
|
||||
set-close::
|
||||
closes the issue
|
||||
|
||||
set-commit::
|
||||
sets the commit bit to trigger the Commit Queue
|
||||
|
||||
status::
|
||||
show status of changelists
|
||||
|
||||
tree::
|
||||
shows the status of the tree
|
||||
|
||||
try::
|
||||
triggers try jobs using either BuildBucket or CQ dry run
|
||||
|
||||
try-results::
|
||||
prints info about try jobs associated with current CL
|
||||
|
||||
upload::
|
||||
uploads the current changelist to codereview
|
||||
|
||||
upstream::
|
||||
prints or sets the name of the upstream branch, if any
|
||||
|
||||
web::
|
||||
opens the current CL in the web browser
|
||||
|
||||
|
||||
OPTIONS
|
||||
-------
|
||||
|
||||
--version::
|
||||
show program's version number and exit
|
||||
|
||||
-h, --help::
|
||||
show this help message and exit
|
||||
|
||||
-v, --verbose::
|
||||
Use 2 times for more debugging info
|
||||
|
||||
|
||||
include::_footer.txt[]
|
||||
|
||||
// vim: ft:asciidoc:
|
Loading…
Reference in New Issue