Google Git
Sign in
chromium / chromium / tools / depot_tools / 9e198a84a930530032d87318b8c33b62b8b3833f
commit9e198a84a930530032d87318b8c33b62b8b3833f[log] [tgz]
authormaruel <maruel@chromium.org>Thu Aug 11 15:32:19 2016
committerCommit bot <commit-bot@chromium.org>Thu Aug 11 15:32:20 2016
tree189425ab0d227fb91aa9633d6cd5e6aec469bf82
parentdafd4f0c9a24d2b46531b9e054eb199e4f305f0a [diff]
Overhaul the README files a bit.

I didn't change the content much but deleted some obviously wrong stuff. Renamed
the files to .md so they will be processed by gitiles.

This change is in no way "sufficient" but that's a start.

R=tandrii@chromium.org

Review-Url: https://codereview.chromium.org/2232303002
6 files changed
tree: 189425ab0d227fb91aa9633d6cd5e6aec469bf82
  1. bootstrap/
  2. fetch_configs/
  3. git-templates/
  4. infra/
  5. man/
  6. recipe_modules/
  7. support/
  8. testing_support/
  9. tests/
  10. third_party/
  11. win_toolchain/
  12. zsh-goodies/
  13. cbuildbot ⇨ support/chromite_wrapper
  14. chrome_set_ver ⇨ support/chromite_wrapper
  15. cros ⇨ support/chromite_wrapper
  16. cros_sdk ⇨ support/chromite_wrapper
  17. .gitignore
  18. .style.yapf
  19. annotated_gclient.py
  20. apply_issue
  21. apply_issue.bat
  22. apply_issue.py
  23. auth.py
  24. breakpad.py
  25. buildbucket.py
  26. checkout.py
  27. chrome-update-create-task.bat
  28. chrome-update.bat
  29. chrome-update.py
  30. cit
  31. cit.bat
  32. cit.py
  33. clang-format
  34. clang-format.bat
  35. clang_format.py
  36. codereview.settings
  37. commit_queue
  38. commit_queue.bat
  39. commit_queue.py
  40. cpplint.bat
  41. cpplint.py
  42. cpplint_chromium.py
  43. create-chromium-git-src
  44. create-ntfs-junction.c
  45. create-ntfs-junction.exe
  46. dart_format.py
  47. depot-tools-auth
  48. depot-tools-auth.bat
  49. depot-tools-auth.py
  50. download_from_google_storage
  51. download_from_google_storage.bat
  52. download_from_google_storage.py
  53. drover
  54. drover.bat
  55. drover.py
  56. fetch
  57. fetch.bat
  58. fetch.py
  59. fix_encoding.py
  60. gcl
  61. gcl.bat
  62. gcl.py
  63. gclient
  64. gclient-new-workdir.py
  65. gclient.bat
  66. gclient.py
  67. gclient_completion.sh
  68. gclient_scm.py
  69. gclient_utils.py
  70. gerrit_util.py
  71. git-auto-svn
  72. git-cache
  73. git-cherry-pick-upload
  74. git-cl
  75. git-crrev-parse
  76. git-crsync
  77. git-drover
  78. git-find-releases
  79. git-footers
  80. git-freeze
  81. git-gs
  82. git-hyper-blame
  83. git-map
  84. git-map-branches
  85. git-mark-merge-base
  86. git-nav-downstream
  87. git-nav-upstream
  88. git-new-branch
  89. git-number
  90. git-rebase-update
  91. git-rename-branch
  92. git-reparent-branch
  93. git-retry
  94. git-runhooks
  95. git-squash-branch
  96. git-thaw
  97. git-upstream-diff
  98. git_auto_svn.py
  99. git_cache.py
  100. git_cherry_pick_upload.py
  101. git_cl.py
  102. git_common.py
  103. git_dates.py
  104. git_drover.py
  105. git_find_releases.py
  106. git_footers.py
  107. git_freezer.py
  108. git_hyper_blame.py
  109. git_map.py
  110. git_map_branches.py
  111. git_mark_merge_base.py
  112. git_nav_downstream.py
  113. git_new_branch.py
  114. git_number.py
  115. git_rebase_update.py
  116. git_rename_branch.py
  117. git_reparent_branch.py
  118. git_retry.py
  119. git_squash_branch.py
  120. git_upstream_diff.py
  121. gn
  122. gn.bat
  123. gn.py
  124. gsutil.py
  125. LICENSE
  126. my_activity.py
  127. my_reviews.py
  128. ninja
  129. ninja-linux32
  130. ninja-linux64
  131. ninja-mac
  132. ninja.exe
  133. OWNERS
  134. owners.py
  135. owners_finder.py
  136. patch.py
  137. PRESUBMIT.py
  138. presubmit_canned_checks.py
  139. presubmit_support.py
  140. profile.xml
  141. pylint
  142. pylint.py
  143. pylintrc
  144. python_runner.sh
  145. README.gclient.md
  146. README.git-cl.md
  147. README.md
  148. README.testing
  149. recipes.py
  150. repo
  151. rietveld.py
  152. roll-dep
  153. roll-dep-svn
  154. roll-dep-svn.bat
  155. roll-dep.bat
  156. roll_dep.py
  157. roll_dep_svn.py
  158. scm.py
  159. setup_color.py
  160. subcommand.py
  161. subprocess2.py
  162. trychange.py
  163. update_depot_tools
  164. update_depot_tools.bat
  165. upload_to_google_storage.py
  166. WATCHLISTS
  167. watchlists.py
  168. weekly
  169. wtf
README.md

depot_tools

This package contains tools for working with Chromium development. It requires python 2.7.

Tools

The most important tools are:

  • fetch: A gclient wrapper to checkout a project. Use fetch --help for more details.
  • gclient: A meta-checkout tool. Think repo or git submodules, except that it support OS-specific rules, e.g. do not checkout Windows only dependencies when checking out for Android. Use gclient help for more details and README.gclient.md.
  • git cl: A code review tool to interact with Rietveld or Gerrit. Use git cl help for more details and README.git-cl.md.
  • roll-dep: A gclient dependency management tool to submit a dep roll, updating a dependency to a newer revision.

There are a lot of git utilities included.

Updating

depot_tools updates itself automatically when running gclient tool. To disable auto update, set the environment variable DEPOT_TOOLS_UPDATE=0.

To update package manually, run update_depot_tools.bat on Windows, or ./update_depot_tools on Linux or Mac.

On Windows only, running gclient will install svn (not for long), git, python.

Contributing

To contribute change for review:

git new-branch <somename>
# Hack
git add .
git commit -a -m "Fixes goat teleporting"
# find reviewers
git cl owners
git log -- <yourfiles>

# Request a review.
git cl upload -r reviewer1@chromium.org,reviewer2@chromium.org --send-mail

# Edit change description if needed.
git cl desc

# If change is approved, flag it to be commited.
git cl set-commit

# If change needs more work.
git rebase-update
...
git cl upload -t "Fixes goat teleporter destination to be Australia"

cpplint.py

To update cpplint.py, please submit the change upstream first at https://github.com/google/styleguide/tree/gh-pages/cpplint then copy it down.