ICU-647 Updated header files with documentation

X-SVN-Rev: 3242

icu4c/source/i18n/unicode/ubrk.h

@@ -9,7 +9,7 @@
 #include "unicode/utypes.h"
 /**
  * \file
- * \brief Description of BreakIterator C API
+ * \brief C API: BreakIterator 
  *
  * <h2> BreakIterator C API </h2>
  *

icu4c/source/i18n/unicode/ucal.h

@@ -9,7 +9,7 @@
 #include "unicode/utypes.h"
 /**
  * \file
- * \brief Description of Calendar C API
+ * \brief C API: Calendar 
  *
  * <h2>Calendar C API</h2>
  *

icu4c/source/i18n/unicode/ucol.h

@@ -11,7 +11,7 @@
 #include "unicode/unorm.h"
 /**
  * \file
- * \brief Description of Collator C API
+ * \brief C API: Collator 
  *
  * <h2> Collator C API </h2>
  *

icu4c/source/i18n/unicode/udat.h

@@ -12,7 +12,7 @@
 #include "unicode/unum.h"
 /**
  * \file
- * \brief Description of DateFormat C API
+ * \brief C API: DateFormat 
  *
  * <h2> Date Format C API</h2>
  *

icu4c/source/i18n/unicode/umsg.h

@@ -11,7 +11,7 @@
 #include <stdarg.h>
 /**
  * \file
- * \brief Description of MessageFormat C API`
+ * \brief C API: MessageFormat 
  *
  * <h2>Message Format C API </h2>
  *

icu4c/source/i18n/unicode/unum.h

@@ -16,7 +16,7 @@
 
 /**
  * \file
- * \brief Description of NumberFormat C API
+ * \brief C API: NumberFormat
  *
  * <h2> Number Format C API </h2>
  *

icu4c/source/i18n/unicode/utrans.h

@@ -18,7 +18,12 @@
 /********************************************************************
  * General Notes
  ********************************************************************
+ */
+/**
+ * \file
+ * \brief C API: Transliterator
  *
+ * <h2> Transliteration </h2>
  * The data structures and functions described in this header provide
  * transliteration services.  Transliteration services are implemented
  * as C++ classes.  The comments and documentation in this header