README for android-vcard
========================

Android-vcard is a Java library for manipulating vCard files. The source code 
was extracted from the Google Android project.

The project is licensed under Apache License 2.0.

Program links:
Android-vcard homepage. . . http://code.google.com/p/android-vcard/
Source code . . . . . . . . http://code.google.com/p/android-vcard/source/checkout
Google Android. . . . . . . http://source.android.com/

Program files:
ChangeLog       - Description of latest changes.
license.txt     - Library license.
README          - This file.
upstream.md5    - List of md5 hashes of upstream files for detecting changes.
examples/       - Usage examples.
lib/            - Program compilation and runtime libraries.
nbproject/      - Project files for the NetBeans IDE.
src/            - Program sources.
test/           - Program test sources.

Project root directory can be opened by NetBeans IDE as its project.


Compiling library
=================

In sources root directory (where build.xml is located) run this command:

 $ ant clean jar

All the sources should be compiled in the build/ directory. In the dist/
directory the resulting android-vcard.jar should be created, together with all 
needed libraries.

Packaging library
=================

You can run command:

 $ ant package
 
to obtain library in a form of a distribution package in the dist/ directory.