Import protobuf-codegen-2.14.0
* Add OWNERS, Android.bp, and README.android.
* Hard code version number in src/lib.rs for now.
It could be in a smarter update_package.sh to get the
new version number from Cargo.tom. But until then,
the difference in lib.rs will be caught and fixed manually.
* Rename protoc_gen_rust to protoc-gen-rust for aprotoc plugin.
Bug: 143953733
Test: make
Change-Id: I9b3c3b9f2e7ad0eb203c26534f2b6ba5fac46eef
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5b654ef
--- /dev/null
+++ b/README.md
@@ -0,0 +1,57 @@
+# protobuf-codegen
+
+This crate contains protobuf code generator and a `protoc-gen-rust` `protoc` plugin.
+
+## protoc-gen-rust
+
+`protoc-gen-rust` implements standard protobuf `protoc` plugin conventions.
+
+Probably you do not want to use it directly in Rust environment, there are easier to use alternatives:
+
+* [protoc-rust crate](https://github.com/stepancheg/rust-protobuf/tree/master/protoc-rust)
+ which can be invoked programmatically from `build.rs` of your project
+ which requires only `protoc` in `$PATH` but not `protoc-gen-rust`.
+* [protobuf-codegen-pure crate](https://github.com/stepancheg/rust-protobuf/tree/master/protobuf-codegen-pure)
+ which behaves like protoc-rust, but does not depend on `protoc` binary
+
+## But if you really want to use that plugin, here's the instruction
+
+(Note `protoc` can be invoked programmatically with
+[protoc crate](https://github.com/stepancheg/rust-protobuf/tree/master/protoc/))
+
+0) Install protobuf for `protoc` binary.
+
+On OS X [Homebrew](https://github.com/Homebrew/brew) can be used:
+
+```
+brew install protobuf
+```
+
+On Ubuntu, `protobuf-compiler` package can be installed:
+
+```
+apt-get install protobuf-compiler
+```
+
+Protobuf is needed only for code generation, `rust-protobuf` runtime
+does not use `protobuf` library.
+
+1) Install `protoc-gen-rust` program (which is `protoc` plugin)
+
+It can be installed either from source or with `cargo install protobuf` command.
+
+2) Add `protoc-gen-rust` to $PATH
+
+If you installed it with cargo, it should be
+
+```
+PATH="$HOME/.cargo/bin:$PATH"
+```
+
+3) Generate .rs files:
+
+```
+protoc --rust_out . foo.proto
+```
+
+This will generate .rs files in current directory.