README.txt
1This directory contains example code that uses Protocol Buffers to manage an
2address book. Two programs are provided, each with three different
3implementations, one written in each of C++, Java, and Python. The add_person
4example adds a new person to an address book, prompting the user to input
5the person's information. The list_people example lists people already in the
6address book. The examples use the exact same format in all three languages,
7so you can, for example, use add_person_java to create an address book and then
8use list_people_python to read it.
9
10You must install the protobuf package before you can build these.
11
12To build all the examples (on a unix-like system), simply run "make". This
13creates 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
17
18If you only want to compile examples in one language, use "make cpp"*,
19"make java", or "make python".
20
21All of these programs simply take an address book file as their parameter.
22The add_person programs will create the file if it doesn't already exist.
23
24These examples are part of the Protocol Buffers tutorial, located at:
25 http://code.google.com/apis/protocolbuffers/docs/tutorials.html
26
27* Note that on some platforms you may have to edit the Makefile and remove
28"-lpthread" from the linker commands (perhaps replacing it with something else).
29We didn't do this automatically because we wanted to keep the example simple.
30