my rage from v8 is spilling over
Go to file
temporal 779f61c6a3 Integrate recent changes from google3.
protoc
- New flags --encode and --decode can be used to convert between protobuf text
  format and binary format from the command-line.
- New flag --descriptor_set_out can be used to write FileDescriptorProtos for
  all parsed files directly into a single output file.  This is particularly
  useful if you wish to parse .proto files from programs written in languages
  other than C++: just run protoc as a background process and have it output
  a FileDescriptorList, then parse that natively.

C++
- Reflection objects are now per-class rather than per-instance.  To make this
  possible, the Reflection interface had to be changed such that all methods
  take the Message instance as a parameter.  This change improves performance
  significantly in memory-bandwidth-limited use cases, since it makes the
  message objects smaller.  Note that source-incompatible interface changes
  like this will not be made again after the library leaves beta.

Python
- MergeFrom(message) and CopyFrom(message) are now implemented.
- SerializeToString() raises an exception if the message is missing required
  fields.
- Code organization improvements.
- Fixed doc comments for RpcController and RpcChannel, which had somehow been
  swapped.
2008-08-13 03:15:00 +00:00
editors Apply Leandro Lucarella <llucax@gmail.com>'s patches for VIM highlighting 2008-07-31 01:43:34 +00:00
examples Initial checkin. 2008-07-10 02:12:20 +00:00
java Sync code with Google-internal branch. Changes: 2008-07-23 01:19:07 +00:00
m4 Initial checkin. 2008-07-10 02:12:20 +00:00
python Integrate recent changes from google3. 2008-08-13 03:15:00 +00:00
src Integrate recent changes from google3. 2008-08-13 03:15:00 +00:00
vsprojects misc. stuff: 2008-07-21 20:28:30 +00:00
autogen.sh Initial checkin. 2008-07-10 02:12:20 +00:00
CHANGES.txt Initial checkin. 2008-07-10 02:12:20 +00:00
configure.ac Initial checkin. 2008-07-10 02:12:20 +00:00
CONTRIBUTORS.txt Heuristically detect sub-messages when printing unknown fields. 2008-08-06 01:12:21 +00:00
COPYING.txt Initial checkin. 2008-07-10 02:12:20 +00:00
generate_descriptor_proto.sh Integrate recent changes from google3. 2008-08-13 03:15:00 +00:00
INSTALL.txt Initial checkin. 2008-07-10 02:12:20 +00:00
Makefile.am Initial checkin. 2008-07-10 02:12:20 +00:00
README.txt misc. stuff: 2008-07-21 20:28:30 +00:00

Protocol Buffers - Google's data interchange format
Copyright 2008 Google Inc.
http://code.google.com/apis/protocolbuffers/

BETA WARNING
============

This package is a beta.  This means that API may change in an
incompatible way in the future.  It's unlikely that any big changes
will be made, but we can make no promises.  Expect a non-beta release
sometime in August 2008.

C++ Installation - Unix
=======================

To build and install the C++ Protocol Buffer runtime and the Protocol
Buffer compiler (protoc) execute the following:

  $ ./configure
  $ make
  $ make check
  $ make install

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, see INSTALL.txt.

** Hint on insall location **

  By default, the package will be installed to /usr/local.  However,
  on many platforms, /usr/local/lib is not part of LD_LIBRARY_PATH.
  You can add it, but it may be easier to just install to /usr
  instead.  To do this, invoke configure as follows:

    ./configure --prefix=/usr

  If you already built the package with a different prefix, make sure
  to run "make clean" before building again.

** Note for Solaris users **

  Solaris 10 x86 has a bug that will make linking fail, complaining
  about libstdc++.la being invalid.  We have included a work-around
  in this package.  To use the work-around, run configure as follows:

    ./configure LDFLAGS=-L$PWD/src/solaris

  See src/solaris/libstdc++.la for more info on this bug.

C++ Installation - Windows
==========================

If you are using Micosoft Visual C++, see vsprojects/readme.txt.

If you are using Cygwin or MinGW, follow the Unix installation
instructions, above.

Java and Python Installation
============================

The Java and Python runtime libraries for Protocol Buffers are located
in the java and python directories.  See the README file in each
directory for more information on how to compile and install them.
Note that both of them require you to first install the Protocol
Buffer compiler (protoc), which is part of the C++ package.

Usage
=====

The complete documentation for Protocol Buffers is available via the
web at:

  http://code.google.com/apis/protocolbuffers/