libv8 8.4.255.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.gitignore +19 -0
- data/.gitmodules +3 -0
- data/.rspec +3 -0
- data/.travis.yml +45 -0
- data/CHANGELOG.md +111 -0
- data/Gemfile +4 -0
- data/README.md +152 -0
- data/Rakefile +125 -0
- data/appveyor.yml.disabled +36 -0
- data/ext/libv8/arch.rb +20 -0
- data/ext/libv8/builder.rb +106 -0
- data/ext/libv8/extconf.rb +7 -0
- data/ext/libv8/location.rb +89 -0
- data/ext/libv8/paths.rb +28 -0
- data/lib/libv8.rb +9 -0
- data/lib/libv8/version.rb +3 -0
- data/libv8.gemspec +30 -0
- data/scaleway.png +0 -0
- data/spec/location_spec.rb +69 -0
- data/spec/spec_helper.rb +4 -0
- data/thefrontside.png +0 -0
- data/vendor/depot_tools/.cipd_impl.ps1 +129 -0
- data/vendor/depot_tools/.gitattributes +55 -0
- data/vendor/depot_tools/.gitignore +92 -0
- data/vendor/depot_tools/.style.yapf +4 -0
- data/vendor/depot_tools/.vpython +55 -0
- data/vendor/depot_tools/.vpython3 +23 -0
- data/vendor/depot_tools/CROS_OWNERS +7 -0
- data/vendor/depot_tools/GOMA_OWNERS +9 -0
- data/vendor/depot_tools/LICENSE +27 -0
- data/vendor/depot_tools/LUCI_OWNERS +5 -0
- data/vendor/depot_tools/OWNERS +39 -0
- data/vendor/depot_tools/PRESUBMIT.py +150 -0
- data/vendor/depot_tools/README.gclient.md +67 -0
- data/vendor/depot_tools/README.git-cl.md +99 -0
- data/vendor/depot_tools/README.md +78 -0
- data/vendor/depot_tools/WATCHLISTS +26 -0
- data/vendor/depot_tools/auth.py +163 -0
- data/vendor/depot_tools/autoninja +36 -0
- data/vendor/depot_tools/autoninja.bat +33 -0
- data/vendor/depot_tools/autoninja.py +148 -0
- data/vendor/depot_tools/bb +12 -0
- data/vendor/depot_tools/bb.bat +7 -0
- data/vendor/depot_tools/bootstrap/README.md +155 -0
- data/vendor/depot_tools/bootstrap/bootstrap.py +356 -0
- data/vendor/depot_tools/bootstrap/git-bash.template.sh +12 -0
- data/vendor/depot_tools/bootstrap/git.template.bat +5 -0
- data/vendor/depot_tools/bootstrap/manifest.txt +27 -0
- data/vendor/depot_tools/bootstrap/manifest_bleeding_edge.txt +27 -0
- data/vendor/depot_tools/bootstrap/profile.d.python.sh +20 -0
- data/vendor/depot_tools/bootstrap/python27.bat +46 -0
- data/vendor/depot_tools/bootstrap/python3.bat +46 -0
- data/vendor/depot_tools/bootstrap/win_tools.bat +79 -0
- data/vendor/depot_tools/bootstrap_python3 +35 -0
- data/vendor/depot_tools/breakpad.py +12 -0
- data/vendor/depot_tools/cbuildbot +1 -0
- data/vendor/depot_tools/chrome_set_ver +1 -0
- data/vendor/depot_tools/cipd +247 -0
- data/vendor/depot_tools/cipd.bat +67 -0
- data/vendor/depot_tools/cipd_bin_setup.bat +6 -0
- data/vendor/depot_tools/cipd_bin_setup.sh +22 -0
- data/vendor/depot_tools/cipd_client_version +1 -0
- data/vendor/depot_tools/cipd_client_version.digests +22 -0
- data/vendor/depot_tools/cipd_manifest.txt +63 -0
- data/vendor/depot_tools/cipd_manifest.versions +438 -0
- data/vendor/depot_tools/cit +8 -0
- data/vendor/depot_tools/cit.bat +12 -0
- data/vendor/depot_tools/cit.py +167 -0
- data/vendor/depot_tools/clang-format +8 -0
- data/vendor/depot_tools/clang-format.bat +12 -0
- data/vendor/depot_tools/clang_format.py +79 -0
- data/vendor/depot_tools/clang_format_merge_driver +8 -0
- data/vendor/depot_tools/clang_format_merge_driver.bat +12 -0
- data/vendor/depot_tools/clang_format_merge_driver.py +69 -0
- data/vendor/depot_tools/codereview.settings +6 -0
- data/vendor/depot_tools/compile_single_file +8 -0
- data/vendor/depot_tools/compile_single_file.bat +11 -0
- data/vendor/depot_tools/compile_single_file.py +79 -0
- data/vendor/depot_tools/cpplint.bat +11 -0
- data/vendor/depot_tools/cpplint.py +6097 -0
- data/vendor/depot_tools/cpplint_chromium.py +50 -0
- data/vendor/depot_tools/cros +87 -0
- data/vendor/depot_tools/cros_sdk +1 -0
- data/vendor/depot_tools/crosjobs +13 -0
- data/vendor/depot_tools/detect_host_arch.py +55 -0
- data/vendor/depot_tools/dirmd +12 -0
- data/vendor/depot_tools/dirmd.bat +7 -0
- data/vendor/depot_tools/download_from_google_storage +8 -0
- data/vendor/depot_tools/download_from_google_storage.bat +12 -0
- data/vendor/depot_tools/download_from_google_storage.py +634 -0
- data/vendor/depot_tools/ensure_bootstrap +53 -0
- data/vendor/depot_tools/fetch +21 -0
- data/vendor/depot_tools/fetch.bat +28 -0
- data/vendor/depot_tools/fetch.py +319 -0
- data/vendor/depot_tools/fetch_configs/android.py +34 -0
- data/vendor/depot_tools/fetch_configs/android_internal.py +34 -0
- data/vendor/depot_tools/fetch_configs/breakpad.py +44 -0
- data/vendor/depot_tools/fetch_configs/chromium.py +66 -0
- data/vendor/depot_tools/fetch_configs/config_util.py +52 -0
- data/vendor/depot_tools/fetch_configs/crashpad.py +41 -0
- data/vendor/depot_tools/fetch_configs/dart.py +45 -0
- data/vendor/depot_tools/fetch_configs/depot_tools.py +44 -0
- data/vendor/depot_tools/fetch_configs/devtools-frontend.py +44 -0
- data/vendor/depot_tools/fetch_configs/goma_client.py +41 -0
- data/vendor/depot_tools/fetch_configs/gyp.py +41 -0
- data/vendor/depot_tools/fetch_configs/infra.py +40 -0
- data/vendor/depot_tools/fetch_configs/infra_internal.py +45 -0
- data/vendor/depot_tools/fetch_configs/inspector_protocol.py +40 -0
- data/vendor/depot_tools/fetch_configs/ios.py +34 -0
- data/vendor/depot_tools/fetch_configs/ios_internal.py +39 -0
- data/vendor/depot_tools/fetch_configs/nacl.py +48 -0
- data/vendor/depot_tools/fetch_configs/naclports.py +47 -0
- data/vendor/depot_tools/fetch_configs/node-ci.py +41 -0
- data/vendor/depot_tools/fetch_configs/pdfium.py +40 -0
- data/vendor/depot_tools/fetch_configs/skia.py +41 -0
- data/vendor/depot_tools/fetch_configs/skia_buildbot.py +41 -0
- data/vendor/depot_tools/fetch_configs/syzygy.py +41 -0
- data/vendor/depot_tools/fetch_configs/v8.py +44 -0
- data/vendor/depot_tools/fetch_configs/webrtc.py +52 -0
- data/vendor/depot_tools/fetch_configs/webrtc_android.py +34 -0
- data/vendor/depot_tools/fetch_configs/webrtc_ios.py +34 -0
- data/vendor/depot_tools/fix_encoding.py +385 -0
- data/vendor/depot_tools/gclient +38 -0
- data/vendor/depot_tools/gclient-new-workdir.py +124 -0
- data/vendor/depot_tools/gclient.bat +32 -0
- data/vendor/depot_tools/gclient.py +3198 -0
- data/vendor/depot_tools/gclient_completion.sh +76 -0
- data/vendor/depot_tools/gclient_eval.py +891 -0
- data/vendor/depot_tools/gclient_paths.py +152 -0
- data/vendor/depot_tools/gclient_scm.py +1615 -0
- data/vendor/depot_tools/gclient_utils.py +1280 -0
- data/vendor/depot_tools/gerrit_client.py +151 -0
- data/vendor/depot_tools/gerrit_util.py +996 -0
- data/vendor/depot_tools/git-cache +6 -0
- data/vendor/depot_tools/git-cl +6 -0
- data/vendor/depot_tools/git-crrev-parse +53 -0
- data/vendor/depot_tools/git-drover +6 -0
- data/vendor/depot_tools/git-find-releases +6 -0
- data/vendor/depot_tools/git-footers +6 -0
- data/vendor/depot_tools/git-freeze +8 -0
- data/vendor/depot_tools/git-gs +9 -0
- data/vendor/depot_tools/git-hyper-blame +6 -0
- data/vendor/depot_tools/git-map +6 -0
- data/vendor/depot_tools/git-map-branches +6 -0
- data/vendor/depot_tools/git-mark-merge-base +6 -0
- data/vendor/depot_tools/git-nav-downstream +6 -0
- data/vendor/depot_tools/git-nav-upstream +6 -0
- data/vendor/depot_tools/git-new-branch +6 -0
- data/vendor/depot_tools/git-number +6 -0
- data/vendor/depot_tools/git-rebase-update +6 -0
- data/vendor/depot_tools/git-rename-branch +6 -0
- data/vendor/depot_tools/git-reparent-branch +6 -0
- data/vendor/depot_tools/git-retry +8 -0
- data/vendor/depot_tools/git-runhooks +23 -0
- data/vendor/depot_tools/git-squash-branch +6 -0
- data/vendor/depot_tools/git-templates/description +3 -0
- data/vendor/depot_tools/git-templates/hooks/applypatch-msg +4 -0
- data/vendor/depot_tools/git-templates/hooks/post-applypatch +4 -0
- data/vendor/depot_tools/git-templates/hooks/post-checkout +4 -0
- data/vendor/depot_tools/git-templates/hooks/post-commit +4 -0
- data/vendor/depot_tools/git-templates/hooks/post-merge +4 -0
- data/vendor/depot_tools/git-templates/hooks/post-update +4 -0
- data/vendor/depot_tools/git-templates/hooks/pre-applypatch +4 -0
- data/vendor/depot_tools/git-templates/hooks/pre-auto-gc +4 -0
- data/vendor/depot_tools/git-templates/hooks/pre-commit +4 -0
- data/vendor/depot_tools/git-templates/hooks/pre-rebase +4 -0
- data/vendor/depot_tools/git-templates/hooks/prepare-commit-msg +4 -0
- data/vendor/depot_tools/git-templates/info/exclude +6 -0
- data/vendor/depot_tools/git-thaw +13 -0
- data/vendor/depot_tools/git-upstream-diff +9 -0
- data/vendor/depot_tools/git_cache.py +786 -0
- data/vendor/depot_tools/git_cl.py +5158 -0
- data/vendor/depot_tools/git_cl_completion.sh +48 -0
- data/vendor/depot_tools/git_common.py +1101 -0
- data/vendor/depot_tools/git_dates.py +62 -0
- data/vendor/depot_tools/git_drover.py +469 -0
- data/vendor/depot_tools/git_find_releases.py +67 -0
- data/vendor/depot_tools/git_footers.py +261 -0
- data/vendor/depot_tools/git_freezer.py +40 -0
- data/vendor/depot_tools/git_hyper_blame.py +391 -0
- data/vendor/depot_tools/git_map.py +166 -0
- data/vendor/depot_tools/git_map_branches.py +354 -0
- data/vendor/depot_tools/git_mark_merge_base.py +73 -0
- data/vendor/depot_tools/git_nav_downstream.py +69 -0
- data/vendor/depot_tools/git_new_branch.py +82 -0
- data/vendor/depot_tools/git_number.py +301 -0
- data/vendor/depot_tools/git_rebase_update.py +351 -0
- data/vendor/depot_tools/git_rename_branch.py +55 -0
- data/vendor/depot_tools/git_reparent_branch.py +101 -0
- data/vendor/depot_tools/git_retry.py +181 -0
- data/vendor/depot_tools/git_squash_branch.py +28 -0
- data/vendor/depot_tools/git_upstream_diff.py +64 -0
- data/vendor/depot_tools/gn +8 -0
- data/vendor/depot_tools/gn.bat +12 -0
- data/vendor/depot_tools/gn.py +78 -0
- data/vendor/depot_tools/goma_auth +12 -0
- data/vendor/depot_tools/goma_auth.bat +8 -0
- data/vendor/depot_tools/goma_ctl +12 -0
- data/vendor/depot_tools/goma_ctl.bat +8 -0
- data/vendor/depot_tools/gsutil.py +190 -0
- data/vendor/depot_tools/gsutil.py.bat +23 -0
- data/vendor/depot_tools/gsutil.vpython +120 -0
- data/vendor/depot_tools/infra/README.md +1 -0
- data/vendor/depot_tools/infra/config/OWNERS +7 -0
- data/vendor/depot_tools/infra/config/README.md +1 -0
- data/vendor/depot_tools/infra/config/recipes.cfg +26 -0
- data/vendor/depot_tools/led +12 -0
- data/vendor/depot_tools/led.bat +7 -0
- data/vendor/depot_tools/lockfile.py +116 -0
- data/vendor/depot_tools/luci-auth +13 -0
- data/vendor/depot_tools/luci-auth.bat +8 -0
- data/vendor/depot_tools/lucicfg +12 -0
- data/vendor/depot_tools/lucicfg.bat +7 -0
- data/vendor/depot_tools/mac_toolchain +12 -0
- data/vendor/depot_tools/man/html/depot_tools.html +934 -0
- data/vendor/depot_tools/man/html/depot_tools_tutorial.html +1593 -0
- data/vendor/depot_tools/man/html/git-cl.html +1033 -0
- data/vendor/depot_tools/man/html/git-drover.html +1048 -0
- data/vendor/depot_tools/man/html/git-footers.html +878 -0
- data/vendor/depot_tools/man/html/git-freeze.html +859 -0
- data/vendor/depot_tools/man/html/git-hyper-blame.html +878 -0
- data/vendor/depot_tools/man/html/git-map-branches.html +904 -0
- data/vendor/depot_tools/man/html/git-map.html +887 -0
- data/vendor/depot_tools/man/html/git-mark-merge-base.html +826 -0
- data/vendor/depot_tools/man/html/git-nav-downstream.html +844 -0
- data/vendor/depot_tools/man/html/git-nav-upstream.html +853 -0
- data/vendor/depot_tools/man/html/git-new-branch.html +932 -0
- data/vendor/depot_tools/man/html/git-rebase-update.html +961 -0
- data/vendor/depot_tools/man/html/git-rename-branch.html +794 -0
- data/vendor/depot_tools/man/html/git-reparent-branch.html +847 -0
- data/vendor/depot_tools/man/html/git-retry.html +858 -0
- data/vendor/depot_tools/man/html/git-squash-branch.html +881 -0
- data/vendor/depot_tools/man/html/git-thaw.html +794 -0
- data/vendor/depot_tools/man/html/git-upstream-diff.html +923 -0
- data/vendor/depot_tools/man/man1/git-cl.1 +198 -0
- data/vendor/depot_tools/man/man1/git-drover.1 +330 -0
- data/vendor/depot_tools/man/man1/git-footers.1 +144 -0
- data/vendor/depot_tools/man/man1/git-freeze.1 +113 -0
- data/vendor/depot_tools/man/man1/git-hyper-blame.1 +128 -0
- data/vendor/depot_tools/man/man1/git-map-branches.1 +210 -0
- data/vendor/depot_tools/man/man1/git-map.1 +179 -0
- data/vendor/depot_tools/man/man1/git-mark-merge-base.1 +69 -0
- data/vendor/depot_tools/man/man1/git-nav-downstream.1 +112 -0
- data/vendor/depot_tools/man/man1/git-nav-upstream.1 +122 -0
- data/vendor/depot_tools/man/man1/git-new-branch.1 +176 -0
- data/vendor/depot_tools/man/man1/git-rebase-update.1 +177 -0
- data/vendor/depot_tools/man/man1/git-rename-branch.1 +53 -0
- data/vendor/depot_tools/man/man1/git-reparent-branch.1 +93 -0
- data/vendor/depot_tools/man/man1/git-retry.1 +108 -0
- data/vendor/depot_tools/man/man1/git-squash-branch.1 +129 -0
- data/vendor/depot_tools/man/man1/git-thaw.1 +54 -0
- data/vendor/depot_tools/man/man1/git-upstream-diff.1 +153 -0
- data/vendor/depot_tools/man/man7/depot_tools.7 +139 -0
- data/vendor/depot_tools/man/man7/depot_tools_tutorial.7 +1061 -0
- data/vendor/depot_tools/man/push_to_gs.sh +4 -0
- data/vendor/depot_tools/man/src/.gitignore +5 -0
- data/vendor/depot_tools/man/src/_aliases.txt +5 -0
- data/vendor/depot_tools/man/src/_footer.txt +8 -0
- data/vendor/depot_tools/man/src/_git-cl_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-drover_desc.helper.txt +2 -0
- data/vendor/depot_tools/man/src/_git-footers_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-freeze_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-hyper-blame_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-map-branches_desc.helper.txt +4 -0
- data/vendor/depot_tools/man/src/_git-map_desc.helper.txt +3 -0
- data/vendor/depot_tools/man/src/_git-mark-merge-base_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-nav-downstream_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-nav-upstream_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-new-branch_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-rebase-update_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-rename-branch_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-reparent-branch_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-retry_desc.helper.txt +2 -0
- data/vendor/depot_tools/man/src/_git-squash-branch_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_git-thaw_desc.helper.txt +2 -0
- data/vendor/depot_tools/man/src/_git-upstream-diff_desc.helper.txt +1 -0
- data/vendor/depot_tools/man/src/_helper_prefix.txt +1 -0
- data/vendor/depot_tools/man/src/asciidoc-override.css +7 -0
- data/vendor/depot_tools/man/src/common_demo_functions.sh +84 -0
- data/vendor/depot_tools/man/src/demo_repo.sh +43 -0
- data/vendor/depot_tools/man/src/depot_tools.txt +28 -0
- data/vendor/depot_tools/man/src/depot_tools_tutorial.demo.walkthrough.sh +155 -0
- data/vendor/depot_tools/man/src/depot_tools_tutorial.txt +432 -0
- data/vendor/depot_tools/man/src/filter_demo_output.py +141 -0
- data/vendor/depot_tools/man/src/git-cl.txt +119 -0
- data/vendor/depot_tools/man/src/git-drover.demo.1.sh +22 -0
- data/vendor/depot_tools/man/src/git-drover.demo.2.sh +23 -0
- data/vendor/depot_tools/man/src/git-drover.demo.3.sh +27 -0
- data/vendor/depot_tools/man/src/git-drover.demo.4.sh +39 -0
- data/vendor/depot_tools/man/src/git-drover.demo.common.sh +19 -0
- data/vendor/depot_tools/man/src/git-drover.txt +102 -0
- data/vendor/depot_tools/man/src/git-footers.demo.1.sh +17 -0
- data/vendor/depot_tools/man/src/git-footers.txt +71 -0
- data/vendor/depot_tools/man/src/git-freeze.demo.1.sh +23 -0
- data/vendor/depot_tools/man/src/git-freeze.txt +54 -0
- data/vendor/depot_tools/man/src/git-hyper-blame.demo.1.sh +3 -0
- data/vendor/depot_tools/man/src/git-hyper-blame.demo.2.sh +4 -0
- data/vendor/depot_tools/man/src/git-hyper-blame.demo.common.sh +57 -0
- data/vendor/depot_tools/man/src/git-hyper-blame.txt +85 -0
- data/vendor/depot_tools/man/src/git-map-branches.demo.1.sh +8 -0
- data/vendor/depot_tools/man/src/git-map-branches.txt +64 -0
- data/vendor/depot_tools/man/src/git-map.demo.1.sh +3 -0
- data/vendor/depot_tools/man/src/git-map.txt +67 -0
- data/vendor/depot_tools/man/src/git-mark-merge-base.txt +46 -0
- data/vendor/depot_tools/man/src/git-nav-downstream.demo.1.sh +12 -0
- data/vendor/depot_tools/man/src/git-nav-downstream.txt +40 -0
- data/vendor/depot_tools/man/src/git-nav-upstream.demo.1.sh +12 -0
- data/vendor/depot_tools/man/src/git-nav-upstream.txt +39 -0
- data/vendor/depot_tools/man/src/git-new-branch.demo.1.sh +17 -0
- data/vendor/depot_tools/man/src/git-new-branch.txt +82 -0
- data/vendor/depot_tools/man/src/git-rebase-update.txt +141 -0
- data/vendor/depot_tools/man/src/git-rename-branch.txt +28 -0
- data/vendor/depot_tools/man/src/git-reparent-branch.txt +61 -0
- data/vendor/depot_tools/man/src/git-retry.txt +67 -0
- data/vendor/depot_tools/man/src/git-squash-branch.demo.1.sh +12 -0
- data/vendor/depot_tools/man/src/git-squash-branch.txt +59 -0
- data/vendor/depot_tools/man/src/git-thaw.txt +29 -0
- data/vendor/depot_tools/man/src/git-upstream-diff.txt +107 -0
- data/vendor/depot_tools/man/src/make_docs.sh +260 -0
- data/vendor/depot_tools/man/src/prep_demo_repo.sh +103 -0
- data/vendor/depot_tools/metrics.README.md +101 -0
- data/vendor/depot_tools/metrics.py +297 -0
- data/vendor/depot_tools/metrics_utils.py +293 -0
- data/vendor/depot_tools/my_activity.py +971 -0
- data/vendor/depot_tools/ninja +44 -0
- data/vendor/depot_tools/ninja-linux32 +0 -0
- data/vendor/depot_tools/ninja-linux64 +0 -0
- data/vendor/depot_tools/ninja-mac +0 -0
- data/vendor/depot_tools/ninja.exe +0 -0
- data/vendor/depot_tools/ninjalog.README.md +64 -0
- data/vendor/depot_tools/ninjalog_uploader.py +233 -0
- data/vendor/depot_tools/ninjalog_uploader_wrapper.py +125 -0
- data/vendor/depot_tools/owners.py +641 -0
- data/vendor/depot_tools/owners_finder.py +385 -0
- data/vendor/depot_tools/post_build_ninja_summary.py +350 -0
- data/vendor/depot_tools/presubmit_canned_checks.py +1655 -0
- data/vendor/depot_tools/presubmit_support.py +1923 -0
- data/vendor/depot_tools/profile.xml +8 -0
- data/vendor/depot_tools/prpc +13 -0
- data/vendor/depot_tools/prpc.bat +8 -0
- data/vendor/depot_tools/pylint +9 -0
- data/vendor/depot_tools/pylint-1.5 +78 -0
- data/vendor/depot_tools/pylint-1.6 +78 -0
- data/vendor/depot_tools/pylint-1.7 +78 -0
- data/vendor/depot_tools/pylint-1.8 +78 -0
- data/vendor/depot_tools/pylint-1.9 +78 -0
- data/vendor/depot_tools/pylint.bat +12 -0
- data/vendor/depot_tools/pylint_main.py +45 -0
- data/vendor/depot_tools/pylintrc +349 -0
- data/vendor/depot_tools/python-bin/python3 +7 -0
- data/vendor/depot_tools/python_runner.sh +60 -0
- data/vendor/depot_tools/rdb +12 -0
- data/vendor/depot_tools/rdb.bat +7 -0
- data/vendor/depot_tools/recipes/OWNERS +4 -0
- data/vendor/depot_tools/recipes/README.recipes.md +1079 -0
- data/vendor/depot_tools/recipes/recipe_modules/OWNERS +1 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/OWNERS +2 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/__init__.py +38 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/api.py +516 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/basic.json +117 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/basic_luci.json +117 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/basic_with_branch_heads.json +118 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/clobber.json +211 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/deprecated_got_revision_mapping.json +194 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/gerrit_no_rebase_patch_ref.json +211 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/gerrit_no_reset.json +211 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/input_commit_with_id_without_repo.json +210 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/multiple_patch_refs.json +214 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/no_apply_patch_on_gclient.json +265 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/no_cp_checkout_HEAD.json +65 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/no_cp_checkout_a_branch_head.json +65 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/no_cp_checkout_a_specific_commit.json +65 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/no_cp_checkout_master.json +65 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/refs.json +212 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/reset_root_solution_revision.json +210 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/resolve_chromium_fixed_version.json +117 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_fail.json +95 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_fail_patch.json +209 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_fail_patch_download.json +193 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_angle.json +265 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_branch_heads.json +261 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_feature_branch.json +261 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_v8_feature_branch.json +265 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_webrtc.json +265 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_v8.json +265 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_v8_head_by_default.json +265 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/unrecognized_commit_repo.json +8 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/with_tags.json +211 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.py +308 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/resources/__init__.py +0 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/resources/bot_update.py +1258 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/test_api.py +93 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/tests/do_not_retry_patch_failures_in_cq.py +42 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/tests/ensure_checkout.py +35 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/__init__.py +9 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/api.py +455 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/basic.json +403 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/basic_pkg.json +403 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/describe-failed.json +82 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/describe-many-instances.json +411 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/mac64.json +403 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/pkg_bad_file.json +315 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/pkg_bad_mode.json +313 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/pkg_bad_verfile.json +313 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/win64.json +403 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.py +187 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/junk arch.json +5 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/junk bits.json +5 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/linux_arm_32.json +12 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/linux_arm_64.json +12 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/linux_intel_32.json +12 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/linux_intel_64.json +12 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/linux_mips_64.json +12 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/mac_intel_64.json +12 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/win_intel_32.json +12 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/win_intel_64.json +12 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.py +59 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/test_api.py +93 -0
- data/vendor/depot_tools/recipes/recipe_modules/depot_tools/__init__.py +9 -0
- data/vendor/depot_tools/recipes/recipe_modules/depot_tools/api.py +75 -0
- data/vendor/depot_tools/recipes/recipe_modules/depot_tools/examples/full.expected/basic.json +83 -0
- data/vendor/depot_tools/recipes/recipe_modules/depot_tools/examples/full.expected/basic_luci.json +83 -0
- data/vendor/depot_tools/recipes/recipe_modules/depot_tools/examples/full.expected/win.json +83 -0
- data/vendor/depot_tools/recipes/recipe_modules/depot_tools/examples/full.py +55 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/__init__.py +13 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/api.py +428 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/config.py +462 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/examples/full.expected/basic.json +238 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/examples/full.expected/revision.json +240 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/examples/full.expected/tryserver.json +238 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/examples/full.py +95 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/resources/diff_deps.py +16 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/test_api.py +36 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/tests/diff_deps.expected/basic.json +55 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/tests/diff_deps.expected/dont have revision yet.json +84 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/tests/diff_deps.expected/no change, exception.json +83 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/tests/diff_deps.expected/windows.json +55 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/tests/diff_deps.py +88 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/tests/patch_project.py +92 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/tests/sync_failure.py +24 -0
- data/vendor/depot_tools/recipes/recipe_modules/gerrit/__init__.py +8 -0
- data/vendor/depot_tools/recipes/recipe_modules/gerrit/api.py +178 -0
- data/vendor/depot_tools/recipes/recipe_modules/gerrit/examples/full.expected/basic.json +284 -0
- data/vendor/depot_tools/recipes/recipe_modules/gerrit/examples/full.py +73 -0
- data/vendor/depot_tools/recipes/recipe_modules/gerrit/test_api.py +53 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/__init__.py +11 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/api.py +405 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic.json +217 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_branch.json +217 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_file_name.json +219 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_hash.json +216 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_ref.json +217 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_submodule_update_force.json +218 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_tags.json +218 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/can_fail_build.json +164 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/cannot_fail_build.json +220 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/cat-file_test.json +239 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/count-objects_delta.json +290 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/count-objects_failed.json +220 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/count-objects_with_bad_output.json +222 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/count-objects_with_bad_output_fails_build.json +111 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/curl_trace_file.json +218 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/git-cache-checkout.json +265 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/platform_win.json +217 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/rebase_failed.json +221 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/remote_not_origin.json +219 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/set_got_revision.json +218 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.py +170 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/resources/git_setup.py +52 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/test_api.py +18 -0
- data/vendor/depot_tools/recipes/recipe_modules/git_cl/__init__.py +5 -0
- data/vendor/depot_tools/recipes/recipe_modules/git_cl/api.py +50 -0
- data/vendor/depot_tools/recipes/recipe_modules/git_cl/config.py +22 -0
- data/vendor/depot_tools/recipes/recipe_modules/git_cl/examples/full.expected/basic.json +105 -0
- data/vendor/depot_tools/recipes/recipe_modules/git_cl/examples/full.py +47 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/OWNERS +2 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/__init__.py +12 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/api.py +257 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/examples/full.expected/basic.json +596 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/examples/full.py +93 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/resources/gerrit_client.py +251 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/test_api.py +95 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/tests/parse_repo_url.expected/basic.json +5 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/tests/parse_repo_url.py +49 -0
- data/vendor/depot_tools/recipes/recipe_modules/gsutil/__init__.py +4 -0
- data/vendor/depot_tools/recipes/recipe_modules/gsutil/api.py +222 -0
- data/vendor/depot_tools/recipes/recipe_modules/gsutil/examples/full.expected/basic.json +247 -0
- data/vendor/depot_tools/recipes/recipe_modules/gsutil/examples/full.py +92 -0
- data/vendor/depot_tools/recipes/recipe_modules/gsutil/resources/gsutil_smart_retry.py +69 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/__init__.py +36 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/api.py +140 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/examples/full.expected/ancient_version.json +83 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/examples/full.expected/automatic_version.json +83 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/examples/full.expected/explicit_version.json +83 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/examples/full.expected/linux.json +21 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/examples/full.expected/mac.json +83 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/examples/full.expected/win.json +21 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/examples/full.py +42 -0
- data/vendor/depot_tools/recipes/recipe_modules/presubmit/__init__.py +27 -0
- data/vendor/depot_tools/recipes/recipe_modules/presubmit/api.py +251 -0
- data/vendor/depot_tools/recipes/recipe_modules/presubmit/examples/full.expected/basic.json +27 -0
- data/vendor/depot_tools/recipes/recipe_modules/presubmit/examples/full.py +19 -0
- data/vendor/depot_tools/recipes/recipe_modules/presubmit/properties.proto +14 -0
- data/vendor/depot_tools/recipes/recipe_modules/presubmit/test_api.py +19 -0
- data/vendor/depot_tools/recipes/recipe_modules/presubmit/tests/execute.py +247 -0
- data/vendor/depot_tools/recipes/recipe_modules/presubmit/tests/prepare.py +49 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/__init__.py +18 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/api.py +264 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/basic_tags.json +57 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/with_gerrit_patch.json +190 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/with_gerrit_patch_and_target_ref.json +190 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/with_wrong_patch.json +21 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/with_wrong_patch_new.json +22 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.py +95 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/test_api.py +14 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/tests/gerrit_change_fetch_ref_timeout.py +29 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/tests/gerrit_change_owner.expected/basic.json +5 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/tests/gerrit_change_owner.py +22 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/tests/gerrit_change_target_ref.py +32 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/__init__.py +25 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/api.py +137 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/examples/full.expected/linux.json +21 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/examples/full.expected/mac.json +21 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/examples/full.expected/win.json +108 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/examples/full.py +21 -0
- data/vendor/depot_tools/recipes/recipes.py +249 -0
- data/vendor/depot_tools/recipes/recipes/fetch_end_to_end_test.expected/basic.json +175 -0
- data/vendor/depot_tools/recipes/recipes/fetch_end_to_end_test.py +56 -0
- data/vendor/depot_tools/recipes/trigger_recipe_roller.txt +13 -0
- data/vendor/depot_tools/repo +1194 -0
- data/vendor/depot_tools/roll-dep +21 -0
- data/vendor/depot_tools/roll-dep.bat +21 -0
- data/vendor/depot_tools/roll_dep.py +282 -0
- data/vendor/depot_tools/scm.py +415 -0
- data/vendor/depot_tools/setup_color.py +130 -0
- data/vendor/depot_tools/split_cl.py +263 -0
- data/vendor/depot_tools/subcommand.py +261 -0
- data/vendor/depot_tools/subprocess2.py +258 -0
- data/vendor/depot_tools/third_party/__init__.py +5 -0
- data/vendor/depot_tools/third_party/colorama/LICENSE.txt +27 -0
- data/vendor/depot_tools/third_party/colorama/README.chromium +12 -0
- data/vendor/depot_tools/third_party/colorama/README.rst +346 -0
- data/vendor/depot_tools/third_party/colorama/__init__.py +6 -0
- data/vendor/depot_tools/third_party/colorama/ansi.py +102 -0
- data/vendor/depot_tools/third_party/colorama/ansitowin32.py +257 -0
- data/vendor/depot_tools/third_party/colorama/initialise.py +80 -0
- data/vendor/depot_tools/third_party/colorama/win32.py +152 -0
- data/vendor/depot_tools/third_party/colorama/winterm.py +169 -0
- data/vendor/depot_tools/third_party/coverage/AUTHORS.txt +43 -0
- data/vendor/depot_tools/third_party/coverage/PKG-INFO +41 -0
- data/vendor/depot_tools/third_party/coverage/README.chromium +13 -0
- data/vendor/depot_tools/third_party/coverage/__init__.py +120 -0
- data/vendor/depot_tools/third_party/coverage/__main__.py +4 -0
- data/vendor/depot_tools/third_party/coverage/annotate.py +101 -0
- data/vendor/depot_tools/third_party/coverage/backward.py +184 -0
- data/vendor/depot_tools/third_party/coverage/bytecode.py +75 -0
- data/vendor/depot_tools/third_party/coverage/cmdline.py +740 -0
- data/vendor/depot_tools/third_party/coverage/codeunit.py +145 -0
- data/vendor/depot_tools/third_party/coverage/collector.py +353 -0
- data/vendor/depot_tools/third_party/coverage/config.py +213 -0
- data/vendor/depot_tools/third_party/coverage/control.py +776 -0
- data/vendor/depot_tools/third_party/coverage/data.py +278 -0
- data/vendor/depot_tools/third_party/coverage/debug.py +54 -0
- data/vendor/depot_tools/third_party/coverage/execfile.py +171 -0
- data/vendor/depot_tools/third_party/coverage/files.py +309 -0
- data/vendor/depot_tools/third_party/coverage/fullcoverage/encodings.py +57 -0
- data/vendor/depot_tools/third_party/coverage/html.py +387 -0
- data/vendor/depot_tools/third_party/coverage/htmlfiles/coverage_html.js +376 -0
- data/vendor/depot_tools/third_party/coverage/htmlfiles/index.html +104 -0
- data/vendor/depot_tools/third_party/coverage/htmlfiles/jquery-1.4.3.min.js +166 -0
- data/vendor/depot_tools/third_party/coverage/htmlfiles/jquery.hotkeys.js +99 -0
- data/vendor/depot_tools/third_party/coverage/htmlfiles/jquery.isonscreen.js +53 -0
- data/vendor/depot_tools/third_party/coverage/htmlfiles/jquery.min.js +166 -0
- data/vendor/depot_tools/third_party/coverage/htmlfiles/jquery.tablesorter.min.js +2 -0
- data/vendor/depot_tools/third_party/coverage/htmlfiles/keybd_closed.png +0 -0
- data/vendor/depot_tools/third_party/coverage/htmlfiles/keybd_open.png +0 -0
- data/vendor/depot_tools/third_party/coverage/htmlfiles/pyfile.html +90 -0
- data/vendor/depot_tools/third_party/coverage/htmlfiles/style.css +300 -0
- data/vendor/depot_tools/third_party/coverage/misc.py +163 -0
- data/vendor/depot_tools/third_party/coverage/parser.py +666 -0
- data/vendor/depot_tools/third_party/coverage/phystokens.py +208 -0
- data/vendor/depot_tools/third_party/coverage/report.py +92 -0
- data/vendor/depot_tools/third_party/coverage/results.py +286 -0
- data/vendor/depot_tools/third_party/coverage/summary.py +86 -0
- data/vendor/depot_tools/third_party/coverage/templite.py +166 -0
- data/vendor/depot_tools/third_party/coverage/version.py +9 -0
- data/vendor/depot_tools/third_party/coverage/xmlreport.py +155 -0
- data/vendor/depot_tools/third_party/httplib2/LICENSE +1339 -0
- data/vendor/depot_tools/third_party/httplib2/README.chromium +15 -0
- data/vendor/depot_tools/third_party/httplib2/__init__.py +1780 -0
- data/vendor/depot_tools/third_party/httplib2/cacerts.txt +2196 -0
- data/vendor/depot_tools/third_party/httplib2/iri2uri.py +110 -0
- data/vendor/depot_tools/third_party/httplib2/socks.py +448 -0
- data/vendor/depot_tools/third_party/repo/COPYING +202 -0
- data/vendor/depot_tools/third_party/repo/README.chromium +4 -0
- data/vendor/depot_tools/third_party/repo/__init__.py +0 -0
- data/vendor/depot_tools/third_party/repo/progress.py +117 -0
- data/vendor/depot_tools/third_party/retry_decorator/LICENSE.google +30 -0
- data/vendor/depot_tools/third_party/retry_decorator/__init__.py +0 -0
- data/vendor/depot_tools/third_party/retry_decorator/decorators.py +45 -0
- data/vendor/depot_tools/third_party/schema/.editorconfig +15 -0
- data/vendor/depot_tools/third_party/schema/.gitignore +174 -0
- data/vendor/depot_tools/third_party/schema/.travis.yml +37 -0
- data/vendor/depot_tools/third_party/schema/LICENSE-MIT +19 -0
- data/vendor/depot_tools/third_party/schema/MANIFEST.in +1 -0
- data/vendor/depot_tools/third_party/schema/README.chromium +12 -0
- data/vendor/depot_tools/third_party/schema/README.rst +382 -0
- data/vendor/depot_tools/third_party/schema/__init__.py +1 -0
- data/vendor/depot_tools/third_party/schema/schema.py +338 -0
- data/vendor/depot_tools/third_party/schema/setup.cfg +5 -0
- data/vendor/depot_tools/third_party/schema/setup.py +30 -0
- data/vendor/depot_tools/third_party/schema/test_schema.py +556 -0
- data/vendor/depot_tools/third_party/schema/tox.ini +33 -0
- data/vendor/depot_tools/third_party/six/LICENSE.txt +18 -0
- data/vendor/depot_tools/third_party/six/README.chromium +10 -0
- data/vendor/depot_tools/third_party/six/__init__.py +762 -0
- data/vendor/depot_tools/update_depot_tools +138 -0
- data/vendor/depot_tools/update_depot_tools.bat +65 -0
- data/vendor/depot_tools/update_depot_tools_toggle.py +38 -0
- data/vendor/depot_tools/upload_metrics.py +26 -0
- data/vendor/depot_tools/upload_to_google_storage.py +306 -0
- data/vendor/depot_tools/vpython +42 -0
- data/vendor/depot_tools/vpython.bat +7 -0
- data/vendor/depot_tools/vpython3 +55 -0
- data/vendor/depot_tools/vpython3.bat +12 -0
- data/vendor/depot_tools/watchlists.py +141 -0
- data/vendor/depot_tools/weekly +54 -0
- data/vendor/depot_tools/win32imports.py +61 -0
- data/vendor/depot_tools/win_toolchain/OWNERS +2 -0
- data/vendor/depot_tools/win_toolchain/README.md +74 -0
- data/vendor/depot_tools/win_toolchain/get_toolchain_if_necessary.py +599 -0
- data/vendor/depot_tools/win_toolchain/package_from_installed.py +524 -0
- data/vendor/depot_tools/wtf +81 -0
- data/vendor/depot_tools/yapf +21 -0
- data/vendor/depot_tools/yapf.bat +12 -0
- data/vendor/depot_tools/zsh-goodies/README +6 -0
- data/vendor/depot_tools/zsh-goodies/_gclient +14 -0
- metadata +729 -0
@@ -0,0 +1,1593 @@
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
|
2
|
+
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
3
|
+
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
|
+
<head>
|
5
|
+
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
|
6
|
+
<meta name="generator" content="AsciiDoc 8.6.9" />
|
7
|
+
<title>depot_tools_tutorial(7)</title>
|
8
|
+
<style type="text/css">
|
9
|
+
/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
|
10
|
+
|
11
|
+
/* Default font. */
|
12
|
+
body {
|
13
|
+
font-family: Georgia,serif;
|
14
|
+
}
|
15
|
+
|
16
|
+
/* Title font. */
|
17
|
+
h1, h2, h3, h4, h5, h6,
|
18
|
+
div.title, caption.title,
|
19
|
+
thead, p.table.header,
|
20
|
+
#toctitle,
|
21
|
+
#author, #revnumber, #revdate, #revremark,
|
22
|
+
#footer {
|
23
|
+
font-family: Arial,Helvetica,sans-serif;
|
24
|
+
}
|
25
|
+
|
26
|
+
body {
|
27
|
+
margin: 1em 5% 1em 5%;
|
28
|
+
}
|
29
|
+
|
30
|
+
a {
|
31
|
+
color: blue;
|
32
|
+
text-decoration: underline;
|
33
|
+
}
|
34
|
+
a:visited {
|
35
|
+
color: fuchsia;
|
36
|
+
}
|
37
|
+
|
38
|
+
em {
|
39
|
+
font-style: italic;
|
40
|
+
color: navy;
|
41
|
+
}
|
42
|
+
|
43
|
+
strong {
|
44
|
+
font-weight: bold;
|
45
|
+
color: #083194;
|
46
|
+
}
|
47
|
+
|
48
|
+
h1, h2, h3, h4, h5, h6 {
|
49
|
+
color: #527bbd;
|
50
|
+
margin-top: 1.2em;
|
51
|
+
margin-bottom: 0.5em;
|
52
|
+
line-height: 1.3;
|
53
|
+
}
|
54
|
+
|
55
|
+
h1, h2, h3 {
|
56
|
+
border-bottom: 2px solid silver;
|
57
|
+
}
|
58
|
+
h2 {
|
59
|
+
padding-top: 0.5em;
|
60
|
+
}
|
61
|
+
h3 {
|
62
|
+
float: left;
|
63
|
+
}
|
64
|
+
h3 + * {
|
65
|
+
clear: left;
|
66
|
+
}
|
67
|
+
h5 {
|
68
|
+
font-size: 1.0em;
|
69
|
+
}
|
70
|
+
|
71
|
+
div.sectionbody {
|
72
|
+
margin-left: 0;
|
73
|
+
}
|
74
|
+
|
75
|
+
hr {
|
76
|
+
border: 1px solid silver;
|
77
|
+
}
|
78
|
+
|
79
|
+
p {
|
80
|
+
margin-top: 0.5em;
|
81
|
+
margin-bottom: 0.5em;
|
82
|
+
}
|
83
|
+
|
84
|
+
ul, ol, li > p {
|
85
|
+
margin-top: 0;
|
86
|
+
}
|
87
|
+
ul > li { color: #aaa; }
|
88
|
+
ul > li > * { color: black; }
|
89
|
+
|
90
|
+
.monospaced, code, pre {
|
91
|
+
font-family: "Courier New", Courier, monospace;
|
92
|
+
font-size: inherit;
|
93
|
+
color: navy;
|
94
|
+
padding: 0;
|
95
|
+
margin: 0;
|
96
|
+
}
|
97
|
+
pre {
|
98
|
+
white-space: pre-wrap;
|
99
|
+
}
|
100
|
+
|
101
|
+
#author {
|
102
|
+
color: #527bbd;
|
103
|
+
font-weight: bold;
|
104
|
+
font-size: 1.1em;
|
105
|
+
}
|
106
|
+
#email {
|
107
|
+
}
|
108
|
+
#revnumber, #revdate, #revremark {
|
109
|
+
}
|
110
|
+
|
111
|
+
#footer {
|
112
|
+
font-size: small;
|
113
|
+
border-top: 2px solid silver;
|
114
|
+
padding-top: 0.5em;
|
115
|
+
margin-top: 4.0em;
|
116
|
+
}
|
117
|
+
#footer-text {
|
118
|
+
float: left;
|
119
|
+
padding-bottom: 0.5em;
|
120
|
+
}
|
121
|
+
#footer-badges {
|
122
|
+
float: right;
|
123
|
+
padding-bottom: 0.5em;
|
124
|
+
}
|
125
|
+
|
126
|
+
#preamble {
|
127
|
+
margin-top: 1.5em;
|
128
|
+
margin-bottom: 1.5em;
|
129
|
+
}
|
130
|
+
div.imageblock, div.exampleblock, div.verseblock,
|
131
|
+
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
|
132
|
+
div.admonitionblock {
|
133
|
+
margin-top: 1.0em;
|
134
|
+
margin-bottom: 1.5em;
|
135
|
+
}
|
136
|
+
div.admonitionblock {
|
137
|
+
margin-top: 2.0em;
|
138
|
+
margin-bottom: 2.0em;
|
139
|
+
margin-right: 10%;
|
140
|
+
color: #606060;
|
141
|
+
}
|
142
|
+
|
143
|
+
div.content { /* Block element content. */
|
144
|
+
padding: 0;
|
145
|
+
}
|
146
|
+
|
147
|
+
/* Block element titles. */
|
148
|
+
div.title, caption.title {
|
149
|
+
color: #527bbd;
|
150
|
+
font-weight: bold;
|
151
|
+
text-align: left;
|
152
|
+
margin-top: 1.0em;
|
153
|
+
margin-bottom: 0.5em;
|
154
|
+
}
|
155
|
+
div.title + * {
|
156
|
+
margin-top: 0;
|
157
|
+
}
|
158
|
+
|
159
|
+
td div.title:first-child {
|
160
|
+
margin-top: 0.0em;
|
161
|
+
}
|
162
|
+
div.content div.title:first-child {
|
163
|
+
margin-top: 0.0em;
|
164
|
+
}
|
165
|
+
div.content + div.title {
|
166
|
+
margin-top: 0.0em;
|
167
|
+
}
|
168
|
+
|
169
|
+
div.sidebarblock > div.content {
|
170
|
+
background: #ffffee;
|
171
|
+
border: 1px solid #dddddd;
|
172
|
+
border-left: 4px solid #f0f0f0;
|
173
|
+
padding: 0.5em;
|
174
|
+
}
|
175
|
+
|
176
|
+
div.listingblock > div.content {
|
177
|
+
border: 1px solid #dddddd;
|
178
|
+
border-left: 5px solid #f0f0f0;
|
179
|
+
background: #f8f8f8;
|
180
|
+
padding: 0.5em;
|
181
|
+
}
|
182
|
+
|
183
|
+
div.quoteblock, div.verseblock {
|
184
|
+
padding-left: 1.0em;
|
185
|
+
margin-left: 1.0em;
|
186
|
+
margin-right: 10%;
|
187
|
+
border-left: 5px solid #f0f0f0;
|
188
|
+
color: #888;
|
189
|
+
}
|
190
|
+
|
191
|
+
div.quoteblock > div.attribution {
|
192
|
+
padding-top: 0.5em;
|
193
|
+
text-align: right;
|
194
|
+
}
|
195
|
+
|
196
|
+
div.verseblock > pre.content {
|
197
|
+
font-family: inherit;
|
198
|
+
font-size: inherit;
|
199
|
+
}
|
200
|
+
div.verseblock > div.attribution {
|
201
|
+
padding-top: 0.75em;
|
202
|
+
text-align: left;
|
203
|
+
}
|
204
|
+
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
|
205
|
+
div.verseblock + div.attribution {
|
206
|
+
text-align: left;
|
207
|
+
}
|
208
|
+
|
209
|
+
div.admonitionblock .icon {
|
210
|
+
vertical-align: top;
|
211
|
+
font-size: 1.1em;
|
212
|
+
font-weight: bold;
|
213
|
+
text-decoration: underline;
|
214
|
+
color: #527bbd;
|
215
|
+
padding-right: 0.5em;
|
216
|
+
}
|
217
|
+
div.admonitionblock td.content {
|
218
|
+
padding-left: 0.5em;
|
219
|
+
border-left: 3px solid #dddddd;
|
220
|
+
}
|
221
|
+
|
222
|
+
div.exampleblock > div.content {
|
223
|
+
border-left: 3px solid #dddddd;
|
224
|
+
padding-left: 0.5em;
|
225
|
+
}
|
226
|
+
|
227
|
+
div.imageblock div.content { padding-left: 0; }
|
228
|
+
span.image img { border-style: none; vertical-align: text-bottom; }
|
229
|
+
a.image:visited { color: white; }
|
230
|
+
|
231
|
+
dl {
|
232
|
+
margin-top: 0.8em;
|
233
|
+
margin-bottom: 0.8em;
|
234
|
+
}
|
235
|
+
dt {
|
236
|
+
margin-top: 0.5em;
|
237
|
+
margin-bottom: 0;
|
238
|
+
font-style: normal;
|
239
|
+
color: navy;
|
240
|
+
}
|
241
|
+
dd > *:first-child {
|
242
|
+
margin-top: 0.1em;
|
243
|
+
}
|
244
|
+
|
245
|
+
ul, ol {
|
246
|
+
list-style-position: outside;
|
247
|
+
}
|
248
|
+
ol.arabic {
|
249
|
+
list-style-type: decimal;
|
250
|
+
}
|
251
|
+
ol.loweralpha {
|
252
|
+
list-style-type: lower-alpha;
|
253
|
+
}
|
254
|
+
ol.upperalpha {
|
255
|
+
list-style-type: upper-alpha;
|
256
|
+
}
|
257
|
+
ol.lowerroman {
|
258
|
+
list-style-type: lower-roman;
|
259
|
+
}
|
260
|
+
ol.upperroman {
|
261
|
+
list-style-type: upper-roman;
|
262
|
+
}
|
263
|
+
|
264
|
+
div.compact ul, div.compact ol,
|
265
|
+
div.compact p, div.compact p,
|
266
|
+
div.compact div, div.compact div {
|
267
|
+
margin-top: 0.1em;
|
268
|
+
margin-bottom: 0.1em;
|
269
|
+
}
|
270
|
+
|
271
|
+
tfoot {
|
272
|
+
font-weight: bold;
|
273
|
+
}
|
274
|
+
td > div.verse {
|
275
|
+
white-space: pre;
|
276
|
+
}
|
277
|
+
|
278
|
+
div.hdlist {
|
279
|
+
margin-top: 0.8em;
|
280
|
+
margin-bottom: 0.8em;
|
281
|
+
}
|
282
|
+
div.hdlist tr {
|
283
|
+
padding-bottom: 15px;
|
284
|
+
}
|
285
|
+
dt.hdlist1.strong, td.hdlist1.strong {
|
286
|
+
font-weight: bold;
|
287
|
+
}
|
288
|
+
td.hdlist1 {
|
289
|
+
vertical-align: top;
|
290
|
+
font-style: normal;
|
291
|
+
padding-right: 0.8em;
|
292
|
+
color: navy;
|
293
|
+
}
|
294
|
+
td.hdlist2 {
|
295
|
+
vertical-align: top;
|
296
|
+
}
|
297
|
+
div.hdlist.compact tr {
|
298
|
+
margin: 0;
|
299
|
+
padding-bottom: 0;
|
300
|
+
}
|
301
|
+
|
302
|
+
.comment {
|
303
|
+
background: yellow;
|
304
|
+
}
|
305
|
+
|
306
|
+
.footnote, .footnoteref {
|
307
|
+
font-size: 0.8em;
|
308
|
+
}
|
309
|
+
|
310
|
+
span.footnote, span.footnoteref {
|
311
|
+
vertical-align: super;
|
312
|
+
}
|
313
|
+
|
314
|
+
#footnotes {
|
315
|
+
margin: 20px 0 20px 0;
|
316
|
+
padding: 7px 0 0 0;
|
317
|
+
}
|
318
|
+
|
319
|
+
#footnotes div.footnote {
|
320
|
+
margin: 0 0 5px 0;
|
321
|
+
}
|
322
|
+
|
323
|
+
#footnotes hr {
|
324
|
+
border: none;
|
325
|
+
border-top: 1px solid silver;
|
326
|
+
height: 1px;
|
327
|
+
text-align: left;
|
328
|
+
margin-left: 0;
|
329
|
+
width: 20%;
|
330
|
+
min-width: 100px;
|
331
|
+
}
|
332
|
+
|
333
|
+
div.colist td {
|
334
|
+
padding-right: 0.5em;
|
335
|
+
padding-bottom: 0.3em;
|
336
|
+
vertical-align: top;
|
337
|
+
}
|
338
|
+
div.colist td img {
|
339
|
+
margin-top: 0.3em;
|
340
|
+
}
|
341
|
+
|
342
|
+
@media print {
|
343
|
+
#footer-badges { display: none; }
|
344
|
+
}
|
345
|
+
|
346
|
+
#toc {
|
347
|
+
margin-bottom: 2.5em;
|
348
|
+
}
|
349
|
+
|
350
|
+
#toctitle {
|
351
|
+
color: #527bbd;
|
352
|
+
font-size: 1.1em;
|
353
|
+
font-weight: bold;
|
354
|
+
margin-top: 1.0em;
|
355
|
+
margin-bottom: 0.1em;
|
356
|
+
}
|
357
|
+
|
358
|
+
div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
|
359
|
+
margin-top: 0;
|
360
|
+
margin-bottom: 0;
|
361
|
+
}
|
362
|
+
div.toclevel2 {
|
363
|
+
margin-left: 2em;
|
364
|
+
font-size: 0.9em;
|
365
|
+
}
|
366
|
+
div.toclevel3 {
|
367
|
+
margin-left: 4em;
|
368
|
+
font-size: 0.9em;
|
369
|
+
}
|
370
|
+
div.toclevel4 {
|
371
|
+
margin-left: 6em;
|
372
|
+
font-size: 0.9em;
|
373
|
+
}
|
374
|
+
|
375
|
+
span.aqua { color: aqua; }
|
376
|
+
span.black { color: black; }
|
377
|
+
span.blue { color: blue; }
|
378
|
+
span.fuchsia { color: fuchsia; }
|
379
|
+
span.gray { color: gray; }
|
380
|
+
span.green { color: green; }
|
381
|
+
span.lime { color: lime; }
|
382
|
+
span.maroon { color: maroon; }
|
383
|
+
span.navy { color: navy; }
|
384
|
+
span.olive { color: olive; }
|
385
|
+
span.purple { color: purple; }
|
386
|
+
span.red { color: red; }
|
387
|
+
span.silver { color: silver; }
|
388
|
+
span.teal { color: teal; }
|
389
|
+
span.white { color: white; }
|
390
|
+
span.yellow { color: yellow; }
|
391
|
+
|
392
|
+
span.aqua-background { background: aqua; }
|
393
|
+
span.black-background { background: black; }
|
394
|
+
span.blue-background { background: blue; }
|
395
|
+
span.fuchsia-background { background: fuchsia; }
|
396
|
+
span.gray-background { background: gray; }
|
397
|
+
span.green-background { background: green; }
|
398
|
+
span.lime-background { background: lime; }
|
399
|
+
span.maroon-background { background: maroon; }
|
400
|
+
span.navy-background { background: navy; }
|
401
|
+
span.olive-background { background: olive; }
|
402
|
+
span.purple-background { background: purple; }
|
403
|
+
span.red-background { background: red; }
|
404
|
+
span.silver-background { background: silver; }
|
405
|
+
span.teal-background { background: teal; }
|
406
|
+
span.white-background { background: white; }
|
407
|
+
span.yellow-background { background: yellow; }
|
408
|
+
|
409
|
+
span.big { font-size: 2em; }
|
410
|
+
span.small { font-size: 0.6em; }
|
411
|
+
|
412
|
+
span.underline { text-decoration: underline; }
|
413
|
+
span.overline { text-decoration: overline; }
|
414
|
+
span.line-through { text-decoration: line-through; }
|
415
|
+
|
416
|
+
div.unbreakable { page-break-inside: avoid; }
|
417
|
+
|
418
|
+
|
419
|
+
/*
|
420
|
+
* xhtml11 specific
|
421
|
+
*
|
422
|
+
* */
|
423
|
+
|
424
|
+
div.tableblock {
|
425
|
+
margin-top: 1.0em;
|
426
|
+
margin-bottom: 1.5em;
|
427
|
+
}
|
428
|
+
div.tableblock > table {
|
429
|
+
border: 3px solid #527bbd;
|
430
|
+
}
|
431
|
+
thead, p.table.header {
|
432
|
+
font-weight: bold;
|
433
|
+
color: #527bbd;
|
434
|
+
}
|
435
|
+
p.table {
|
436
|
+
margin-top: 0;
|
437
|
+
}
|
438
|
+
/* Because the table frame attribute is overriden by CSS in most browsers. */
|
439
|
+
div.tableblock > table[frame="void"] {
|
440
|
+
border-style: none;
|
441
|
+
}
|
442
|
+
div.tableblock > table[frame="hsides"] {
|
443
|
+
border-left-style: none;
|
444
|
+
border-right-style: none;
|
445
|
+
}
|
446
|
+
div.tableblock > table[frame="vsides"] {
|
447
|
+
border-top-style: none;
|
448
|
+
border-bottom-style: none;
|
449
|
+
}
|
450
|
+
|
451
|
+
|
452
|
+
/*
|
453
|
+
* html5 specific
|
454
|
+
*
|
455
|
+
* */
|
456
|
+
|
457
|
+
table.tableblock {
|
458
|
+
margin-top: 1.0em;
|
459
|
+
margin-bottom: 1.5em;
|
460
|
+
}
|
461
|
+
thead, p.tableblock.header {
|
462
|
+
font-weight: bold;
|
463
|
+
color: #527bbd;
|
464
|
+
}
|
465
|
+
p.tableblock {
|
466
|
+
margin-top: 0;
|
467
|
+
}
|
468
|
+
table.tableblock {
|
469
|
+
border-width: 3px;
|
470
|
+
border-spacing: 0px;
|
471
|
+
border-style: solid;
|
472
|
+
border-color: #527bbd;
|
473
|
+
border-collapse: collapse;
|
474
|
+
}
|
475
|
+
th.tableblock, td.tableblock {
|
476
|
+
border-width: 1px;
|
477
|
+
padding: 4px;
|
478
|
+
border-style: solid;
|
479
|
+
border-color: #527bbd;
|
480
|
+
}
|
481
|
+
|
482
|
+
table.tableblock.frame-topbot {
|
483
|
+
border-left-style: hidden;
|
484
|
+
border-right-style: hidden;
|
485
|
+
}
|
486
|
+
table.tableblock.frame-sides {
|
487
|
+
border-top-style: hidden;
|
488
|
+
border-bottom-style: hidden;
|
489
|
+
}
|
490
|
+
table.tableblock.frame-none {
|
491
|
+
border-style: hidden;
|
492
|
+
}
|
493
|
+
|
494
|
+
th.tableblock.halign-left, td.tableblock.halign-left {
|
495
|
+
text-align: left;
|
496
|
+
}
|
497
|
+
th.tableblock.halign-center, td.tableblock.halign-center {
|
498
|
+
text-align: center;
|
499
|
+
}
|
500
|
+
th.tableblock.halign-right, td.tableblock.halign-right {
|
501
|
+
text-align: right;
|
502
|
+
}
|
503
|
+
|
504
|
+
th.tableblock.valign-top, td.tableblock.valign-top {
|
505
|
+
vertical-align: top;
|
506
|
+
}
|
507
|
+
th.tableblock.valign-middle, td.tableblock.valign-middle {
|
508
|
+
vertical-align: middle;
|
509
|
+
}
|
510
|
+
th.tableblock.valign-bottom, td.tableblock.valign-bottom {
|
511
|
+
vertical-align: bottom;
|
512
|
+
}
|
513
|
+
|
514
|
+
|
515
|
+
/*
|
516
|
+
* manpage specific
|
517
|
+
*
|
518
|
+
* */
|
519
|
+
|
520
|
+
body.manpage h1 {
|
521
|
+
padding-top: 0.5em;
|
522
|
+
padding-bottom: 0.5em;
|
523
|
+
border-top: 2px solid silver;
|
524
|
+
border-bottom: 2px solid silver;
|
525
|
+
}
|
526
|
+
body.manpage h2 {
|
527
|
+
border-style: none;
|
528
|
+
}
|
529
|
+
body.manpage div.sectionbody {
|
530
|
+
margin-left: 3em;
|
531
|
+
}
|
532
|
+
|
533
|
+
@media print {
|
534
|
+
body.manpage div#toc { display: none; }
|
535
|
+
}
|
536
|
+
|
537
|
+
|
538
|
+
div.listingblock > div.content {
|
539
|
+
background: rgb(28, 28, 28);
|
540
|
+
}
|
541
|
+
|
542
|
+
div.listingblock > div > pre > code {
|
543
|
+
color: rgb(187, 187, 187);
|
544
|
+
}
|
545
|
+
</style>
|
546
|
+
<script type="text/javascript">
|
547
|
+
/*<![CDATA[*/
|
548
|
+
var asciidoc = { // Namespace.
|
549
|
+
|
550
|
+
/////////////////////////////////////////////////////////////////////
|
551
|
+
// Table Of Contents generator
|
552
|
+
/////////////////////////////////////////////////////////////////////
|
553
|
+
|
554
|
+
/* Author: Mihai Bazon, September 2002
|
555
|
+
* http://students.infoiasi.ro/~mishoo
|
556
|
+
*
|
557
|
+
* Table Of Content generator
|
558
|
+
* Version: 0.4
|
559
|
+
*
|
560
|
+
* Feel free to use this script under the terms of the GNU General Public
|
561
|
+
* License, as long as you do not remove or alter this notice.
|
562
|
+
*/
|
563
|
+
|
564
|
+
/* modified by Troy D. Hanson, September 2006. License: GPL */
|
565
|
+
/* modified by Stuart Rackham, 2006, 2009. License: GPL */
|
566
|
+
|
567
|
+
// toclevels = 1..4.
|
568
|
+
toc: function (toclevels) {
|
569
|
+
|
570
|
+
function getText(el) {
|
571
|
+
var text = "";
|
572
|
+
for (var i = el.firstChild; i != null; i = i.nextSibling) {
|
573
|
+
if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
|
574
|
+
text += i.data;
|
575
|
+
else if (i.firstChild != null)
|
576
|
+
text += getText(i);
|
577
|
+
}
|
578
|
+
return text;
|
579
|
+
}
|
580
|
+
|
581
|
+
function TocEntry(el, text, toclevel) {
|
582
|
+
this.element = el;
|
583
|
+
this.text = text;
|
584
|
+
this.toclevel = toclevel;
|
585
|
+
}
|
586
|
+
|
587
|
+
function tocEntries(el, toclevels) {
|
588
|
+
var result = new Array;
|
589
|
+
var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
|
590
|
+
// Function that scans the DOM tree for header elements (the DOM2
|
591
|
+
// nodeIterator API would be a better technique but not supported by all
|
592
|
+
// browsers).
|
593
|
+
var iterate = function (el) {
|
594
|
+
for (var i = el.firstChild; i != null; i = i.nextSibling) {
|
595
|
+
if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
|
596
|
+
var mo = re.exec(i.tagName);
|
597
|
+
if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
|
598
|
+
result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
|
599
|
+
}
|
600
|
+
iterate(i);
|
601
|
+
}
|
602
|
+
}
|
603
|
+
}
|
604
|
+
iterate(el);
|
605
|
+
return result;
|
606
|
+
}
|
607
|
+
|
608
|
+
var toc = document.getElementById("toc");
|
609
|
+
if (!toc) {
|
610
|
+
return;
|
611
|
+
}
|
612
|
+
|
613
|
+
// Delete existing TOC entries in case we're reloading the TOC.
|
614
|
+
var tocEntriesToRemove = [];
|
615
|
+
var i;
|
616
|
+
for (i = 0; i < toc.childNodes.length; i++) {
|
617
|
+
var entry = toc.childNodes[i];
|
618
|
+
if (entry.nodeName.toLowerCase() == 'div'
|
619
|
+
&& entry.getAttribute("class")
|
620
|
+
&& entry.getAttribute("class").match(/^toclevel/))
|
621
|
+
tocEntriesToRemove.push(entry);
|
622
|
+
}
|
623
|
+
for (i = 0; i < tocEntriesToRemove.length; i++) {
|
624
|
+
toc.removeChild(tocEntriesToRemove[i]);
|
625
|
+
}
|
626
|
+
|
627
|
+
// Rebuild TOC entries.
|
628
|
+
var entries = tocEntries(document.getElementById("content"), toclevels);
|
629
|
+
for (var i = 0; i < entries.length; ++i) {
|
630
|
+
var entry = entries[i];
|
631
|
+
if (entry.element.id == "")
|
632
|
+
entry.element.id = "_toc_" + i;
|
633
|
+
var a = document.createElement("a");
|
634
|
+
a.href = "#" + entry.element.id;
|
635
|
+
a.appendChild(document.createTextNode(entry.text));
|
636
|
+
var div = document.createElement("div");
|
637
|
+
div.appendChild(a);
|
638
|
+
div.className = "toclevel" + entry.toclevel;
|
639
|
+
toc.appendChild(div);
|
640
|
+
}
|
641
|
+
if (entries.length == 0)
|
642
|
+
toc.parentNode.removeChild(toc);
|
643
|
+
},
|
644
|
+
|
645
|
+
|
646
|
+
/////////////////////////////////////////////////////////////////////
|
647
|
+
// Footnotes generator
|
648
|
+
/////////////////////////////////////////////////////////////////////
|
649
|
+
|
650
|
+
/* Based on footnote generation code from:
|
651
|
+
* http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
|
652
|
+
*/
|
653
|
+
|
654
|
+
footnotes: function () {
|
655
|
+
// Delete existing footnote entries in case we're reloading the footnodes.
|
656
|
+
var i;
|
657
|
+
var noteholder = document.getElementById("footnotes");
|
658
|
+
if (!noteholder) {
|
659
|
+
return;
|
660
|
+
}
|
661
|
+
var entriesToRemove = [];
|
662
|
+
for (i = 0; i < noteholder.childNodes.length; i++) {
|
663
|
+
var entry = noteholder.childNodes[i];
|
664
|
+
if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
|
665
|
+
entriesToRemove.push(entry);
|
666
|
+
}
|
667
|
+
for (i = 0; i < entriesToRemove.length; i++) {
|
668
|
+
noteholder.removeChild(entriesToRemove[i]);
|
669
|
+
}
|
670
|
+
|
671
|
+
// Rebuild footnote entries.
|
672
|
+
var cont = document.getElementById("content");
|
673
|
+
var spans = cont.getElementsByTagName("span");
|
674
|
+
var refs = {};
|
675
|
+
var n = 0;
|
676
|
+
for (i=0; i<spans.length; i++) {
|
677
|
+
if (spans[i].className == "footnote") {
|
678
|
+
n++;
|
679
|
+
var note = spans[i].getAttribute("data-note");
|
680
|
+
if (!note) {
|
681
|
+
// Use [\s\S] in place of . so multi-line matches work.
|
682
|
+
// Because JavaScript has no s (dotall) regex flag.
|
683
|
+
note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
|
684
|
+
spans[i].innerHTML =
|
685
|
+
"[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
|
686
|
+
"' title='View footnote' class='footnote'>" + n + "</a>]";
|
687
|
+
spans[i].setAttribute("data-note", note);
|
688
|
+
}
|
689
|
+
noteholder.innerHTML +=
|
690
|
+
"<div class='footnote' id='_footnote_" + n + "'>" +
|
691
|
+
"<a href='#_footnoteref_" + n + "' title='Return to text'>" +
|
692
|
+
n + "</a>. " + note + "</div>";
|
693
|
+
var id =spans[i].getAttribute("id");
|
694
|
+
if (id != null) refs["#"+id] = n;
|
695
|
+
}
|
696
|
+
}
|
697
|
+
if (n == 0)
|
698
|
+
noteholder.parentNode.removeChild(noteholder);
|
699
|
+
else {
|
700
|
+
// Process footnoterefs.
|
701
|
+
for (i=0; i<spans.length; i++) {
|
702
|
+
if (spans[i].className == "footnoteref") {
|
703
|
+
var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
|
704
|
+
href = href.match(/#.*/)[0]; // Because IE return full URL.
|
705
|
+
n = refs[href];
|
706
|
+
spans[i].innerHTML =
|
707
|
+
"[<a href='#_footnote_" + n +
|
708
|
+
"' title='View footnote' class='footnote'>" + n + "</a>]";
|
709
|
+
}
|
710
|
+
}
|
711
|
+
}
|
712
|
+
},
|
713
|
+
|
714
|
+
install: function(toclevels) {
|
715
|
+
var timerId;
|
716
|
+
|
717
|
+
function reinstall() {
|
718
|
+
asciidoc.footnotes();
|
719
|
+
if (toclevels) {
|
720
|
+
asciidoc.toc(toclevels);
|
721
|
+
}
|
722
|
+
}
|
723
|
+
|
724
|
+
function reinstallAndRemoveTimer() {
|
725
|
+
clearInterval(timerId);
|
726
|
+
reinstall();
|
727
|
+
}
|
728
|
+
|
729
|
+
timerId = setInterval(reinstall, 500);
|
730
|
+
if (document.addEventListener)
|
731
|
+
document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
|
732
|
+
else
|
733
|
+
window.onload = reinstallAndRemoveTimer;
|
734
|
+
}
|
735
|
+
|
736
|
+
}
|
737
|
+
asciidoc.install();
|
738
|
+
/*]]>*/
|
739
|
+
</script>
|
740
|
+
</head>
|
741
|
+
<body class="manpage">
|
742
|
+
<div id="header">
|
743
|
+
<h1>
|
744
|
+
depot_tools_tutorial(7) Manual Page
|
745
|
+
</h1>
|
746
|
+
<h2>NAME</h2>
|
747
|
+
<div class="sectionbody">
|
748
|
+
<p>depot_tools_tutorial -
|
749
|
+
A tutorial introduction to the Chromium depot_tools git extensions.
|
750
|
+
</p>
|
751
|
+
</div>
|
752
|
+
</div>
|
753
|
+
<div id="content">
|
754
|
+
<div class="sect1">
|
755
|
+
<h2 id="_description">DESCRIPTION</h2>
|
756
|
+
<div class="sectionbody">
|
757
|
+
<div class="paragraph"><p>The Chromium <a href="depot_tools.html">depot_tools(7)</a> suite contains many git workflow-enhancing
|
758
|
+
tools which are designed to work together to enable anyone to wrangle the
|
759
|
+
Chromium codebase expertly. This tutorial explains how to do development on
|
760
|
+
Chromium using these tools. This will cover:</p></div>
|
761
|
+
<div class="ulist"><ul>
|
762
|
+
<li>
|
763
|
+
<p>
|
764
|
+
<a href="#_setting_up">Setting up</a>
|
765
|
+
</p>
|
766
|
+
</li>
|
767
|
+
<li>
|
768
|
+
<p>
|
769
|
+
<a href="#_getting_the_code">Getting the code</a>
|
770
|
+
</p>
|
771
|
+
</li>
|
772
|
+
<li>
|
773
|
+
<p>
|
774
|
+
<a href="#_tl_dr">TL;DR</a>
|
775
|
+
</p>
|
776
|
+
</li>
|
777
|
+
<li>
|
778
|
+
<p>
|
779
|
+
<a href="#_creating_uploading_a_cl">Creating / Uploading a CL</a>
|
780
|
+
</p>
|
781
|
+
</li>
|
782
|
+
<li>
|
783
|
+
<p>
|
784
|
+
<a href="#_updating_the_code">Updating the code</a>
|
785
|
+
</p>
|
786
|
+
</li>
|
787
|
+
<li>
|
788
|
+
<p>
|
789
|
+
<a href="#_managing_multiple_cls">Managing multiple CLs</a>
|
790
|
+
</p>
|
791
|
+
</li>
|
792
|
+
<li>
|
793
|
+
<p>
|
794
|
+
<a href="#_managing_dependent_cls">Managing dependent CLs</a>
|
795
|
+
</p>
|
796
|
+
</li>
|
797
|
+
<li>
|
798
|
+
<p>
|
799
|
+
<a href="#_example_walkthrough">Example Walkthrough</a>
|
800
|
+
</p>
|
801
|
+
</li>
|
802
|
+
</ul></div>
|
803
|
+
<div class="paragraph"><p>Please refer to the manpages (or <code>--help</code> output) for details about any of the
|
804
|
+
commands mentioned in this tutorial.</p></div>
|
805
|
+
<div class="admonitionblock">
|
806
|
+
<table><tr>
|
807
|
+
<td class="icon">
|
808
|
+
<div class="title">Note</div>
|
809
|
+
</td>
|
810
|
+
<td class="content">If your platform does not support manpages (or you prefer something a bit more
|
811
|
+
expressive than plain text) you can find all documentation in <em>html</em> form in the
|
812
|
+
<code>[DEPOT_TOOLS]/man/html</code> folder.</td>
|
813
|
+
</tr></table>
|
814
|
+
</div>
|
815
|
+
<div class="sect2">
|
816
|
+
<h3 id="_prerequisites">PREREQUISITES</h3>
|
817
|
+
<div class="paragraph"><p>This tutorial assumes basic familiarity with git terminology and concepts. If you
|
818
|
+
need to brush up on these, the following are very good resources:</p></div>
|
819
|
+
<div class="ulist"><ul>
|
820
|
+
<li>
|
821
|
+
<p>
|
822
|
+
<a href="http://think-like-a-git.net/">Think like (a) Git</a> - A lighthearted
|
823
|
+
overview of git. If you’re sorta-familiar with git, but not <em>comfortable</em> with
|
824
|
+
it, then give this a look.
|
825
|
+
</p>
|
826
|
+
</li>
|
827
|
+
<li>
|
828
|
+
<p>
|
829
|
+
<a href="http://gitimmersion.com/">Git Immersion Tutorial</a> - An in-depth git
|
830
|
+
tutorial.
|
831
|
+
</p>
|
832
|
+
</li>
|
833
|
+
<li>
|
834
|
+
<p>
|
835
|
+
<a href="http://pcottle.github.io/learnGitBranching">pcottle’s Visual Git
|
836
|
+
Branching</a> - An excellent interactive/graphical demo on how git handles
|
837
|
+
commits, branches, and shows the operations git performs on them.
|
838
|
+
</p>
|
839
|
+
</li>
|
840
|
+
<li>
|
841
|
+
<p>
|
842
|
+
<a href="http://git-scm.com/book">Pro Git book</a> - “The” book for learning git
|
843
|
+
from basics to advanced concepts. A bit dry, but very through.
|
844
|
+
</p>
|
845
|
+
</li>
|
846
|
+
</ul></div>
|
847
|
+
<div class="paragraph"><p>If you’ve tried these out and are still having some trouble getting started,
|
848
|
+
there are <em>many</em> other resources online which should help. If you’re <em>really</em>
|
849
|
+
<strong><em>really</em></strong> stuck, then chat up one of the Chromium infrastructure team
|
850
|
+
members for some pointers.</p></div>
|
851
|
+
<div class="dlist"><dl>
|
852
|
+
<dt class="hdlist1">
|
853
|
+
Litmus Test
|
854
|
+
</dt>
|
855
|
+
<dd>
|
856
|
+
<p>
|
857
|
+
If you know what <code>git add</code>, <code>git status</code>, <code>git commit</code> do and you know
|
858
|
+
<em>essentially</em> what <code>git rebase</code> does, then you should know enough to follow
|
859
|
+
along.
|
860
|
+
</p>
|
861
|
+
</dd>
|
862
|
+
</dl></div>
|
863
|
+
</div>
|
864
|
+
</div>
|
865
|
+
</div>
|
866
|
+
<div class="sect1">
|
867
|
+
<h2 id="_setting_up">SETTING UP</h2>
|
868
|
+
<div class="sectionbody">
|
869
|
+
<div class="sect2">
|
870
|
+
<h3 id="_get_depot_tools">GET DEPOT TOOLS</h3>
|
871
|
+
<div class="sect3">
|
872
|
+
<h4 id="_linux_mac">LINUX / MAC</h4>
|
873
|
+
<div class="paragraph"><p>Clone the <em>depot_tools</em> repository:</p></div>
|
874
|
+
<div class="listingblock">
|
875
|
+
<div class="content">
|
876
|
+
<pre><code><strong><span class="white">$ git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git</span></strong></code></pre>
|
877
|
+
</div></div>
|
878
|
+
<div class="paragraph"><p>Add <em>depot_tools</em> to the <em>front</em> of your PATH (you will probably want to put this
|
879
|
+
in your <code>~/.bashrc</code> or <code>~/.zshrc</code>). Assuming you cloned <em>depot_tools</em> to
|
880
|
+
<code>/path/to/depot_tools</code>:</p></div>
|
881
|
+
<div class="listingblock">
|
882
|
+
<div class="content">
|
883
|
+
<pre><code><strong><span class="white">$ export PATH=/path/to/depot_tools:$PATH</span></strong></code></pre>
|
884
|
+
</div></div>
|
885
|
+
</div>
|
886
|
+
<div class="sect3">
|
887
|
+
<h4 id="_windows">WINDOWS</h4>
|
888
|
+
<div class="paragraph"><p>Download the <em>depot_tools</em>
|
889
|
+
<a href="https://storage.googleapis.com/chrome-infra/depot_tools.zip">bundle</a> and
|
890
|
+
extract it somewhere.</p></div>
|
891
|
+
<div class="admonitionblock">
|
892
|
+
<table><tr>
|
893
|
+
<td class="icon">
|
894
|
+
<div class="title">Warning</div>
|
895
|
+
</td>
|
896
|
+
<td class="content"><strong>DO NOT</strong> use drag-n-drop or copy-n-paste extract from Explorer, this will not
|
897
|
+
extract the hidden “.git” folder which is necessary for <em>depot_tools</em> to
|
898
|
+
autoupdate itself. You can use “Extract all…” from the context menu though.</td>
|
899
|
+
</tr></table>
|
900
|
+
</div>
|
901
|
+
<div class="paragraph"><p>Add <em>depot_tools</em> to the <em>front</em> of your PATH (must be ahead of any installs of
|
902
|
+
Python). Assuming you unzipped the bundle to <code>C:\workspace\depot_tools</code>:</p></div>
|
903
|
+
<div class="dlist"><dl>
|
904
|
+
<dt class="hdlist1">
|
905
|
+
With Administrator access:
|
906
|
+
</dt>
|
907
|
+
<dd>
|
908
|
+
<p>
|
909
|
+
<strong>Control Panel → System and Security → System → Advanced system settings</strong>
|
910
|
+
</p>
|
911
|
+
<div class="paragraph"><p>Modify the PATH system variable to include <code>C:\workspace\depot_tools</code>.</p></div>
|
912
|
+
</dd>
|
913
|
+
<dt class="hdlist1">
|
914
|
+
Without Administrator access:
|
915
|
+
</dt>
|
916
|
+
<dd>
|
917
|
+
<p>
|
918
|
+
<strong>Control Panel → User Accounts → User Accounts → Change my environment variables</strong>
|
919
|
+
</p>
|
920
|
+
<div class="paragraph"><p>Add a PATH user variable: <code>C:\workspace\depot_tools;%PATH%</code>.</p></div>
|
921
|
+
</dd>
|
922
|
+
</dl></div>
|
923
|
+
<div class="paragraph"><p>From a <code>cmd.exe</code> shell, run the command <code>gclient</code> (without arguments). On first
|
924
|
+
run, gclient will install all the Windows-specific bits needed to work with the
|
925
|
+
code, including msysgit and python.</p></div>
|
926
|
+
<div class="admonitionblock">
|
927
|
+
<table><tr>
|
928
|
+
<td class="icon">
|
929
|
+
<div class="title">Note</div>
|
930
|
+
</td>
|
931
|
+
<td class="content">
|
932
|
+
<div class="ulist"><ul>
|
933
|
+
<li>
|
934
|
+
<p>
|
935
|
+
If you run gclient from a non-cmd shell (e.g., cygwin, PowerShell), it
|
936
|
+
may appear to run properly, but msysgit, python, and other tools may not get
|
937
|
+
installed correctly.
|
938
|
+
</p>
|
939
|
+
</li>
|
940
|
+
<li>
|
941
|
+
<p>
|
942
|
+
If you see strange errors with the file system on the first run of gclient,
|
943
|
+
you may want to <a href="http://tortoisesvn.tigris.org/faq.html#cantmove2">disable
|
944
|
+
Windows Indexing</a>.
|
945
|
+
</p>
|
946
|
+
</li>
|
947
|
+
<li>
|
948
|
+
<p>
|
949
|
+
After running gclient open a command prompt and type <code>where python</code> and confirm that
|
950
|
+
the depot_tools python.bat comes ahead of any copies of python.exe. Failing to ensure
|
951
|
+
this can lead to overbuilding when using gn - see
|
952
|
+
<a href="https://bugs.chromium.org/p/chromium/issues/detail?id=611087">crbug.com/611087</a>.
|
953
|
+
</p>
|
954
|
+
</li>
|
955
|
+
</ul></div>
|
956
|
+
</td>
|
957
|
+
</tr></table>
|
958
|
+
</div>
|
959
|
+
</div>
|
960
|
+
</div>
|
961
|
+
<div class="sect2">
|
962
|
+
<h3 id="_bootstrapping_configuration">BOOTSTRAPPING CONFIGURATION</h3>
|
963
|
+
<div class="paragraph"><p>If you have never used git before, you’ll need to set some global git
|
964
|
+
configurations; substitute your name and email address in the following
|
965
|
+
commands:</p></div>
|
966
|
+
<div class="listingblock">
|
967
|
+
<div class="content">
|
968
|
+
<pre><code><strong><span class="white">$ git config --global user.name "John Doe"</span></strong>
|
969
|
+
<strong><span class="white">$ git config --global user.email "jdoe@email.com"</span></strong>
|
970
|
+
<strong><span class="white">$ git config --global core.autocrlf false</span></strong>
|
971
|
+
<strong><span class="white">$ git config --global core.filemode false</span></strong>
|
972
|
+
<strong><span class="white">$</span></strong> # and for fun!
|
973
|
+
<strong><span class="white">$ git config --global color.ui true</span></strong></code></pre>
|
974
|
+
</div></div>
|
975
|
+
</div>
|
976
|
+
</div>
|
977
|
+
</div>
|
978
|
+
<div class="sect1">
|
979
|
+
<h2 id="_tl_dr">TL;DR</h2>
|
980
|
+
<div class="sectionbody">
|
981
|
+
<div class="listingblock">
|
982
|
+
<div class="content">
|
983
|
+
<pre><code><strong><span class="white">$</span></strong> # get the code
|
984
|
+
<strong><span class="white">$</span></strong> # In an empty directory:
|
985
|
+
<strong><span class="white">$ fetch {chromium,...}</span></strong>
|
986
|
+
|
987
|
+
<strong><span class="white">$</span></strong> # Update third_party repos and run pre-compile hooks
|
988
|
+
<strong><span class="white">$ gclient sync</span></strong>
|
989
|
+
|
990
|
+
<strong><span class="white">$</span></strong> # Make a new change and upload it for review
|
991
|
+
<strong><span class="white">$ git new-branch <branch_name></span></strong>
|
992
|
+
<strong><span class="white">$</span></strong> # repeat: [edit, git add, git commit]
|
993
|
+
<strong><span class="white">$ git cl upload</span></strong>
|
994
|
+
|
995
|
+
<strong><span class="white">$</span></strong> # After change is reviewed, commit with the CQ
|
996
|
+
<strong><span class="white">$ git cl set_commit</span></strong>
|
997
|
+
<strong><span class="white">$</span></strong> # Note that the committed hash which lands will /not/ match the
|
998
|
+
<strong><span class="white">$</span></strong> # commit hashes of your local branch.</code></pre>
|
999
|
+
</div></div>
|
1000
|
+
</div>
|
1001
|
+
</div>
|
1002
|
+
<div class="sect1">
|
1003
|
+
<h2 id="_getting_the_code">GETTING THE CODE</h2>
|
1004
|
+
<div class="sectionbody">
|
1005
|
+
<div class="paragraph"><p>Pick an empty directory and run one of the following:</p></div>
|
1006
|
+
<div class="listingblock">
|
1007
|
+
<div class="content">
|
1008
|
+
<pre><code><strong><span class="white">$ fetch chromium</span></strong> # Basic checkout for desktop Chromium
|
1009
|
+
<strong><span class="white">$ fetch android</span></strong> # Chromium checkout for Android platform
|
1010
|
+
<strong><span class="white">$ fetch ios</span></strong> # Chromium checkout for iOS platform</code></pre>
|
1011
|
+
</div></div>
|
1012
|
+
<div class="paragraph"><p>When the <code>fetch</code> tool completes you should have the following in your working
|
1013
|
+
directory:</p></div>
|
1014
|
+
<div class="listingblock">
|
1015
|
+
<div class="content">
|
1016
|
+
<pre><code><strong><span class="white">.gclient</span></strong> # A configuration file for you source checkout
|
1017
|
+
<strong><span class="white">src/</span></strong> # Top-level Chromium source checkout.</code></pre>
|
1018
|
+
</div></div>
|
1019
|
+
<div class="paragraph"><p>If you are on linux and fetching the code for the first time, then you’ll need
|
1020
|
+
to run:</p></div>
|
1021
|
+
<div class="listingblock">
|
1022
|
+
<div class="content">
|
1023
|
+
<pre><code><strong><span class="white">$ cd src && ./build/install-build-deps.sh</span></strong></code></pre>
|
1024
|
+
</div></div>
|
1025
|
+
<div class="paragraph"><p>And finally:</p></div>
|
1026
|
+
<div class="listingblock">
|
1027
|
+
<div class="content">
|
1028
|
+
<pre><code><strong><span class="white">$ gclient sync</span></strong></code></pre>
|
1029
|
+
</div></div>
|
1030
|
+
<div class="paragraph"><p>This will pull all dependencies of the Chromium src checkout. You will need
|
1031
|
+
to run this any time you update the main src checkout, including when you
|
1032
|
+
switch branches.</p></div>
|
1033
|
+
</div>
|
1034
|
+
</div>
|
1035
|
+
<div class="sect1">
|
1036
|
+
<h2 id="_creating_uploading_a_cl">CREATING / UPLOADING A CL</h2>
|
1037
|
+
<div class="sectionbody">
|
1038
|
+
<div class="admonitionblock">
|
1039
|
+
<table><tr>
|
1040
|
+
<td class="icon">
|
1041
|
+
<div class="title">Note</div>
|
1042
|
+
</td>
|
1043
|
+
<td class="content">The remainder of the tutorial assumes that your current working directory
|
1044
|
+
is the <code>src/</code> folder mentioned in <a href="#_getting_the_code">Getting the code</a>.</td>
|
1045
|
+
</tr></table>
|
1046
|
+
</div>
|
1047
|
+
<div class="paragraph"><p>Each CL corresponds exactly with a single branch in git. Any time you want to
|
1048
|
+
begin a new CL:</p></div>
|
1049
|
+
<div class="listingblock">
|
1050
|
+
<div class="content">
|
1051
|
+
<pre><code><strong><span class="white">$ git new-branch <branch_name></span></strong></code></pre>
|
1052
|
+
</div></div>
|
1053
|
+
<div class="paragraph"><p>This will create and checkout a new branch named <code>branch_name</code> which will track
|
1054
|
+
the default upstream branch (<code>origin/master</code>). See
|
1055
|
+
<a href="git-new-branch.html">git-new-branch(1)</a> for more features.</p></div>
|
1056
|
+
<div class="paragraph"><p>Commit as many changes as you like to this branch. When you want to upload it
|
1057
|
+
for review, run:</p></div>
|
1058
|
+
<div class="listingblock">
|
1059
|
+
<div class="content">
|
1060
|
+
<pre><code><strong><span class="white">$ git cl upload</span></strong></code></pre>
|
1061
|
+
</div></div>
|
1062
|
+
<div class="paragraph"><p>This will take the diff of your branch against its upstream branch (in that
|
1063
|
+
case origin/master), and will post it to the
|
1064
|
+
<a href="https://codereview.chromium.org">Chromium code review site</a>.</p></div>
|
1065
|
+
</div>
|
1066
|
+
</div>
|
1067
|
+
<div class="sect1">
|
1068
|
+
<h2 id="_updating_the_code">UPDATING THE CODE</h2>
|
1069
|
+
<div class="sectionbody">
|
1070
|
+
<div class="paragraph"><p>Inevitably, you’ll want to pull in changes from the main Chromium repo. This is
|
1071
|
+
pretty easy with <em>depot_tools</em>:</p></div>
|
1072
|
+
<div class="listingblock">
|
1073
|
+
<div class="content">
|
1074
|
+
<pre><code><strong><span class="white">$ git rebase-update</span></strong></code></pre>
|
1075
|
+
</div></div>
|
1076
|
+
<div class="paragraph"><p>This command will update all of your CLs to contain the latest code from their
|
1077
|
+
upstreams. It will also automatically clean up CLs which have been committed and
|
1078
|
+
a couple other nice things. See <a href="git-rebase-update.html">git-rebase-update(1)</a> for the full
|
1079
|
+
scoop.</p></div>
|
1080
|
+
<div class="paragraph"><p>One thing to look out for are <em>merge conflicts</em>. These happen for exactly the
|
1081
|
+
same as they do with SVN, but the experience is a little more controllable with
|
1082
|
+
git. <code>git rebase-update</code> will try to rebase all your branches for you, but if it
|
1083
|
+
encounters a merge conflict in one, it will halt and leave you in a rebase
|
1084
|
+
conflict state (see <a href="git-rebase.html">git-rebase(1)</a>). Resolving <code>git rebase</code> merge
|
1085
|
+
conflicts is beyond the scope of this tutorial, but there are many good sources
|
1086
|
+
online (see the <a href="#_prerequisites">Prerequisites</a> for some).</p></div>
|
1087
|
+
<div class="paragraph"><p>Sometimes you’re pretty certain that you’ve committed a certain branch, but <code>git
|
1088
|
+
rebase-update</code> isn’t able to tell that for sure. This is usually because your
|
1089
|
+
branch doesn’t rebase cleanly. You could just delete the branch with <code>git branch
|
1090
|
+
-D <branch></code>, but you’d like to double check the diff of your branch against its
|
1091
|
+
upstream before deleting it. If this is the case you can abort the rebase
|
1092
|
+
started by <code>git rebase-update</code>, and then run <a href="git-squash-branch.html">git-squash-branch(1)</a> to
|
1093
|
+
flatten your branch into a single commit. When you run <code>git rebase-update</code>
|
1094
|
+
again, you’ll get a (hopefully) much smaller / saner diff. If it turns out you
|
1095
|
+
were wrong about your branch being fully committed, you can use
|
1096
|
+
<a href="git-reflog.html">git-reflog(1)</a> to reset your branch back to where it was before. If the
|
1097
|
+
diff looks inconsequential, you can use <code>git rebase --skip</code> to ignore it, and
|
1098
|
+
then <code>git rebase-update</code> will clean it up for you.</p></div>
|
1099
|
+
<div class="paragraph"><p>Once you’re done resolving all of the merge conflict, just run <code>git
|
1100
|
+
rebase-update</code>, and it will pick up where it left off. Once the command has
|
1101
|
+
finished updating all of your branches, it will return you back to the branch
|
1102
|
+
you started on.</p></div>
|
1103
|
+
<div class="admonitionblock">
|
1104
|
+
<table><tr>
|
1105
|
+
<td class="icon">
|
1106
|
+
<div class="title">Note</div>
|
1107
|
+
</td>
|
1108
|
+
<td class="content">Running <code>git rebase-update</code> will update all your branches, but it will not
|
1109
|
+
automatically run <code>gclient sync</code> to update your dependencies.</td>
|
1110
|
+
</tr></table>
|
1111
|
+
</div>
|
1112
|
+
</div>
|
1113
|
+
</div>
|
1114
|
+
<div class="sect1">
|
1115
|
+
<h2 id="_managing_multiple_cls">MANAGING MULTIPLE CLS</h2>
|
1116
|
+
<div class="sectionbody">
|
1117
|
+
<div class="paragraph"><p>Sometimes you want to work on more than one CL at once (say, you have a CL
|
1118
|
+
posted for review and want to work on something else). For each CL that you
|
1119
|
+
want to work on, just use <code>git new-branch <branch_name></code>.</p></div>
|
1120
|
+
<div class="paragraph"><p>Once you start to have more than one CL at a time, it can be easy to lose your
|
1121
|
+
bearings. Fortunately, <em>depot_tools</em> has two tools to help you out:</p></div>
|
1122
|
+
<div class="listingblock">
|
1123
|
+
<div class="content">
|
1124
|
+
<pre><code><strong><span class="white">$ git map</span></strong>
|
1125
|
+
<span class="white blue-background">*</span>​<strong><span class="blue-background red"> 7dcfe47 </span></strong> <span class="green">(</span>​<strong><span class="aqua">frozen_changes</span></strong>​<span class="green">)</span> <span class="yellow">2014-03-12</span> ~ FREEZE.unindexed
|
1126
|
+
* <strong><span class="red">4b0c180</span></strong> <span class="yellow">2014-03-12</span> ~ modfile
|
1127
|
+
* <strong><span class="red">59a7cca</span></strong> <span class="yellow">2014-03-12</span> ~ a deleted file
|
1128
|
+
* <strong><span class="red">6bec695</span></strong> <span class="green">(</span>​<span class="red">origin/master</span>​<span class="green">)</span> <span class="yellow">2014-03-11</span> ~ Add neat feature <strong><span class="white"><(frozen_changes)</span></strong>
|
1129
|
+
* <strong><span class="red">d15a38a</span></strong> <span class="yellow">2014-03-11</span> ~ Epic README update
|
1130
|
+
* <strong><span class="red">d559894</span></strong> <span class="green">(</span>​<strong><span class="lime">master</span></strong>​<span class="green">)</span> <span class="yellow">2014-03-11</span> ~ Important upstream change
|
1131
|
+
<span class="red">|</span> * <strong><span class="red">9c311fd</span></strong> <span class="green">(</span>​<strong><span class="lime">cool_feature</span></strong>​<span class="green">)</span> <span class="yellow">2014-03-11</span> ~ Respond to CL comments
|
1132
|
+
<span class="red">|</span> <span class="green">|</span> * <strong><span class="red">2a1eeb2</span></strong> <span class="green">(</span>​<strong><span class="lime">subfeature</span></strong>​<span class="green">)</span> <span class="yellow">2014-03-11</span> ~ integrate with CoolService
|
1133
|
+
<span class="red">|</span> <span class="green">|</span> * <strong><span class="red">d777af6</span></strong> <span class="yellow">2014-03-11</span> ~ slick commenting action
|
1134
|
+
<span class="red">|</span> <span class="green">|/</span>
|
1135
|
+
<span class="red">|</span> * <strong><span class="red">265803a</span></strong> <span class="yellow">2014-03-11</span> ~ another improvement <strong><span class="white"><(subfeature)</span></strong>
|
1136
|
+
<span class="red">|</span> * <strong><span class="red">6d831ac</span></strong> <span class="green">(</span>​<strong><span class="fuchsia">spleen_tag</span></strong>​<span class="green">)</span> <span class="yellow">2014-03-11</span> ~ Refactor spleen
|
1137
|
+
<span class="red">|</span> * <strong><span class="red">82e74ab</span></strong> <span class="yellow">2014-03-11</span> ~ Add widget
|
1138
|
+
<span class="red">|/</span>
|
1139
|
+
* <strong><span class="red">d08c5b3</span></strong> <span class="green">(</span>​<strong><span class="lime">bogus_noparent</span></strong>​<span class="green">)</span> <span class="yellow">2014-03-11</span> ~ Wonderful beginnings <strong><span class="white"><(cool_feature)</span></strong></code></pre>
|
1140
|
+
</div></div>
|
1141
|
+
<div class="paragraph"><p>Note that this example repo is in dire need of a <a href="git-rebase-update.html">git-rebase-update(1)</a>!</p></div>
|
1142
|
+
<div class="listingblock">
|
1143
|
+
<div class="content">
|
1144
|
+
<pre><code><strong><span class="white">$ git map-branches</span></strong>
|
1145
|
+
<span class="red">origin/master</span>
|
1146
|
+
<span class="green">cool_feature</span>
|
1147
|
+
<span class="green">subfeature</span>
|
1148
|
+
<span class="aqua">frozen_changes *</span>
|
1149
|
+
<span class="green">master</span></code></pre>
|
1150
|
+
</div></div>
|
1151
|
+
<div class="dlist"><dl>
|
1152
|
+
<dt class="hdlist1">
|
1153
|
+
<a href="git-map.html">git-map(1)</a>
|
1154
|
+
</dt>
|
1155
|
+
<dd>
|
1156
|
+
<p>
|
1157
|
+
This tool shows you the history of all of your branches in a pseudo-graphical
|
1158
|
+
format. In particular, it will show you which commits all of your branches
|
1159
|
+
are on, which commit you currently have checked out, and more. Check out the
|
1160
|
+
doc for the full details.
|
1161
|
+
</p>
|
1162
|
+
</dd>
|
1163
|
+
<dt class="hdlist1">
|
1164
|
+
<a href="git-map-branches.html">git-map-branches(1)</a>
|
1165
|
+
</dt>
|
1166
|
+
<dd>
|
1167
|
+
<p>
|
1168
|
+
This tool just shows you which branches you have in your repo, and their
|
1169
|
+
upstream relationship to each other (as well as which branch you have checked
|
1170
|
+
out at the moment).
|
1171
|
+
</p>
|
1172
|
+
</dd>
|
1173
|
+
</dl></div>
|
1174
|
+
<div class="paragraph"><p>Additionally, sometimes you need to switch between branches, but you’ve got work
|
1175
|
+
in progress. You could use <a href="git-stash.html">git-stash(1)</a>, but that can be tricky to
|
1176
|
+
manage because you need to remember which branches you stashed what changes on.
|
1177
|
+
Helpfully <em>depot_tools</em> includes two tools which can greatly assist in case:</p></div>
|
1178
|
+
<div class="paragraph"><p><a href="git-freeze.html">git-freeze(1)</a> allows you to put the current branch in 'suspended
|
1179
|
+
animation' by committing your changes to a specially-named commit on the top of
|
1180
|
+
your current branch. When you come back to your branch later, you can just run
|
1181
|
+
<a href="git-thaw.html">git-thaw(1)</a> to get your work-in-progress changes back to what they were.</p></div>
|
1182
|
+
<div class="paragraph"><p>Another useful tool is <a href="git-rename-branch.html">git-rename-branch(1)</a>. Unlike <code>git branch -m <old>
|
1183
|
+
<new></code>, this tool will correctly preserve the upstream relationships of your
|
1184
|
+
branch compared to its downstreams.</p></div>
|
1185
|
+
<div class="paragraph"><p>Finally, take a look at <a href="git-upstream-diff.html">git-upstream-diff(1)</a>. This will show you the
|
1186
|
+
combined diff for all the commits on your branch against the upstream tracking
|
1187
|
+
branch. This is <em>exactly</em> what <code>git cl upload</code> will push up to code review.
|
1188
|
+
Additionally, consider trying the <code>--wordwise</code> argument to get a colorized
|
1189
|
+
per-word diff (instead of a per-line diff).</p></div>
|
1190
|
+
</div>
|
1191
|
+
</div>
|
1192
|
+
<div class="sect1">
|
1193
|
+
<h2 id="_managing_dependent_cls">MANAGING DEPENDENT CLS</h2>
|
1194
|
+
<div class="sectionbody">
|
1195
|
+
<div class="paragraph"><p>Now that you know how to manage <em>independent</em> CLs, we’ll see how to manage
|
1196
|
+
<em>dependent</em> CLs. Dependent CLs are useful when your second (or third or fourth
|
1197
|
+
or …) CL depends on the changes in one of your other CLs (such as: CL 2 won’t
|
1198
|
+
compile without CL 1, but you want to submit them as two separate reviews).</p></div>
|
1199
|
+
<div class="paragraph"><p>Like all of the other CLs we’ve created, we use <a href="git-new-branch.html">git-new-branch(1)</a>, but
|
1200
|
+
this time with an extra argument. First, <code>git checkout</code> the branch
|
1201
|
+
you want to base the new one on (i.e. CL 1), and then run:</p></div>
|
1202
|
+
<div class="listingblock">
|
1203
|
+
<div class="content">
|
1204
|
+
<pre><code><strong><span class="white">$ git new-branch --upstream_current <branch_name></span></strong></code></pre>
|
1205
|
+
</div></div>
|
1206
|
+
<div class="paragraph"><p>This will make a new branch which tracks the <em>current</em> branch as its upstream
|
1207
|
+
(as opposed to <em>origin/master</em>). All changes you commit to this branch will be
|
1208
|
+
in addition to the previous branch, but when you <code>git cl upload</code>, you will only
|
1209
|
+
upload the diff for the dependent (child) branch. You may have as many branches
|
1210
|
+
nested in this fashion as you like.</p></div>
|
1211
|
+
<div class="paragraph"><p><a href="git-map.html">git-map(1)</a> and <a href="git-map-branches.html">git-map-branches(1)</a> are particularly helpful when
|
1212
|
+
you have dependent branches. In addition, there are two helper commands which
|
1213
|
+
let you traverse your working copy up and down this tree of branches:
|
1214
|
+
<a href="git-nav-upstream.html">git-nav-upstream(1)</a> and <a href="git-nav-downstream.html">git-nav-downstream(1)</a>.</p></div>
|
1215
|
+
<div class="paragraph"><p>Sometimes when dealing with dependent CLs, it turns out that you accidentally
|
1216
|
+
based a branch on the wrong upstream, but since then you’ve committed changes to
|
1217
|
+
it, or even based <em>another</em> branch off of that one. Or you discover that you
|
1218
|
+
have two independent CLs that would actually be much better off as dependent
|
1219
|
+
CLs. In instances like these, you can check out the offending branch and use
|
1220
|
+
<a href="git-reparent-branch.html">git-reparent-branch(1)</a> to move it to track a different parent. Note that
|
1221
|
+
this can also be used to move a branch from tracking <code>origin/master</code> to <code>lkgr</code>
|
1222
|
+
or vice versa.</p></div>
|
1223
|
+
</div>
|
1224
|
+
</div>
|
1225
|
+
<div class="sect1">
|
1226
|
+
<h2 id="_example_walkthrough">EXAMPLE WALKTHROUGH</h2>
|
1227
|
+
<div class="sectionbody">
|
1228
|
+
<div class="paragraph"><p>This section will demo what a typical workflow looks like when writing,
|
1229
|
+
updating, and committing multiple CLs.</p></div>
|
1230
|
+
<div class="paragraph"><p></p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ fetch chromium</span>
|
1231
|
+
... truncated output ...
|
1232
|
+
<span style="font-weight: bold; color: #ffffff">$ cd src</span>
|
1233
|
+
</code></pre></div></div><p><div class="paragraph"> (only on linux)</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ ./build/install-build-deps.sh</span>
|
1234
|
+
... truncated output ...
|
1235
|
+
</code></pre></div></div><p><div class="paragraph"> Pull in all dependencies for HEAD</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ gclient sync</span>
|
1236
|
+
... truncated output ...
|
1237
|
+
</code></pre></div></div><p><div class="paragraph"> Let's fix something!</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ git new-branch fix_typo</span>
|
1238
|
+
<span style="font-weight: bold; color: #ffffff">$ echo -e '/Banana\ns/Banana/Kuun\nwq' | ed build/whitespace_file.txt</span>
|
1239
|
+
1503
|
1240
|
+
It was a Domo-Banana.
|
1241
|
+
It was a Domo-Kuun.
|
1242
|
+
1501
|
1243
|
+
<span style="font-weight: bold; color: #ffffff">$ git commit -am 'Fix terrible typo.'</span>
|
1244
|
+
[fix_typo 615ffa7] Fix terrible typo.
|
1245
|
+
1 file changed, 1 insertion(+), 1 deletion(-)
|
1246
|
+
<span style="font-weight: bold; color: #ffffff">$ git map</span>
|
1247
|
+
* <span style="font-weight: bold; color: #e42e16">615ffa7 </span><span style="color: #19c518"> (</span><span style="color: #e42e16">HEAD -> fix_typo</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Fix terrible typo.
|
1248
|
+
* <span style="font-weight: bold; color: #e42e16">beec6f4 </span><span style="color: #19c518"> (</span><span style="color: #e42e16">origin/master</span><span style="color: #19c518">, </span><span style="color: #e42e16">origin/HEAD</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Make ReflectorImpl use mailboxes<span style="font-weight: bold"></span><span style="font-weight: bold; color: #ffffff"> <(fix_typo)</span><span style="font-weight: bold"></span><span style="font-weight: bold"></span>
|
1249
|
+
* <span style="font-weight: bold; color: #e42e16">41290e0 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ don't use glibc-specific execinfo.h on uclibc builds
|
1250
|
+
* <span style="font-weight: bold; color: #e42e16">a76fde7 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ [fsp] Add requestUnmount() method together with the request manager.
|
1251
|
+
* <span style="font-weight: bold; color: #e42e16">9de7a71 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ linux_aura: Use system configuration for middle clicking the titlebar.
|
1252
|
+
* <span style="font-weight: bold; color: #e42e16">073b0c2 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ContentView->ContentViewCore in ContentViewRenderView
|
1253
|
+
* <span style="font-weight: bold; color: #e42e16">2250f53 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ozone: evdev: Filter devices by path
|
1254
|
+
* <span style="font-weight: bold; color: #e42e16">33a7a74 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Always output seccomp error messages to stderr
|
1255
|
+
<span style="font-weight: bold; color: #ffffff">$ git status</span>
|
1256
|
+
On branch fix_typo
|
1257
|
+
Your branch is ahead of 'origin/master' by 1 commit.
|
1258
|
+
(use "git push" to publish your local commits)
|
1259
|
+
|
1260
|
+
nothing to commit, working tree clean
|
1261
|
+
<span style="font-weight: bold; color: #ffffff">$ git cl upload -r domo@chromium.org --send-mail</span>
|
1262
|
+
... truncated output ...
|
1263
|
+
</code></pre></div></div><p><div class="paragraph"> While we wait for feedback, let's do something else.</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ git new-branch chap2</span>
|
1264
|
+
<span style="font-weight: bold; color: #ffffff">$ git map-branches</span>
|
1265
|
+
<span style="color: #e42e16"></span><span style="font-weight: bold; color: #e42e16">origin/master
|
1266
|
+
</span><span style="font-weight: bold; color: #33d6e5"></span><span style="font-weight: bold; color: #33d6e5"> chap2 *
|
1267
|
+
</span><span style="font-weight: bold; color: #19c518"></span><span style="color: #19c518"> fix_typo
|
1268
|
+
</span><span style="font-weight: bold; color: #ffffff">$ cat >> build/whitespace_file.txt <<EOF</span>
|
1269
|
+
|
1270
|
+
"You recall what happened on Mulholland drive?" The ceiling fan rotated slowly
|
1271
|
+
overhead, barely disturbing the thick cigarette smoke. No doubt was left about
|
1272
|
+
when the fan was last cleaned.
|
1273
|
+
EOF
|
1274
|
+
<span style="font-weight: bold; color: #ffffff">$ git status</span>
|
1275
|
+
On branch chap2
|
1276
|
+
Your branch is up to date with 'origin/master'.
|
1277
|
+
|
1278
|
+
Changes not staged for commit:
|
1279
|
+
(use "git add <file>..." to update what will be committed)
|
1280
|
+
(use "git restore <file>..." to discard changes in working directory)
|
1281
|
+
|
1282
|
+
<span style="color: #e42e16">modified: build/whitespace_file.txt</span>
|
1283
|
+
|
1284
|
+
no changes added to commit (use "git add" and/or "git commit -a")
|
1285
|
+
</code></pre></div></div><p><div class="paragraph"> Someone on the code review pointed out that our typo-fix has a typo :( We're still working on 'chap2' but we really want to land 'fix_typo', so let's switch over and fix it.</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ git freeze</span>
|
1286
|
+
<span style="font-weight: bold; color: #ffffff">$ git checkout fix_typo</span>
|
1287
|
+
Switched to branch 'fix_typo'
|
1288
|
+
Your branch is ahead of 'origin/master' by 1 commit.
|
1289
|
+
(use "git push" to publish your local commits)
|
1290
|
+
<span style="font-weight: bold; color: #ffffff">$ echo -e '/Kuun\ns/Kuun/Kun\nwq' | ed build/whitespace_file.txt</span>
|
1291
|
+
1501
|
1292
|
+
It was a Domo-Kuun.
|
1293
|
+
It was a Domo-Kun.
|
1294
|
+
1500
|
1295
|
+
<span style="font-weight: bold; color: #ffffff">$ git upstream-diff --wordwise</span>
|
1296
|
+
<span style="font-weight: bold">diff --git a/build/whitespace_file.txt b/build/whitespace_file.txt</span>
|
1297
|
+
<span style="font-weight: bold">index 3eba355..57cdcee 100644</span>
|
1298
|
+
<span style="font-weight: bold">--- a/build/whitespace_file.txt</span>
|
1299
|
+
<span style="font-weight: bold">+++ b/build/whitespace_file.txt</span>
|
1300
|
+
<span style="color: #33d6e5">@@ -17,7 +17,7 @@</span> swept up the streets (for it is in London that our scene lies), rattling along
|
1301
|
+
the housetops, and fiercely agitating the scanty flame of the lamps that
|
1302
|
+
struggled against the elements. A hooded figure emerged.
|
1303
|
+
|
1304
|
+
It was a Domo-<span style="color: #e42e16">Banana</span><span style="color: #19c518">Kun</span>.
|
1305
|
+
|
1306
|
+
"What took you so long?", inquired his wife.
|
1307
|
+
|
1308
|
+
<span style="font-weight: bold; color: #ffffff">$ git commit -am 'Fix typo for good!'</span>
|
1309
|
+
[fix_typo 2c0ad9c] Fix typo for good!
|
1310
|
+
1 file changed, 1 insertion(+), 1 deletion(-)
|
1311
|
+
<span style="font-weight: bold; color: #ffffff">$ git cl upload</span>
|
1312
|
+
... truncated output ...
|
1313
|
+
</code></pre></div></div><p><div class="paragraph"> Since we got lgtm, let the CQ land it.</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ git cl set_commit</span>
|
1314
|
+
<span style="font-weight: bold; color: #ffffff">$ git map</span>
|
1315
|
+
* <span style="font-weight: bold; color: #e42e16">0e2e52e </span><span style="color: #19c518"> (</span><span style="color: #19c518"></span><span style="font-weight: bold; color: #19c518">chap2</span><span style="font-weight: bold"></span><span style="font-weight: bold"></span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ FREEZE.unindexed
|
1316
|
+
<span style="color: #e42e16">|</span> * <span style="font-weight: bold; color: #e42e16">2c0ad9c </span><span style="color: #19c518"> (</span><span style="color: #e42e16">HEAD -> fix_typo</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Fix typo for good!
|
1317
|
+
<span style="color: #e42e16">|</span> * <span style="font-weight: bold; color: #e42e16">615ffa7 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Fix terrible typo.
|
1318
|
+
<span style="color: #e42e16">|</span><span style="color: #e42e16">/</span>
|
1319
|
+
* <span style="font-weight: bold; color: #e42e16">beec6f4 </span><span style="color: #19c518"> (</span><span style="color: #e42e16">origin/master</span><span style="color: #19c518">, </span><span style="color: #e42e16">origin/HEAD</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Make ReflectorImpl use mailboxes<span style="font-weight: bold"></span><span style="font-weight: bold; color: #ffffff"> <(chap2, fix_typo)</span><span style="font-weight: bold"></span><span style="font-weight: bold"></span>
|
1320
|
+
* <span style="font-weight: bold; color: #e42e16">41290e0 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ don't use glibc-specific execinfo.h on uclibc builds
|
1321
|
+
* <span style="font-weight: bold; color: #e42e16">a76fde7 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ [fsp] Add requestUnmount() method together with the request manager.
|
1322
|
+
* <span style="font-weight: bold; color: #e42e16">9de7a71 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ linux_aura: Use system configuration for middle clicking the titlebar.
|
1323
|
+
* <span style="font-weight: bold; color: #e42e16">073b0c2 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ContentView->ContentViewCore in ContentViewRenderView
|
1324
|
+
* <span style="font-weight: bold; color: #e42e16">2250f53 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ozone: evdev: Filter devices by path
|
1325
|
+
* <span style="font-weight: bold; color: #e42e16">33a7a74 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Always output seccomp error messages to stderr
|
1326
|
+
</code></pre></div></div><p><div class="paragraph"> Switch back to where we were using the nav* commands (for fun... git checkout would work here too)</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ git map-branches</span>
|
1327
|
+
<span style="color: #e42e16"></span><span style="color: #e42e16">origin/master
|
1328
|
+
</span><span style="color: #19c518"></span><span style="color: #19c518"> chap2
|
1329
|
+
</span><span style="color: #33d6e5"></span><span style="font-weight: bold; color: #33d6e5"> fix_typo *
|
1330
|
+
</span><span style="font-weight: bold; color: #ffffff">$ git nav-upstream</span>
|
1331
|
+
Note: switching to 'origin/master'.
|
1332
|
+
|
1333
|
+
You are in 'detached HEAD' state. You can look around, make experimental
|
1334
|
+
changes and commit them, and you can discard any commits you make in this
|
1335
|
+
state without impacting any branches by switching back to a branch.
|
1336
|
+
|
1337
|
+
If you want to create a new branch to retain commits you create, you may
|
1338
|
+
do so (now or later) by using -c with the switch command. Example:
|
1339
|
+
|
1340
|
+
git switch -c <new-branch-name>
|
1341
|
+
|
1342
|
+
Or undo this operation with:
|
1343
|
+
|
1344
|
+
git switch -
|
1345
|
+
|
1346
|
+
Turn off this advice by setting config variable advice.detachedHead to false
|
1347
|
+
|
1348
|
+
HEAD is now at beec6f4 Make ReflectorImpl use mailboxes
|
1349
|
+
<span style="font-weight: bold; color: #ffffff">$ git nav-downstream</span>
|
1350
|
+
Previous HEAD position was beec6f4 Make ReflectorImpl use mailboxes
|
1351
|
+
Switched to branch 'chap2'
|
1352
|
+
Your branch is ahead of 'origin/master' by 1 commit.
|
1353
|
+
(use "git push" to publish your local commits)
|
1354
|
+
Please select a downstream branch
|
1355
|
+
0. chap2
|
1356
|
+
1. fix_typo
|
1357
|
+
Selection (0-1)[0]: 0
|
1358
|
+
<span style="font-weight: bold; color: #ffffff">$ git map-branches</span>
|
1359
|
+
<span style="color: #e42e16"></span><span style="color: #e42e16">origin/master
|
1360
|
+
</span><span style="color: #33d6e5"></span><span style="font-weight: bold; color: #33d6e5"> chap2 *
|
1361
|
+
</span><span style="font-weight: bold; color: #19c518"></span><span style="color: #19c518"> fix_typo
|
1362
|
+
</code></pre></div></div><p><div class="paragraph"> Now we can pick up on chapter2 where we left off.</p></div><div class="listingblock"><div class="content"><pre><code></span><span style="font-weight: bold; color: #ffffff">$ git thaw</span>
|
1363
|
+
<span style="font-weight: bold; color: #ffffff">$ git diff</span>
|
1364
|
+
<span style="font-weight: bold">diff --git a/build/whitespace_file.txt b/build/whitespace_file.txt</span>
|
1365
|
+
<span style="font-weight: bold">index 3eba355..9d08d9d 100644</span>
|
1366
|
+
<span style="font-weight: bold">--- a/build/whitespace_file.txt</span>
|
1367
|
+
<span style="font-weight: bold">+++ b/build/whitespace_file.txt</span>
|
1368
|
+
<span style="color: #33d6e5">@@ -34,3 +34,7 @@</span> with his fork, watching the runny jelly spread and pool across his plate,
|
1369
|
+
like the blood of a dying fawn. \"It reminds me of that time --\" he started, as
|
1370
|
+
his wife cut in quickly: \"-- please. I can't bear to hear it.\". A flury of
|
1371
|
+
images coming from the past flowed through his mind.
|
1372
|
+
<span style="color: #19c518">+</span>
|
1373
|
+
<span style="color: #19c518">+</span><span style="color: #19c518">"You recall what happened on Mulholland drive?" The ceiling fan rotated slowly</span>
|
1374
|
+
<span style="color: #19c518">+</span><span style="color: #19c518">overhead, barely disturbing the thick cigarette smoke. No doubt was left about</span>
|
1375
|
+
<span style="color: #19c518">+</span><span style="color: #19c518">when the fan was last cleaned.</span>
|
1376
|
+
<span style="font-weight: bold; color: #ffffff">$ cat >> build/whitespace_file.txt <<EOF</span>
|
1377
|
+
|
1378
|
+
There was an poignant pause.
|
1379
|
+
EOF
|
1380
|
+
<span style="font-weight: bold; color: #ffffff">$ git diff</span>
|
1381
|
+
<span style="font-weight: bold">diff --git a/build/whitespace_file.txt b/build/whitespace_file.txt</span>
|
1382
|
+
<span style="font-weight: bold">index 3eba355..e3a55de 100644</span>
|
1383
|
+
<span style="font-weight: bold">--- a/build/whitespace_file.txt</span>
|
1384
|
+
<span style="font-weight: bold">+++ b/build/whitespace_file.txt</span>
|
1385
|
+
<span style="color: #33d6e5">@@ -34,3 +34,9 @@</span> with his fork, watching the runny jelly spread and pool across his plate,
|
1386
|
+
like the blood of a dying fawn. \"It reminds me of that time --\" he started, as
|
1387
|
+
his wife cut in quickly: \"-- please. I can't bear to hear it.\". A flury of
|
1388
|
+
images coming from the past flowed through his mind.
|
1389
|
+
<span style="color: #19c518">+</span>
|
1390
|
+
<span style="color: #19c518">+</span><span style="color: #19c518">"You recall what happened on Mulholland drive?" The ceiling fan rotated slowly</span>
|
1391
|
+
<span style="color: #19c518">+</span><span style="color: #19c518">overhead, barely disturbing the thick cigarette smoke. No doubt was left about</span>
|
1392
|
+
<span style="color: #19c518">+</span><span style="color: #19c518">when the fan was last cleaned.</span>
|
1393
|
+
<span style="color: #19c518">+</span>
|
1394
|
+
<span style="color: #19c518">+</span><span style="color: #19c518">There was an poignant pause.</span>
|
1395
|
+
<span style="font-weight: bold; color: #ffffff">$ git commit -am 'Finish chapter 2'</span>
|
1396
|
+
[chap2 ceef712] Finish chapter 2
|
1397
|
+
1 file changed, 6 insertions(+)
|
1398
|
+
<span style="font-weight: bold; color: #ffffff">$ git map</span>
|
1399
|
+
* <span style="font-weight: bold; color: #e42e16">ceef712 </span><span style="color: #19c518"> (</span><span style="color: #e42e16">HEAD -> chap2</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Finish chapter 2
|
1400
|
+
<span style="color: #e42e16">|</span> * <span style="font-weight: bold; color: #e42e16">2c0ad9c </span><span style="color: #19c518"> (</span><span style="color: #19c518"></span><span style="font-weight: bold; color: #19c518">fix_typo</span><span style="font-weight: bold"></span><span style="font-weight: bold"></span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Fix typo for good!
|
1401
|
+
<span style="color: #e42e16">|</span> * <span style="font-weight: bold; color: #e42e16">615ffa7 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Fix terrible typo.
|
1402
|
+
<span style="color: #e42e16">|</span><span style="color: #e42e16">/</span>
|
1403
|
+
* <span style="font-weight: bold; color: #e42e16">beec6f4 </span><span style="color: #19c518"> (</span><span style="color: #e42e16">origin/master</span><span style="color: #19c518">, </span><span style="color: #e42e16">origin/HEAD</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Make ReflectorImpl use mailboxes<span style="font-weight: bold"></span><span style="font-weight: bold; color: #ffffff"> <(chap2, fix_typo)</span><span style="font-weight: bold"></span><span style="font-weight: bold"></span>
|
1404
|
+
* <span style="font-weight: bold; color: #e42e16">41290e0 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ don't use glibc-specific execinfo.h on uclibc builds
|
1405
|
+
* <span style="font-weight: bold; color: #e42e16">a76fde7 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ [fsp] Add requestUnmount() method together with the request manager.
|
1406
|
+
* <span style="font-weight: bold; color: #e42e16">9de7a71 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ linux_aura: Use system configuration for middle clicking the titlebar.
|
1407
|
+
* <span style="font-weight: bold; color: #e42e16">073b0c2 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ContentView->ContentViewCore in ContentViewRenderView
|
1408
|
+
* <span style="font-weight: bold; color: #e42e16">2250f53 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ozone: evdev: Filter devices by path
|
1409
|
+
* <span style="font-weight: bold; color: #e42e16">33a7a74 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Always output seccomp error messages to stderr
|
1410
|
+
<span style="font-weight: bold; color: #ffffff">$ git cl upload -r domo@chromium.org --send-mail</span>
|
1411
|
+
... truncated output ...
|
1412
|
+
</code></pre></div></div><p><div class="paragraph"> We poke a committer until they lgtm :)</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ git cl set_commit</span>
|
1413
|
+
</code></pre></div></div><p><div class="paragraph"> While that runs through the CQ, let's get started on chapter 3. Since we know that chapter 3 depends on chapter 2, we'll track the current chapter2 branch.</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ git new-branch --upstream_current chap3</span>
|
1414
|
+
<span style="font-weight: bold; color: #ffffff">$ cat >> build/whitespace_file.txt <<EOF</span>
|
1415
|
+
|
1416
|
+
CHAPTER 3:
|
1417
|
+
Mr. Usagi felt that something wasn't right. Shortly after the Domo-Kun left he
|
1418
|
+
began feeling sick.
|
1419
|
+
EOF
|
1420
|
+
<span style="font-weight: bold; color: #ffffff">$ git commit -am 'beginning of chapter 3'</span>
|
1421
|
+
[chap3 7d4238a] beginning of chapter 3
|
1422
|
+
1 file changed, 4 insertions(+)
|
1423
|
+
<span style="font-weight: bold; color: #ffffff">$ git map</span>
|
1424
|
+
* <span style="font-weight: bold; color: #e42e16">7d4238a </span><span style="color: #19c518"> (</span><span style="color: #e42e16">HEAD -> chap3</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ beginning of chapter 3
|
1425
|
+
* <span style="font-weight: bold; color: #e42e16">ceef712 </span><span style="color: #19c518"> (</span><span style="color: #19c518"></span><span style="font-weight: bold; color: #19c518">chap2</span><span style="font-weight: bold"></span><span style="font-weight: bold"></span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Finish chapter 2<span style="font-weight: bold"></span><span style="font-weight: bold; color: #ffffff"> <(chap3)</span><span style="font-weight: bold"></span><span style="font-weight: bold"></span>
|
1426
|
+
<span style="color: #e42e16">|</span> * <span style="font-weight: bold; color: #e42e16">2c0ad9c </span><span style="color: #19c518"> (</span><span style="color: #19c518"></span><span style="font-weight: bold; color: #19c518">fix_typo</span><span style="font-weight: bold"></span><span style="font-weight: bold"></span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Fix typo for good!
|
1427
|
+
<span style="color: #e42e16">|</span> * <span style="font-weight: bold; color: #e42e16">615ffa7 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Fix terrible typo.
|
1428
|
+
<span style="color: #e42e16">|</span><span style="color: #e42e16">/</span>
|
1429
|
+
* <span style="font-weight: bold; color: #e42e16">beec6f4 </span><span style="color: #19c518"> (</span><span style="color: #e42e16">origin/master</span><span style="color: #19c518">, </span><span style="color: #e42e16">origin/HEAD</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Make ReflectorImpl use mailboxes<span style="font-weight: bold"></span><span style="font-weight: bold; color: #ffffff"> <(chap2, fix_typo)</span><span style="font-weight: bold"></span><span style="font-weight: bold"></span>
|
1430
|
+
* <span style="font-weight: bold; color: #e42e16">41290e0 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ don't use glibc-specific execinfo.h on uclibc builds
|
1431
|
+
* <span style="font-weight: bold; color: #e42e16">a76fde7 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ [fsp] Add requestUnmount() method together with the request manager.
|
1432
|
+
* <span style="font-weight: bold; color: #e42e16">9de7a71 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ linux_aura: Use system configuration for middle clicking the titlebar.
|
1433
|
+
* <span style="font-weight: bold; color: #e42e16">073b0c2 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ContentView->ContentViewCore in ContentViewRenderView
|
1434
|
+
* <span style="font-weight: bold; color: #e42e16">2250f53 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ozone: evdev: Filter devices by path
|
1435
|
+
* <span style="font-weight: bold; color: #e42e16">33a7a74 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Always output seccomp error messages to stderr
|
1436
|
+
</code></pre></div></div><p><div class="paragraph"> We haven't updated the code in a while, so let's do that now.</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ git rebase-update</span>
|
1437
|
+
Fetching origin
|
1438
|
+
From https://upstream
|
1439
|
+
beec6f4..59cdb73 master -> origin/master
|
1440
|
+
Rebasing: chap2
|
1441
|
+
Rebasing: fix_typo
|
1442
|
+
Failed! Attempting to squash fix_typo ... Success!
|
1443
|
+
Rebasing: chap3
|
1444
|
+
Reparented chap3 to track origin/master (was tracking chap2)
|
1445
|
+
Deleted branch fix_typo (was 5d26fec).
|
1446
|
+
Deleted branch chap2 (was 5d26fec).
|
1447
|
+
</code></pre></div></div><p><div class="paragraph"> Well look at that. The CQ landed our typo and chapter2 branches already and git rebase-update cleaned them up for us.</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ gclient sync</span>
|
1448
|
+
... truncated output ...
|
1449
|
+
<span style="font-weight: bold; color: #ffffff">$ git map</span>
|
1450
|
+
* <span style="font-weight: bold; color: #e42e16">93fe917 </span><span style="color: #19c518"> (</span><span style="color: #e42e16">HEAD -> chap3</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ beginning of chapter 3
|
1451
|
+
* <span style="font-weight: bold; color: #e42e16">5d26fec </span><span style="color: #19c518"> (</span><span style="color: #e42e16">origin/master</span><span style="color: #19c518">, </span><span style="color: #e42e16">origin/HEAD</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Finish chapter 2<span style="font-weight: bold"></span><span style="font-weight: bold; color: #ffffff"> <(chap3)</span><span style="font-weight: bold"></span><span style="font-weight: bold"></span>
|
1452
|
+
* <span style="font-weight: bold; color: #e42e16">df7fefb </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Revert 255617, due to it not tracking use of the link doctor page properly.
|
1453
|
+
* <span style="font-weight: bold; color: #e42e16">4b39cda </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Fix terrible typo.
|
1454
|
+
* <span style="font-weight: bold; color: #e42e16">248c5b6 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Temporarily CHECK(trial) in ChromeRenderProcessObserver::OnSetFieldTrialGroup.
|
1455
|
+
* <span style="font-weight: bold; color: #e42e16">8171df8 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Remove AMD family check for the flapper crypto accelerator.
|
1456
|
+
* <span style="font-weight: bold; color: #e42e16">d6a30d2 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Change the Pica load benchmark to listen for the polymer-ready event
|
1457
|
+
* <span style="font-weight: bold; color: #e42e16">beec6f4 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Make ReflectorImpl use mailboxes
|
1458
|
+
* <span style="font-weight: bold; color: #e42e16">41290e0 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ don't use glibc-specific execinfo.h on uclibc builds
|
1459
|
+
* <span style="font-weight: bold; color: #e42e16">a76fde7 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ [fsp] Add requestUnmount() method together with the request manager.
|
1460
|
+
* <span style="font-weight: bold; color: #e42e16">9de7a71 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ linux_aura: Use system configuration for middle clicking the titlebar.
|
1461
|
+
* <span style="font-weight: bold; color: #e42e16">073b0c2 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ContentView->ContentViewCore in ContentViewRenderView
|
1462
|
+
* <span style="font-weight: bold; color: #e42e16">2250f53 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ozone: evdev: Filter devices by path
|
1463
|
+
* <span style="font-weight: bold; color: #e42e16">33a7a74 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Always output seccomp error messages to stderr
|
1464
|
+
</code></pre></div></div><p><div class="paragraph"> Someone on IRC mentions that they actually landed a chapter 3 already! We should pull their changes before continuing. Brace for a code conflict!</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ git rebase-update</span>
|
1465
|
+
Fetching origin
|
1466
|
+
From https://upstream
|
1467
|
+
5d26fec..59cdb73 master -> origin/master
|
1468
|
+
Rebasing: chap2
|
1469
|
+
... lots of output, it's a conflict alright :(...
|
1470
|
+
<span style="font-weight: bold; color: #ffffff">$ git diff</span>
|
1471
|
+
<span style="font-weight: bold">diff --cc build/whitespace_file.txt</span>
|
1472
|
+
<span style="font-weight: bold">index 1293282,f903ea2..0000000</span>
|
1473
|
+
<span style="font-weight: bold">--- a/build/whitespace_file.txt</span>
|
1474
|
+
<span style="font-weight: bold">+++ b/build/whitespace_file.txt</span>
|
1475
|
+
<span style="color: #33d6e5">@@@ -42,4 -42,5 +42,9 @@@</span> when the fan was last cleaned
|
1476
|
+
There was an poignant pause.
|
1477
|
+
|
1478
|
+
CHAPTER 3:
|
1479
|
+
<span style="color: #19c518">++<<<<<<< HEAD</span>
|
1480
|
+
<span style="color: #19c518"> +Hilariousness! This chapter is awesome!</span>
|
1481
|
+
<span style="color: #19c518">++=======</span>
|
1482
|
+
<span style="color: #19c518">+ Mr. Usagi felt that something wasn't right. Shortly after the Domo-Kun left he</span>
|
1483
|
+
<span style="color: #19c518">+ began feeling sick.</span>
|
1484
|
+
<span style="color: #19c518">++>>>>>>> beginning of chapter 3</span>
|
1485
|
+
</code></pre></div></div><p><div class="paragraph"> Oh, well, that's not too bad. In fact... that's a terrible chapter 3!</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ $EDITOR build/whitespace_file.txt</span>
|
1486
|
+
... /me deletes bad chapter 3 ...
|
1487
|
+
<span style="font-weight: bold; color: #ffffff">$ git add build/whitespace_file.txt</span>
|
1488
|
+
<span style="font-weight: bold; color: #ffffff">$ git diff --cached</span>
|
1489
|
+
<span style="font-weight: bold">diff --git a/build/whitespace_file.txt b/build/whitespace_file.txt</span>
|
1490
|
+
<span style="font-weight: bold">index 1293282..f903ea2 100644</span>
|
1491
|
+
<span style="font-weight: bold">--- a/build/whitespace_file.txt</span>
|
1492
|
+
<span style="font-weight: bold">+++ b/build/whitespace_file.txt</span>
|
1493
|
+
<span style="color: #33d6e5">@@ -42,4 +42,5 @@</span> when the fan was last cleaned.
|
1494
|
+
There was an poignant pause.
|
1495
|
+
|
1496
|
+
CHAPTER 3:
|
1497
|
+
<span style="color: #e42e16">-Hilariousness! This chapter is awesome!</span>
|
1498
|
+
<span style="color: #19c518">+</span><span style="color: #19c518">Mr. Usagi felt that something wasn't right. Shortly after the Domo-Kun left he</span>
|
1499
|
+
<span style="color: #19c518">+</span><span style="color: #19c518">began feeling sick.</span>
|
1500
|
+
</code></pre></div></div><p><div class="paragraph"> Much better</p></div><div class="listingblock"><div class="content"><pre><code><span style="font-weight: bold; color: #ffffff">$ git rebase --continue</span>
|
1501
|
+
Applying: beginning of chapter 3
|
1502
|
+
<span style="font-weight: bold; color: #ffffff">$ git rebase-update</span>
|
1503
|
+
Fetching origin
|
1504
|
+
chap3 up-to-date
|
1505
|
+
<span style="font-weight: bold; color: #ffffff">$ gclient sync</span>
|
1506
|
+
... truncated output ...
|
1507
|
+
<span style="font-weight: bold; color: #ffffff">$ git map</span>
|
1508
|
+
* <span style="font-weight: bold; color: #e42e16">1cb4f5b </span><span style="color: #19c518"> (</span><span style="color: #e42e16">HEAD -> chap3</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ beginning of chapter 3
|
1509
|
+
* <span style="font-weight: bold; color: #e42e16">59cdb73 </span><span style="color: #19c518"> (</span><span style="color: #e42e16">origin/master</span><span style="color: #19c518">, </span><span style="color: #e42e16">origin/HEAD</span><span style="color: #19c518">) </span><span style="color: #e7e71c">2014-04-10</span> ~ Refactor data interchange format.<span style="font-weight: bold"></span><span style="font-weight: bold; color: #ffffff"> <(chap3)</span><span style="font-weight: bold"></span><span style="font-weight: bold"></span>
|
1510
|
+
* <span style="font-weight: bold; color: #e42e16">34676a3 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Ensure FS is exited for all not-in-same-page navigations.
|
1511
|
+
* <span style="font-weight: bold; color: #e42e16">7d4784e </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Add best chapter2 ever!
|
1512
|
+
* <span style="font-weight: bold; color: #e42e16">5d26fec </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Finish chapter 2
|
1513
|
+
* <span style="font-weight: bold; color: #e42e16">df7fefb </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Revert 255617, due to it not tracking use of the link doctor page properly.
|
1514
|
+
* <span style="font-weight: bold; color: #e42e16">4b39cda </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Fix terrible typo.
|
1515
|
+
* <span style="font-weight: bold; color: #e42e16">248c5b6 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Temporarily CHECK(trial) in ChromeRenderProcessObserver::OnSetFieldTrialGroup.
|
1516
|
+
* <span style="font-weight: bold; color: #e42e16">8171df8 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Remove AMD family check for the flapper crypto accelerator.
|
1517
|
+
* <span style="font-weight: bold; color: #e42e16">d6a30d2 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Change the Pica load benchmark to listen for the polymer-ready event
|
1518
|
+
* <span style="font-weight: bold; color: #e42e16">beec6f4 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Make ReflectorImpl use mailboxes
|
1519
|
+
* <span style="font-weight: bold; color: #e42e16">41290e0 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ don't use glibc-specific execinfo.h on uclibc builds
|
1520
|
+
* <span style="font-weight: bold; color: #e42e16">a76fde7 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ [fsp] Add requestUnmount() method together with the request manager.
|
1521
|
+
* <span style="font-weight: bold; color: #e42e16">9de7a71 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ linux_aura: Use system configuration for middle clicking the titlebar.
|
1522
|
+
* <span style="font-weight: bold; color: #e42e16">073b0c2 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ContentView->ContentViewCore in ContentViewRenderView
|
1523
|
+
* <span style="font-weight: bold; color: #e42e16">2250f53 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ ozone: evdev: Filter devices by path
|
1524
|
+
* <span style="font-weight: bold; color: #e42e16">33a7a74 </span><span style="color: #19c518"></span> <span style="color: #e7e71c">2014-04-10</span> ~ Always output seccomp error messages to stderr
|
1525
|
+
<span style="font-weight: bold; color: #ffffff">$ git cl upload</span>
|
1526
|
+
... truncated output ...
|
1527
|
+
</code></pre></div></div><p><div class="paragraph"></p></div>
|
1528
|
+
<div class="paragraph"><p>So there you have the basic flow. Note that you don’t <em>have</em> to do chromium
|
1529
|
+
development using these tools. Any git workflow is compatible, as long as
|
1530
|
+
<code>git cl upload</code> is able to upload good patches.</p></div>
|
1531
|
+
</div>
|
1532
|
+
</div>
|
1533
|
+
<div class="sect1">
|
1534
|
+
<h2 id="_conclusion">CONCLUSION</h2>
|
1535
|
+
<div class="sectionbody">
|
1536
|
+
<div class="paragraph"><p>Hopefully that gives you a good starting overview on Chromium development using
|
1537
|
+
<em>depot_tools</em>. If you have questions which weren’t answered by this tutorial or
|
1538
|
+
the man pages for the tools (see the index of all tools here:
|
1539
|
+
<a href="depot_tools.html">depot_tools(7)</a>), please feel free to ask.</p></div>
|
1540
|
+
</div>
|
1541
|
+
</div>
|
1542
|
+
<div class="sect1">
|
1543
|
+
<h2 id="_glossary">GLOSSARY</h2>
|
1544
|
+
<div class="sectionbody">
|
1545
|
+
<div class="dlist"><dl>
|
1546
|
+
<dt class="hdlist1">
|
1547
|
+
CL
|
1548
|
+
</dt>
|
1549
|
+
<dd>
|
1550
|
+
<p>
|
1551
|
+
A <em>change-list</em>. This is a diff which you would like to commit to the
|
1552
|
+
codebase.
|
1553
|
+
</p>
|
1554
|
+
</dd>
|
1555
|
+
<dt class="hdlist1">
|
1556
|
+
DEPS
|
1557
|
+
</dt>
|
1558
|
+
<dd>
|
1559
|
+
<p>
|
1560
|
+
A file in the chromium checkout which <code>gclient sync</code> uses to determine what
|
1561
|
+
dependencies to pull in. This file also contains <em>hooks</em>.
|
1562
|
+
</p>
|
1563
|
+
</dd>
|
1564
|
+
<dt class="hdlist1">
|
1565
|
+
LKGR
|
1566
|
+
</dt>
|
1567
|
+
<dd>
|
1568
|
+
<p>
|
1569
|
+
Last Known Good Revision. This is a <a href="git-tag.html">git-tag(1)</a> which tracks the last
|
1570
|
+
version of <code>origin/master</code> which has passed the full set of testing on the
|
1571
|
+
<a href="http://build.chromium.org">main Chromium waterfall</a>.
|
1572
|
+
</p>
|
1573
|
+
</dd>
|
1574
|
+
</dl></div>
|
1575
|
+
</div>
|
1576
|
+
</div>
|
1577
|
+
<div class="sect1">
|
1578
|
+
<h2 id="_chromium_depot_tools">CHROMIUM DEPOT_TOOLS</h2>
|
1579
|
+
<div class="sectionbody">
|
1580
|
+
<div class="paragraph"><p>Part of the chromium <a href="depot_tools.html">depot_tools(7)</a> suite. These tools are meant to
|
1581
|
+
assist with the development of chromium and related projects. Download the tools
|
1582
|
+
from <a href="https://chromium.googlesource.com/chromium/tools/depot_tools.git">here</a>.</p></div>
|
1583
|
+
</div>
|
1584
|
+
</div>
|
1585
|
+
</div>
|
1586
|
+
<div id="footnotes"><hr /></div>
|
1587
|
+
<div id="footer">
|
1588
|
+
<div id="footer-text">
|
1589
|
+
Last updated 2019-05-03 10:40:16 EDT
|
1590
|
+
</div>
|
1591
|
+
</div>
|
1592
|
+
</body>
|
1593
|
+
</html>
|