ICU-647 Updated header files with documentation

X-SVN-Rev: 3242

icu4c/source/i18n/unicode/ubrk.h

diff --git a/icu4c/source/i18n/unicode/ubrk.h b/icu4c/source/i18n/unicode/ubrk.h
index ed9af27..51c6a5da 100644
--- a/icu4c/source/i18n/unicode/ubrk.h
+++ b/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

diff --git a/icu4c/source/i18n/unicode/ucal.h b/icu4c/source/i18n/unicode/ucal.h
index fec3946..1fe073f 100644
--- a/icu4c/source/i18n/unicode/ucal.h
+++ b/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

diff --git a/icu4c/source/i18n/unicode/ucol.h b/icu4c/source/i18n/unicode/ucol.h
index e64eba0..b14c464 100644
--- a/icu4c/source/i18n/unicode/ucol.h
+++ b/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

diff --git a/icu4c/source/i18n/unicode/udat.h b/icu4c/source/i18n/unicode/udat.h
index 507535f..8d4d371 100644
--- a/icu4c/source/i18n/unicode/udat.h
+++ b/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

diff --git a/icu4c/source/i18n/unicode/umsg.h b/icu4c/source/i18n/unicode/umsg.h
index e7e2be9..009d89e 100644
--- a/icu4c/source/i18n/unicode/umsg.h
+++ b/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

diff --git a/icu4c/source/i18n/unicode/unum.h b/icu4c/source/i18n/unicode/unum.h
index 91ff71e..7fb565b 100644
--- a/icu4c/source/i18n/unicode/unum.h
+++ b/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

diff --git a/icu4c/source/i18n/unicode/utrans.h b/icu4c/source/i18n/unicode/utrans.h
index 9c48759..ccdab6a 100644
--- a/icu4c/source/i18n/unicode/utrans.h
+++ b/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