| Index: source/common/unicode/udata.h
|
| diff --git a/source/common/unicode/udata.h b/source/common/unicode/udata.h
|
| index f9b4cd4423e71c015c5db4dc2af7a41c3fbcf9a1..29e46630d5398d82738d1d61ffc4d2c914e8c68b 100644
|
| --- a/source/common/unicode/udata.h
|
| +++ b/source/common/unicode/udata.h
|
| @@ -1,7 +1,7 @@
|
| /*
|
| ******************************************************************************
|
| *
|
| -* Copyright (C) 1999-2012, International Business Machines
|
| +* Copyright (C) 1999-2014, International Business Machines
|
| * Corporation and others. All Rights Reserved.
|
| *
|
| ******************************************************************************
|
| @@ -77,6 +77,10 @@ U_CDECL_BEGIN
|
| * <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
|
| @@ -92,7 +96,7 @@ U_CDECL_BEGIN
|
| *
|
| * <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>
|
| @@ -101,6 +105,7 @@ U_CDECL_BEGIN
|
| * 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 {
|
| @@ -279,6 +284,9 @@ U_NAMESPACE_END
|
| /**
|
| * 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
|
| */
|
| @@ -311,6 +319,9 @@ udata_getInfo(UDataMemory *pData, UDataInfo *pInfo);
|
| * 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
|
| @@ -355,6 +366,9 @@ udata_setCommonData(const void *data, UErrorCode *err);
|
| * 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
|
|
|