summaryrefslogtreecommitdiff
path: root/tools/icu4c_srcgen/doc_patches/patches/unicode/utext.h.patch
diff options
context:
space:
mode:
Diffstat (limited to 'tools/icu4c_srcgen/doc_patches/patches/unicode/utext.h.patch')
-rw-r--r--tools/icu4c_srcgen/doc_patches/patches/unicode/utext.h.patch132
1 files changed, 66 insertions, 66 deletions
diff --git a/tools/icu4c_srcgen/doc_patches/patches/unicode/utext.h.patch b/tools/icu4c_srcgen/doc_patches/patches/unicode/utext.h.patch
index d2f760fbc..978a75c5b 100644
--- a/tools/icu4c_srcgen/doc_patches/patches/unicode/utext.h.patch
+++ b/tools/icu4c_srcgen/doc_patches/patches/unicode/utext.h.patch
@@ -1,6 +1,6 @@
---- libicu/ndk_headers/unicode/utext.h 2021-02-10 23:39:51.649654277 +0000
-+++ libicu/ndk_headers/unicode/utext.h 2021-02-10 23:39:51.865655704 +0000
-@@ -625,787 +625,6 @@
+--- libicu/ndk_headers/unicode/utext.h 2021-07-29 18:38:27.265302620 +0100
++++ libicu/ndk_headers/unicode/utext.h 2021-07-29 18:38:27.533304961 +0100
+@@ -627,787 +627,6 @@
@@ -27,7 +27,7 @@
- * Returns U_SENTINEL (-1) if the position is at the end of the
- * text.
- *
-- * @internal ICU 4.4 technology preview
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only. ICU 4.4 technology preview
- */
-#define UTEXT_CURRENT32(ut) \
- ((ut)->chunkOffset < (ut)->chunkLength && ((ut)->chunkContents)[(ut)->chunkOffset]<0xd800 ? \
@@ -43,7 +43,7 @@
- * Returns U_SENTINEL (-1) if the position is at the end of the
- * text.
- *
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-#define UTEXT_NEXT32(ut) \
- ((ut)->chunkOffset < (ut)->chunkLength && ((ut)->chunkContents)[(ut)->chunkOffset]<0xd800 ? \
@@ -57,7 +57,7 @@
- * This is a pre-decrement operation.
- * Returns U_SENTINEL (-1) if the position is at the start of the text.
- *
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-#define UTEXT_PREVIOUS32(ut) \
- ((ut)->chunkOffset > 0 && \
@@ -74,7 +74,7 @@
- * the corresponding UChar (UTF-16) index.
- * The returned position will always be aligned to a code point boundary.
- *
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
-#define UTEXT_GETNATIVEINDEX(ut) \
- ((ut)->chunkOffset <= (ut)->nativeIndexingLimit? \
@@ -90,7 +90,7 @@
- * If the index is out of range, it will be pinned to be within
- * the range of the input text.
- *
-- * @stable ICU 3.8
+- * \xrefitem stable "Stable" "Stable List" ICU 3.8
- */
-#define UTEXT_SETNATIVEINDEX(ut, ix) UPRV_BLOCK_MACRO_BEGIN { \
- int64_t __offset = (ix) - (ut)->chunkNativeStart; \
@@ -132,32 +132,32 @@
- * UText provider properties (bit field indexes).
- *
- * @see UText
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-enum {
- /**
- * It is potentially time consuming for the provider to determine the length of the text.
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- UTEXT_PROVIDER_LENGTH_IS_EXPENSIVE = 1,
- /**
- * Text chunks remain valid and usable until the text object is modified or
- * deleted, not just until the next time the access() function is called
- * (which is the default).
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- UTEXT_PROVIDER_STABLE_CHUNKS = 2,
- /**
- * The provider supports modifying the text via the replace() and copy()
- * functions.
- * @see Replaceable
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- UTEXT_PROVIDER_WRITABLE = 3,
- /**
- * There is meta data associated with the text.
- * @see Replaceable::hasMetaData()
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- UTEXT_PROVIDER_HAS_META_DATA = 4,
- /**
@@ -165,7 +165,7 @@
- * Generally occurs as the result of a deep clone of the UText.
- * When closing the UText, the associated text must
- * also be closed/deleted/freed/ whatever is appropriate.
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- UTEXT_PROVIDER_OWNS_TEXT = 5
-};
@@ -205,7 +205,7 @@
- * original text.
- * @return The newly created clone, or NULL if the clone operation failed.
- *
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-typedef UText * U_CALLCONV
-UTextClone(UText *dest, const UText *src, UBool deep, UErrorCode *status);
@@ -217,7 +217,7 @@
- * @param ut the UText to get the length of.
- * @return the length, in the native units of the original text string.
- * @see UText
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-typedef int64_t U_CALLCONV
-UTextNativeLength(UText *ut);
@@ -245,7 +245,7 @@
- * (the requested index is out of bounds).
- *
- * @see UText
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-typedef UBool U_CALLCONV
-UTextAccess(UText *ut, int64_t nativeIndex, UBool forward);
@@ -275,7 +275,7 @@
- * preflighting.
- * @return Number of UChars in the data. Does not include a trailing NUL.
- *
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-typedef int32_t U_CALLCONV
-UTextExtract(UText *ut,
@@ -310,7 +310,7 @@
- * @return The signed number of (native) storage units by which
- * the length of the text expanded or contracted.
- *
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-typedef int32_t U_CALLCONV
-UTextReplace(UText *ut,
@@ -344,7 +344,7 @@
- * @param move If true, then the substring is moved, not copied/duplicated.
- * @param status receives any error status. Possible errors include U_NO_WRITE_PERMISSION
- *
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-typedef void U_CALLCONV
-UTextCopy(UText *ut,
@@ -364,7 +364,7 @@
- * @return Absolute (native) index corresponding to chunkOffset in the current chunk.
- * The returned native index should always be to a code point boundary.
- *
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-typedef int64_t U_CALLCONV
-UTextMapOffsetToNative(const UText *ut);
@@ -382,7 +382,7 @@
- * @return Chunk-relative UTF-16 offset corresponding to the specified native
- * index.
- *
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-typedef int32_t U_CALLCONV
-UTextMapNativeIndexToUTF16(const UText *ut, int64_t nativeIndex);
@@ -403,7 +403,7 @@
- *
- * @param ut A UText object to be closed.
- *
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
-typedef void U_CALLCONV
-UTextClose(UText *ut);
@@ -416,7 +416,7 @@
- * Each text provider implementation must provide an
- * actual table that is initialized with the appropriate functions
- * for the type of text being handled.
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
-struct UTextFuncs {
- /**
@@ -431,23 +431,23 @@
- * 4 pointers,
- * 2 64-bit fields
- * in sequence.
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- int32_t tableSize;
-
- /**
- * (private) Alignment padding.
- * Do not use, reserved for use by the UText framework only.
-- * @internal
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only.
- */
-- int32_t reserved1, /** @internal */ reserved2, /** @internal */ reserved3;
+- int32_t reserved1, /** \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only. */ reserved2, /** \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only. */ reserved3;
-
-
- /**
- * (public) Function pointer for UTextClone
- *
- * @see UTextClone
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- UTextClone *clone;
-
@@ -456,7 +456,7 @@
- * May be expensive to compute!
- *
- * @see UTextLength
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- UTextNativeLength *nativeLength;
-
@@ -464,7 +464,7 @@
- * (public) Function pointer for UTextAccess.
- *
- * @see UTextAccess
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- UTextAccess *access;
-
@@ -472,7 +472,7 @@
- * (public) Function pointer for UTextExtract.
- *
- * @see UTextExtract
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- UTextExtract *extract;
-
@@ -480,7 +480,7 @@
- * (public) Function pointer for UTextReplace.
- *
- * @see UTextReplace
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- UTextReplace *replace;
-
@@ -488,7 +488,7 @@
- * (public) Function pointer for UTextCopy.
- *
- * @see UTextCopy
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- UTextCopy *copy;
-
@@ -496,7 +496,7 @@
- * (public) Function pointer for UTextMapOffsetToNative.
- *
- * @see UTextMapOffsetToNative
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- UTextMapOffsetToNative *mapOffsetToNative;
-
@@ -504,7 +504,7 @@
- * (public) Function pointer for UTextMapNativeIndexToUTF16.
- *
- * @see UTextMapNativeIndexToUTF16
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- UTextMapNativeIndexToUTF16 *mapNativeIndexToUTF16;
-
@@ -512,25 +512,25 @@
- * (public) Function pointer for UTextClose.
- *
- * @see UTextClose
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- UTextClose *close;
-
- /**
- * (private) Spare function pointer
-- * @internal
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only.
- */
- UTextClose *spare1;
-
- /**
- * (private) Spare function pointer
-- * @internal
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only.
- */
- UTextClose *spare2;
-
- /**
- * (private) Spare function pointer
-- * @internal
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only.
- */
- UTextClose *spare3;
-
@@ -550,7 +550,7 @@
- * to pass text data to ICU services will have no need to view the
- * internals of the UText structs that they open.
- *
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
-struct UText {
- /**
@@ -563,7 +563,7 @@
- * Text provider close functions must NOT clear
- * the magic field because that would prevent
- * reuse of the UText struct.
-- * @internal
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only.
- */
- uint32_t magic;
-
@@ -571,7 +571,7 @@
- /**
- * (private) Flags for managing the allocation and freeing of
- * memory associated with this UText.
-- * @internal
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only.
- */
- int32_t flags;
-
@@ -579,7 +579,7 @@
- /**
- * Text provider properties. This set of flags is maintained by the
- * text provider implementation.
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- int32_t providerProperties;
-
@@ -587,7 +587,7 @@
- * (public) sizeOfStruct=sizeof(UText)
- * Allows possible backward compatible extension.
- *
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- int32_t sizeOfStruct;
-
@@ -597,13 +597,13 @@
- /**
- * (protected) Native index of the first character position following
- * the current chunk.
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- int64_t chunkNativeLimit;
-
- /**
- * (protected) Size in bytes of the extra space (pExtra).
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- int32_t extraSize;
-
@@ -612,7 +612,7 @@
- * chunk (UTF-16) indexing correspond. For UTF-16 sources, value
- * will be equal to chunkLength.
- *
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- int32_t nativeIndexingLimit;
-
@@ -620,20 +620,20 @@
-
- /**
- * (protected) Native index of the first character in the text chunk.
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- int64_t chunkNativeStart;
-
- /**
- * (protected) Current iteration position within the text chunk (UTF-16 buffer).
- * This is the index to the character that will be returned by utext_next32().
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- int32_t chunkOffset;
-
- /**
- * (protected) Length the text chunk (UTF-16 buffer), in UChars.
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- int32_t chunkLength;
-
@@ -644,20 +644,20 @@
- * (protected) pointer to a chunk of text in UTF-16 format.
- * May refer either to original storage of the source of the text, or
- * if conversion was required, to a buffer owned by the UText.
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- const UChar *chunkContents;
-
- /**
- * (public) Pointer to Dispatch table for accessing functions for this UText.
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- const UTextFuncs *pFuncs;
-
- /**
- * (protected) Pointer to additional space requested by the
- * text provider during the utext_open operation.
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- void *pExtra;
-
@@ -665,7 +665,7 @@
- * (protected) Pointer to string or text-containing object or similar.
- * This is the source of the text that this UText is wrapping, in a format
- * that is known to the text provider functions.
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- const void *context;
-
@@ -674,26 +674,26 @@
- /**
- * (protected) Pointer fields available for use by the text provider.
- * Not used by UText common code.
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- const void *p;
- /**
- * (protected) Pointer fields available for use by the text provider.
- * Not used by UText common code.
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- const void *q;
- /**
- * (protected) Pointer fields available for use by the text provider.
- * Not used by UText common code.
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
- const void *r;
-
- /**
- * Private field reserved for future use by the UText framework
- * itself. This is not to be touched by the text providers.
-- * @internal ICU 3.4
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only. ICU 3.4
- */
- void *privP;
-
@@ -704,21 +704,21 @@
- /**
- * (protected) Integer field reserved for use by the text provider.
- * Not used by the UText framework, or by the client (user) of the UText.
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- int64_t a;
-
- /**
- * (protected) Integer field reserved for use by the text provider.
- * Not used by the UText framework, or by the client (user) of the UText.
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- int32_t b;
-
- /**
- * (protected) Integer field reserved for use by the text provider.
- * Not used by the UText framework, or by the client (user) of the UText.
-- * @stable ICU 3.4
+- * \xrefitem stable "Stable" "Stable List" ICU 3.4
- */
- int32_t c;
-
@@ -728,19 +728,19 @@
- /**
- * Private field reserved for future use by the UText framework
- * itself. This is not to be touched by the text providers.
-- * @internal ICU 3.4
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only. ICU 3.4
- */
- int64_t privA;
- /**
- * Private field reserved for future use by the UText framework
- * itself. This is not to be touched by the text providers.
-- * @internal ICU 3.4
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only. ICU 3.4
- */
- int32_t privB;
- /**
- * Private field reserved for future use by the UText framework
- * itself. This is not to be touched by the text providers.
-- * @internal ICU 3.4
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only. ICU 3.4
- */
- int32_t privC;
-};
@@ -750,7 +750,7 @@
-
-// do not use #ifndef U_HIDE_INTERNAL_API around the following!
-/**
-- * @internal
+- * \xrefitem internal "Internal" "Internal List" Do not use. This API is for internal use only.
- * Value used to help identify correctly initialized UText structs.
- * Note: must be publicly visible so that UTEXT_INITIALIZER can access it.
- */
@@ -763,7 +763,7 @@
- * struct. UText structs must be initialized before passing
- * them to one of the utext_open functions.
- *
-- * @stable ICU 3.6
+- * \xrefitem stable "Stable" "Stable List" ICU 3.6
- */
-#define UTEXT_INITIALIZER { \
- UTEXT_MAGIC, /* magic */ \