diff options
| author | Lorry Tar Creator <lorry-tar-importer@baserock.org> | 2013-10-04 21:09:55 +0000 |
|---|---|---|
| committer | <> | 2014-04-14 10:39:20 +0000 |
| commit | e2bd11ca1374cccfa50b7d27507ba9fe581be76a (patch) | |
| tree | 62f5853a0f4760b506d28ee1f107a8b2b8252f66 /readme.html | |
| parent | 759b3e7cadc76a716799cacd892dc499198656d2 (diff) | |
| download | icu-master.tar.gz | |
Imported from /home/lorry/working-area/delta_icu/icu4c-52_1-src.tgz.HEADicu4c-52_1-srcmaster
Diffstat (limited to 'readme.html')
| -rw-r--r-- | readme.html | 120 |
1 files changed, 74 insertions, 46 deletions
diff --git a/readme.html b/readme.html index a9d9c4a..d134720 100644 --- a/readme.html +++ b/readme.html @@ -3,7 +3,7 @@ <html lang="en-US" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US"> <head> - <title>ReadMe for ICU 51</title> + <title>ReadMe for ICU 52</title> <meta name="COPYRIGHT" content= "Copyright (c) 1997-2013 IBM Corporation and others. All Rights Reserved." /> <meta name="KEYWORDS" content= @@ -14,9 +14,9 @@ <link type="text/css" href="./icu4c.css" rel="stylesheet"/> </head> - <body class="draft"> + <body> <h1>International Components for Unicode<br /> - <abbr title="International Components for Unicode">ICU</abbr> 51 (Release Candidate) ReadMe</h1> + <abbr title="International Components for Unicode">ICU</abbr> 52 ReadMe</h1> <!--<p><b>Note:</b> This is a development milestone release of ICU4C 52. This milestone is intended for those wishing to get an early look at ICU 52 new features and API changes. @@ -24,7 +24,7 @@ <!--<p><b>Note:</b> This is a release candidate version of ICU4C 52. It is not recommended for production use.</p>--> - <p>Last updated: 2013-Mar-15<br /> + <p>Last updated: 2013-Sep-30<br /> Copyright © 1997-2013 International Business Machines Corporation and others. All Rights Reserved.</p> <!-- Remember that there is a copyright at the end too --> @@ -44,7 +44,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> @@ -69,7 +69,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 @@ -82,7 +82,7 @@ </li> <li> - <a href="#PlatformDependencies">Platform Dependencies</a> + <a href="#PlatformDependencies">Platform Dependencies</a> <ul > <li><a href="#PlatformDependenciesNew">Porting To A New @@ -215,15 +215,32 @@ <p>To see which APIs are new or changed in this release, view the <a href="APIChangeReport.html">ICU4C API Change Report</a>. </p> + <!-- ICU 52 items --> + <h3>DecimalFormat - two functions marked as const</h3> + <p> + <tt>DecimalFormat::isScientificNotation</tt> and <tt>DecimalFormat::isExponentSignAlwaysShown</tt> + are now const member functions. DecimalFormat is not recommended for subclassing. + </p> + + <h3>CollationElementIterator protected methods became private</h3> + <p>The C++ CollationElementIterator (CEI) had two protected constructors + (called only by RuleBasedCollator CEI factory methods) + and a protected assignment operator. + The class documentation says "CollationElementIterator should not be subclassed", + and it cannot be subclassed effectively. + The protected methods were made private and might be removed altogether. + For details see <a href="http://bugs.icu-project.org/trac/ticket/10251">ticket #10251</a>.</p> + <!-- end ICU 52 items --> + <p>The following list concentrates on <em>changes that affect existing applications migrating from previous ICU releases</em>. For more news about this release, see the - <!-- - <a href="http://site.icu-project.org/download/">ICU download page</a>. - --> - <a href="http://site.icu-project.org/download/milestone">ICU milestone download page</a>. - </p> - + + <a href="http://site.icu-project.org/download/52">ICU download page</a>. + +<!-- <a href="http://site.icu-project.org/download/milestone">ICU milestone download page</a>. + </p>--> + <h3>C++ BasicTimeZone subclassing-API breaking changes</h3> <p>We have made make some changes to the C++ BasicTimeZone(basictz.h) for ICU 51 that will make it easier to use some time zone support features found in BasicTimeZone @@ -248,7 +265,7 @@ a time zone abbreviation even it is not commonly used for a locale. For example, time zone abbreviation "AEST" for Australian Eastern Standard Time might not be well recognized by people in the United States. For the zone, pattern "z" does not use "AEST" (instead, use - UTC offset format "GMT+10:00, as the fallback) , while pattern "V" used to print out "AEST". + UTC offset format "GMT+10:00", as the fallback) , while pattern "V" used to print out "AEST". In CLDR 21, the data used for checking commonly used or not was completely removed (CLDR ticket <a href="http://unicode.org/cldr/trac/ticket/4052">#4052</a>), so the difference between pattern "z" and "V" is no longer available since ICU 49 (based on CLDR 21 specification).</p> @@ -758,7 +775,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 @@ -785,7 +802,7 @@ <br/> or <br /> <tt><i><ICU></i>\source\allinone\icucheck.bat <b>x64</b> <b>Release</b> </tt></li> - </ul> + </ul> <h4>Running the Tests from within Visual Studio</h4> @@ -824,10 +841,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> @@ -854,7 +871,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> @@ -871,7 +888,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> @@ -936,7 +953,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> @@ -1028,7 +1045,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 @@ -1124,7 +1141,7 @@ <pre><samp>export _CXX_PSYSIX="CEE.SCEELIB(C128N)":"CBC.SCLBSID(IOSTREAM,COMPLEX)"</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 @@ -1235,47 +1252,59 @@ Data set name type : PDS</samp> <ol> <li> + Copy the ICU source .tgz to the IBM i environment, as binary. + Also, copy the <a href='as_is/os400/unpax-icu.sh'>unpax-icu.sh</a> script into the same directory, as a text file. + </li> + + <li> Create target library. This library will be the target for the resulting modules, programs and service programs. You will specify this library on the OUTPUTDIR environment variable. <pre> <samp>CRTLIB LIB(<i>libraryname</i>) -ADDENVVAR ENVVAR(OUTPUTDIR) VALUE('<i>libraryname</i>') REPLACE(*YES) </samp> -</pre> +ADDENVVAR ENVVAR(OUTPUTDIR) VALUE('<i>libraryname</i>') REPLACE(*YES) </samp></pre> </li> <li> Set up the following environment variables and job characteristics in your build process <pre> <samp>ADDENVVAR ENVVAR(MAKE) VALUE('gmake') REPLACE(*YES) -CHGJOB CCSID(37)</samp> -</pre></li> +CHGJOB CCSID(37)</samp></pre></li> - <li>Run <tt>'QSH'</tt></li> - - <li>Run: <br /><tt>export PATH=/QIBM/ProdData/DeveloperTools/qsh/bin:$PATH:/QOpenSys/usr/bin</tt> + <li>Fire up the QSH (all subsequent commands are run inside the qsh session.)</i> + <pre><samp>qsh</samp></pre> </li> - <li>Run <b><tt>gzip -d</tt></b> on the ICU source code compressed tar archive - (icu-<i>X</i>.<i>Y</i>.tgz).</li> + <li>Set up the PATH: <pre><samp>export PATH=/QIBM/ProdData/DeveloperTools/qsh/bin:$PATH:/QOpenSys/usr/bin</samp></pre> + </li> - <li>Run <a href='as_is/os400/unpax-icu.sh'>unpax-icu.sh</a> on the tar file generated from the previous step.</li> + <li>Unpack the ICU source code archive: + <pre><samp>gzip -d icu-<i>X</i>.<i>Y</i>.tgz</samp></pre> + </li> - <li>Change your current directory to icu/as_is/os400.</li> - <li>Run <tt>qsh bldiculd.sh</tt> to build the program ICULD which ICU will use for linkage.</li> + <li>Run unpax-icu.sh on the tar file generated from the previous step. + <pre><samp>unpax-icu.sh icu.tar</samp></pre></li> - <li>Change your current directory to icu/source.</li> + <li>Build the program ICULD which ICU will use for linkage. + <pre><samp>cd icu/as_is/os400 +qsh bldiculd.sh +cd ../../..</pre></samp> + </li> - <li>Run <tt>'./runConfigureICU IBMi'</tt> (See <a href="#HowToConfigureICU">configuration - note</a> for details). Note that --with-data-packaging=archive and setting the --prefix are recommended, building in default (dll) mode is currently not supported.</li> + <li>Change into the 'source' directory, and configure ICU. (See <a href="#HowToConfigureICU">configuration + note</a> for details). Note that --with-data-packaging=archive and setting the --prefix are recommended, building in default (dll) mode is currently not supported. + <pre><samp>cd icu/source +./runConfigureICU IBMi --prefix=<i>/path/to/somewhere</i> --with-data-packaging=archive</samp></pre> +</li> - <li>Run <tt>'gmake'</tt> to build ICU. (Do not use the -j option)</li> + <li>Build ICU. <i>(Note: Do not use the -j option)</i> <pre><samp>gmake</samp></pre></li> - <li>Run <tt>'gmake check QIBM_MULTI_THREADED=Y'</tt> to build and run the tests. - You can look at the <a href= + <li>Test ICU. <pre><samp>gmake check</samp></pre> + <smaller>(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"> iSeries Information Center</a> for more details regarding the running of multiple threads - on IBM i.</li> + on IBM i.)</smaller></li> </ol> <!-- cross --> @@ -1296,7 +1325,7 @@ CHGJOB CCSID(37)</samp> <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): @@ -1691,7 +1720,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, @@ -1709,7 +1738,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 @@ -1759,4 +1788,3 @@ gnumake</pre> USA</p> </body> </html> - |