ICU-12187 BRS task - Update readme for release candidate

X-SVN-Rev: 38498
This commit is contained in:
Peter Edberg 2016-03-05 20:01:24 +00:00
parent 2d40cbbf01
commit 1ea7639da3

View File

@ -3,7 +3,7 @@
<html lang="en-US" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">
<head>
<title>ReadMe for ICU 57.0.1</title>
<title>ReadMe for ICU 57.1</title>
<meta name="COPYRIGHT" content=
"Copyright (c) 1997-2016 IBM Corporation and others. All Rights Reserved." />
<meta name="KEYWORDS" content=
@ -13,16 +13,16 @@
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<link type="text/css" href="./icu4c.css" rel="stylesheet"/>
</head>
<!--
classes to use with the "body" -
<!--
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="milestone"> -->
<body class="milestone">
<!-- <body class="rc"> -->
<body class="rc">
<!-- <body> -->
<p class="only-draft"><b>Note:</b> This is a draft readme.</p>
@ -31,7 +31,7 @@
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> 57.0.1 ReadMe
<abbr title="International Components for Unicode">ICU</abbr> 57.1 ReadMe
</h1>
<!-- Shouldn't need to comment/uncomment this paragraph, just change the body class -->
@ -43,7 +43,7 @@
<p class="note only-rc">This is a release candidate version of ICU4C.
It is not recommended for production use.</p>
<p>Last updated: 2016-Feb-03<br />
<p>Last updated: 2016-Mar-05<br />
Copyright &copy; 1997-2016 International Business Machines Corporation and
others. All Rights Reserved.</p>
<!-- Remember that there is a copyright at the end too -->
@ -63,7 +63,7 @@
<li><a href="#SourceCode">ICU Source Code Organization</a></li>
<li>
<a href="#HowToBuild">How To Build And Install ICU</a>
<a href="#HowToBuild">How To Build And Install ICU</a>
<ul >
<li><a href="#RecBuild">Recommended Build Options</a></li>
@ -88,7 +88,7 @@
<li><a href="#HowToPackage">How To Package ICU</a></li>
<li>
<a href="#ImportantNotes">Important Notes About Using ICU</a>
<a href="#ImportantNotes">Important Notes About Using ICU</a>
<ul >
<li><a href="#ImportantNotesMultithreaded">Using ICU in a Multithreaded
@ -101,7 +101,7 @@
</li>
<li>
<a href="#PlatformDependencies">Platform Dependencies</a>
<a href="#PlatformDependencies">Platform Dependencies</a>
<ul >
<li><a href="#PlatformDependenciesNew">Porting To A New
@ -233,7 +233,7 @@
release?</a></h2>
<h3>API Changes</h3>
<p>See the <a href="APIChangeReport.html">API Change Report</a> for a complete
<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>
<!-- ICU 56 items -->
@ -308,7 +308,7 @@
the users' guide</a> for more information about how to build.
</p>
<h3>ICU 54: Deprecation of Collation Short Strings</h3>
<p>The collation short naming scheme and its API functions are deprecated.
<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", &amp;errorCode)</code>
for German Phonebook order with "ignore punctuation" mode.</p>
@ -816,7 +816,7 @@
<ul>
<li>Microsoft Windows</li>
<li>Microsoft Visual C++ (see the ICU download page for the currently compatible version)</li>
<li>Microsoft Visual C++ (see the ICU download page for the currently compatible version)</li>
</ul>
<p class="note"><a href="#HowToBuildCygwin">Cygwin</a> is required if using a version of MSVC other than the one
compatible with the supplied project files or if other compilers are used to build ICU. (e.g. GCC)</p>
@ -839,7 +839,7 @@
"#HowToBuildWindowsCommandLine">command line note below</a> if you want to
build from the command line instead.</li>
<li>Set the active platform to "Win32" or "x64" (See <a href="#HowToBuildWindowsPlatform">Windows platform note</a> below)
<li>Set the active platform to "Win32" or "x64" (See <a href="#HowToBuildWindowsPlatform">Windows platform note</a> below)
and configuration to "Debug" or "Release" (See <a href="#HowToBuildWindowsConfig">Windows configuration note</a> below).</li>
<li>Choose the "Build" menu and select "Rebuild Solution". If you want to
@ -863,7 +863,7 @@
<samp><i>&lt;ICU&gt;</i>\source\allinone\icucheck.bat <b>x86</b> <b>Release</b></samp>
or
<samp><i>&lt;ICU&gt;</i>\source\allinone\icucheck.bat <b>x64</b> <b>Release</b></samp></li>
</ul>
</ul>
<h4>Running the Tests from within Visual Studio</h4>
@ -902,10 +902,10 @@
use Cygwin with this compiler to build ICU, and you can refer to the <a href=
"#HowToBuildCygwin">How To Build And Install On Windows with Cygwin</a>
section for more details.</p>
<p><a name="HowToBuildWindowsPlatform" id=
"HowToBuildWindowsPlatform"><strong>Setting Active Platform
Note:</strong></a> Even though you are able to select "x64" as the active platform, if your operating system is
Note:</strong></a> Even though you are able to select "x64" as the active platform, if your operating system is
not a 64 bit version of Windows, the build will fail. To set the active platform, two different possibilities are:</p>
<ul>
@ -932,7 +932,7 @@
</ul>
<p><a name="HowToBuildWindowsBatch" id="HowToBuildWindowsBatch"><strong>Batch
Configuration Note:</strong></a> If you want to build the Win32 and x64 platforms and
Configuration Note:</strong></a> If you want to build the Win32 and x64 platforms and
Debug and Release configurations at the same time, choose "Build" menu, and select "Batch
Build...". Click the "Select All" button, and then click the "Rebuild"
button.</p>
@ -949,7 +949,7 @@
<li>Microsoft Visual C++ (when gcc isn't used).</li>
<li>
Cygwin with the following installed:
Cygwin with the following installed:
<ul>
<li>bash</li>
@ -1014,7 +1014,7 @@
"HowToWindowsConfigureICU"><strong>Configuring ICU on Windows
NOTE:</strong></a> </p>
<p>
Ensure that the order of the PATH is MSVC, Cygwin, and then other PATHs. The configure
Ensure that the order of the PATH is MSVC, Cygwin, and then other PATHs. The configure
script needs certain tools in Cygwin (e.g. grep).
</p>
<p>
@ -1106,7 +1106,7 @@
you may want to give runConfigureICU. If you are not using the
runConfigureICU script, or your platform is not supported by the script, you
may need to set your CC, CXX, CFLAGS and CXXFLAGS environment variables, and
type <tt>"./configure"</tt>.
type <tt>"./configure"</tt>.
HP-UX users, please see this <a href="#ImportantNotesHPUX">note regarding
HP-UX multithreaded build issues</a> with newer compilers. Solaris users,
please see this <a href="#ImportantNotesSolaris">note regarding Solaris
@ -1202,13 +1202,13 @@
<pre><samp>export _CXX_PSYSIX="CEE.SCEELIB(C128N)":"CBC.SCLBSID(IOSTREAM,COMPLEX)"</samp></pre>
</li>
<li>When building ICU data, the heap size may need to be increased with the following
environment variable:
<pre><samp>export _CEE_RUNOPTS="HEAPPOOLS(ON),HEAP(4M,1M,ANY,FREE,0K,4080)"</samp></pre>
</li>
<li>The rest of the instructions for building and testing ICU on z/OS with
UNIX System Services are the same as the <a href="#HowToBuildUNIX">How To
@ -1366,7 +1366,7 @@ cd ../../..</samp></pre>
<li>Build ICU. <i>(Note: Do not use the -j option)</i> <pre><samp>gmake</samp></pre></li>
<li>Test ICU. <pre><samp>gmake check</samp></pre>
<li>Test ICU. <pre><samp>gmake check</samp></pre>
(The <tt> QIBM_MULTI_THREADED=Y</tt> flag will be automatically applied to intltest -
you can look at the <a href=
"http://publib.boulder.ibm.com/infocenter/iseries/v5r3/index.jsp?topic=/apis/concept4.htm">
@ -1392,7 +1392,7 @@ cd ../../..</samp></pre>
<th align="left">/buildB</th><td>an empty directory, it will contain ICU built for B<br />(HaikuOS in this case)</td>
</tr>
</table>
<ol>
<li>Check out or unpack the ICU source code into the /icu directory.You will have the directories /icu/source, etc.</li>
<li>Build ICU in /buildA normally (using runConfigureICU or configure):
@ -1787,7 +1787,7 @@ gnumake</pre>
<strong>unicode/p<i>XXXX</i>.h</strong> (others: pwin32.h, ppalmos.h,
..): Platform-dependent typedefs and defines:<br />
<br />
<ul>
<li>Generic types like UBool, int8_t, int16_t, int32_t, int64_t,
@ -1805,7 +1805,7 @@ gnumake</pre>
<strong>unicode/putil.h, putil.c</strong>: platform-dependent
implementations of various functions that are platform dependent:<br />
<br />
<ul>
<li>uprv_isNaN, uprv_isInfinite, uprv_getNaN and uprv_getInfinity for