blob: 4826df80af23af18e5f896b6084f7f0ccaef233a [file] [log] [blame]
iannucci@chromium.orga5d95022014-03-25 21:30:37 +00001'\" t
2.\" Title: depot_tools
3.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
mgiuca@chromium.org81937562016-02-03 08:00:53 +00004.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
agablebaba25e2016-07-22 09:36:21 -07005.\" Date: 07/21/2016
iannucci@chromium.orga5d95022014-03-25 21:30:37 +00006.\" Manual: Chromium depot_tools Manual
agablebaba25e2016-07-22 09:36:21 -07007.\" Source: depot_tools bf2a341
iannucci@chromium.orga5d95022014-03-25 21:30:37 +00008.\" Language: English
9.\"
agablebaba25e2016-07-22 09:36:21 -070010.TH "DEPOT_TOOLS" "7" "07/21/2016" "depot_tools bf2a341" "Chromium depot_tools Manual"
iannucci@chromium.orga5d95022014-03-25 21:30:37 +000011.\" -----------------------------------------------------------------
12.\" * Define some portability stuff
13.\" -----------------------------------------------------------------
14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15.\" http://bugs.debian.org/507673
16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18.ie \n(.g .ds Aq \(aq
19.el .ds Aq '
20.\" -----------------------------------------------------------------
21.\" * set default formatting
22.\" -----------------------------------------------------------------
23.\" disable hyphenation
24.nh
25.\" disable justification (adjust text to left margin only)
26.ad l
27.\" -----------------------------------------------------------------
28.\" * MAIN CONTENT STARTS HERE *
29.\" -----------------------------------------------------------------
30.SH "NAME"
31depot_tools \- A collection of tools for dealing with Chromium development\&.
32.SH "DESCRIPTION"
33.sp
34The Chromium depot_tools suite contains many tools to assist/augment the Chromium development environment\&. The tools may be downloaded from \m[blue]\fBhere\fR\m[]\&\s-2\u[1]\d\s+2\&.
35.sp
36There are two primary categories of tools\&. Some of these tools are \fIessential\fR to the development flow, in the sense that you cannot successfully develop Chromium without them\&.
37.sp
38Other tools are merely \fIhelper\fR tools\&. Not required, but they can substantially ease the develpment workflow\&.
39.sp
40A listing of both categories of tools follows\&.
41.SH "HELPER TOOLS"
iannucci@chromium.org21980022014-04-11 04:51:49 +000042.sp
43A tutorial for these tools can be found at \fBdepot_tools_tutorial\fR(7)\&.
iannucci@chromium.orga5d95022014-03-25 21:30:37 +000044.PP
mmoss@chromium.orga2e54c12014-08-25 23:58:16 +000045\fBgit-cherry-pick-upload\fR(1)
46.RS 4
47Upload the diff between a revision and its parent to rietveld\&.
48.RE
49.PP
50\fBgit-drover\fR(1)
51.RS 4
52Apply a commit from the trunk to a release branch, or from one release branch to another\&.
53.RE
54.PP
mmoss@chromium.org873a9d02014-09-09 22:09:53 +000055\fBgit-footers\fR(1)
56.RS 4
57Extract meta\-information expressed as footers in a commit message\&.
58.RE
59.PP
iannucci@chromium.orga5d95022014-03-25 21:30:37 +000060\fBgit-freeze\fR(1)
61.RS 4
62Freeze all changes on a branch (indexed and unindexed)\&.
63.RE
64.PP
mgiuca@chromium.org81937562016-02-03 08:00:53 +000065\fBgit-hyper-blame\fR(1)
66.RS 4
67Like git blame, but with the ability to ignore or bypass certain commits\&.
68.RE
69.PP
iannucci@chromium.orga5d95022014-03-25 21:30:37 +000070\fBgit-map-branches\fR(1)
71.RS 4
72Helper script to display all local git branches with \(oqupstream\(cq hierarchy in colorized terminal format\&.
73.RE
74.PP
75\fBgit-map\fR(1)
76.RS 4
77Display history of all branches in a colorized terminal format\&.
78.RE
79.PP
iannucci@chromium.orgc050a5b2014-03-26 06:18:50 +000080\fBgit-mark-merge-base\fR(1)
81.RS 4
82Manually interact with depot_tools\*(Aq merge\-base markers\&.
83.RE
84.PP
iannucci@chromium.orga5d95022014-03-25 21:30:37 +000085\fBgit-nav-downstream\fR(1)
86.RS 4
87Checkout a downstream branch of the currently checked out branch\&.
88.RE
89.PP
90\fBgit-nav-upstream\fR(1)
91.RS 4
92Checkout the upstream branch of the currently checked out branch\&.
93.RE
94.PP
iannucci@chromium.orgc050a5b2014-03-26 06:18:50 +000095\fBgit-new-branch\fR(1)
96.RS 4
97Create a new branch with correct tracking information\&.
98.RE
99.PP
100\fBgit-rebase-update\fR(1)
101.RS 4
102Updates all branches to have the latest changes from their upstreams\&.
103.RE
104.PP
105\fBgit-rename-branch\fR(1)
106.RS 4
107Rename a branch and correctly preserve all downstream relationships\&.
108.RE
109.PP
110\fBgit-reparent-branch\fR(1)
111.RS 4
112Alter the parentage (upstream) for the current branch\&.
113.RE
114.PP
mmoss@chromium.orga2e54c12014-08-25 23:58:16 +0000115\fBgit-retry\fR(1)
116.RS 4
117Bootstrap function to retry a git command\&.
118.RE
119.PP
iannucci@chromium.orgc050a5b2014-03-26 06:18:50 +0000120\fBgit-squash-branch\fR(1)
121.RS 4
122Takes all commits in a single branch and replaces them with a single commit\&.
123.RE
124.PP
iannucci@chromium.orga5d95022014-03-25 21:30:37 +0000125\fBgit-thaw\fR(1)
126.RS 4
127Un\-freeze all changes on a frozen branch\&.
128.RE
iannucci@chromium.orgc050a5b2014-03-26 06:18:50 +0000129.PP
130\fBgit-upstream-diff\fR(1)
131.RS 4
132Print a diff of the current branch, compared to its upstream\&.
133.RE
iannucci@chromium.orga5d95022014-03-25 21:30:37 +0000134.SH "NOTES"
135.IP " 1." 4
136here
137.RS 4
agablebaba25e2016-07-22 09:36:21 -0700138\%https://chromium.googlesource.com/chromium/tools/depot_tools
iannucci@chromium.orga5d95022014-03-25 21:30:37 +0000139.RE