From e6e3075392c5047e583310fb99671b8197755d93 Mon Sep 17 00:00:00 2001 From: Markus Scherer Date: Fri, 24 Aug 2007 19:49:03 +0000 Subject: [PATCH] ICU-5481 add details to ucnv_setFallback documentation X-SVN-Rev: 22526 --- icu4c/source/common/unicode/ucnv.h | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/icu4c/source/common/unicode/ucnv.h b/icu4c/source/common/unicode/ucnv.h index 7c1eb5fddb..6579934a8a 100644 --- a/icu4c/source/common/unicode/ucnv.h +++ b/icu4c/source/common/unicode/ucnv.h @@ -1834,20 +1834,31 @@ U_STABLE UBool U_EXPORT2 ucnv_isAmbiguous(const UConverter *cnv); /** - * Sets the converter to use fallback mapping or not. + * Sets the converter to use fallback mappings or not. + * Regardless of this flag, the converter will always use + * fallbacks from Unicode Private Use code points, as well as + * reverse fallbacks (to Unicode). + * For details see ".ucm File Format" + * in the Conversion Data chapter of the ICU User Guide: + * http://www.icu-project.org/userguide/conversion-data.html#ucmformat + * * @param cnv The converter to set the fallback mapping usage on. * @param usesFallback TRUE if the user wants the converter to take advantage of the fallback * mapping, FALSE otherwise. * @stable ICU 2.0 + * @see ucnv_usesFallback */ U_STABLE void U_EXPORT2 ucnv_setFallback(UConverter *cnv, UBool usesFallback); /** * Determines if the converter uses fallback mappings or not. + * This flag has restrictions, see ucnv_setFallback(). + * * @param cnv The converter to be tested * @return TRUE if the converter uses fallback, FALSE otherwise. * @stable ICU 2.0 + * @see ucnv_setFallback */ U_STABLE UBool U_EXPORT2 ucnv_usesFallback(const UConverter *cnv);