README
1 Guava: Google Core Libraries for Java
2 =====================================
3
4 Requires JDK 1.5 or higher.
5
6 Project page:
7 http://guava-libraries.googlecode.com
8
9 Report a defect or feature request here:
10 http://code.google.com/p/guava-libraries/issues/entry
11
12 Ask "how-to" and "why-didn't-it-work" questions at:
13 http://www.stackoverflow.com/questions/ask (use the "guava" tag)
14
15 For open-ended questions and discussion:
16 http://groups.google.com/group/guava-discuss
17
18 Subscribe to project updates in your feed reader:
19 http://code.google.com/feeds/p/guava-libraries/updates/basic
20
21 IMPORTANT WARNINGS
22 ------------------
23
24 1. APIs marked with the @Beta annotation at the class or method level
25 are subject to change. They can be modified in any way, or even
26 removed, at any time. If your code is a library itself (i.e. it is
27 used on the CLASSPATH of users outside your own control), you should
28 not use beta APIs, unless you repackage them (e.g. using ProGuard).
29
30 2. Deprecated non-beta APIs will be removed eighteen months after the
31 release in which they are first deprecated. You must fix your
32 references before this time. If you don't, any manner of breakage
33 could result (you are not guaranteed a compilation error).
34
35 3. Serialized forms of ALL objects are subject to change. Do not
36 persist these and assume they can be read by a future version of the
37 library.
38
39 4. Our classes are not designed to protect against a malicious caller.
40 You should not use them for communication between trusted and
41 untrusted code.
42
43 5. We unit-test and benchmark the libraries using only OpenJDK 1.6 on
44 Linux. Some features, especially in com.google.common.io, may not work
45 correctly in other environments.
46
47