diff --git a/icu4c/source/Doxyfile.in b/icu4c/source/Doxyfile.in index 7bc2951441e4..25b535cc7ac7 100644 --- a/icu4c/source/Doxyfile.in +++ b/icu4c/source/Doxyfile.in @@ -242,8 +242,7 @@ ALIASES = "memo=\par Note:\n" \ "deprecated=\xrefitem deprecated \"Deprecated\" \"Deprecated List\"" \ "obsolete=\xrefitem obsolete \"Obsolete\" \"Obsolete List\"" \ "system=\xrefitem system \"System\" \"System List\" \n Do not use unless you know what you are doing." \ - "internal=\xrefitem internal \"Internal\" \"Internal List\" Do not use. This API is for internal use only." \ - "preview=\xrefitem preview \"Preview\" \"Preview List\" This API is a technical preview. It may change in an upcoming release." + "internal=\xrefitem internal \"Internal\" \"Internal List\" Do not use. This API is for internal use only." # This tag can be used to specify a number of word-keyword mappings (TCL only). # A mapping has the form "name=value". For example adding "class=itcl::class" diff --git a/icu4c/source/common/unicode/icuplug.h b/icu4c/source/common/unicode/icuplug.h index e1daf3bfad1d..2e57b149e14e 100644 --- a/icu4c/source/common/unicode/icuplug.h +++ b/icu4c/source/common/unicode/icuplug.h @@ -100,7 +100,7 @@ * SHOULD call uplug_setPlugName to indicate a human readable plugin name. * * - * \preview ICU 4.4 + * \internal ICU 4.4 Technology Preview */ @@ -121,7 +121,7 @@ * @{ * Opaque structure passed to/from a plugin. * use the APIs to access it. - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ struct UPlugData; @@ -132,13 +132,13 @@ typedef struct UPlugData UPlugData; /** * Random Token to identify a valid ICU plugin. Plugins must return this * from the entrypoint. - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ #define UPLUG_TOKEN 0x54762486 /** * Max width of names, symbols, and configuration strings - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ #define UPLUG_NAME_MAX 100 @@ -147,13 +147,13 @@ typedef struct UPlugData UPlugData; * Return value from a plugin entrypoint. * Must always be set to UPLUG_TOKEN * @see UPLUG_TOKEN - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ typedef uint32_t UPlugTokenReturn; /** * Reason code for the entrypoint's call - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ typedef enum { UPLUG_REASON_QUERY = 0, /**< The plugin is being queried for info. **/ @@ -172,7 +172,7 @@ typedef enum { * INITIAL: UNKNOWN * QUERY: INVALID -> { LOW | HIGH } * ERR -> INVALID - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ typedef enum { UPLUG_LEVEL_INVALID = 0, /**< The plugin is invalid, hasn't called uplug_setLevel, or can't load. **/ @@ -191,7 +191,7 @@ typedef enum { * @param plug the UPlugData handle. * @param status the plugin's extended status code. * @return A valid plugin must return UPLUG_TOKEN - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ typedef UPlugTokenReturn (U_EXPORT2 UPlugEntrypoint) ( UPlugData *plug, @@ -206,7 +206,7 @@ typedef UPlugTokenReturn (U_EXPORT2 UPlugEntrypoint) ( * @see u_cleanup() * @param plug plugin * @param dontUnload set true if this plugin can't be unloaded - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL void U_EXPORT2 uplug_setPlugNoUnload(UPlugData *plug, UBool dontUnload); @@ -215,7 +215,7 @@ uplug_setPlugNoUnload(UPlugData *plug, UBool dontUnload); * Set the level of this plugin. * @param plug plugin data handle * @param level the level of this plugin - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL void U_EXPORT2 uplug_setPlugLevel(UPlugData *plug, UPlugLevel level); @@ -224,7 +224,7 @@ uplug_setPlugLevel(UPlugData *plug, UPlugLevel level); * Get the level of this plugin. * @param plug plugin data handle * @return the level of this plugin - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL UPlugLevel U_EXPORT2 uplug_getPlugLevel(UPlugData *plug); @@ -234,7 +234,7 @@ uplug_getPlugLevel(UPlugData *plug); * For example, if UPLUG_LEVEL_LOW is returned, then low level plugins may load * if UPLUG_LEVEL_HIGH is returned, then only high level plugins may load. * @return the lowest level of plug which can currently load - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL UPlugLevel U_EXPORT2 uplug_getCurrentLevel(void); @@ -243,7 +243,7 @@ uplug_getCurrentLevel(void); /** * Get plug load status * @return The error code of this plugin's load attempt. - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL UErrorCode U_EXPORT2 uplug_getPlugLoadStatus(UPlugData *plug); @@ -252,7 +252,7 @@ uplug_getPlugLoadStatus(UPlugData *plug); * Set the human-readable name of this plugin. * @param plug plugin data handle * @param name the name of this plugin. The first UPLUG_NAME_MAX characters willi be copied into a new buffer. - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL void U_EXPORT2 uplug_setPlugName(UPlugData *plug, const char *name); @@ -261,7 +261,7 @@ uplug_setPlugName(UPlugData *plug, const char *name); * Get the human-readable name of this plugin. * @param plug plugin data handle * @return the name of this plugin - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL const char * U_EXPORT2 uplug_getPlugName(UPlugData *plug); @@ -270,7 +270,7 @@ uplug_getPlugName(UPlugData *plug); * Return the symbol name for this plugin, if known. * @param plug plugin data handle * @return the symbol name, or NULL - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL const char * U_EXPORT2 uplug_getSymbolName(UPlugData *plug); @@ -280,7 +280,7 @@ uplug_getSymbolName(UPlugData *plug); * @param plug plugin data handle * @param status error code * @return the library name, or NULL - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL const char * U_EXPORT2 uplug_getLibraryName(UPlugData *plug, UErrorCode *status); @@ -290,7 +290,7 @@ uplug_getLibraryName(UPlugData *plug, UErrorCode *status); * Plugins could use this to load data out of their * @param plug plugin data handle * @return the library, or NULL - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL void * U_EXPORT2 uplug_getLibrary(UPlugData *plug); @@ -299,7 +299,7 @@ uplug_getLibrary(UPlugData *plug); * Return the plugin-specific context data. * @param plug plugin data handle * @return the context, or NULL if not set - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL void * U_EXPORT2 uplug_getContext(UPlugData *plug); @@ -308,7 +308,7 @@ uplug_getContext(UPlugData *plug); * Set the plugin-specific context data. * @param plug plugin data handle * @param context new context to set - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL void U_EXPORT2 uplug_setContext(UPlugData *plug, void *context); @@ -319,7 +319,7 @@ uplug_setContext(UPlugData *plug, void *context); * The string is in the platform default codepage. * @param plug plugin data handle * @return configuration string, or else null. - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL const char * U_EXPORT2 uplug_getConfiguration(UPlugData *plug); @@ -337,7 +337,7 @@ uplug_getConfiguration(UPlugData *plug); * @param prior pass in 'NULL' to get the first (most recent) plug, * otherwise pass the value returned on a prior call to uplug_nextPlug * @return the next oldest plugin, or NULL if no more. - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL UPlugData* U_EXPORT2 uplug_nextPlug(UPlugData *prior); @@ -352,7 +352,7 @@ uplug_nextPlug(UPlugData *prior); * @param config user specified configuration string, if available, or NULL. * @param status error result * @return the new UPlugData associated with this plugin, or NULL if error. - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL UPlugData* U_EXPORT2 uplug_loadPlugFromEntrypoint(UPlugEntrypoint *entrypoint, const char *config, UErrorCode *status); @@ -366,7 +366,7 @@ uplug_loadPlugFromEntrypoint(UPlugEntrypoint *entrypoint, const char *config, UE * @param config configuration string, or NULL * @param status error result * @return the new UPlugData associated with this plugin, or NULL if error. - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL UPlugData* U_EXPORT2 uplug_loadPlugFromLibrary(const char *libName, const char *sym, const char *config, UErrorCode *status); @@ -376,7 +376,7 @@ uplug_loadPlugFromLibrary(const char *libName, const char *sym, const char *conf * Will request the plugin to be unloaded, and close the library if needed * @param plug plugin handle to close * @param status error result - * @preview ICU 4.4 + * @internal ICU 4.4 Technology Preview */ U_INTERNAL void U_EXPORT2 uplug_removePlug(UPlugData *plug, UErrorCode *status); diff --git a/icu4c/source/common/unicode/utext.h b/icu4c/source/common/unicode/utext.h index bec01e4b1f64..ad21d70a164c 100644 --- a/icu4c/source/common/unicode/utext.h +++ b/icu4c/source/common/unicode/utext.h @@ -701,7 +701,7 @@ utext_extract(UText *ut, * Returns U_SENTINEL (-1) if the position is at the end of the * text. * - * @preview ICU 4.4 + * @internal ICU 4.4 technology preview */ #define UTEXT_CURRENT32(ut) \ ((ut)->chunkOffset < (ut)->chunkLength && ((ut)->chunkContents)[(ut)->chunkOffset]<0xd800 ? \ diff --git a/icu4c/source/i18n/reldtfmt.h b/icu4c/source/i18n/reldtfmt.h index 0e532282c323..c3b3044e442d 100644 --- a/icu4c/source/i18n/reldtfmt.h +++ b/icu4c/source/i18n/reldtfmt.h @@ -194,7 +194,7 @@ class RelativeDateFormat : public DateFormat { * date and time formatters associated with this object. * @param result Output param to receive the pattern. * @return A reference to 'result'. - * @preview ICU 4.2 + * @internal ICU 4.2 technology preview */ virtual UnicodeString& toPattern(UnicodeString& result, UErrorCode& status) const; @@ -202,7 +202,7 @@ class RelativeDateFormat : public DateFormat { * Get the date pattern for the the date formatter associated with this object. * @param result Output param to receive the date pattern. * @return A reference to 'result'. - * @preview ICU 4.2 + * @internal ICU 4.2 technology preview */ virtual UnicodeString& toPatternDate(UnicodeString& result, UErrorCode& status) const; @@ -210,7 +210,7 @@ class RelativeDateFormat : public DateFormat { * Get the time pattern for the the time formatter associated with this object. * @param result Output param to receive the time pattern. * @return A reference to 'result'. - * @preview ICU 4.2 + * @internal ICU 4.2 technology preview */ virtual UnicodeString& toPatternTime(UnicodeString& result, UErrorCode& status) const; @@ -221,7 +221,7 @@ class RelativeDateFormat : public DateFormat { * * @param datePattern The date pattern to be applied. * @param timePattern The time pattern to be applied. - * @preview ICU 4.2 + * @internal ICU 4.2 technology preview */ virtual void applyPatterns(const UnicodeString& datePattern, const UnicodeString& timePattern, UErrorCode &status); diff --git a/icu4c/source/i18n/unicode/decimfmt.h b/icu4c/source/i18n/unicode/decimfmt.h index aab3cb297616..ba5452f699df 100644 --- a/icu4c/source/i18n/unicode/decimfmt.h +++ b/icu4c/source/i18n/unicode/decimfmt.h @@ -1295,7 +1295,7 @@ class U_I18N_API DecimalFormat : public NumberFormat { #ifndef U_HIDE_INTERNAL_API /** * Whether to show the plus sign on positive (non-negative) numbers; for example, "+12" - * @preview + * @internal Technical Preview */ UBool isSignAlwaysShown() const; #endif /* U_HIDE_INTERNAL_API */ @@ -1303,7 +1303,7 @@ class U_I18N_API DecimalFormat : public NumberFormat { /** * Set whether to show the plus sign on positive (non-negative) numbers; for example, "+12" * @param value The new setting for whether to show plus sign on positive numbers - * @preview + * @internal Technical Preview */ virtual void setSignAlwaysShown(UBool value); @@ -1675,7 +1675,7 @@ class U_I18N_API DecimalFormat : public NumberFormat { * * @see setMinimumGroupingDigits * @see getGroupingSize - * @preview + * @internal technology preview */ int32_t getMinimumGroupingDigits() const; @@ -1688,7 +1688,7 @@ class U_I18N_API DecimalFormat : public NumberFormat { * * @param newValue the new value of minimum grouping digits. * @see getMinimumGroupingDigits - * @preview + * @internal technology preview */ virtual void setMinimumGroupingDigits(int32_t newValue); @@ -1736,7 +1736,7 @@ class U_I18N_API DecimalFormat : public NumberFormat { * Returns whether to ignore exponents when parsing. * * @see #setParseNoExponent - * @preview + * @internal This API is a technical preview. It may change in an upcoming release. */ virtual UBool isParseNoExponent() const; @@ -1746,7 +1746,7 @@ class U_I18N_API DecimalFormat : public NumberFormat { * 5). * * @param value true to prevent exponents from being parsed; false to allow them to be parsed. - * @preview + * @internal This API is a technical preview. It may change in an upcoming release. */ virtual void setParseNoExponent(UBool value); @@ -1754,7 +1754,7 @@ class U_I18N_API DecimalFormat : public NumberFormat { * Returns whether parsing is sensitive to case (lowercase/uppercase). * * @see #setParseCaseSensitive - * @preview + * @internal This API is a technical preview. It may change in an upcoming release. */ virtual UBool isParseCaseSensitive() const; @@ -1765,7 +1765,7 @@ class U_I18N_API DecimalFormat : public NumberFormat { * Currency symbols are never case-folded. For example, "us$1.00" will not parse in case-insensitive * mode, even though "US$1.00" parses. * - * @preview + * @internal This API is a technical preview. It may change in an upcoming release. */ virtual void setParseCaseSensitive(UBool value); @@ -1774,7 +1774,7 @@ class U_I18N_API DecimalFormat : public NumberFormat { * By default, setMaximumIntegerDigits truncates high-order digits silently. * * @see setFormatFailIfMoreThanMaxDigits - * @preview + * @internal This API is a technical preview. It may change in an upcoming release. */ virtual UBool isFormatFailIfMoreThanMaxDigits() const; @@ -1782,7 +1782,7 @@ class U_I18N_API DecimalFormat : public NumberFormat { * Sets whether truncation of high-order integer digits should result in an error. * By default, setMaximumIntegerDigits truncates high-order digits silently. * - * @preview + * @internal This API is a technical preview. It may change in an upcoming release. */ virtual void setFormatFailIfMoreThanMaxDigits(UBool value); diff --git a/icu4c/source/i18n/unicode/smpdtfmt.h b/icu4c/source/i18n/unicode/smpdtfmt.h index 1b3648958ccc..929c1b4675b4 100644 --- a/icu4c/source/i18n/unicode/smpdtfmt.h +++ b/icu4c/source/i18n/unicode/smpdtfmt.h @@ -1113,21 +1113,21 @@ class U_I18N_API SimpleDateFormat: public DateFormat { * The caller should not delete the TimeZoneFormat object after * it is adopted by this call. * @param timeZoneFormatToAdopt The TimeZoneFormat object to be adopted. - * @preview ICU 49 + * @internal ICU 49 technology preview */ virtual void adoptTimeZoneFormat(TimeZoneFormat* timeZoneFormatToAdopt); /** * Sets the TimeZoneFormat to be used by this date/time formatter. * @param newTimeZoneFormat The TimeZoneFormat object to copy. - * @preview ICU 49 + * @internal ICU 49 technology preview */ virtual void setTimeZoneFormat(const TimeZoneFormat& newTimeZoneFormat); /** * Gets the time zone format object associated with this date/time formatter. * @return the time zone format associated with this date/time formatter. - * @preview ICU 49 + * @internal ICU 49 technology preview */ virtual const TimeZoneFormat* getTimeZoneFormat(void) const; diff --git a/icu4c/source/i18n/unicode/udat.h b/icu4c/source/i18n/unicode/udat.h index 4806cf1a7859..90aff20df2a1 100644 --- a/icu4c/source/i18n/unicode/udat.h +++ b/icu4c/source/i18n/unicode/udat.h @@ -1581,7 +1581,7 @@ udat_getContext(const UDateFormat* fmt, UDisplayContextType type, UErrorCode* st * @param status A pointer to a UErrorCode to receive any errors * @return The total buffer size needed; if greater than resultLength, the output was truncated. * @see udat_applyPatternRelative -* @preview ICU 4.2 +* @internal ICU 4.2 technology preview */ U_INTERNAL int32_t U_EXPORT2 udat_toPatternRelativeDate(const UDateFormat *fmt, @@ -1598,7 +1598,7 @@ udat_toPatternRelativeDate(const UDateFormat *fmt, * @param status A pointer to a UErrorCode to receive any errors * @return The total buffer size needed; if greater than resultLength, the output was truncated. * @see udat_applyPatternRelative -* @preview ICU 4.2 +* @internal ICU 4.2 technology preview */ U_INTERNAL int32_t U_EXPORT2 udat_toPatternRelativeTime(const UDateFormat *fmt, @@ -1616,7 +1616,7 @@ udat_toPatternRelativeTime(const UDateFormat *fmt, * @param timePatternLength The length of timePattern, or -1 if null-terminated. * @param status A pointer to a UErrorCode to receive any errors * @see udat_toPatternRelativeDate, udat_toPatternRelativeTime -* @preview ICU 4.2 +* @internal ICU 4.2 technology preview */ U_INTERNAL void U_EXPORT2 udat_applyPatternRelative(UDateFormat *format, diff --git a/icu4c/source/i18n/unicode/unum.h b/icu4c/source/i18n/unicode/unum.h index ea14906cd09a..1808c8d36b94 100644 --- a/icu4c/source/i18n/unicode/unum.h +++ b/icu4c/source/i18n/unicode/unum.h @@ -1027,7 +1027,7 @@ typedef enum UNumberFormatAttribute { * Minimum grouping digits, technology preview. * See DecimalFormat::getMinimumGroupingDigits(). * - * @preview + * @internal technology preview */ UNUM_MINIMUM_GROUPING_DIGITS = 22, /* TODO: test C API when it becomes @draft */ @@ -1079,14 +1079,14 @@ typedef enum UNumberFormatAttribute { /** * Whether parsing is sensitive to case (lowercase/uppercase). * TODO: Add to the test suite. - * @preview + * @internal This API is a technical preview. It may change in an upcoming release. */ UNUM_PARSE_CASE_SENSITIVE = 0x1004, /** * Formatting: whether to show the plus sign on non-negative numbers. * TODO: Add to the test suite. - * @preview + * @internal This API is a technical preview. It may change in an upcoming release. */ UNUM_SIGN_ALWAYS_SHOWN = 0x1005, } UNumberFormatAttribute; diff --git a/icu4c/source/i18n/unicode/upluralrules.h b/icu4c/source/i18n/unicode/upluralrules.h index fdf9f9e4e5fd..690846bc89cd 100644 --- a/icu4c/source/i18n/unicode/upluralrules.h +++ b/icu4c/source/i18n/unicode/upluralrules.h @@ -164,7 +164,7 @@ uplrules_select(const UPluralRules *uplrules, * @param capacity The capacity of the keyword buffer. * @param status A pointer to a UErrorCode to receive any errors. * @return The length of keyword. - * @preview ICU 59 + * @internal ICU 59 technology preview, may be removed in the future */ U_INTERNAL int32_t U_EXPORT2 uplrules_selectWithFormat(const UPluralRules *uplrules, diff --git a/icu4c/source/layoutex/layout/playout.h b/icu4c/source/layoutex/layout/playout.h index 57bb7a02c1c5..317b43891367 100644 --- a/icu4c/source/layoutex/layout/playout.h +++ b/icu4c/source/layoutex/layout/playout.h @@ -32,21 +32,21 @@ /** * The opaque type for a paragraph layout. * - * @preview + * @internal */ typedef void pl_paragraph; /** * The opaque type for a line in a paragraph layout. * - * @preview + * @internal */ typedef void pl_line; /** * The opaque type for a visual run in a line. * - * @preview + * @internal */ typedef void pl_visualRun; @@ -93,7 +93,7 @@ typedef void pl_visualRun; * @see longine.h * @see plruns.h * - * @preview + * @internal */ U_INTERNAL pl_paragraph * U_EXPORT2 pl_create(const LEUnicode chars[], @@ -113,7 +113,7 @@ pl_create(const LEUnicode chars[], * closed. Once this routine returns the object * can no longer be referenced * - * @preview + * @internal */ U_INTERNAL void U_EXPORT2 pl_close(pl_paragraph *paragraph); @@ -128,7 +128,7 @@ pl_close(pl_paragraph *paragraph); * * @return TRUE if any of the text requires complex processing. * - * @preview + * @internal */ U_INTERNAL le_bool U_EXPORT2 @@ -144,7 +144,7 @@ pl_isComplex(const LEUnicode chars[], * * @return the resolved paragraph level. * - * @preview + * @internal */ U_INTERNAL UBiDiLevel U_EXPORT2 pl_getParagraphLevel(pl_paragraph *paragraph); @@ -158,7 +158,7 @@ pl_getParagraphLevel(pl_paragraph *paragraph); * UBIDI_RTL if the text is all right to left, * or UBIDI_MIXED if the text has mixed direction. * - * @preview + * @internal */ U_INTERNAL UBiDiDirection U_EXPORT2 pl_getTextDirection(pl_paragraph *paragraph); @@ -176,7 +176,7 @@ pl_getTextDirection(pl_paragraph *paragraph); * * @return the ascent value. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getAscent(const pl_paragraph *paragraph); @@ -189,7 +189,7 @@ pl_getAscent(const pl_paragraph *paragraph); * * @return the decent value. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getDescent(const pl_paragraph *paragraph); @@ -202,7 +202,7 @@ pl_getDescent(const pl_paragraph *paragraph); * * @return the leading value. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getLeading(const pl_paragraph *paragraph); @@ -212,7 +212,7 @@ pl_getLeading(const pl_paragraph *paragraph); * * @param paragraph the pl_paragraph * - * @preview + * @internal */ U_INTERNAL void U_EXPORT2 pl_reflow(pl_paragraph *paragraph); @@ -233,7 +233,7 @@ pl_reflow(pl_paragraph *paragraph); * * @see pl_line * - * @preview + * @internal */ U_INTERNAL pl_line * U_EXPORT2 pl_nextLine(pl_paragraph *paragraph, float width); @@ -245,7 +245,7 @@ pl_nextLine(pl_paragraph *paragraph, float width); * * @param line the pl_line object to close. * - * @preview + * @internal */ U_INTERNAL void U_EXPORT2 pl_closeLine(pl_line *line); @@ -257,7 +257,7 @@ pl_closeLine(pl_line *line); * * @return the number of visual runs. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_countLineRuns(const pl_line *line); @@ -270,7 +270,7 @@ pl_countLineRuns(const pl_line *line); * * @return the ascent of the line. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getLineAscent(const pl_line *line); @@ -283,7 +283,7 @@ pl_getLineAscent(const pl_line *line); * * @return the descent of the line. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getLineDescent(const pl_line *line); @@ -296,7 +296,7 @@ pl_getLineDescent(const pl_line *line); * * @return the leading of the line. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getLineLeading(const pl_line *line); @@ -310,7 +310,7 @@ pl_getLineLeading(const pl_line *line); * * @return the width of the line. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getLineWidth(const pl_line *line); @@ -329,7 +329,7 @@ pl_getLineWidth(const pl_line *line); * * @see pl_visualRun * - * @preview + * @internal */ U_INTERNAL const pl_visualRun * U_EXPORT2 pl_getLineVisualRun(const pl_line *line, le_int32 runIndex); @@ -346,7 +346,7 @@ pl_getLineVisualRun(const pl_line *line, le_int32 runIndex); * * @see le_font * - * @preview + * @internal */ U_INTERNAL const le_font * U_EXPORT2 pl_getVisualRunFont(const pl_visualRun *run); @@ -359,7 +359,7 @@ pl_getVisualRunFont(const pl_visualRun *run); * @return the direction of the run. This will be UBIDI_LTR if the * run is left-to-right and UBIDI_RTL if the line is right-to-left. * - * @preview + * @internal */ U_INTERNAL UBiDiDirection U_EXPORT2 pl_getVisualRunDirection(const pl_visualRun *run); @@ -371,7 +371,7 @@ pl_getVisualRunDirection(const pl_visualRun *run); * * @return the number of glyphs. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getVisualRunGlyphCount(const pl_visualRun *run); @@ -386,7 +386,7 @@ pl_getVisualRunGlyphCount(const pl_visualRun *run); * is owned by the pl_visualRun object and must not be deleted. * It will remain valid as long as the pl_visualRun object is valid. * - * @preview + * @internal */ U_INTERNAL const LEGlyphID * U_EXPORT2 pl_getVisualRunGlyphs(const pl_visualRun *run); @@ -404,7 +404,7 @@ pl_getVisualRunGlyphs(const pl_visualRun *run); * is owned by the pl_visualRun object and must not be deleted. * It will remain valid as long as the pl_visualRun object is valid. * - * @preview + * @internal */ U_INTERNAL const float * U_EXPORT2 pl_getVisualRunPositions(const pl_visualRun *run); @@ -419,7 +419,7 @@ pl_getVisualRunPositions(const pl_visualRun *run); * is owned by the pl_visualRun object and must not be deleted. * It will remain valid as long as the pl_visualRun object is valid. * - * @preview + * @internal */ U_INTERNAL const le_int32 * U_EXPORT2 pl_getVisualRunGlyphToCharMap(const pl_visualRun *run); @@ -432,7 +432,7 @@ pl_getVisualRunGlyphToCharMap(const pl_visualRun *run); * * @return the ascent value of this run's font. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getVisualRunAscent(const pl_visualRun *run); @@ -445,7 +445,7 @@ pl_getVisualRunAscent(const pl_visualRun *run); * * @return the descent value of this run's font. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getVisualRunDescent(const pl_visualRun *run); @@ -458,7 +458,7 @@ pl_getVisualRunDescent(const pl_visualRun *run); * * @return the leading value of this run's font. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getVisualRunLeading(const pl_visualRun *run); diff --git a/icu4c/source/layoutex/layout/plruns.h b/icu4c/source/layoutex/layout/plruns.h index 6e16cba1309c..6cbece8040ec 100644 --- a/icu4c/source/layoutex/layout/plruns.h +++ b/icu4c/source/layoutex/layout/plruns.h @@ -20,17 +20,17 @@ /** * Opaque datatype representing an array of font runs - * @preview + * @internal */ typedef void pl_fontRuns; /** * Opaque datatype representing an array of value runs - * @preview + * @internal */ typedef void pl_valueRuns; /** * Opaque datatype representing an array of locale runs - * @preview + * @internal */ typedef void pl_localeRuns; @@ -56,7 +56,7 @@ typedef void pl_localeRuns; * * @param count is the number of entries in the two arrays. * - * @preview + * @internal */ U_INTERNAL pl_fontRuns * U_EXPORT2 pl_openFontRuns(const le_font **fonts, @@ -72,7 +72,7 @@ pl_openFontRuns(const le_font **fonts, * * @see pl_addFontRun * - * @preview + * @internal */ U_INTERNAL pl_fontRuns * U_EXPORT2 pl_openEmptyFontRuns(le_int32 initialCapacity); @@ -83,7 +83,7 @@ pl_openEmptyFontRuns(le_int32 initialCapacity); * * @param fontRuns is the pl_fontRuns object. * - * @preview + * @internal */ U_INTERNAL void U_EXPORT2 pl_closeFontRuns(pl_fontRuns *fontRuns); @@ -95,7 +95,7 @@ pl_closeFontRuns(pl_fontRuns *fontRuns); * * @return the number of entries in the limit indices array. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getFontRunCount(const pl_fontRuns *fontRuns); @@ -105,7 +105,7 @@ pl_getFontRunCount(const pl_fontRuns *fontRuns); * * @param fontRuns is the pl_fontRuns object. * - * @preview + * @internal */ U_INTERNAL void U_EXPORT2 pl_resetFontRuns(pl_fontRuns *fontRuns); @@ -118,7 +118,7 @@ pl_resetFontRuns(pl_fontRuns *fontRuns); * * @return the last limit index. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getFontRunLastLimit(const pl_fontRuns *fontRuns); @@ -131,7 +131,7 @@ pl_getFontRunLastLimit(const pl_fontRuns *fontRuns); * * @return the limit index for the run, or -1 if run is out of bounds. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getFontRunLimit(const pl_fontRuns *fontRuns, @@ -147,7 +147,7 @@ pl_getFontRunLimit(const pl_fontRuns *fontRuns, * * @return the le_font associated with the given text run. * - * @preview + * @internal */ U_INTERNAL const le_font * U_EXPORT2 pl_getFontRunFont(const pl_fontRuns *fontRuns, @@ -170,7 +170,7 @@ pl_getFontRunFont(const pl_fontRuns *fontRuns, * @return the run index where the font and limit index were stored, or -1 if * the run cannot be added. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_addFontRun(pl_fontRuns *fontRuns, @@ -189,7 +189,7 @@ pl_addFontRun(pl_fontRuns *fontRuns, * * @param count is the number of entries in the two arrays. * - * @preview + * @internal */ U_INTERNAL pl_valueRuns * U_EXPORT2 pl_openValueRuns(const le_int32 *values, @@ -205,7 +205,7 @@ pl_openValueRuns(const le_int32 *values, * * @see pl_addValueRun * - * @preview + * @internal */ U_INTERNAL pl_valueRuns * U_EXPORT2 pl_openEmptyValueRuns(le_int32 initialCapacity); @@ -216,7 +216,7 @@ pl_openEmptyValueRuns(le_int32 initialCapacity); * * @param valueRuns is the pl_valueRuns object. * - * @preview + * @internal */ U_INTERNAL void U_EXPORT2 pl_closeValueRuns(pl_valueRuns *valueRuns); @@ -228,7 +228,7 @@ pl_closeValueRuns(pl_valueRuns *valueRuns); * * @return the number of value runs. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getValueRunCount(const pl_valueRuns *valueRuns); @@ -238,7 +238,7 @@ pl_getValueRunCount(const pl_valueRuns *valueRuns); * * @param valueRuns is the pl_valueRuns object. * - * @preview + * @internal */ U_INTERNAL void U_EXPORT2 pl_resetValueRuns(pl_valueRuns *valueRuns); @@ -251,7 +251,7 @@ pl_resetValueRuns(pl_valueRuns *valueRuns); * * @return the last limit index. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getValueRunLastLimit(const pl_valueRuns *valueRuns); @@ -264,7 +264,7 @@ pl_getValueRunLastLimit(const pl_valueRuns *valueRuns); * * @return the limit index for the run, or -1 if run is out of bounds. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getValueRunLimit(const pl_valueRuns *valueRuns, @@ -280,7 +280,7 @@ pl_getValueRunLimit(const pl_valueRuns *valueRuns, * * @return the value associated with the given text run. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getValueRunValue(const pl_valueRuns *valueRuns, @@ -302,7 +302,7 @@ pl_getValueRunValue(const pl_valueRuns *valueRuns, * @return the run index where the font and limit index were stored, or -1 if * the run cannot be added. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_addValueRun(pl_valueRuns *valueRuns, @@ -321,7 +321,7 @@ pl_addValueRun(pl_valueRuns *valueRuns, * * @param count is the number of entries in the two arrays. * - * @preview + * @internal */ U_INTERNAL pl_localeRuns * U_EXPORT2 pl_openLocaleRuns(const char **locales, @@ -337,7 +337,7 @@ pl_openLocaleRuns(const char **locales, * * @see pl_addLocaleRun * - * @preview + * @internal */ U_INTERNAL pl_localeRuns * U_EXPORT2 pl_openEmptyLocaleRuns(le_int32 initialCapacity); @@ -348,7 +348,7 @@ pl_openEmptyLocaleRuns(le_int32 initialCapacity); * * @param localeRuns is the pl_localeRuns object. * - * @preview + * @internal */ U_INTERNAL void U_EXPORT2 pl_closeLocaleRuns(pl_localeRuns *localeRuns); @@ -360,7 +360,7 @@ pl_closeLocaleRuns(pl_localeRuns *localeRuns); * * @return the number of entries in the limit indices array. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getLocaleRunCount(const pl_localeRuns *localeRuns); @@ -370,7 +370,7 @@ pl_getLocaleRunCount(const pl_localeRuns *localeRuns); * * @param localeRuns is the pl_localeRuns object. * - * @preview + * @internal */ U_INTERNAL void U_EXPORT2 pl_resetLocaleRuns(pl_localeRuns *localeRuns); @@ -383,7 +383,7 @@ pl_resetLocaleRuns(pl_localeRuns *localeRuns); * * @return the last limit index. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getLocaleRunLastLimit(const pl_localeRuns *localeRuns); @@ -396,7 +396,7 @@ pl_getLocaleRunLastLimit(const pl_localeRuns *localeRuns); * * @return the limit index for the run, or -1 if run is out of bounds. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_getLocaleRunLimit(const pl_localeRuns *localeRuns, @@ -412,7 +412,7 @@ pl_getLocaleRunLimit(const pl_localeRuns *localeRuns, * * @return the le_font associated with the given text run. * - * @preview + * @internal */ U_INTERNAL const char * U_EXPORT2 pl_getLocaleRunLocale(const pl_localeRuns *localeRuns, @@ -435,7 +435,7 @@ pl_getLocaleRunLocale(const pl_localeRuns *localeRuns, * @return the run index where the font and limit index were stored, or -1 if * the run cannot be added. * - * @preview + * @internal */ U_INTERNAL le_int32 U_EXPORT2 pl_addLocaleRun(pl_localeRuns *localeRuns, diff --git a/icu4c/source/test/intltest/colldata.h b/icu4c/source/test/intltest/colldata.h index 6e4294ffe5f6..7400d2b3ca35 100644 --- a/icu4c/source/test/intltest/colldata.h +++ b/icu4c/source/test/intltest/colldata.h @@ -14,8 +14,8 @@ */ /* - * Note: This module was incldued in ICU 4.0.1 as technology @preview for supporting - * Boyer-Moore string search API. For now, only SSearchTest depends on this module. I temporarily + * Note: This module was incldued in ICU 4.0.1 as @internal technology preview for supporting + * Boyer-Moore string search API. For now, only SSearchTest depends on this module. I temporaly * moved the module from i18n directory to intltest, because we have no plan to publish this * as public API. (2012-12-18 yoshito) */