Google Git
Sign in
chromium / chromium / tools / depot_tools / dd55dc6d1c7de110bca46d939f56d2f519d54612
commitdd55dc6d1c7de110bca46d939f56d2f519d54612[log] [tgz]
authorbrucedawson <brucedawson@chromium.org>Thu Sep 29 19:02:50 2016
committerCommit bot <commit-bot@chromium.org>Thu Sep 29 19:02:51 2016
treea9e78ce0286729094850267de962118d5af06ad4
parent8818977467d88125743535010c5b37521694df0a [diff]
Modify depot_tools instructions regarding %PATH%

The old depot_tools instructions insisted that depot_tools be the last
entry in the PATH environment variable, for reasons that are unclear and
may only have applied to Linux. Meanwhile, there is a gn issue that can
cause unnecessary building if depot_tools is not near the front of the
path - ahead of other Python installs. This change alters the
instructions for Windows.

This also removes some obsolete instructions regarding building Chrome
on Windows XP - Chrome doesn't even *run* on Windows XP anymore.

BUG=611087

Review-Url: https://codereview.chromium.org/2371333002
3 files changed
tree: a9e78ce0286729094850267de962118d5af06ad4
  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. cit
  28. cit.bat
  29. cit.py
  30. clang-format
  31. clang-format.bat
  32. clang_format.py
  33. clang_format_merge_driver
  34. clang_format_merge_driver.bat
  35. clang_format_merge_driver.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-ntfs-junction.c
  44. create-ntfs-junction.exe
  45. dart_format.py
  46. depot-tools-auth
  47. depot-tools-auth.bat
  48. depot-tools-auth.py
  49. download_from_google_storage
  50. download_from_google_storage.bat
  51. download_from_google_storage.py
  52. fetch
  53. fetch.bat
  54. fetch.py
  55. fix_encoding.py
  56. gclient
  57. gclient-new-workdir.py
  58. gclient.bat
  59. gclient.py
  60. gclient_completion.sh
  61. gclient_scm.py
  62. gclient_utils.py
  63. gerrit_util.py
  64. git-cache
  65. git-cherry-pick-upload
  66. git-cl
  67. git-crrev-parse
  68. git-crsync
  69. git-drover
  70. git-find-releases
  71. git-footers
  72. git-freeze
  73. git-gs
  74. git-hyper-blame
  75. git-map
  76. git-map-branches
  77. git-mark-merge-base
  78. git-nav-downstream
  79. git-nav-upstream
  80. git-new-branch
  81. git-number
  82. git-rebase-update
  83. git-rename-branch
  84. git-reparent-branch
  85. git-retry
  86. git-runhooks
  87. git-squash-branch
  88. git-thaw
  89. git-upstream-diff
  90. git_cache.py
  91. git_cherry_pick_upload.py
  92. git_cl.py
  93. git_cl_completion.sh
  94. git_common.py
  95. git_dates.py
  96. git_drover.py
  97. git_find_releases.py
  98. git_footers.py
  99. git_freezer.py
  100. git_hyper_blame.py
  101. git_map.py
  102. git_map_branches.py
  103. git_mark_merge_base.py
  104. git_nav_downstream.py
  105. git_new_branch.py
  106. git_number.py
  107. git_rebase_update.py
  108. git_rename_branch.py
  109. git_reparent_branch.py
  110. git_retry.py
  111. git_squash_branch.py
  112. git_upstream_diff.py
  113. gn
  114. gn.bat
  115. gn.py
  116. gsutil.py
  117. LICENSE
  118. my_activity.py
  119. my_reviews.py
  120. ninja
  121. ninja-linux32
  122. ninja-linux64
  123. ninja-mac
  124. ninja.exe
  125. OWNERS
  126. owners.py
  127. owners_finder.py
  128. patch.py
  129. PRESUBMIT.py
  130. presubmit_canned_checks.py
  131. presubmit_support.py
  132. profile.xml
  133. pylint
  134. pylint.py
  135. pylintrc
  136. python_runner.sh
  137. README.gclient.md
  138. README.git-cl.md
  139. README.md
  140. README.testing
  141. recipes.py
  142. repo
  143. rietveld.py
  144. roll-dep
  145. roll-dep-svn
  146. roll-dep-svn.bat
  147. roll-dep.bat
  148. roll_dep.py
  149. roll_dep_svn.py
  150. scm.py
  151. setup_color.py
  152. subcommand.py
  153. subprocess2.py
  154. update_depot_tools
  155. update_depot_tools.bat
  156. upload_to_google_storage.py
  157. WATCHLISTS
  158. watchlists.py
  159. weekly
  160. 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 git and 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.