| OLD | NEW |
| 1 Commit Queue Keywords | 1 Commit Queue Keywords |
| 2 ===================== | 2 ===================== |
| 3 | 3 |
| 4 COMMIT | 4 COMMIT |
| 5 ------ | 5 ------ |
| 6 | 6 |
| 7 If you are working on experimental code and do not want to risk accidentally | 7 If you are working on experimental code and do not want to risk accidentally |
| 8 submitting the change via the CQ, then you can mark it with "COMMIT=false". | 8 submitting the change via the CQ, then you can mark it with "COMMIT=false". |
| 9 The CQ will immediately abandon the change if it contains this option. | 9 The CQ will immediately abandon the change if it contains this option. |
| 10 To do a dry run through the CQ please use Rietveld's [dry run](https://groups.go
ogle.com/a/chromium.org/forum/#!topic/chromium-dev/G5-X0_tfmok) feature. | 10 To do a dry run through the CQ please use Rietveld's [dry run](https://groups.go
ogle.com/a/chromium.org/forum/#!topic/chromium-dev/G5-X0_tfmok) feature. |
| 11 | 11 |
| 12 COMMIT=false | 12 COMMIT=false |
| 13 | 13 |
| 14 The CQ will run through its list of verifiers (reviewer check, trybots, tree che
ck, | 14 The CQ will run through its list of verifiers (reviewer check, trybots, tree che
ck, |
| 15 presubmit check), and will close the issue instead of committing it. | 15 presubmit check), and will close the issue instead of committing it. |
| 16 | 16 |
| 17 NO_DEPENDENCY_CHECKS | 17 NO_DEPENDENCY_CHECKS |
| 18 -------------------- | 18 -------------------- |
| 19 | 19 |
| 20 NO_DEPENDENCY_CHECKS=true | 20 NO_DEPENDENCY_CHECKS=true |
| 21 | 21 |
| 22 The CQ rejects patchsets with open dependencies. An open dependency exists when
a CL | 22 The CQ rejects patchsets with open dependencies. An open dependency exists when
a CL |
| 23 depends on another CL that is not yet closed. You can skip this check with this
keyword. | 23 depends on another CL that is not yet closed. You can skip this check with this
keyword. |
| 24 | 24 |
| 25 CQ_INCLUDE_TRYBOTS | 25 CQ_INCLUDE_TRYBOTS |
| 26 ------------------ | 26 ------------------ |
| 27 | 27 |
| 28 Allows you to add arbitrary trybots to the CQ's list of default trybots. | 28 Allows you to add arbitrary trybots to the CQ's list of default trybots. |
| 29 The CQ will block till these tryjobs pass just like the default list of tryjobs. | 29 The CQ will block till these tryjobs pass just like the default list of tryjobs. |
| 30 | 30 |
| 31 This is the format of the values of this keyword: | 31 This is the format of the values of this keyword: |
| 32 | 32 |
| 33 CQ_INCLUDE_TRYBOTS=master1:bot1,bot2;master2:bot3,bot4 | 33 CQ_INCLUDE_TRYBOTS=master1:bot1,bot2;master2:bot3,bot4 |
| 34 | 34 |
| 35 Here are some real world examples: | 35 Here are some real world examples: |
| 36 | 36 |
| 37 CQ_INCLUDE_TRYBOTS=tryserver.chromium:linux_layout_rel | 37 CQ_INCLUDE_TRYBOTS=tryserver.chromium:linux_layout_rel |
| 38 | 38 |
| 39 CQ_INCLUDE_TRYBOTS=tryserver.skia:Build-Mac10.9-Clang-x86_64-Debug | 39 CQ_INCLUDE_TRYBOTS=tryserver.skia:Build-Mac10.9-Clang-x86_64-Debug |
| 40 | 40 |
| 41 CQ_EXCLUDE_TRYBOTS | 41 CQ_EXCLUDE_TRYBOTS |
| 42 ------------------ | 42 ------------------ |
| 43 | 43 |
| 44 Allows you to remove trybots from the CQ's list of default trybots. Should only
be | 44 Allows you to remove trybots from the CQ's list of default trybots. Should only
be |
| 45 used when particular builders are failing for reasons unrelated to your code cha
nges. | 45 used when particular builders are failing for reasons unrelated to your code cha
nges. |
| 46 | 46 |
| 47 This is the format of the values of this keyword: | 47 This is the format of the values of this keyword: |
| 48 | 48 |
| 49 CQ_EXCLUDE_TRYBOTS=master1:bot1,bot2;master2:bot3,bot4 | 49 CQ_EXCLUDE_TRYBOTS=master1:bot1,bot2;master2:bot3,bot4 |
| 50 | 50 |
| 51 Here are some real world examples: | 51 Here are some real world examples: |
| 52 | 52 |
| 53 CQ_EXCLUDE_TRYBOTS=tryserver.chromium:win_chromium_compile_dbg | 53 CQ_EXCLUDE_TRYBOTS=tryserver.chromium:win_chromium_compile_dbg |
| 54 | 54 |
| 55 CQ_EXCLUDE_TRYBOTS=tryserver.skia:Build-Win7-VS2010-x86-Debug-Trybot | 55 CQ_EXCLUDE_TRYBOTS=tryserver.skia:Build-Win7-VS2010-x86-Debug-Trybot |
| 56 | 56 |
| 57 CQ_TRYBOTS | 57 CQ_TRYBOTS |
| 58 ---------- | 58 ---------- |
| 59 | 59 |
| 60 Allows you to list every trybot that you want to run for your CL. | 60 Allows you to list every trybot that you want to run for your CL. |
| 61 | 61 |
| 62 This is the format of the values of this keyword: | 62 This is the format of the values of this keyword: |
| 63 | 63 |
| 64 CQ_TRYBOTS=master1:bot1,bot2;master2:bot3,bot4 | 64 CQ_TRYBOTS=master1:bot1,bot2;master2:bot3,bot4 |
| 65 | 65 |
| 66 Here are some real world examples: | 66 Here are some real world examples: |
| 67 | 67 |
| 68 CQ_TRYBOTS=tryserver.chromium:linux_chromium_gn_rel,linux_chromium_chromeos_
rel, | 68 CQ_TRYBOTS=tryserver.chromium:linux_chromium_gn_rel,linux_chromium_chromeos_
rel, |
| 69 android_dbg_triggered_tests,android_dbg,mac_chromium_rel,win_chromium_x64_
rel | 69 android_dbg_triggered_tests,android_dbg,mac_chromium_rel,win_chromium_x64_
rel |
| 70 | 70 |
| 71 CQ_TRYBOTS=tryserver.skia:Build-Win7-VS2010-x86-Debug-Trybot, | 71 CQ_TRYBOTS=tryserver.skia:Build-Win7-VS2010-x86-Debug-Trybot, |
| 72 Test-Ubuntu13.10-ShuttleA-NoGPU-x86_64-Debug-Trybot, | 72 Test-Ubuntu13.10-ShuttleA-NoGPU-x86_64-Debug-Trybot, |
| 73 Build-Ubuntu13.10-GCC4.8-x86_64-Release-Trybot, | 73 Build-Ubuntu13.10-GCC4.8-x86_64-Release-Trybot, |
| 74 Build-Ubuntu13.10-Clang-x86_64-Debug-Trybot,Build-Mac10.8-Clang-x86_64-Rel
ease-Trybot | 74 Build-Ubuntu13.10-Clang-x86_64-Debug-Trybot,Build-Mac10.8-Clang-x86_64-Rel
ease-Trybot |
| 75 | 75 |
| 76 TBR | 76 TBR |
| 77 --- | 77 --- |
| 78 | 78 |
| 79 If you are a Skia committer and cannot wait for a review, | 79 If you are a Skia committer and cannot wait for a review, |
| 80 then you can include the TBR keyword in your CL's description. | 80 then you can include the TBR keyword in your CL's description. |
| 81 | 81 |
| 82 Example: | 82 Example: |
| 83 | 83 |
| 84 TBR=rmistry@google.com | 84 TBR=rmistry@google.com |
| 85 | 85 |
| 86 NOTREECHECKS | 86 NOTREECHECKS |
| 87 ------------ | 87 ------------ |
| 88 | 88 |
| 89 If you want to skip the tree status checks, to make the CQ commit a CL even if t
he tree is closed, | 89 If you want to skip the tree status checks, to make the CQ commit a CL even if t
he tree is closed, |
| 90 you can add the following line to the CL description: | 90 you can add the following line to the CL description: |
| 91 | 91 |
| 92 NOTREECHECKS=true | 92 NOTREECHECKS=true |
| 93 | 93 |
| 94 This is discouraged, since the tree is closed for a reason. However, in rare cas
es this is acceptable, | 94 This is discouraged, since the tree is closed for a reason. However, in rare cas
es this is acceptable, |
| 95 primarily to fix build breakages (i.e., your CL will help in reopening the tree)
. | 95 primarily to fix build breakages (i.e., your CL will help in reopening the tree)
. |
| 96 | 96 |
| 97 NOPRESUBMIT | 97 CQ_EXCLUDE_TRYBOTS=client.skia.fyi:skia_presubmit-Trybot (née NOPRESUBMIT) |
| 98 ----------- | 98 ----------- |
| 99 | 99 |
| 100 If you want to skip the presubmit checks, add the following line to the CL descr
iption: | 100 If you want to skip the presubmit checks, add the following line to the CL descr
iption: |
| 101 | 101 |
| 102 NOPRESUBMIT=true | 102 CQ_EXCLUDE_TRYBOTS=client.skia.fyi:skia_presubmit-Trybot |
| 103 | 103 |
| 104 NOTRY | 104 NOTRY |
| 105 ----- | 105 ----- |
| 106 | 106 |
| 107 If you cannot wait for the try job results, you can add the following line to th
e CL description: | 107 If you cannot wait for the try job results, you can add the following line to th
e CL description: |
| 108 | 108 |
| 109 NOTRY=true | 109 NOTRY=true |
| 110 | 110 |
| 111 The CQ will then not run any try jobs for your change and will commit the CL as
soon as the tree is open, assuming the presubmit check passes. | 111 The CQ will then not run any try jobs for your change and will commit the CL as
soon as the tree is open, assuming the presubmit check passes. |
| 112 | 112 |
| 113 NO_MERGE_BUILDS | 113 NO_MERGE_BUILDS |
| 114 --------------- | 114 --------------- |
| 115 | 115 |
| 116 This keyword prevents the Skia build masters from building this commit with othe
rs. Use it when your | 116 This keyword prevents the Skia build masters from building this commit with othe
rs. Use it when your |
| 117 commit may have effects that you don't want mis-attributed to other commits. Jus
t include the keyword | 117 commit may have effects that you don't want mis-attributed to other commits. Jus
t include the keyword |
| 118 somewhere in the commit message: | 118 somewhere in the commit message: |
| 119 | 119 |
| 120 NO_MERGE_BUILDS | 120 NO_MERGE_BUILDS |
| OLD | NEW |