Update ICU to 54.1 step 1

source/common/unicode/udata.h

 /*
 ******************************************************************************
 *
-*   Copyright (C) 1999-2012, International Business Machines
+*   Copyright (C) 1999-2014, International Business Machines
 *   Corporation and others.  All Rights Reserved.
 *
 ******************************************************************************
 *   file name:  udata.h
 *   encoding:   US-ASCII
 *   tab size:   8 (not used)
 *   indentation:4
 *
 *   created on: 1999oct25
 *   created by: Markus W. Scherer
@@ skipping 55 matching lines @@
 
 #endif /* U_HIDE_INTERNAL_API */
 
 /**
  * UDataInfo contains the properties about the requested data.
  * This is meta data.
  *
  * <p>This structure may grow in the future, indicated by the
  * <code>size</code> field.</p>
  *
+ * <p>ICU data must be at least 8-aligned, and should be 16-aligned.
+ * The UDataInfo struct begins 4 bytes after the start of the data item,
+ * so it is 4-aligned.
+ *
  * <p>The platform data property fields help determine if a data
  * file can be efficiently used on a given machine.
  * The particular fields are of importance only if the data
  * is affected by the properties - if there is integer data
  * with word sizes > 1 byte, char* text, or UChar* text.</p>
  *
  * <p>The implementation for the <code>udata_open[Choice]()</code>
  * functions may reject data based on the value in <code>isBigEndian</code>.
  * No other field is used by the <code>udata</code> API implementation.</p>
  *
  * <p>The <code>dataFormat</code> may be used to identify
  * the kind of data, e.g. a converter table.</p>
  *
  * <p>The <code>formatVersion</code> field should be used to
  * make sure that the format can be interpreted.
- * I may be a good idea to check only for the one or two highest
+ * It may be a good idea to check only for the one or two highest
  * of the version elements to allow the data memory to
  * get more or somewhat rearranged contents, for as long
  * as the using code can still interpret the older contents.</p>
  *
  * <p>The <code>dataVersion</code> field is intended to be a
  * common place to store the source version of the data;
  * for data from the Unicode character database, this could
  * reflect the Unicode version.</p>
+ *
  * @stable ICU 2.0
  */
 typedef struct {
     /** sizeof(UDataInfo)
      *  @stable ICU 2.0 */
     uint16_t size;
 
     /** unused, set to 0 
      *  @stable ICU 2.0*/
     uint16_t reservedWord;
@@ skipping 158 matching lines @@
  */
 U_DEFINE_LOCAL_OPEN_POINTER(LocalUDataMemoryPointer, UDataMemory, udata_close);
 
 U_NAMESPACE_END
 
 #endif
 
 /**
  * Get the pointer to the actual data inside the data memory.
  * The data is read-only.
+ *
+ * ICU data must be at least 8-aligned, and should be 16-aligned.
+ *
  * @param pData The pointer to data memory object
  * @stable ICU 2.0
  */
 U_STABLE const void * U_EXPORT2
 udata_getMemory(UDataMemory *pData);
 
 /**
  * Get the information from the data memory header.
  * This allows to get access to the header containing
  * platform data properties etc. which is not part of
@@ skipping 12 matching lines @@
  * @stable ICU 2.0
  */
 U_STABLE void U_EXPORT2
 udata_getInfo(UDataMemory *pData, UDataInfo *pInfo);
 
 /**
  * This function bypasses the normal ICU data loading process and
  * allows you to force ICU's system data to come out of a user-specified
  * area in memory.
  *
+ * ICU data must be at least 8-aligned, and should be 16-aligned.
+ * See http://userguide.icu-project.org/icudata
+ *
  * The format of this data is that of the icu common data file, as is
  * generated by the pkgdata tool with mode=common or mode=dll.
  * You can read in a whole common mode file and pass the address to the start of the
  * data, or (with the appropriate link options) pass in the pointer to
  * the data that has been loaded from a dll by the operating system,
  * as shown in this code:
  *
  *       extern const char U_IMPORT U_ICUDATA_ENTRY_POINT [];
  *        // U_ICUDATA_ENTRY_POINT is same as entry point specified to pkgdata tool
  *       UErrorCode  status = U_ZERO_ERROR;
@@ skipping 24 matching lines @@
  */
 U_STABLE void U_EXPORT2
 udata_setCommonData(const void *data, UErrorCode *err);
 
 
 /**
  * This function bypasses the normal ICU data loading process for application-specific
  * data and allows you to force the it to come out of a user-specified
  * pointer.
  *
+ * ICU data must be at least 8-aligned, and should be 16-aligned.
+ * See http://userguide.icu-project.org/icudata
+ *
  * The format of this data is that of the icu common data file, like 'icudt26l.dat'
  * or the corresponding shared library (DLL) file.
  * The application must read in or otherwise construct an image of the data and then
  * pass the address of it to this function.
  *
  *
  * Warning:  setAppData will set a U_USING_DEFAULT_WARNING code if
  *           data with the specifed path that has already been opened, or
  *           if setAppData with the same path has already been called.
  *           Any such calls to setAppData will have no effect.
@@ skipping 39 matching lines @@
  * @param status Error code.
  * @see UDataFileAccess
  * @stable ICU 3.4 
  */
 U_STABLE void U_EXPORT2
 udata_setFileAccess(UDataFileAccess access, UErrorCode *status);
 
 U_CDECL_END
 
 #endif