From 341b5abef5a039a731c9da260c4e9b76b1849415 Mon Sep 17 00:00:00 2001 From: Yuchen Zeng Date: Tue, 8 Mar 2016 17:16:29 -0800 Subject: [PATCH] Doc Fixit: src/cpp/README need more information --- src/cpp/README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) diff --git a/src/cpp/README.md b/src/cpp/README.md index baeba083155..a13669b99e1 100644 --- a/src/cpp/README.md +++ b/src/cpp/README.md @@ -6,3 +6,62 @@ This directory contains source code for C++ implementation of gRPC. #Status Beta + +#Pre-requisites + +##Linux + +```sh + $ [sudo] apt-get install build-essential autoconf libtool +``` + +##Mac OSX + +For a Mac system, git is not available by default. You will first need to +install Xcode from the Mac AppStore and then run the following command from a +terminal: + +```sh + $ [sudo] xcode-select --install +``` + +##Protoc + +By default gRPC uses [protocol buffers](https://github.com/google/protobuf), +you will need the `protoc` compiler to generate stub server and client code. + +If you compile gRPC from source, as described below, the Makefile will +automatically try and compile the `protoc` in third party if you cloned the +repository recursively and it detects that you don't already have it +installed. + +If it hasn't been installed, you can run the following commands to install it. + +```sh +$ cd grpc/third_party/protobuf +$ sudo make install # 'make' should have been run by core grpc +``` + +Alternatively, you can download `protoc` binaries from +[the protocol buffers Github repository](https://github.com/google/protobuf/releases). + +#INSTALLATION + +Currently to install gRPC for C++, you need to build from source as described below. + +#Build from Source + +```sh + $ git clone https://github.com/grpc/grpc.git + $ cd grpc + $ git submodule update --init + $ make + $ [sudo] make install +``` + +#DOCUMENTATION + +- The gRPC C++ refenrence documentation is available online at + [grpc.io](http://www.grpc.io/docs/tutorials/basic/c.html) +- [Helloworld example](../../examples/cpp/helloworld) +