diff options
author | Jakob Buchgraber <buchgr@google.com> | 2017-04-12 14:30:38 +0200 |
---|---|---|
committer | Jakob Buchgraber <buchgr@google.com> | 2017-04-14 14:06:29 +0200 |
commit | 5235d06159ba6fee412bee261ea7867d061252b0 (patch) | |
tree | d502ed5c8d15f750c8ca1eccc2cb929862dd0947 /third_party/protobuf/README.md | |
parent | 5bf9e0f225b4c1636e24782ef9043e6201a65188 (diff) |
protobuf: Update protobuf to @laszlocsomor's master at commit 421d909.
Update protobuf to @laszlocsomor's fork of protobuf. This is essentially
the development version of protobuf 3.2.0 and windows specific fixes
from laszlo. Those fixes will be merged into protobuf soon:
https://github.com/google/protobuf/pull/2969).
For instructions on how to update protobuf for bazel see
README.bazel.md.
Change-Id: Ic1daafe30270cb6bcc6231e6c94fb670af0475e7
Diffstat (limited to 'third_party/protobuf/README.md')
-rw-r--r-- | third_party/protobuf/README.md | 105 |
1 files changed, 77 insertions, 28 deletions
diff --git a/third_party/protobuf/README.md b/third_party/protobuf/README.md index 367d542d06..b26e5424af 100644 --- a/third_party/protobuf/README.md +++ b/third_party/protobuf/README.md @@ -1,28 +1,77 @@ -### 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 +Protocol Buffers - Google's data interchange format +=================================================== + +[![Build Status](https://travis-ci.org/google/protobuf.svg?branch=master)](https://travis-ci.org/google/protobuf) [![Build status](https://ci.appveyor.com/api/projects/status/73ctee6ua4w2ruin?svg=true)](https://ci.appveyor.com/project/protobuf/protobuf) [![Build Status](https://grpc-testing.appspot.com/buildStatus/icon?job=protobuf_branch)](https://grpc-testing.appspot.com/job/protobuf_branch) [![Build Status](https://grpc-testing.appspot.com/job/protobuf_branch_32/badge/icon)](https://grpc-testing.appspot.com/job/protobuf_branch_32) [![Build Status](http://ci.bazel.io/buildStatus/icon?job=protobuf)](http://ci.bazel.io/job/protobuf/) + +Copyright 2008 Google Inc. + +https://developers.google.com/protocol-buffers/ + +Overview +-------- + +Protocol Buffers (a.k.a., protobuf) are Google's language-neutral, +platform-neutral, extensible mechanism for serializing structured data. You +can find [protobuf's documentation on the Google Developers site](https://developers.google.com/protocol-buffers/). + +This README file contains protobuf installation instructions. To install +protobuf, you need to install the protocol compiler (used to compile .proto +files) and the protobuf runtime for your chosen programming language. + +Protocol Compiler Installation +------------------------------ + +The protocol compiler is written in C++. If you are using C++, please follow +the [C++ Installation Instructions](src/README.md) to install protoc along +with the C++ runtime. + +For non-C++ users, the simplest way to install the protocol compiler is to +download a pre-built binary from our release page: + + [https://github.com/google/protobuf/releases](https://github.com/google/protobuf/releases) + +In the downloads section of each release, you can find pre-built binaries in +zip packages: protoc-$VERSION-$PLATFORM.zip. It contains the protoc binary +as well as a set of standard .proto files distributed along with protobuf. + +If you are looking for an old version that is not available in the release +page, check out the maven repo here: + + [http://repo1.maven.org/maven2/com/google/protobuf/protoc/](http://repo1.maven.org/maven2/com/google/protobuf/protoc/) + +These pre-built binaries are only provided for released versions. If you want +to use the github master version at HEAD, or you need to modify protobuf code, +or you are using C++, it's recommended to build your own protoc binary from +source. + +If you would like to build protoc binary from source, see the [C++ Installation +Instructions](src/README.md). + +Protobuf Runtime Installation +----------------------------- + +Protobuf supports several different programming languages. For each programming +language, you can find instructions in the corresponding source directory about +how to install protobuf runtime for that specific language: + +| Language | Source | +|--------------------------------------|-------------------------------------------------------| +| C++ (include C++ runtime and protoc) | [src](src) | +| Java | [java](java) | +| Python | [python](python) | +| Objective-C | [objectivec](objectivec) | +| C# | [csharp](csharp) | +| JavaNano | [javanano](javanano) | +| JavaScript | [js](js) | +| Ruby | [ruby](ruby) | +| Go | [golang/protobuf](https://github.com/golang/protobuf) | +| PHP | [php](php) | + + +Usage +----- + +The complete documentation for Protocol Buffers is available via the +web at: + +https://developers.google.com/protocol-buffers/ |