aboutsummaryrefslogtreecommitdiff
path: root/llvm_tools
diff options
context:
space:
mode:
authorGeorge Burgess IV <gbiv@google.com>2020-03-20 13:04:51 -0700
committerGeorge Burgess <gbiv@chromium.org>2020-03-20 20:09:59 +0000
commit93535dbdbe90df6d6672b87225c83378532237a3 (patch)
tree99daa3cc04b6367e834515c7d00af1d5672d17a7 /llvm_tools
parentf2bba3e2c1071e9965d9702da29ea4fecd7c9040 (diff)
downloadtoolchain-utils-93535dbdbe90df6d6672b87225c83378532237a3.tar.gz
llvm_tools: add git_llvm_rev notes.
BUG=None TEST=None Change-Id: I64dd7b2e8a5e5210d3a53bb1de5c510072715aa4 Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/third_party/toolchain-utils/+/2113170 Reviewed-by: Manoj Gupta <manojgupta@chromium.org> Tested-by: George Burgess <gbiv@chromium.org>
Diffstat (limited to 'llvm_tools')
-rw-r--r--llvm_tools/README.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/llvm_tools/README.md b/llvm_tools/README.md
index 5d27a962..07c11651 100644
--- a/llvm_tools/README.md
+++ b/llvm_tools/README.md
@@ -471,6 +471,23 @@ from get_llvm_hash import GetGoogle3LLVMVersion
GetGoogle3LLVMVersion(stable=True)
```
+### `git_llvm_rev.py`
+
+This script is meant to synthesize LLVM revision numbers, and translate between
+these synthesized numbers and git SHAs. Usage should be straightforward:
+
+```
+~> ./git_llvm_rev.py --llvm_dir llvm-project-copy/ --rev r380000
+6f635f90929da9545dd696071a829a1a42f84b30
+~> ./git_llvm_rev.py --llvm_dir llvm-project-copy/ --sha 6f635f90929da9545dd696071a829a1a42f84b30
+r380000
+~> ./git_llvm_rev.py --llvm_dir llvm-project-copy/ --sha origin/master
+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`
#### Usage