blob: d37d90e8874f72f0cac7f232c48a04bafbe1fcdb [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]
mmoss@chromium.orga2e54c12014-08-25 23:58:16 +00004.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5.\" Date: 08/25/2014
iannucci@chromium.orga5d95022014-03-25 21:30:37 +00006.\" Manual: Chromium depot_tools Manual
mmoss@chromium.orga2e54c12014-08-25 23:58:16 +00007.\" Source: depot_tools 19f1c45
iannucci@chromium.orga5d95022014-03-25 21:30:37 +00008.\" Language: English
9.\"
mmoss@chromium.orga2e54c12014-08-25 23:58:16 +000010.TH "DEPOT_TOOLS" "7" "08/25/2014" "depot_tools 19f1c45" "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
iannucci@chromium.orga5d95022014-03-25 21:30:37 +000055\fBgit-freeze\fR(1)
56.RS 4
57Freeze all changes on a branch (indexed and unindexed)\&.
58.RE
59.PP
60\fBgit-map-branches\fR(1)
61.RS 4
62Helper script to display all local git branches with \(oqupstream\(cq hierarchy in colorized terminal format\&.
63.RE
64.PP
65\fBgit-map\fR(1)
66.RS 4
67Display history of all branches in a colorized terminal format\&.
68.RE
69.PP
iannucci@chromium.orgc050a5b2014-03-26 06:18:50 +000070\fBgit-mark-merge-base\fR(1)
71.RS 4
72Manually interact with depot_tools\*(Aq merge\-base markers\&.
73.RE
74.PP
iannucci@chromium.orga5d95022014-03-25 21:30:37 +000075\fBgit-nav-downstream\fR(1)
76.RS 4
77Checkout a downstream branch of the currently checked out branch\&.
78.RE
79.PP
80\fBgit-nav-upstream\fR(1)
81.RS 4
82Checkout the upstream branch of the currently checked out branch\&.
83.RE
84.PP
iannucci@chromium.orgc050a5b2014-03-26 06:18:50 +000085\fBgit-new-branch\fR(1)
86.RS 4
87Create a new branch with correct tracking information\&.
88.RE
89.PP
90\fBgit-rebase-update\fR(1)
91.RS 4
92Updates all branches to have the latest changes from their upstreams\&.
93.RE
94.PP
95\fBgit-rename-branch\fR(1)
96.RS 4
97Rename a branch and correctly preserve all downstream relationships\&.
98.RE
99.PP
100\fBgit-reparent-branch\fR(1)
101.RS 4
102Alter the parentage (upstream) for the current branch\&.
103.RE
104.PP
mmoss@chromium.orga2e54c12014-08-25 23:58:16 +0000105\fBgit-retry\fR(1)
106.RS 4
107Bootstrap function to retry a git command\&.
108.RE
109.PP
iannucci@chromium.orgc050a5b2014-03-26 06:18:50 +0000110\fBgit-squash-branch\fR(1)
111.RS 4
112Takes all commits in a single branch and replaces them with a single commit\&.
113.RE
114.PP
iannucci@chromium.orga5d95022014-03-25 21:30:37 +0000115\fBgit-thaw\fR(1)
116.RS 4
117Un\-freeze all changes on a frozen branch\&.
118.RE
iannucci@chromium.orgc050a5b2014-03-26 06:18:50 +0000119.PP
120\fBgit-upstream-diff\fR(1)
121.RS 4
122Print a diff of the current branch, compared to its upstream\&.
123.RE
iannucci@chromium.orga5d95022014-03-25 21:30:37 +0000124.SH "NOTES"
125.IP " 1." 4
126here
127.RS 4
128\%https://chromium.googlesource.com/chromium/tools/depot_tools.git
129.RE