Initial import of v2.0.0beta
[protobuf.git] / examples / README.txt
blobb0d1a0c2e51ec34c5bbff882db94548c35172bd4
1 This directory contains example code that uses Protocol Buffers to manage an
2 address book.  Two programs are provided, each with three different
3 implementations, one written in each of C++, Java, and Python.  The add_person
4 example adds a new person to an address book, prompting the user to input
5 the person's information.  The list_people example lists people already in the
6 address book.  The examples use the exact same format in all three languages,
7 so you can, for example, use add_person_java to create an address book and then
8 use list_people_python to read it.
10 You must install the protobuf package before you can build these.
12 To build all the examples (on a unix-like system), simply run "make".  This
13 creates the following executable files in the current directory:
14   add_person_cpp     list_people_cpp
15   add_person_java    list_people_java
16   add_person_python  list_people_python
18 If you only want to compile examples in one language, use "make cpp",
19 "make java", or "make python".
21 All of these programs simply take an address book file as their parameter.
22 The add_person programs will create the file if it doesn't already exist.
24 These examples are part of the Protocol Buffers tutorial, located at:
25   http://code.google.com/apis/protocolbuffers/docs/tutorials.html