aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorFeng Xiao <xfxyjwf@gmail.com>2016-01-06 16:25:35 -0800
committerFeng Xiao <xfxyjwf@gmail.com>2016-01-06 18:25:25 -0800
commit64d865210f4a10e90e3d914801ab5f21daa4a737 (patch)
tree0257d2abf9cc753a785a0f89f38adb1e6b73c67e /README.md
parent76195058e25d19fc918996d55d3ad69ee55cb77e (diff)
downloadprotobuf-64d865210f4a10e90e3d914801ab5f21daa4a737.tar.gz
protobuf-64d865210f4a10e90e3d914801ab5f21daa4a737.tar.bz2
protobuf-64d865210f4a10e90e3d914801ab5f21daa4a737.zip
Update README.md and remove INSTALL.txt
Added instructions on what tools to install to compile protobuf from source. Removed the INSTALL.txt file because it's just a simple copy of the autoconf documentation and confuses users. Change-Id: I6fd8aa13495f1238fe5c62451b95ad480b1c4bed
Diffstat (limited to 'README.md')
-rw-r--r--README.md35
1 files changed, 30 insertions, 5 deletions
diff --git a/README.md b/README.md
index a974d301..eb57be8a 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,20 @@ https://developers.google.com/protocol-buffers/
C++ Installation - Unix
-----------------------
+To build protobuf from source, the following tools are needed:
+
+ * autoconf
+ * automake
+ * libtool
+ * curl (used to download gmock)
+
+On Ubuntu, you can install them with:
+
+ $ sudo apt-get intall autoconf automake libtool curl
+
+On other platforms, please use the corresponding package managing tool to
+install them before proceeding.
+
If you get the source from github, you need to generate the configure script
first:
@@ -28,15 +42,17 @@ Buffer compiler (protoc) execute the following:
$ ./configure
$ make
$ make check
- $ make install
+ $ sudo make install
+ $ sudo ldconfig # refresh shared library cache.
If "make check" fails, you can still install, but it is likely that
some features of this library will not work correctly on your system.
Proceed at your own risk.
-"make install" may require superuser privileges.
+For advanced usage information on configure and make, please refer to the
+autoconf documentation:
-For advanced usage information on configure and make, see INSTALL.txt.
+ http://www.gnu.org/software/autoconf/manual/autoconf.html#Running-configure-Scripts
**Hint on install location**
@@ -156,9 +172,18 @@ For advanced usage information on configure and make, see INSTALL.txt.
C++ Installation - Windows
--------------------------
-If you are using Microsoft Visual C++, see cmake/README.md.
+If you only need the protoc binary, you can download it from the release
+page:
+
+ https://github.com/google/protobuf/releases
+
+In the downloads section, download the zip file protoc-$VERSION-win32.zip.
+It contains the protoc binary as well as public proto files of protobuf
+library.
+
+To build from source using Microsoft Visual C++, see cmake/README.md.
-If you are using Cygwin or MinGW, follow the Unix installation
+To build from source using Cygwin or MinGW, follow the Unix installation
instructions, above.
Binary Compatibility Warning