aboutsummaryrefslogtreecommitdiff
path: root/llvm_tools/README.md
diff options
context:
space:
mode:
authorJian Cai <jiancai@google.com>2021-04-29 14:23:49 -0700
committerJian Cai <jiancai@google.com>2021-05-10 20:17:15 +0000
commitfd0b18e0c6c4736b4818b7d30546ae37b17dee8f (patch)
tree82f90a7c9177b26f60145b7edb6ac250e200a157 /llvm_tools/README.md
parent6fed0d0594c243585878e3bdea112838785c2a31 (diff)
downloadtoolchain-utils-fd0b18e0c6c4736b4818b7d30546ae37b17dee8f.tar.gz
llvm_tool: support differential reviews in the cherry-pick tool.
Rename cherrypick_cl.py to get_llvm_upstream.py, and add --differential option for creating local patches based on differential reviews. This should help testing experimental Clang/LLVM patches on ChromeOS. BUG=chromium:1202311 TEST=Successfully run the script with --sha $SHA --differential $DIFFERENTIAL_REVISION Change-Id: I7bd1704d1079352db52fc4690ef453436fe854de Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/third_party/toolchain-utils/+/2861111 Tested-by: Jian Cai <jiancai@google.com> Reviewed-by: George Burgess <gbiv@chromium.org>
Diffstat (limited to 'llvm_tools/README.md')
-rw-r--r--llvm_tools/README.md10
1 files changed, 6 insertions, 4 deletions
diff --git a/llvm_tools/README.md b/llvm_tools/README.md
index fabb37a9..f15040ec 100644
--- a/llvm_tools/README.md
+++ b/llvm_tools/README.md
@@ -472,18 +472,20 @@ r387778
**Tip**: if you put a symlink called `git-llvm-rev` to this script somewhere on
your `$PATH`, you can also use it as `git llvm-rev`.
-### `cherrypick_cl.py`
+### `get_upstream_patch.py`
#### Usage
-This script updates the proper ChromeOS packages with an LLVM cherrypick of your choosing, and
-copies the cherrypick into patch folders of the packages.
+This script updates the proper ChromeOS packages with LLVM patches of your choosing, and
+copies the patches into patch folders of the packages. This tool supports both git hash
+of commits as well as differential reviews.
Usage:
```
-./cherrypick_cl.py --chroot_path /abs/path/to/chroot --start_sha llvm
+./get_upstream_patch.py --chroot_path /abs/path/to/chroot --start_sha llvm
--sha 174c3eb69f19ff2d6a3eeae31d04afe77e62c021 --sha 174c3eb69f19ff2d6a3eeae31d04afe77e62c021
+--differential D123456
```
It tries to autodetect a lot of things (e.g., packages changed by each sha,