Guava: Google Core Libraries for Java
=====================================

Requires JDK 1.6 or higher (as of 12.0).

Project page:
  http://guava-libraries.googlecode.com

Report a defect or feature request here:
  http://code.google.com/p/guava-libraries/issues/entry

Ask "how-to" and "why-didn't-it-work" questions at:
  http://www.stackoverflow.com/questions/ask (use the "guava" tag)

For open-ended questions and discussion:
  http://groups.google.com/group/guava-discuss

Subscribe to project updates in your feed reader:
  http://code.google.com/feeds/p/guava-libraries/updates/basic

IMPORTANT WARNINGS
------------------

1. APIs marked with the @Beta annotation at the class or method level
are subject to change. They can be modified in any way, or even
removed, at any time. If your code is a library itself (i.e. it is
used on the CLASSPATH of users outside your own control), you should
not use beta APIs, unless you repackage them (e.g. using ProGuard).

2. Deprecated non-beta APIs will be removed eighteen months after the
release in which they are first deprecated. You must fix your
references before this time. If you don't, any manner of breakage
could result (you are not guaranteed a compilation error).

3. Serialized forms of ALL objects are subject to change. Do not
persist these and assume they can be read by a future version of the
library.

4. Our classes are not designed to protect against a malicious caller.
You should not use them for communication between trusted and
untrusted code.

5. We unit-test and benchmark the libraries using only OpenJDK 1.6 on
Linux. Some features, especially in com.google.common.io, may not work
correctly in other environments.

URL: http://code.google.com/p/guava-libraries/source/checkout
Version: v11.0.2
License: Apache 2
Description: "Guava: Google Core Libraries for Java 1.5"

Local Modifications:
   Commented out use of the non-public sun.misc.Unsafe
   from guava/src/com/google/common/primitives/UnsignedBytes.java
   Look for "BEGIN/END android-changed" markers.

Guava-libraries are a grab bag of utility libraries published by Google as
open source, including among other things the Google collections libraries.

This code is built as a static library.

Guava: Google Core Libraries for Java (JDK5 Backport)
=====================================================

This is the JDK5 backport of Guava. Notable differences from the
JDK6 version of Guava include:

- A variety of code is removed, most notably code that uses
  `Math.scalb`, `Deque` and its inheritors, `NavigableMap`,
  `NavigableSet` and their inheritors, and lots of methods that don't
  make sense without the above.
- `TimeUnit` only supports `SECONDS` as the highest granularity time
  unit in 1.5, so all uses of `MINUTES`, `DAYS` and `HOURS` have been
  re-cast in terms of `SECONDS`.
- `Charset`-accepting methods on `String` and elsewhere were added in
  1.6, so all charsets are passed in by using `Charsets.FOO.name()`,
  and exceptions are trapped or thrown as appropriate.
- The guava-gwt module is disabled by not including it in the list
  of modules in the parent pom.xml.

The JDK5 backport builds with Maven, but has a number of
ideosyncrasies.

- While it uses `-source 1.5` and `-target 1.5` and produces valid 1.5
  compatible class files, the backport does not build with JDK5.
  @Override annotations on interface methods are retained.
- It requries a custom ExecutorService and AbstractExecutorService,
  which we build in a boostrap project which is included in the build
  of guava, guava-testlib and guava-tests.
- The Maven build will use a bootstrap rt.jar classpath based on a
  standard sun JDK on unix. But this is overridable on a Mac by
  passing in `-Dbootstrap.classes=/path/to/my/classes.jar`. Since
  the backport will not build with JDK5, a JDK5 `rt.jar` should be used
  to ensure that no JDK6+ APIs are used. If you have difficulties
  building, please try setting the `bootstrap.classes` property to a
  known `rt.jar` or `classes.jar`.
- Some tests will fail when run under JDK5 due to `guava-testlib` and
  `guava-tests` having dependencies on other libraries that are compiled
  with `-target 1.6`.

These folders host the maven metadata which are used to
build release binaries for hosting in the central maven
repositories.  These are not considered the "canonical"
build, but are maintained seperately by (a) volunteer(s)
with an interest in easy use of Guava by the Maven build
system.

As a convenience, these folders have been set up to
provide alternate packaging of the sub-pmodules, which
correspond to their respective java packages, with
sources symbolically linked back to the main project.
This will work to allow command-line builds on MacOS X
or other Unix platforms which support symbolic linking,
but is not known to work on Windows platforms.
(Obviously the deployed binaries in maven repostories
will work fine on any compliant JVM).

The maintainers of these metadata have used M2Eclipse
to import these projects directly into Eclipse.  Please
remember that this codebase uses @Override annotations
on methods which implement an interface method, and
therefore require a JDK 1.6 (or newer 1.5 with the
appropriate fix) to support this behaviour.  Executing
Maven with an appropriate JAVA_HOME env is sufficient,
and these metadata do not have toolchain restrictions
currently set up.

Christian
cgruber@google.com