aboutsummaryrefslogtreecommitdiffhomepage
path: root/third_party/protobuf/README.md
diff options
context:
space:
mode:
authorGravatar Damien Martin-Guillerez <dmarting@google.com>2016-12-21 18:29:04 +0100
committerGravatar Damien Martin-Guillerez <dmarting@google.com>2016-12-21 18:29:04 +0100
commitf1ce35f4691fa5cd8849bf8944d1a4bdd2393690 (patch)
tree8687d77030d82048b53612e0bce816555dd46dd2 /third_party/protobuf/README.md
parentb649428620711c12ba18f7f1477d36742f267a31 (diff)
Commit 6d31cb was an internal reorganization of google repository that should have resulted in no change. Due to a bug in our export process it deleted several files in third_party.
Diffstat (limited to 'third_party/protobuf/README.md')
-rw-r--r--third_party/protobuf/README.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/third_party/protobuf/README.md b/third_party/protobuf/README.md
new file mode 100644
index 0000000000..367d542d06
--- /dev/null
+++ b/third_party/protobuf/README.md
@@ -0,0 +1,28 @@
+### Updating the jar binary
+
+1. Go to http://search.maven.org/
+2. Search for g:"com.google.protobuf"
+3. Download the "jar" link from protobuf-java and put them in `<Bazel tree>/third_party/protobuf/<version>`
+
+* * *
+### Updating `protobuf.bzl` and the `src/` directory:
+
+1. `git clone http://github.com/google/protobuf.git`
+2. `git checkout <tag or commithash>` (e.g. `v3.0.0` or `e8ae137`)
+3. `mkdir -p third_party/protobuf/<version>/src/google` in the root of the Bazel tree.
+4. `cp -R <root of protobuf tree>/src/google/protobuf third_party/protobuf/src/google`
+5. Update the rules in `third_party/protobuf/BUILD` with the rules in the protobuf repository.
+
+Finally, update the rules:
+
+1. Add a BUILD file to `third_party/protobuf/<version>/`. Use the BUILD file
+ for the previous version as a template. Update the `cc_library` rules to
+ match the rules in the BUILD file in the protobuf repository. Also copy
+ `protobuf.bzl` from the protobuf repository into
+ `third_party/protobuf/<version>/`.
+2. Modify `third_party/protobuf/BUILD` to point to the new rules.
+3. Delete the old version of protobuf.
+
+* * *
+### Updating anything else in the directory
+Follow usual procedure as described on https://www.bazel.build/contributing.html