add java5 EOS notice and clean up readme

README.md

@@ -2,22 +2,33 @@
 
 ## <a name='maintenance'>Library maintenance</a>
 
-This client library is supported but in maintenance mode only. We are fixing necessary bugs and adding essential features to ensure this library continues to meet your needs for accessing Google APIs. Non-critical issues will be closed. Any issue may be reopened if it is causing ongoing problems.
+This client library is supported but in maintenance mode only. We are fixing necessary bugs and
+adding essential features to ensure this library continues to meet your needs for accessing Google
+APIs. Non-critical issues will be closed. Any issue may be reopened if it is causing ongoing
+problems.
 
 ## Description
 
-Written by Google, the Google OAuth Client Library for Java is a powerful and easy-to-use Java library for the OAuth 1.0a and OAuth 2.0 authorization standards. The Google OAuth Client Library for Java is designed to work with any OAuth service on the web, not just with Google APIs. It is built on the [Google HTTP Client Library for Java](https://github.com/google/google-http-java-client).
+Written by Google, the Google OAuth Client Library for Java is a powerful and easy-to-use Java
+library for the OAuth 1.0a and OAuth 2.0 authorization standards. The Google OAuth Client Library
+for Java is designed to work with any OAuth service on the web, not just with Google APIs. It is
+built on the [Google HTTP Client Library for Java](https://github.com/google/google-http-java-client).
 
 The library supports the following Java environments:
- - Java 5 (or higher), standard (SE) and enterprise (EE)
- - Android 2.1 (or higher)
- - Google App Engine
 
-For access to Google APIs, see the [Google APIs Client Library for Java](https://github.com/google/google-api-java-client).
+- Java 5 (or higher), standard (SE) and enterprise (EE)
+- Android 2.1 (or higher)
+- Google App Engine
 
-This is an open-source library, and [contributions](https://developers.google.com/api-client-library/java/google-oauth-java-client/contribute) are welcome.
+For access to Google APIs, see the
+[Google APIs Client Library for Java](https://github.com/google/google-api-java-client).
+
+This is an open-source library, and
+[contributions](https://developers.google.com/api-client-library/java/google-oauth-java-client/contribute)
+are welcome.
 
 ## Documentation
+
 - [Developer's Guide](https://developers.google.com/api-client-library/java/google-oauth-java-client/)
 - [Setup Instructions](https://developers.google.com/api-client-library/java/google-oauth-java-client/setup)
 - [Samples](https://developers.google.com/api-client-library/java/google-oauth-java-client/samples)
@@ -26,7 +37,15 @@ This is an open-source library, and [contributions](https://developers.google.co
 - [Support (Questions, Bugs)](https://developers.google.com/api-client-library/java/google-oauth-java-client/support)
 
 ## Links
-- Blogs
-  - [Announcements](http://google-oauth-java-client.blogspot.com/)
-- Groups
-  - [Discuss](http://groups.google.com/group/google-oauth-java-client)
+
+- [Announcements](http://google-oauth-java-client.blogspot.com/)
+- [Discuss](http://groups.google.com/group/google-oauth-java-client)
+
+## Notice: Ending Java 5 Support
+
+Please note: since Java 5 is no longer supported by Oracle or in Android, we will begin ending
+Java 5 support in release 1.24.0. Users may stay still use these libraries in Java 5 projects for
+some time, but going forward we will not ensure that these libraries work in such an environment.
+After 1.24.0, our supported versions will include Java 6 and onward.
+
+For questions or concerns, please file an issue.