| OLD | NEW |
|---|
| 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" | 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" |
| 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> | 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
| 3 | 3 |
| 4 <html lang="en-US" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US"> | 4 <html lang="en-US" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US"> |
| 5 <head> | 5 <head> |
| 6 <title>ReadMe for ICU 54.1</title> | 6 <title>ReadMe for ICU 56.1</title> |
| 7 <meta name="COPYRIGHT" content= | 7 <meta name="COPYRIGHT" content= |
| 8 "Copyright (c) 1997-2014 IBM Corporation and others. All Rights Reserved." /
> | 8 "Copyright (c) 1997-2015 IBM Corporation and others. All Rights Reserved." /
> |
| 9 <meta name="KEYWORDS" content= | 9 <meta name="KEYWORDS" content= |
| 10 "ICU; International Components for Unicode; ICU4C; what's new; readme; read
me; introduction; downloads; downloading; building; installation;" /> | 10 "ICU; International Components for Unicode; ICU4C; what's new; readme; read
me; introduction; downloads; downloading; building; installation;" /> |
| 11 <meta name="DESCRIPTION" content= | 11 <meta name="DESCRIPTION" content= |
| 12 "The introduction to the International Components for Unicode with instructi
ons on building, installation, usage and other information about ICU." /> | 12 "The introduction to the International Components for Unicode with instructi
ons on building, installation, usage and other information about ICU." /> |
| 13 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> | 13 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> |
| 14 <link type="text/css" href="./icu4c.css" rel="stylesheet"/> | 14 <link type="text/css" href="./icu4c.css" rel="stylesheet"/> |
| 15 </head> | 15 </head> |
| 16 | 16 |
| 17 <!-- | 17 <!-- |
| 18 classes to use with the "body" - | 18 classes to use with the "body" - |
| 19 draft - if the release note is itself a draft (May be combined with the
other two) | 19 draft - if the release note is itself a draft (May be combined with the
other two) |
| 20 | |
| 21 | |
| 22 rc - if the release note is a release candidate | 20 rc - if the release note is a release candidate |
| 23 milestone - if the release note is a milestone release | 21 milestone - if the release note is a milestone release |
| 24 --> | 22 --> |
| 25 | 23 |
| 26 <!--<body class="rc">--> | 24 <!-- <body class="milestone"> --> |
| 27 <body> | 25 <body class="rc"> |
| 26 <!-- <body> --> |
| 28 <p class="only-draft"><b>Note:</b> This is a draft readme.</p> | 27 <p class="only-draft"><b>Note:</b> This is a draft readme.</p> |
| 29 | 28 |
| 30 <h1> | 29 <h1> |
| 31 <span class="only-draft">DRAFT</span> | 30 <span class="only-draft">DRAFT</span> |
| 32 International Components for Unicode<br/> | 31 International Components for Unicode<br/> |
| 32 <span class="only-rc">Release Candidate</span> |
| 33 <span class="only-milestone">(Milestone Release)</span> |
| 34 <abbr title="International Components for Unicode">ICU</abbr> 56.1 ReadMe |
| 35 </h1> |
| 33 | 36 |
| 34 <span class="only-rc">Release Candidate</span> | |
| 35 <span class="only-milestone">(Milestone Release)</span> | |
| 36 <abbr title="International Components for Unicode">ICU</abbr> 54.1 Read
Me | |
| 37 </h1> | |
| 38 | |
| 39 | |
| 40 <!-- Shouldn't need to comment/uncomment this paragraph, just change the bod
y class --> | 37 <!-- Shouldn't need to comment/uncomment this paragraph, just change the bod
y class --> |
| 41 <p class="note only-milestone">This is a development milestone release of IC
U | 38 <p class="note only-milestone">This is a development milestone release of IC
U |
| 42 This milestone is intended for those wishing to get an early look at new fea
tures and API changes. | 39 This milestone is intended for those wishing to get an early look at new f
eatures and API changes. |
| 43 It is not recommended for production use.</p> | 40 It is not recommended for production use.</p> |
| 44 | 41 |
| 45 <!-- Shouldn't need to comment/uncomment this paragraph, just change the bod
y class --> | 42 <!-- Shouldn't need to comment/uncomment this paragraph, just change the bod
y class --> |
| 46 <p class="note only-rc">This is a release candidate version of ICU4C. | 43 <p class="note only-rc">This is a release candidate version of ICU4C. |
| 47 It is not recommended for production use.</p> | 44 It is not recommended for production use.</p> |
| 48 | 45 |
| 49 <p>Last updated: 2014-September-24<br /> | 46 <p>Last updated: 2015-Sep-07<br /> |
| 50 Copyright © 1997-2014 International Business Machines Corporation and | 47 Copyright © 1997-2015 International Business Machines Corporation and |
| 51 others. All Rights Reserved.</p> | 48 others. All Rights Reserved.</p> |
| 52 <!-- Remember that there is a copyright at the end too --> | 49 <!-- Remember that there is a copyright at the end too --> |
| 53 <hr/> | 50 <hr/> |
| 54 | 51 |
| 55 <h2 class="TOC">Table of Contents</h2> | 52 <h2 class="TOC">Table of Contents</h2> |
| 56 | 53 |
| 57 <ul class="TOC"> | 54 <ul class="TOC"> |
| 58 <li><a href="#Introduction">Introduction</a></li> | 55 <li><a href="#Introduction">Introduction</a></li> |
| 59 | 56 |
| 60 <li><a href="#GettingStarted">Getting Started</a></li> | 57 <li><a href="#GettingStarted">Getting Started</a></li> |
| 61 | 58 |
| (...skipping 168 matching lines...) Loading... |
| 230 </table> | 227 </table> |
| 231 | 228 |
| 232 <p><strong>Important:</strong> Please make sure you understand the <a href= | 229 <p><strong>Important:</strong> Please make sure you understand the <a href= |
| 233 "license.html">Copyright and License Information</a>.</p> | 230 "license.html">Copyright and License Information</a>.</p> |
| 234 | 231 |
| 235 <h2><a name="News" href="#News" id="News">What is new in this | 232 <h2><a name="News" href="#News" id="News">What is new in this |
| 236 release?</a></h2> | 233 release?</a></h2> |
| 237 | 234 |
| 238 <h3>API Changes</h3> | 235 <h3>API Changes</h3> |
| 239 <p>See the <a href="APIChangeReport.html">API Change Report</a> for a comple
te | 236 <p>See the <a href="APIChangeReport.html">API Change Report</a> for a comple
te |
| 240 list of APIs added, removed, or changed in this release.</p> | 237 list of APIs added, removed, or changed in this release.</p> |
| 238 |
| 239 <!-- ICU 56 items --> |
| 240 <h3>COLON withdrawn as date/time pattern character</h3> |
| 241 <p>In ICU 55, COLON was introduced as a date/time pattern character |
| 242 to be replaced by the value of the timeSeparator for the number |
| 243 system being used; a corresponding new UDateFormatField |
| 244 UDAT_TIME_SEPARATOR_FIELD was added. Use of COLON caused some |
| 245 backwards compatibility problems, so it is being withdrawn as a |
| 246 pattern character. However, UDAT_TIME_SEPARATOR_FIELD remains |
| 247 as does the mechanism for replacing a pattern character with the |
| 248 value of the timeSeparator; a new pattern character may be |
| 249 assigned in the future.</p> |
| 250 |
| 251 <h3>ICU Plugins: disabled by default</h3> |
| 252 <p>ICU Plugins are now disabled by default. They may be enabled |
| 253 with the configure option |
| 254 <tt>--enable-plugins</tt> or by means of |
| 255 <tt>#define UCONFIG_ENABLE_PLUGINS</tt>. |
| 256 » </p> |
| 257 |
| 258 <!-- ICU 55 items --> |
| 259 <h3>ICU 55: Layout Engine breaking API change</h3> |
| 260 <p>The LayoutEngine (already deprecated) has had the function |
| 261 <tt>LEFontInstance::getFontTable(LETag, size_t &length)</tt> |
| 262 since ICU 52. Its implementation was optional. In ICU 55, this |
| 263 version |
| 264 of <tt>getFontTable</tt> has been made pure virtual, and the |
| 265 version without a length (<tt>getFontTable(LETag)</tt>) has been |
| 266 completely removed. This is a breaking change for users who have |
| 267 not implemented the two-argument <tt>getFontTable()</tt> |
| 268 function in their <tt>LEFontInstance</tt> subclasses. |
| 269 The break is intentional, as the one-argument version cannot be |
| 270 made secure. See <tt>LEFontInstance</tt> api docs for more detail. |
| 271 </p> |
| 272 |
| 273 <h3>ICU 55: Deprecations in PluralRules (plurrule.h)</h3> |
| 274 <p>The following PluralRules methods never had an implementation |
| 275 but were inadvertently marked @stable; they have now been |
| 276 deprecated. [#<a href="http://bugs.icu-project.org/trac/ticket/10759">1075
9</a>]</p> |
| 277 <ul> |
| 278 <li><tt>double icu::PluralRules::getUniqueKeywordValue(const UnicodeString
&)</tt></li> |
| 279 <li><tt>int32_t icu::PluralRules::getAllKeywordValues(const UnicodeString&
amp;, double*, int32_t, UErrorCode&)</tt></li> |
| 280 </ul> |
| 281 |
| 282 <h3>ICU 55: Deprecate uidna.h functions for IDNA2003 support</h3> |
| 283 <p>The IDNA2003 API has been deprecated; use the API for IDNA2008 / UTS #46
instead via |
| 284 uidna_openUTS46() or class IDNA [#<a href="http://bugs.icu-project.org/tra
c/ticket/8477">8477</a>]. |
| 285 This applies to the following:</p> |
| 286 <ul> |
| 287 <li><tt>enum value UIDNA_ALLOW_UNASSIGNED</tt></li> |
| 288 <li><tt>uidna_IDNToASCII</tt></li> |
| 289 <li><tt>uidna_IDNToUnicode</tt></li> |
| 290 <li><tt>uidna_compare</tt></li> |
| 291 <li><tt>uidna_toASCII</tt></li> |
| 292 <li><tt>uidna_toUnicode</tt></li> |
| 293 </ul> |
| 241 | 294 |
| 242 <!-- ICU 54 items --> | 295 <!-- ICU 54 items --> |
| 243 <h3>Deprecation: Layout Engine</h3> | 296 <h3>ICU 54: Deprecation of Layout Engine</h3> |
| 244 <p>The LayoutEngine is now deprecated. Please | 297 <p>The LayoutEngine is now deprecated. Please |
| 245 see <a href='http://userguide.icu-project.org/layoutengine'>the | 298 see <a href='http://userguide.icu-project.org/layoutengine'>the |
| 246 User's Guide</a> for more details and migration recommendations. | 299 User's Guide</a> for more details and migration recommendations. |
| 247 In the future, passing "<tt>--enable-layout</tt>" to configure | 300 In the future, passing "<tt>--enable-layout</tt>" to configure |
| 248 will be required to | 301 will be required to |
| 249 enable the layout engine.</p> | 302 enable the layout engine.</p> |
| 250 <p> | 303 <p> |
| 251 Note that the ParagraphLayout (layoutex) library is not deprecated. | 304 Note that the ParagraphLayout (layoutex) library is not deprecated. |
| 252 There is a new option, <tt>--enable-layoutex</tt> which will build | 305 There is a new option, <tt>--enable-layoutex</tt> which will build |
| 253 the ParagraphLayout library using <a href="http://harfbuzz.org">HarfBuzz</
a> | 306 the ParagraphLayout library using <a href="http://harfbuzz.org">HarfBuzz</
a> |
| 254 instead of ICU as the layout engine. See <a href="http://userguide.icu-pro
ject.org/layoutengine"> | 307 instead of ICU as the layout engine. See <a href="http://userguide.icu-pro
ject.org/layoutengine"> |
| 255 the users' guide</a> for more information about how to build. | 308 the users' guide</a> for more information about how to build. |
| 256 </p> | 309 </p> |
| 257 <h3>Deprecation: Collation Short Strings</h3> | 310 <h3>ICU 54: Deprecation of Collation Short Strings</h3> |
| 258 <p>The collation short naming scheme and its API functions are deprecated. | 311 <p>The collation short naming scheme and its API functions are deprecated. |
| 259 Use ucol_open() with language tag collation keywords instead (see <a href="h
ttp://userguide.icu-project.org/collation/api">Collation API Details</a>). For e
xample, <code>ucol_open("de-u-co-phonebk-ka-shifted", &errorCode)</code> | 312 Use ucol_open() with language tag collation keywords instead (see <a href="h
ttp://userguide.icu-project.org/collation/api">Collation API Details</a>). For e
xample, <code>ucol_open("de-u-co-phonebk-ka-shifted", &errorCode)</code> |
| 260 for German Phonebook order with "ignore punctuation" mode.</p> | 313 for German Phonebook order with "ignore punctuation" mode.</p> |
| 261 | 314 |
| 262 <h3>Deprecation: UCOL_TAILORINGS_VERSION</h3> | 315 <h3>ICU 54: Deprecation of UCOL_TAILORINGS_VERSION</h3> |
| 263 <p>This was originally intended to be the version of collation tailorings, | 316 <p>This was originally intended to be the version of collation tailorings, |
| 264 but that information is actually in the tailorings data and this | 317 but that information is actually in the tailorings data and this |
| 265 constant has always been (and now will continue to be) 1.</p> | 318 constant has always been (and now will continue to be) 1.</p> |
| 266 | 319 |
| 267 <h3>Deprecation (in ICU 53): TimeUnitFormat</h3> | 320 <!-- ICU 53 items --> |
| 321 <h3>ICU 53: Deprecation of TimeUnitFormat</h3> |
| 268 <p>The TimeUnitFormat and its methods were actually deprecated in ICU 53 and
the | 322 <p>The TimeUnitFormat and its methods were actually deprecated in ICU 53 and
the |
| 269 class as a whole was tagged as deprecated in that release, but the status ta
gs for | 323 class as a whole was tagged as deprecated in that release, but the status ta
gs for |
| 270 the individual methods did not correctly indicate the deprecated status; now
they do. | 324 the individual methods did not correctly indicate the deprecated status; the
y |
| 271 Use the MeasureFormat class and its methods instead.</p> | 325 do as of ICU 54. Use the MeasureFormat class and its methods instead.</p> |
| 272 | 326 |
| 273 <!-- standing item --> | 327 <!-- standing item --> |
| 274 <h3>Full release notes and the latest updates</h3> | 328 <h3>Full release notes and the latest updates</h3> |
| 275 <p>The previous list concentrates on <em>changes that affect existing | 329 <p>The previous list concentrates on <em>changes that affect existing |
| 276 applications migrating from previous ICU releases</em>. | 330 applications migrating from previous ICU releases</em>. |
| 277 For more news about this release, as well as late-breaking news, see the | 331 For more news about this release, as well as late-breaking news, see the |
| 278 <a href="http://site.icu-project.org/download/54">ICU download page</a>.</p> | 332 <a href="http://site.icu-project.org/download/54">ICU download page</a>.</p> |
| 279 | 333 |
| 280 <!-- end ICU 54 items --> | 334 <!-- end of What's New items --> |
| 281 | 335 |
| 282 <h2><a name="Download" href="#Download" id="Download">How To Download the | 336 <h2><a name="Download" href="#Download" id="Download">How To Download the |
| 283 Source Code</a></h2> | 337 Source Code</a></h2> |
| 284 | 338 |
| 285 <p>There are two ways to download ICU releases:</p> | 339 <p>There are two ways to download ICU releases:</p> |
| 286 | 340 |
| 287 <ul> | 341 <ul> |
| 288 <li><strong>Official Release Snapshot:</strong><br /> | 342 <li><strong>Official Release Snapshot:</strong><br /> |
| 289 If you want to use ICU (as opposed to developing it), you should download | 343 If you want to use ICU (as opposed to developing it), you should download |
| 290 an official packaged version of the ICU source code. These versions are | 344 an official packaged version of the ICU source code. These versions are |
| (...skipping 1495 matching lines...) Loading... |
| 1786 from files makes use of these functions.<br /> | 1840 from files makes use of these functions.<br /> |
| 1787 <br /> | 1841 <br /> |
| 1788 </li> | 1842 </li> |
| 1789 | 1843 |
| 1790 <li>Using platform specific #ifdef macros are highly discouraged outside o
f | 1844 <li>Using platform specific #ifdef macros are highly discouraged outside o
f |
| 1791 the scope of these files. When the source code gets updated in the future, | 1845 the scope of these files. When the source code gets updated in the future, |
| 1792 these #ifdef's can cause testing problems for your platform.</li> | 1846 these #ifdef's can cause testing problems for your platform.</li> |
| 1793 </ul> | 1847 </ul> |
| 1794 <hr /> | 1848 <hr /> |
| 1795 | 1849 |
| 1796 <p>Copyright © 1997-2014 International Business Machines Corporation an
d | 1850 <p>Copyright © 1997-2015 International Business Machines Corporation an
d |
| 1797 others. All Rights Reserved.<br /> | 1851 others. All Rights Reserved.<br /> |
| 1798 IBM Globalization Center of Competency - San José<br /> | 1852 IBM Globalization Center of Competency - San José<br /> |
| 1799 4400 North First Street<br /> | 1853 4400 North First Street<br /> |
| 1800 San José, CA 95134<br /> | 1854 San José, CA 95134<br /> |
| 1801 USA</p> | 1855 USA</p> |
| 1802 </body> | 1856 </body> |
| 1803 </html> | 1857 </html> |
| OLD | NEW |
|---|
Chromium Code Reviews