AuroraMiddleware/scuffed-code
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

ICU-4195 doc tag cleanup for 3.2 release

Browse Source 
X-SVN-Rev: 16733
This commit is contained in:
Doug Felt 2004-11-02 22:31:02 +00:00
parent 541aee4f63
commit bb02387c91
15 changed files with 459 additions and 578 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
icu4j/src/com/ibm/icu/dev/tool/docs/CheckTags.java
View File

@ -350,10 +350,10 @@ public class CheckTags {
break;
case OBSOLETE:
foundObsoleteTag = true;
if (tag.text().indexOf("ICU") != 0) {
tagErr(tag);
}
foundObsoleteTag = true;
foundRequiredTag = true;
break;

706
icu4j/src/com/ibm/icu/lang/UCharacter.java
View File

File diff suppressed because it is too large Load Diff

8
icu4j/src/com/ibm/icu/lang/UProperty.java
View File

@ -309,8 +309,7 @@ public interface UProperty
* <p>Either the source of a case
* mapping or _in_ the target of a case mapping. Not the same as
* the general category Cased_Letter.</p>
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int CASE_SENSITIVE = 34;
@ -508,9 +507,8 @@ public interface UProperty
/**
* Enumerated property Hangul_Syllable_Type, new in Unicode 4.
* Returns HangulSyllableType values.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* */
* @stable ICU 2.6
*/
public static final int HANGUL_SYLLABLE_TYPE = 0x100B;
/**

51
icu4j/src/com/ibm/icu/lang/UScript.java
View File

@ -237,8 +237,7 @@ public final class UScript {
public static final int TIBETAN = 39; /* Tibt */
/**
* Unified Canadian Aboriginal Symbols
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int CANADIAN_ABORIGINAL = 40; /* Cans */
/**
@ -274,58 +273,58 @@ public final class UScript {
/**
* Braille
* New script in Unicode 4
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* */
* @stable ICU 2.6
*
*/
public static final int BRAILLE = 46; /* Brai */
/**
* Cypriot
* New script in Unicode 4
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* */
* @stable ICU 2.6
*
*/
public static final int CYPRIOT = 47; /* Cprt */
/**
* Limbu
* New script in Unicode 4
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* */
* @stable ICU 2.6
*
*/
public static final int LIMBU = 48; /* Limb */
/**
* Linear B
* New script in Unicode 4
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* */
* @stable ICU 2.6
*
*/
public static final int LINEAR_B = 49; /* Linb */
/**
* Osmanya
* New script in Unicode 4
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* */
* @stable ICU 2.6
*
*/
public static final int OSMANYA = 50; /* Osma */
/**
* Shavian
* New script in Unicode 4
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* */
* @stable ICU 2.6
*
*/
public static final int SHAVIAN = 51; /* Shaw */
/**
* Tai Le
* New script in Unicode 4
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* */
* @stable ICU 2.6
*
*/
public static final int TAI_LE = 52; /* Tale */
/**
* Ugaritic
* New script in Unicode 4
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* */
* @stable ICU 2.6
*
*/
public static final int UGARITIC = 53; /* Ugar */
/**
* New script code in Unicode 4.0.1

3
icu4j/src/com/ibm/icu/text/BreakIterator.java
View File

@ -719,8 +719,7 @@ public abstract class BreakIterator implements Cloneable
* Returns a list of locales for which BreakIterators can be used.
* @return An array of Locales. All of the locales in the array can
* be used when creating a BreakIterator.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static synchronized Locale[] getAvailableLocales()
{

21
icu4j/src/com/ibm/icu/text/CollationKey.java
View File

@ -87,8 +87,7 @@ public final class CollationKey implements Comparable
/**
* Options that used in the API CollationKey.getBound() for getting a
* CollationKey based on the bound mode requested.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final class BoundMode
{
@ -99,30 +98,26 @@ public final class CollationKey implements Comparable
/**
* Lower bound
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int LOWER = 0;
/**
* Upper bound that will match strings of exact size
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int UPPER = 1;
/**
* Upper bound that will match all the strings that have the same
* initial substring as the given string
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int UPPER_LONG = 2;
/**
* Number of bound mode
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int COUNT = 3;
@ -441,8 +436,7 @@ public final class CollationKey implements Comparable
* @see Collator#TERTIARY
* @see Collator#QUATERNARY
* @see Collator#IDENTICAL
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public CollationKey getBound(int boundType, int noOfLevels)
{
@ -538,8 +532,7 @@ public final class CollationKey implements Comparable
* i.e. <tt>new CollationKey(null, merge_sort_order)</tt>
* @exception IllegalArgumentException thrown if source CollationKey
* argument is null or of 0 length.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public CollationKey merge(CollationKey source)
{

47
icu4j/src/com/ibm/icu/text/Collator.java
View File

@ -306,8 +306,7 @@ public abstract class Collator implements Comparator, Cloneable
/**
* Clone the collator.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
* @return a clone of this collator.
*/
public Object clone() throws CloneNotSupportedException {
@ -320,8 +319,7 @@ public abstract class Collator implements Comparator, Cloneable
* A factory used with registerFactory to register multiple collators and provide
* display names for them. If standard locale display names are sufficient,
* Collator instances may be registered instead.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static abstract class CollatorFactory {
/**
@ -330,8 +328,7 @@ public abstract class Collator implements Comparator, Cloneable
* be listed by getAvailableLocales.
*
* @return true if this factory is visible
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public boolean visible() {
return true;
@ -342,8 +339,7 @@ public abstract class Collator implements Comparator, Cloneable
* is not supported, return null.
* @param loc the locale for which this collator is to be created.
* @return the newly created collator.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public abstract Collator createCollator(ULocale loc);
@ -353,8 +349,7 @@ public abstract class Collator implements Comparator, Cloneable
* @param objectLocale the locale identifying the collator
* @param displayLocale the locale for which the display name of the collator should be localized
* @return the display name
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public String getDisplayName(ULocale objectLocale, ULocale displayLocale) {
if (visible()) {
@ -372,15 +367,13 @@ public abstract class Collator implements Comparator, Cloneable
* supported by this factory.
*
* @return the set of supported locale IDs.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public abstract Set getSupportedLocaleIDs();
/**
* Empty default constructor.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
protected CollatorFactory() {
}
@ -474,8 +467,7 @@ public abstract class Collator implements Comparator, Cloneable
* @param factory the factory to register
* @return an object that can be used to unregister the registered factory.
*
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final Object registerFactory(CollatorFactory factory) {
return getShim().registerFactory(factory);
@ -485,8 +477,7 @@ public abstract class Collator implements Comparator, Cloneable
* Unregister a collator previously registered using registerInstance.
* @param registryKey the object previously returned by registerInstance.
* @return true if the collator was successfully unregistered.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final boolean unregister(Object registryKey) {
if (shim == null) {
@ -631,8 +622,7 @@ public abstract class Collator implements Comparator, Cloneable
* @param objectLocale the locale of the collator
* @param displayLocale the locale for the collator's display name
* @return the display name
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
static public String getDisplayName(Locale objectLocale, Locale displayLocale) {
return getShim().getDisplayName(ULocale.forLocale(objectLocale),
@ -655,8 +645,7 @@ public abstract class Collator implements Comparator, Cloneable
* Get the name of the collator for the objectLocale, localized for the current locale.
* @param objectLocale the locale of the collator
* @return the display name
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
static public String getDisplayName(Locale objectLocale) {
return getShim().getDisplayName(ULocale.forLocale(objectLocale), ULocale.getDefault());
@ -870,8 +859,7 @@ public abstract class Collator implements Comparator, Cloneable
* element for the variable top has more than two bytes
* @see #getVariableTop
* @see RuleBasedCollator#setAlternateHandlingShifted
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public abstract int setVariableTop(String varTop);
@ -880,8 +868,7 @@ public abstract class Collator implements Comparator, Cloneable
* Lower 16 bits are undefined and should be ignored.
* @return the variable top value of a Collator.
* @see #setVariableTop
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public abstract int getVariableTop();
@ -893,13 +880,13 @@ public abstract class Collator implements Comparator, Cloneable
* getVariableTop
* @see #getVariableTop
* @see #setVariableTop
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public abstract void setVariableTop(int varTop);
/** Get the version of this collator object.
* @return the version object associated with this collator
/**
* Get the version of this collator object.
* @return the version object associated with this collator
* @draft ICU 2.8
* @deprecated This is a draft API and might change in a future release of ICU.
*/

84
icu4j/src/com/ibm/icu/text/Normalizer.java
View File

@ -141,8 +141,7 @@ public final class Normalizer implements Cloneable {
* Options bit set value to select Unicode 3.2 normalization
* (except NormalizationCorrections).
* At most one Unicode version can be selected at a time.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int UNICODE_3_2=0x20;
@ -165,8 +164,7 @@ public final class Normalizer implements Cloneable {
/**
* This method is used for method dispatch
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
protected int normalize(char[] src, int srcStart, int srcLimit,
char[] dest,int destStart,int destLimit,
@ -182,8 +180,7 @@ public final class Normalizer implements Cloneable {
/**
* This method is used for method dispatch
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
protected int normalize(char[] src, int srcStart, int srcLimit,
char[] dest,int destStart,int destLimit,
@ -196,8 +193,7 @@ public final class Normalizer implements Cloneable {
/**
* This method is used for method dispatch
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
protected String normalize(String src, int options) {
return src;
@ -237,8 +233,7 @@ public final class Normalizer implements Cloneable {
/**
* This method is used for method dispatch
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
protected QuickCheckResult quickCheck(char[] src,int start, int limit,
boolean allowMaybe,UnicodeSet nx) {
@ -739,8 +734,7 @@ public final class Normalizer implements Cloneable {
* internal normalization functions.)
*
* @see #compare
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int COMPARE_NORM_OPTIONS_SHIFT = 20;
@ -764,8 +758,7 @@ public final class Normalizer implements Cloneable {
* Currently the only available option is {@link #UNICODE_3_2}.
* If you want the default behavior corresponding to one of the
* standard Unicode Normalization Forms, use 0 for this argument.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public Normalizer(String str, Mode mode, int opt) {
this.text = UCharacterIterator.getInstance(str);
@ -786,8 +779,7 @@ public final class Normalizer implements Cloneable {
* Currently the only available option is {@link #UNICODE_3_2}.
* If you want the default behavior corresponding to one of the
* standard Unicode Normalization Forms, use 0 for this argument.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public Normalizer(CharacterIterator iter, Mode mode, int opt) {
this.text = UCharacterIterator.getInstance(
@ -806,8 +798,7 @@ public final class Normalizer implements Cloneable {
*
* @param mode The normalization mode.
* @param options The normalization options, ORed together (0 for no options).
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public Normalizer(UCharacterIterator iter, Mode mode, int options) {
try {
@ -872,8 +863,7 @@ public final class Normalizer implements Cloneable {
* NFC rules.
* @param options The only recognized option is UNICODE_3_2
* @return String The composed string
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static String compose(String str, boolean compat, int options) {
@ -914,8 +904,7 @@ public final class Normalizer implements Cloneable {
* result, the output was truncated.
* @exception IndexOutOfBoundsException if target.length is less than the
* required length
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static int compose(char[] source,char[] target, boolean compat, int options) {
UnicodeSet nx = NormalizerImpl.getNX(options);
@ -954,8 +943,7 @@ public final class Normalizer implements Cloneable {
* result, the output was truncated.
* @exception IndexOutOfBoundsException if target.length is less than the
* required length
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static int compose(char[] src,int srcStart, int srcLimit,
char[] dest,int destStart, int destLimit,
@ -1005,8 +993,7 @@ public final class Normalizer implements Cloneable {
* rules.
* @param options The normalization options, ORed together (0 for no options).
* @return String The decomposed string
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static String decompose(String str, boolean compat, int options) {
@ -1040,8 +1027,7 @@ public final class Normalizer implements Cloneable {
* @param options The normalization options, ORed together (0 for no options).
* @exception IndexOutOfBoundsException if the target capacity is less than
* the required length
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static int decompose(char[] source,char[] target, boolean compat, int options) {
int[] trailCC = new int[1];
@ -1073,8 +1059,7 @@ public final class Normalizer implements Cloneable {
* result,the output was truncated.
* @exception IndexOutOfBoundsException if the target capacity is less than
* the required length
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static int decompose(char[] src,int srcStart, int srcLimit,
char[] dest,int destStart, int destLimit,
@ -1120,8 +1105,7 @@ public final class Normalizer implements Cloneable {
* @param mode the normalization mode
* @param options the optional features to be enabled.
* @return String the normalized string
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static String normalize(String str, Mode mode, int options) {
return mode.normalize(str,options);
@ -1156,8 +1140,7 @@ public final class Normalizer implements Cloneable {
* result, the output was truncated.
* @exception IndexOutOfBoundsException if the target capacity is less
* than the required length
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static int normalize(char[] source,char[] target, Mode mode, int options) {
int length = normalize(source,0,source.length,target,0,target.length,mode, options);
@ -1186,8 +1169,7 @@ public final class Normalizer implements Cloneable {
* result, the output was truncated.
* @exception IndexOutOfBoundsException if the target capacity is
* less than the required length
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static int normalize(char[] src,int srcStart, int srcLimit,
char[] dest,int destStart, int destLimit,
@ -1208,8 +1190,7 @@ public final class Normalizer implements Cloneable {
* @param options Options for use with exclusion set an tailored Normalization
* The only option that is currently recognized is UNICODE_3_2
* @return String The normalized string
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
* @see #UNICODE_3_2
*/
// TODO: actually do the optimization when the guts of Normalizer are
@ -1224,8 +1205,7 @@ public final class Normalizer implements Cloneable {
* @param mode The normalization mode
* @return String The normalized string
* @see #UNICODE_3_2
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
// TODO: actually do the optimization when the guts of Normalizer are
// upgraded --has just dumb implementation for now
@ -1257,8 +1237,7 @@ public final class Normalizer implements Cloneable {
* The only option that is currently recognized is UNICODE_3_2
* @return Return code to specify if the text is normalized or not
* (Normalizer.YES, Normalizer.NO or Normalizer.MAYBE)
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static QuickCheckResult quickCheck( String source, Mode mode, int options) {
return mode.quickCheck(source.toCharArray(),0,source.length(),true,NormalizerImpl.getNX(options));
@ -1275,8 +1254,7 @@ public final class Normalizer implements Cloneable {
* The only option that is currently recognized is UNICODE_3_2
* @return Return code to specify if the text is normalized or not
* (Normalizer.YES, Normalizer.NO or Normalizer.MAYBE)
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static QuickCheckResult quickCheck(char[] source, Mode mode, int options) {
return mode.quickCheck(source,0,source.length,true, NormalizerImpl.getNX(options));
@ -1303,8 +1281,7 @@ public final class Normalizer implements Cloneable {
* @return Return code to specify if the text is normalized or not
* (Normalizer.YES, Normalizer.NO or
* Normalizer.MAYBE)
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static QuickCheckResult quickCheck(char[] source,int start,
@ -1334,8 +1311,7 @@ public final class Normalizer implements Cloneable {
* The only option that is currently recognized is UNICODE_3_2
* @return Boolean value indicating whether the source string is in the
* "mode" normalization form
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static boolean isNormalized(char[] src,int start,
int limit, Mode mode,
@ -1351,8 +1327,7 @@ public final class Normalizer implements Cloneable {
* @param options Options for use with exclusion set an tailored Normalization
* The only option that is currently recognized is UNICODE_3_2
* @see #isNormalized
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static boolean isNormalized(String str, Mode mode, int options) {
return (mode.quickCheck(str.toCharArray(),0,str.length(),false,NormalizerImpl.getNX(options))==YES);
@ -1367,8 +1342,7 @@ public final class Normalizer implements Cloneable {
* The only option that is currently recognized is UNICODE_3_2
*
* @see #isNormalized
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
// TODO: actually do the optimization when the guts of Normalizer are
// upgraded --has just dumb implementation for now
@ -2065,8 +2039,7 @@ public final class Normalizer implements Cloneable {
* turn the option on and <tt>false</tt> to turn it off.
*
* @see #getOption
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public void setOption(int option,boolean value) {
if (value) {
@ -2080,8 +2053,7 @@ public final class Normalizer implements Cloneable {
* Determine whether an option is turned on or off.
* <p>
* @see #setOption
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public int getOption(int option) {
if((options & option)!=0) {

60
icu4j/src/com/ibm/icu/text/NumberFormat.java
View File

@ -634,42 +634,36 @@ public abstract class NumberFormat extends UFormat {
* supports. When registered, the locales it supports extend or override the
* locales already supported by ICU.
*
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static abstract class NumberFormatFactory {
/**
* Value passed to format requesting a default number format.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int FORMAT_NUMBER = NUMBERSTYLE;
/**
* Value passed to format requesting a currency format.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int FORMAT_CURRENCY = CURRENCYSTYLE;
/**
* Value passed to format requesting a percent format.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int FORMAT_PERCENT = PERCENTSTYLE;
/**
* Value passed to format requesting a scientific format.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int FORMAT_SCIENTIFIC = SCIENTIFICSTYLE;
/**
* Value passed to format requesting an integer format.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int FORMAT_INTEGER = INTEGERSTYLE;
@ -678,8 +672,7 @@ public abstract class NumberFormat extends UFormat {
* If not visible, the locales supported by this factory will not
* be listed by getAvailableLocales. This value must not change.
* @return true if the factory is visible.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
///CLOVER:OFF
public boolean visible() {
@ -691,8 +684,7 @@ public abstract class NumberFormat extends UFormat {
* Returns an immutable collection of the locale names directly
* supported by this factory.
* @return the supported locale names.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public abstract Set getSupportedLocaleNames();
@ -704,14 +696,12 @@ public abstract class NumberFormat extends UFormat {
* @param loc the locale for which to create the format
* @param formatType the type of format
* @return the NumberFormat, or null.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public abstract NumberFormat createFormat(ULocale loc, int formatType);
/**
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
protected NumberFormatFactory() {
}
@ -719,24 +709,21 @@ public abstract class NumberFormat extends UFormat {
/**
* A NumberFormatFactory that supports a single locale. It can be visible or invisible.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static abstract class SimpleNumberFormatFactory extends NumberFormatFactory {
final Set localeNames;
final boolean visible;
/**
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public SimpleNumberFormatFactory(ULocale locale) {
this(locale, true);
}
/**
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public SimpleNumberFormatFactory(ULocale locale, boolean visible) {
localeNames = Collections.singleton(locale.getBaseName());
@ -744,16 +731,14 @@ public abstract class NumberFormat extends UFormat {
}
/**
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public final boolean visible() {
return visible;
}
/**
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public final Set getSupportedLocaleNames() {
return localeNames;
@ -821,8 +806,7 @@ public abstract class NumberFormat extends UFormat {
* key that can be used to unregister this factory.
* @param factory the factory to register
* @return a key with which to unregister the factory
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static Object registerFactory(NumberFormatFactory factory) {
if (factory == null) {
@ -836,8 +820,7 @@ public abstract class NumberFormat extends UFormat {
* registerInstance or registerFactory).
* @param registryKey a key obtained from registerFactory
* @return true if the object was successfully unregistered
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static boolean unregister(Object registryKey) {
if (registryKey == null) {
@ -1055,8 +1038,7 @@ public abstract class NumberFormat extends UFormat {
* currency format.
* @param theCurrency new currency object to use. May be null for
* some subclasses.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public void setCurrency(Currency theCurrency) {
currency = theCurrency;
@ -1065,8 +1047,7 @@ public abstract class NumberFormat extends UFormat {
/**
* Gets the <tt>Currency</tt> object used to display currency
* amounts. This may be null.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public Currency getCurrency() {
return currency;
@ -1450,8 +1431,7 @@ public abstract class NumberFormat extends UFormat {
/**
* Empty constructor.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
protected NumberFormat() {
}

17
icu4j/src/com/ibm/icu/text/RuleBasedCollator.java
View File

@ -602,8 +602,7 @@ public final class RuleBasedCollator extends Collator
* </ul>
* @see #getVariableTop
* @see RuleBasedCollator#setAlternateHandlingShifted
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public int setVariableTop(String varTop)
{
@ -648,8 +647,7 @@ public final class RuleBasedCollator extends Collator
* getVariableTop
* @see #getVariableTop
* @see #setVariableTop
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public void setVariableTop(int varTop)
{
@ -695,8 +693,7 @@ public final class RuleBasedCollator extends Collator
* the tailored rules
* @return the current rules that defines this Collator.
* @see #getRules
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public String getRules(boolean fullrules)
{
@ -936,8 +933,7 @@ public final class RuleBasedCollator extends Collator
* Lower 16 bits are undefined and should be ignored.
* @return the variable top value of a Collator.
* @see #setVariableTop
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public int getVariableTop()
{
@ -4449,8 +4445,9 @@ public final class RuleBasedCollator extends Collator
// versionInfo[3] = coll->UCA->image->UCAVersion[0];
}
/** Get the UCA version of this collator object.
* @return the version object associated with this collator
/**
* Get the UCA version of this collator object.
* @return the version object associated with this collator
* @draft ICU 2.8
* @deprecated This is a draft API and might change in a future release of ICU.
*/

12
icu4j/src/com/ibm/icu/text/Transliterator.java
View File

@ -360,8 +360,7 @@ public abstract class Transliterator {
/**
* Constructs a Position object that is a copy of another.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public Position(Position pos) {
set(pos);
@ -369,8 +368,7 @@ public abstract class Transliterator {
/**
* Copies the indices of this position from another.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public void set(Position pos) {
contextStart = pos.contextStart;
@ -381,8 +379,7 @@ public abstract class Transliterator {
/**
* Returns true if this Position is equal to the given object.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public boolean equals(Object obj) {
if (obj instanceof Position) {
@ -397,8 +394,7 @@ public abstract class Transliterator {
/**
* Returns a string representation of this Position.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public String toString() {
return "[cs=" + contextStart

6
icu4j/src/com/ibm/icu/text/UnicodeSet.java
View File

@ -2842,7 +2842,9 @@ public class UnicodeSet extends UnicodeFilter {
* @param valueAlias
* @param symbols if not null, then symbols are first called to see if a property
* is available. If true, then everything else is skipped.
* @return
* @return this set
* @draft ICU 3.2
* @deprecated This is a draft API and might change in a future release of ICU.
*/
public UnicodeSet applyPropertyAlias(String propertyAlias,
String valueAlias, SymbolTable symbols) {
@ -3543,7 +3545,7 @@ public class UnicodeSet extends UnicodeFilter {
* @deprecated
* @author medavis
*/
abstract public static class XSymbolTable implements SymbolTable {
abstract static class XSymbolTable implements SymbolTable {
public UnicodeMatcher lookupMatcher(int i) {
return null;}
public boolean applyPropertyAlias(String propertyName, String propertyValue, UnicodeSet result) {

14
icu4j/src/com/ibm/icu/util/Currency.java
View File

@ -45,16 +45,14 @@ public class Currency extends MeasureUnit implements Serializable {
/**
* Selector for getName() indicating a symbolic name for a
* currency, such as "$" for USD.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int SYMBOL_NAME = 0;
/**
* Selector for ucurr_getName indicating the long name for a
* currency, such as "US Dollar" for USD.
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final int LONG_NAME = 1;
@ -192,8 +190,7 @@ public class Currency extends MeasureUnit implements Serializable {
* registerInstance).
* @param registryKey the registry key returned from registerInstance
* @see #registerInstance
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static boolean unregister(Object registryKey) {
if (registryKey == null) {
@ -641,7 +638,7 @@ public class Currency extends MeasureUnit implements Serializable {
// -------- BEGIN ULocale boilerplate --------
/*
/**
* Return the locale that was used to create this object, or null.
* This may may differ from the locale requested at the time of
* this object's creation. For example, if an object is created
@ -662,7 +659,8 @@ public class Currency extends MeasureUnit implements Serializable {
* @see com.ibm.icu.util.ULocale
* @see com.ibm.icu.util.ULocale#VALID_LOCALE
* @see com.ibm.icu.util.ULocale#ACTUAL_LOCALE
* @obsolete ICU 3.2
* @obsolete ICU 3.2 to be removed
* @deprecated This is a draft API and might change in a future release of ICU.
*/
public final ULocale getLocale(ULocale.Type type) {
return ULocale.ROOT;

3
icu4j/src/com/ibm/icu/util/ULocale.java
View File

@ -2146,8 +2146,7 @@ public final class ULocale implements Serializable {
if (subtableName != null) {
table = table.getWithFallback(subtableName);
}
table = table.get(item); // no fallback?
return table.getString();
return table.getStringWithFallback(item);
}
catch (MissingResourceException e) {
String fallbackLocale = table.getWithFallback("Fallback").getString();

3
icu4j/src/com/ibm/icu/util/VersionInfo.java
View File

@ -91,8 +91,7 @@ public final class VersionInfo
/**
* Unicode 4.0 version
* @draft ICU 2.6
* @deprecated This is a draft API and might change in a future release of ICU.
* @stable ICU 2.6
*/
public static final VersionInfo UNICODE_4_0;