| Index: readme.html
|
| diff --git a/readme.html b/readme.html
|
| index 4f992452fbff3e57646329ec0768ce04e436bb16..486a78d435c635eee5aac5a1174d28a18a22c8c4 100644
|
| --- a/readme.html
|
| +++ b/readme.html
|
| @@ -3,9 +3,9 @@
|
|
|
| <html lang="en-US" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">
|
| <head>
|
| - <title>ReadMe for ICU 54.1</title>
|
| + <title>ReadMe for ICU 56.1</title>
|
| <meta name="COPYRIGHT" content=
|
| - "Copyright (c) 1997-2014 IBM Corporation and others. All Rights Reserved." />
|
| + "Copyright (c) 1997-2015 IBM Corporation and others. All Rights Reserved." />
|
| <meta name="KEYWORDS" content=
|
| "ICU; International Components for Unicode; ICU4C; what's new; readme; read me; introduction; downloads; downloading; building; installation;" />
|
| <meta name="DESCRIPTION" content=
|
| @@ -17,38 +17,35 @@
|
| <!--
|
| classes to use with the "body" -
|
| draft - if the release note is itself a draft (May be combined with the other two)
|
| -
|
| -
|
| rc - if the release note is a release candidate
|
| milestone - if the release note is a milestone release
|
| -->
|
| -
|
| - <!--<body class="rc">-->
|
| - <body>
|
| +
|
| + <!-- <body class="milestone"> -->
|
| + <body class="rc">
|
| + <!-- <body> -->
|
| <p class="only-draft"><b>Note:</b> This is a draft readme.</p>
|
|
|
| <h1>
|
| - <span class="only-draft">DRAFT</span>
|
| - International Components for Unicode<br/>
|
| -
|
| - <span class="only-rc">Release Candidate</span>
|
| - <span class="only-milestone">(Milestone Release)</span>
|
| - <abbr title="International Components for Unicode">ICU</abbr> 54.1 ReadMe
|
| - </h1>
|
| + <span class="only-draft">DRAFT</span>
|
| + International Components for Unicode<br/>
|
| + <span class="only-rc">Release Candidate</span>
|
| + <span class="only-milestone">(Milestone Release)</span>
|
| + <abbr title="International Components for Unicode">ICU</abbr> 56.1 ReadMe
|
| + </h1>
|
|
|
| -
|
| <!-- Shouldn't need to comment/uncomment this paragraph, just change the body class -->
|
| <p class="note only-milestone">This is a development milestone release of ICU
|
| - This milestone is intended for those wishing to get an early look at new features and API changes.
|
| - It is not recommended for production use.</p>
|
| + This milestone is intended for those wishing to get an early look at new features and API changes.
|
| + It is not recommended for production use.</p>
|
|
|
| <!-- Shouldn't need to comment/uncomment this paragraph, just change the body class -->
|
| <p class="note only-rc">This is a release candidate version of ICU4C.
|
| - It is not recommended for production use.</p>
|
| + It is not recommended for production use.</p>
|
|
|
| - <p>Last updated: 2014-September-24<br />
|
| - Copyright © 1997-2014 International Business Machines Corporation and
|
| - others. All Rights Reserved.</p>
|
| + <p>Last updated: 2015-Sep-07<br />
|
| + Copyright © 1997-2015 International Business Machines Corporation and
|
| + others. All Rights Reserved.</p>
|
| <!-- Remember that there is a copyright at the end too -->
|
| <hr/>
|
|
|
| @@ -237,10 +234,66 @@
|
|
|
| <h3>API Changes</h3>
|
| <p>See the <a href="APIChangeReport.html">API Change Report</a> for a complete
|
| - list of APIs added, removed, or changed in this release.</p>
|
| + list of APIs added, removed, or changed in this release.</p>
|
| +
|
| + <!-- ICU 56 items -->
|
| + <h3>COLON withdrawn as date/time pattern character</h3>
|
| + <p>In ICU 55, COLON was introduced as a date/time pattern character
|
| + to be replaced by the value of the timeSeparator for the number
|
| + system being used; a corresponding new UDateFormatField
|
| + UDAT_TIME_SEPARATOR_FIELD was added. Use of COLON caused some
|
| + backwards compatibility problems, so it is being withdrawn as a
|
| + pattern character. However, UDAT_TIME_SEPARATOR_FIELD remains
|
| + as does the mechanism for replacing a pattern character with the
|
| + value of the timeSeparator; a new pattern character may be
|
| + assigned in the future.</p>
|
| +
|
| + <h3>ICU Plugins: disabled by default</h3>
|
| + <p>ICU Plugins are now disabled by default. They may be enabled
|
| + with the configure option
|
| + <tt>--enable-plugins</tt> or by means of
|
| + <tt>#define UCONFIG_ENABLE_PLUGINS</tt>.
|
| + </p>
|
| +
|
| + <!-- ICU 55 items -->
|
| + <h3>ICU 55: Layout Engine breaking API change</h3>
|
| + <p>The LayoutEngine (already deprecated) has had the function
|
| + <tt>LEFontInstance::getFontTable(LETag, size_t &length)</tt>
|
| + since ICU 52. Its implementation was optional. In ICU 55, this
|
| + version
|
| + of <tt>getFontTable</tt> has been made pure virtual, and the
|
| + version without a length (<tt>getFontTable(LETag)</tt>) has been
|
| + completely removed. This is a breaking change for users who have
|
| + not implemented the two-argument <tt>getFontTable()</tt>
|
| + function in their <tt>LEFontInstance</tt> subclasses.
|
| + The break is intentional, as the one-argument version cannot be
|
| + made secure. See <tt>LEFontInstance</tt> api docs for more detail.
|
| + </p>
|
| +
|
| + <h3>ICU 55: Deprecations in PluralRules (plurrule.h)</h3>
|
| + <p>The following PluralRules methods never had an implementation
|
| + but were inadvertently marked @stable; they have now been
|
| + deprecated. [#<a href="http://bugs.icu-project.org/trac/ticket/10759">10759</a>]</p>
|
| + <ul>
|
| + <li><tt>double icu::PluralRules::getUniqueKeywordValue(const UnicodeString&)</tt></li>
|
| + <li><tt>int32_t icu::PluralRules::getAllKeywordValues(const UnicodeString&, double*, int32_t, UErrorCode&)</tt></li>
|
| + </ul>
|
| +
|
| + <h3>ICU 55: Deprecate uidna.h functions for IDNA2003 support</h3>
|
| + <p>The IDNA2003 API has been deprecated; use the API for IDNA2008 / UTS #46 instead via
|
| + uidna_openUTS46() or class IDNA [#<a href="http://bugs.icu-project.org/trac/ticket/8477">8477</a>].
|
| + This applies to the following:</p>
|
| + <ul>
|
| + <li><tt>enum value UIDNA_ALLOW_UNASSIGNED</tt></li>
|
| + <li><tt>uidna_IDNToASCII</tt></li>
|
| + <li><tt>uidna_IDNToUnicode</tt></li>
|
| + <li><tt>uidna_compare</tt></li>
|
| + <li><tt>uidna_toASCII</tt></li>
|
| + <li><tt>uidna_toUnicode</tt></li>
|
| + </ul>
|
|
|
| <!-- ICU 54 items -->
|
| - <h3>Deprecation: Layout Engine</h3>
|
| + <h3>ICU 54: Deprecation of Layout Engine</h3>
|
| <p>The LayoutEngine is now deprecated. Please
|
| see <a href='http://userguide.icu-project.org/layoutengine'>the
|
| User's Guide</a> for more details and migration recommendations.
|
| @@ -254,21 +307,22 @@
|
| instead of ICU as the layout engine. See <a href="http://userguide.icu-project.org/layoutengine">
|
| the users' guide</a> for more information about how to build.
|
| </p>
|
| - <h3>Deprecation: Collation Short Strings</h3>
|
| + <h3>ICU 54: Deprecation of Collation Short Strings</h3>
|
| <p>The collation short naming scheme and its API functions are deprecated.
|
| Use ucol_open() with language tag collation keywords instead (see <a href="http://userguide.icu-project.org/collation/api">Collation API Details</a>). For example, <code>ucol_open("de-u-co-phonebk-ka-shifted", &errorCode)</code>
|
| for German Phonebook order with "ignore punctuation" mode.</p>
|
|
|
| - <h3>Deprecation: UCOL_TAILORINGS_VERSION</h3>
|
| + <h3>ICU 54: Deprecation of UCOL_TAILORINGS_VERSION</h3>
|
| <p>This was originally intended to be the version of collation tailorings,
|
| but that information is actually in the tailorings data and this
|
| constant has always been (and now will continue to be) 1.</p>
|
|
|
| - <h3>Deprecation (in ICU 53): TimeUnitFormat</h3>
|
| + <!-- ICU 53 items -->
|
| + <h3>ICU 53: Deprecation of TimeUnitFormat</h3>
|
| <p>The TimeUnitFormat and its methods were actually deprecated in ICU 53 and the
|
| class as a whole was tagged as deprecated in that release, but the status tags for
|
| - the individual methods did not correctly indicate the deprecated status; now they do.
|
| - Use the MeasureFormat class and its methods instead.</p>
|
| + the individual methods did not correctly indicate the deprecated status; they
|
| + do as of ICU 54. Use the MeasureFormat class and its methods instead.</p>
|
|
|
| <!-- standing item -->
|
| <h3>Full release notes and the latest updates</h3>
|
| @@ -277,7 +331,7 @@
|
| For more news about this release, as well as late-breaking news, see the
|
| <a href="http://site.icu-project.org/download/54">ICU download page</a>.</p>
|
|
|
| - <!-- end ICU 54 items -->
|
| + <!-- end of What's New items -->
|
|
|
| <h2><a name="Download" href="#Download" id="Download">How To Download the
|
| Source Code</a></h2>
|
| @@ -1793,7 +1847,7 @@ gnumake</pre>
|
| </ul>
|
| <hr />
|
|
|
| - <p>Copyright © 1997-2014 International Business Machines Corporation and
|
| + <p>Copyright © 1997-2015 International Business Machines Corporation and
|
| others. All Rights Reserved.<br />
|
| IBM Globalization Center of Competency - San José<br />
|
| 4400 North First Street<br />
|
|
|