Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Update README referencing OpenJDK

  • Loading branch information...
commit af3b952dbd95ab1b87f099c7017e896f337d6729 1 parent 280f25a
@jodastephen jodastephen authored
Showing with 31 additions and 119 deletions.
  1. +31 −119 README.txt
View
150 README.txt
@@ -1,119 +1,31 @@
-ThreeTen
-========
-ThreeTen provides a modern date and time library for Java.
-It is the reference implementation for JSR-310.
-
-See the home page for more details and downloads:
-Home page and downloads are at Sourceforge.
-http://threeten.sourceforge.net/
-http://sourceforge.net/projects/threeten/
-
-The source code is held primarily at GitHub:
-https://github.com/ThreeTen/threeten
-
-Geting started
---------------
-The main build process uses Apache Ant - http://ant.apache.org
-From the command line the following options will get you started:
- ant # downloads libraries and compiles code to a jar file
- ant examples # runs a supplied java program to print some examples
- ant javadoc # creates the javadoc
- ant test # runs the main test suite (excluding OpenJDK classes)
- ant tck # runs the tck acceptance test. NB: you must use the -Dtck.implementation parameter in order to specify the jar under test
- ant coverage # calculates test coverage (excluding OpenJDK classes)
-Oracle JDK 1.6 (or OpenJDK) is required to build the codebase.
-
-
-Basic user guide
-----------------
-ThreeTen divides time into two categories - continuous and human.
-
-Continuous time is based around a single incrementing number from a single epoch.
-ThreeTen counts in nanoseconds from 1970-01-01T00:00:00.000000000Z
-Continuous time is represented as follows:
- - Instant - a point on the time-line to nanosecond precision
- - Duration - an amount of time measured in nanoseconds
-
-Human time is based around fields, such as year, month, day and hour.
-ThreeTen supports precision of nanoseconds.
-The year range roughly equal to the range of a 32-bit int.
-Human time is represented via a group of classes:
- - LocalDate - a date, without time of day, offset or zone
- - LocalTime - the time of day, without date, offset or zone
- - LocalDateTime - the date and time, without offset or zone
- - OffsetDate - a date with an offset such as +02:00, without time of day or zone
- - OffsetTime - the time of day with an offset such as +02:00, without date or zone
- - OffsetDateTime - the date and time with an offset such as +02:00, without a zone
- - ZonedDateTime - the date and time with a time zone and offset
- - YearMonth - a year and month
- - MonthDay - month and day
- - Year/MonthOfDay/DayOfWeek/... - classes for the important fields
- - DateTimeFields - stores a map of field-value pairs which may be invalid
- - Calendrical - access to the low-level API
- - Period - a descriptive amount of time, such as "2 months and 3 days"
-
-Support classes include:
- - Clock - wraps the current date and time
- - ZoneOffset - the offset from UTC, such as -05:00
- - ZoneId - the time zone, such as Europe/London
- - Numerous small interfaces - these link the main classes together
-
-Additional packages provide for:
- - formatting and parsing
- - alternate calendar systems
- - single field periods
- - integration with existing Java classes
-
-
-Status
-------
-The ThreeTen project is used to drive the reference implementation of JSR-310.
-The API is currently considered usable and accurate, yet incomplete and subject to change.
-If you use this API you must be able to handle incompatible changes in later versions.
-
-Special efforts with the boot classpath are necessary to test and use
-the integration with the existing Java classes.
-
-Test coverage is high and all current tests pass.
-
-Feedback is welcomed!
-Home page: http://threeten.sourceforge.net/
-Mailing list: http://sourceforge.net/mailarchive/forum.php?forum_name=threeten-develop (develop)
-
-ThreeTen/JSR-310 team
-
-
-(See the license files for detail on licensing, warranty and disclaimers)
-(All trademarks are hereby granted to their respective owners)
-
-/*
- * Copyright (c) 2008, Stephen Colebourne & Michael Nascimento Santos
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- * * Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- *
- * * Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- *
- * * Neither the name of JSR-310 nor the names of its contributors
- * may be used to endorse or promote products derived from this software
- * without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
- * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
- * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
- * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
- * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
- * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
+ThreeTen
+========
+ThreeTen provides a modern date and time library for Java.
+It is the reference implementation for JSR-310.
+
+This GitHub project is currently dormant, as active development
+has moved to OpenJDK:
+
+Project: http://openjdk.java.net/projects/threeten/
+ Code: http://hg.openjdk.java.net/threeten/threeten/jdk
+Javadoc: http://cr.openjdk.java.net/~rriggs/threeten-javadoc/index.html
+
+The active issue tracker is located here at GitHub:
+https://github.com/ThreeTen/threeten/issues
+
+The project was originally housed at Sourceforge.
+The original home page and early downloads are available there:
+http://threeten.sourceforge.net/
+http://sourceforge.net/projects/threeten/
+
+It is intended that the GitHub sourcebase will be used for a
+backport of JSR-310-like functionality to JDK7. However, to avoid
+confusion, this may occur in a separate GitHub repo.
+
+
+Summary of active JSR-310 development
+-------------------------------------
+Home: OpenJDK
+Code: OpenJDK Hg
+Issues: GitHub
+Mailing list: OpenJDK and Sourceforge
Please sign in to comment.
Something went wrong with that request. Please try again.