From 9054a6919b0e93cdd19ab511b87424c6f5019b1a Mon Sep 17 00:00:00 2001 From: Doug Felt Date: Thu, 7 Jan 2010 00:31:57 +0000 Subject: [PATCH] ICU-3072 Add comments at top of Holiday files reminding clients that this is draft API. X-SVN-Rev: 27156 --- icu4j/main/classes/core/src/com/ibm/icu/util/DateRule.java | 5 ++++- .../classes/core/src/com/ibm/icu/util/EasterHoliday.java | 5 ++++- .../classes/core/src/com/ibm/icu/util/HebrewHoliday.java | 5 ++++- icu4j/main/classes/core/src/com/ibm/icu/util/Holiday.java | 5 ++++- .../classes/core/src/com/ibm/icu/util/RangeDateRule.java | 5 ++++- .../classes/core/src/com/ibm/icu/util/SimpleDateRule.java | 5 ++++- .../classes/core/src/com/ibm/icu/util/SimpleHoliday.java | 5 ++++- 7 files changed, 28 insertions(+), 7 deletions(-) diff --git a/icu4j/main/classes/core/src/com/ibm/icu/util/DateRule.java b/icu4j/main/classes/core/src/com/ibm/icu/util/DateRule.java index 35341f9b795..0d0f2f9e14b 100644 --- a/icu4j/main/classes/core/src/com/ibm/icu/util/DateRule.java +++ b/icu4j/main/classes/core/src/com/ibm/icu/util/DateRule.java @@ -1,6 +1,6 @@ /* ******************************************************************************* - * Copyright (C) 1996-2007, International Business Machines Corporation and * + * Copyright (C) 1996-2010, International Business Machines Corporation and * * others. All Rights Reserved. * ******************************************************************************* */ @@ -10,6 +10,9 @@ package com.ibm.icu.util; import java.util.Date; /** + * Note: The Holiday framework is a technology preview. + * Despite its age, is still draft API, and clients should treat it as such. + * * DateRule is an interface for calculating the date of an event. * It supports both recurring events and those which occur only once. * DateRule is useful for storing information about holidays, diff --git a/icu4j/main/classes/core/src/com/ibm/icu/util/EasterHoliday.java b/icu4j/main/classes/core/src/com/ibm/icu/util/EasterHoliday.java index 5f14e209708..982d298db8a 100644 --- a/icu4j/main/classes/core/src/com/ibm/icu/util/EasterHoliday.java +++ b/icu4j/main/classes/core/src/com/ibm/icu/util/EasterHoliday.java @@ -1,6 +1,6 @@ /* ******************************************************************************* - * Copyright (C) 1996-2006, International Business Machines Corporation and * + * Copyright (C) 1996-2010, International Business Machines Corporation and * * others. All Rights Reserved. * ******************************************************************************* */ @@ -10,6 +10,9 @@ package com.ibm.icu.util; import java.util.Date; /** + * Note: The Holiday framework is a technology preview. + * Despite its age, is still draft API, and clients should treat it as such. + * * A Holiday subclass which represents holidays that occur * a fixed number of days before or after Easter. Supports both the * Western and Orthodox methods for calculating Easter. diff --git a/icu4j/main/classes/core/src/com/ibm/icu/util/HebrewHoliday.java b/icu4j/main/classes/core/src/com/ibm/icu/util/HebrewHoliday.java index 01fff4a43ac..bb36af70809 100644 --- a/icu4j/main/classes/core/src/com/ibm/icu/util/HebrewHoliday.java +++ b/icu4j/main/classes/core/src/com/ibm/icu/util/HebrewHoliday.java @@ -1,6 +1,6 @@ /* ******************************************************************************* - * Copyright (C) 1996-2006, International Business Machines Corporation and * + * Copyright (C) 1996-2010, International Business Machines Corporation and * * others. All Rights Reserved. * ******************************************************************************* */ @@ -8,6 +8,9 @@ package com.ibm.icu.util; /** + * Note: The Holiday framework is a technology preview. + * Despite its age, is still draft API, and clients should treat it as such. + * * @draft ICU 2.8 (retainAll) * @provisional This API might change or be removed in a future release. */ diff --git a/icu4j/main/classes/core/src/com/ibm/icu/util/Holiday.java b/icu4j/main/classes/core/src/com/ibm/icu/util/Holiday.java index 0e2b646db25..d80a1492a40 100644 --- a/icu4j/main/classes/core/src/com/ibm/icu/util/Holiday.java +++ b/icu4j/main/classes/core/src/com/ibm/icu/util/Holiday.java @@ -1,6 +1,6 @@ /* ******************************************************************************* - * Copyright (C) 1996-2008, International Business Machines Corporation and * + * Copyright (C) 1996-2010, International Business Machines Corporation and * * others. All Rights Reserved. * ******************************************************************************* */ @@ -13,6 +13,9 @@ import java.util.MissingResourceException; import java.util.ResourceBundle; /** + * Note: The Holiday framework is a technology preview. + * Despite its age, is still draft API, and clients should treat it as such. + * * An abstract class representing a holiday. * @draft ICU 2.8 (retainAll) * @provisional This API might change or be removed in a future release. diff --git a/icu4j/main/classes/core/src/com/ibm/icu/util/RangeDateRule.java b/icu4j/main/classes/core/src/com/ibm/icu/util/RangeDateRule.java index 1438a6bfc39..bfddf511593 100644 --- a/icu4j/main/classes/core/src/com/ibm/icu/util/RangeDateRule.java +++ b/icu4j/main/classes/core/src/com/ibm/icu/util/RangeDateRule.java @@ -1,6 +1,6 @@ /* ******************************************************************************* - * Copyright (C) 1996-2009, International Business Machines Corporation and * + * Copyright (C) 1996-2010, International Business Machines Corporation and * * others. All Rights Reserved. * ******************************************************************************* */ @@ -11,6 +11,9 @@ import java.util.Date; import java.util.Vector; /** + * Note: The Holiday framework is a technology preview. + * Despite its age, is still draft API, and clients should treat it as such. + * * Implementation of DateRule that takes a range. * @draft ICU 2.8 (retainAll) * @provisional This API might change or be removed in a future release. diff --git a/icu4j/main/classes/core/src/com/ibm/icu/util/SimpleDateRule.java b/icu4j/main/classes/core/src/com/ibm/icu/util/SimpleDateRule.java index 82d6158a01f..4503b64af5d 100644 --- a/icu4j/main/classes/core/src/com/ibm/icu/util/SimpleDateRule.java +++ b/icu4j/main/classes/core/src/com/ibm/icu/util/SimpleDateRule.java @@ -1,6 +1,6 @@ /* ******************************************************************************* - * Copyright (C) 1996-2008, International Business Machines Corporation and * + * Copyright (C) 1996-2010, International Business Machines Corporation and * * others. All Rights Reserved. * ******************************************************************************* */ @@ -10,6 +10,9 @@ package com.ibm.icu.util; import java.util.Date; /** + * Note: The Holiday framework is a technology preview. + * Despite its age, is still draft API, and clients should treat it as such. + * * Simple implementation of DateRule. * @draft ICU 2.8 (retainAll) * @provisional This API might change or be removed in a future release. diff --git a/icu4j/main/classes/core/src/com/ibm/icu/util/SimpleHoliday.java b/icu4j/main/classes/core/src/com/ibm/icu/util/SimpleHoliday.java index e4176b8d7c1..3e795029b85 100644 --- a/icu4j/main/classes/core/src/com/ibm/icu/util/SimpleHoliday.java +++ b/icu4j/main/classes/core/src/com/ibm/icu/util/SimpleHoliday.java @@ -1,6 +1,6 @@ /* ******************************************************************************* - * Copyright (C) 1996-2006, International Business Machines Corporation and * + * Copyright (C) 1996-2010, International Business Machines Corporation and * * others. All Rights Reserved. * ******************************************************************************* */ @@ -12,6 +12,9 @@ import com.ibm.icu.util.Calendar; import com.ibm.icu.util.GregorianCalendar; /** + * Note: The Holiday framework is a technology preview. + * Despite its age, is still draft API, and clients should treat it as such. + * * A holiday whose date can be represented by a month, day, and optionally day of week * in the Gregorian calendar. *