depot_tools.7 3.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139
  1. '\" t
  2. .\" Title: depot_tools
  3. .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
  4. .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
  5. .\" Date: 05/03/2019
  6. .\" Manual: Chromium depot_tools Manual
  7. .\" Source: depot_tools e58cce6c
  8. .\" Language: English
  9. .\"
  10. .TH "DEPOT_TOOLS" "7" "05/03/2019" "depot_tools e58cce6c" "Chromium depot_tools Manual"
  11. .\" -----------------------------------------------------------------
  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"
  31. depot_tools \- A collection of tools for dealing with Chromium development\&.
  32. .SH "DESCRIPTION"
  33. .sp
  34. The 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
  36. There 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
  38. Other tools are merely \fIhelper\fR tools\&. Not required, but they can substantially ease the development workflow\&.
  39. .sp
  40. A listing of both categories of tools follows\&.
  41. .SH "HELPER TOOLS"
  42. .sp
  43. A tutorial for these tools can be found at \fBdepot_tools_tutorial\fR(7)\&.
  44. .PP
  45. \fBgit-cl\fR(1)
  46. .RS 4
  47. Interact with code reviews on Gerrit and Rietveld
  48. .RE
  49. .PP
  50. \fBgit-drover\fR(1)
  51. .RS 4
  52. Apply a commit from the trunk to a release branch, or from one release branch to another\&.
  53. .RE
  54. .PP
  55. \fBgit-footers\fR(1)
  56. .RS 4
  57. Extract meta\-information expressed as footers in a commit message\&.
  58. .RE
  59. .PP
  60. \fBgit-freeze\fR(1)
  61. .RS 4
  62. Freeze all changes on a branch (indexed and unindexed)\&.
  63. .RE
  64. .PP
  65. \fBgit-hyper-blame\fR(1)
  66. .RS 4
  67. Like git blame, but with the ability to ignore or bypass certain commits\&.
  68. .RE
  69. .PP
  70. \fBgit-map-branches\fR(1)
  71. .RS 4
  72. Helper 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
  77. Display history of all branches in a colorized terminal format\&.
  78. .RE
  79. .PP
  80. \fBgit-mark-merge-base\fR(1)
  81. .RS 4
  82. Manually interact with depot_tools\*(Aq merge\-base markers\&.
  83. .RE
  84. .PP
  85. \fBgit-nav-downstream\fR(1)
  86. .RS 4
  87. Checkout a downstream branch of the currently checked out branch\&.
  88. .RE
  89. .PP
  90. \fBgit-nav-upstream\fR(1)
  91. .RS 4
  92. Checkout the upstream branch of the currently checked out branch\&.
  93. .RE
  94. .PP
  95. \fBgit-new-branch\fR(1)
  96. .RS 4
  97. Create a new branch with correct tracking information\&.
  98. .RE
  99. .PP
  100. \fBgit-rebase-update\fR(1)
  101. .RS 4
  102. Updates all branches to have the latest changes from their upstreams\&.
  103. .RE
  104. .PP
  105. \fBgit-rename-branch\fR(1)
  106. .RS 4
  107. Rename a branch and correctly preserve all downstream relationships\&.
  108. .RE
  109. .PP
  110. \fBgit-reparent-branch\fR(1)
  111. .RS 4
  112. Alter the parentage (upstream) for the current branch\&.
  113. .RE
  114. .PP
  115. \fBgit-retry\fR(1)
  116. .RS 4
  117. Bootstrap function to retry a git command\&.
  118. .RE
  119. .PP
  120. \fBgit-squash-branch\fR(1)
  121. .RS 4
  122. Takes all commits in a single branch and replaces them with a single commit\&.
  123. .RE
  124. .PP
  125. \fBgit-thaw\fR(1)
  126. .RS 4
  127. Un\-freeze all changes on a frozen branch\&.
  128. .RE
  129. .PP
  130. \fBgit-upstream-diff\fR(1)
  131. .RS 4
  132. Print a diff of the current branch, compared to its upstream\&.
  133. .RE
  134. .SH "NOTES"
  135. .IP " 1." 4
  136. here
  137. .RS 4
  138. \%https://chromium.googlesource.com/chromium/tools/depot_tools.git
  139. .RE