JavaScriptCore-7601.1.46.3.tar.gz

[apple/javascriptcore.git] / icu / unicode / putil.h

diff --git a/icu/unicode/putil.h b/icu/unicode/putil.h
index 685df530ef3ea5fcdfd8d0133f1f26fb12bca7f8..71d5d26430529b60b7ea4c4d830dbc8617529465 100644 (file)
--- a/icu/unicode/putil.h
+++ b/icu/unicode/putil.h
@@ -1,7 +1,7 @@
 /*
 ******************************************************************************
 *
-*   Copyright (C) 1997-2004, International Business Machines
+*   Copyright (C) 1997-2009, International Business Machines
 *   Corporation and others.  All Rights Reserved.
 *
 ******************************************************************************
@@ -25,8 +25,12 @@
 #define PUTIL_H
 
 #include "unicode/utypes.h"
+ /**
+  * \file
+  * \brief C API: Platform Utilities
+  */
 
-/* Define this to 1 if your platform supports IEEE 754 floating point,
+/** Define this to 1 if your platform supports IEEE 754 floating point,
    to 0 if it does not. */
 #ifndef IEEE_754
 #   define IEEE_754 1
@@ -54,7 +58,11 @@
  *    If u_setDataDirectory() has been called, that is it, otherwise
  *    if the ICU_DATA environment variable is set, use that, otherwise
  *    If a data directory was specifed at ICU build time
- *      (#define ICU_DATA_DIR "path"), use that,
+ *      <code>
+ * \code
+ *        #define ICU_DATA_DIR "path" 
+ * \endcode
+ * </code> use that,
  *    otherwise no data directory is available.
  *
  * @return the data directory, or an empty string ("") if no data directory has
@@ -85,6 +93,7 @@ U_STABLE const char* U_EXPORT2 u_getDataDirectory(void);
  */
 U_STABLE void U_EXPORT2 u_setDataDirectory(const char *directory);
 
+#if !U_CHARSET_IS_UTF8
 /**
  * Please use ucnv_getDefaultName() instead.
  * Return the default codepage for this platform and locale.
@@ -94,6 +103,7 @@ U_STABLE void U_EXPORT2 u_setDataDirectory(const char *directory);
  * @internal
  */
 U_INTERNAL const char*  U_EXPORT2 uprv_getDefaultCodepage(void);
+#endif
 
 /**
  * Please use uloc_getDefault() instead.
@@ -107,6 +117,7 @@ U_INTERNAL const char*  U_EXPORT2 uprv_getDefaultCodepage(void);
 U_INTERNAL const char*  U_EXPORT2 uprv_getDefaultLocaleID(void);
 
 /**
+ * @{
  * Filesystem file and path separator characters.
  * Example: '/' and ':' on Unix, '\\' and ';' on Windows.
  * @stable ICU 2.0
@@ -134,6 +145,8 @@ U_INTERNAL const char*  U_EXPORT2 uprv_getDefaultLocaleID(void);
 #   define U_PATH_SEP_STRING ":"
 #endif
 
+/** @} */
+
 /**
  * Convert char characters to UChar characters.
  * This utility function is useful only for "invariant characters"