AuroraMiddleware/scuffed-code
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

ICU-4412 Bye bye oss.software.ibm.com. Your pages have been sent to other various web sites.

Browse Source 
X-SVN-Rev: 17219
This commit is contained in:
George Rhoten 2005-02-17 22:55:11 +00:00
parent 1ab6191f2c
commit 8651474793
1 changed files with 58 additions and 51 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

109
icu4c/readme.html
View File

@ -29,8 +29,8 @@
<abbr title="International Components for Unicode">ICU</abbr> 3.2
ReadMe</h1>
<p>Version: 2004-Nov-30<br>
Copyright &copy; 1997-2004 International Business Machines Corporation and
<p>Version: 2005-Feb-17<br>
Copyright &copy; 1997-2005 International Business Machines Corporation and
others. All Rights Reserved.</p>
<!-- Remember that there is a copyright at the end too -->
<hr>
@ -138,10 +138,9 @@
boundaries</li>
</ul>
<p>ICU has a sister project <a href=
"http://oss.software.ibm.com/icu4j/index.html">ICU4J</a> that extends the
internationalization capabilities of Java to a level similar to ICU. The
ICU C/C++ project is also called ICU4C when a distinction is necessary.</p>
<p>ICU has a sister project ICU4J that extends the internationalization
capabilities of Java to a level similar to ICU. The ICU C/C++ project is
also called ICU4C when a distinction is necessary.</p>
<h2><a name="GettingStarted" href="#GettingStarted" id=
"GettingStarted">Getting started</a></h2>
@ -160,59 +159,59 @@
</caption>
<tr>
<td>ICU Homepage</td>
<td>ICU, ICU4C, ICU4J &amp; ICU4JNI Official Homepage</td>
<td><a href=
"http://oss.software.ibm.com/icu/index.html">http://oss.software.ibm.com/icu/index.html</a></td>
"http://www.ibm.com/software/globalization/icu/index.jsp">http://www.ibm.com/software/globalization/icu/index.jsp</a></td>
</tr>
<tr>
<td>ICU4J Homepage</td>
<td>ICU, ICU4C, ICU4J &amp; ICU4JNI Unofficial Homepage</td>
<td><a href=
"http://oss.software.ibm.com/icu4j/index.html">http://oss.software.ibm.com/icu4j/index.html</a></td>
"http://icu.sourceforge.net/">http://icu.sourceforge.net/</a></td>
</tr>
<tr>
<td>FAQ - Frequently Asked Questions about ICU</td>
<td><a href=
"http://oss.software.ibm.com/icu/userguide/icufaq.html">http://oss.software.ibm.com/icu/userguide/icufaq.html</a></td>
"http://icu.sourceforge.net/userguide/icufaq.html">http://icu.sourceforge.net/userguide/icufaq.html</a></td>
</tr>
<tr>
<td>ICU User's Guide</td>
<td><a href=
"http://oss.software.ibm.com/icu/userguide/index.html">http://oss.software.ibm.com/icu/userguide/index.html</a></td>
"http://icu.sourceforge.net/userguide/">http://icu.sourceforge.net/userguide/</a></td>
</tr>
<tr>
<td>Download ICU Releases</td>
<td><a href=
"http://oss.software.ibm.com/icu/download/index.html">http://oss.software.ibm.com/icu/download/index.html</a></td>
"http://www.ibm.com/software/globalization/icu/downloads.jsp">http://www.ibm.com/software/globalization/icu/downloads.jsp</a></td>
</tr>
<tr>
<td>API Documentation Online</td>
<td><a href=
"http://oss.software.ibm.com/icu/apiref/index.html">http://oss.software.ibm.com/icu/apiref/index.html</a></td>
"http://icu.sourceforge.net/apiref/index.html">http://icu.sourceforge.net/apiref/index.html</a></td>
</tr>
<tr>
<td>Online ICU Demos</td>
<td><a href=
"http://oss.software.ibm.com/icu/demo/index.html">http://oss.software.ibm.com/icu/demo/index.html</a></td>
"http://www.ibm.com/software/globalization/icu/chartsdemostools.jsp">http://www.ibm.com/software/globalization/icu/chartsdemostools.jsp</a></td>
</tr>
<tr>
<td>Contacts and Bug Reports/Feature Requests</td>
<td><a href=
"http://oss.software.ibm.com/icu/archives/index.html">http://oss.software.ibm.com/icu/archives/index.html</a></td>
"http://icu.sourceforge.net/contacts.html">http://icu.sourceforge.net/contacts.html</a></td>
</tr>
</table>
@ -255,7 +254,7 @@
versions are tested more thoroughly than day-to-day development builds of
the system, and they are packaged in zip and tar files for convenient
download. These packaged files can be found at <a href=
"http://oss.software.ibm.com/icu/download/index.html">http://oss.software.ibm.com/icu/download/index.html</a>.<br>
"http://www.ibm.com/software/globalization/icu/downloads.jsp">http://www.ibm.com/software/globalization/icu/downloads.jsp</a>.<br>
The packaged snapshots are named <strong>icu-nnnn.zip</strong> or
<strong>icu-nnnn.tgz</strong>, where nnnn is the version number. The .zip
@ -269,8 +268,9 @@
ICU, you should probably be working with the latest version of the ICU
source code. You will need to check the code out of our CVS repository to
ensure that you have the most recent version of all of the files. See our
<a href="http://oss.software.ibm.com/icu/develop/cvs.html">CVS page</a>
for details.</li>
<a href=
"http://www.ibm.com/software/globalization/icu/repository.jsp">CVS
page</a> for details.</li>
</ul>
<h2><a name="SourceCode" href="#SourceCode" id="SourceCode">ICU Source Code
@ -279,7 +279,7 @@
<p>In the descriptions below, <strong><i>&lt;ICU&gt;</i></strong> is the
full path name of the ICU directory (the top level directory from the
distribution archives) in your file system. You can also view the <a href=
"http://oss.software.ibm.com/icu/userguide/design.html">ICU Architectural
"http://icu.sourceforge.net/userguide/design.html">ICU Architectural
Design</a> section of the User's Guide to see which libraries you need for
your software product. You need at least the data (<code>[lib]icudt</code>)
and the common (<code>[lib]icuuc</code>) libraries in order to use ICU.</p>
@ -397,7 +397,7 @@
environment variable to the out/ or the out/build/ directories, but
this is generally discouraged because most people set it incorrectly.
You can view the <a href=
"http://oss.software.ibm.com/icu/userguide/icudata.html">ICU Data
"http://icu.sourceforge.net/userguide/icudata.html">ICU Data
Management</a> section of the ICU User's Guide for details.</p>
</td>
</tr>
@ -823,8 +823,8 @@
file in Microsoft Visual Studio .NET 2003. (This solution includes all
the International Components for Unicode libraries, necessary ICU
building tools, and the test suite projects). Please see the <a href=
"HowToBuildWindowsCommandLine">command line note below</a> if you want to
build from the command line instead.</li>
"#HowToBuildWindowsCommandLine">command line note below</a> if you want
to build from the command line instead.</li>
<li>Set the active configuration to "Debug" or "Release" (See <a href=
"#HowToBuildWindowsConfig">Windows configuration note</a> below).</li>
@ -1106,7 +1106,8 @@
the current location). HP-UX user's, please see this <a href=
"#ImportantNotesHPUX">note regarding HP-UX multithreaded build issues</a>
with newer compilers. Solaris user's, please see this <a href=
"#ImportantNotesSolaris">note regarding Solaris multithreaded build issues</a>.</p>
"#ImportantNotesSolaris">note regarding Solaris multithreaded build
issues</a>.</p>
<p><a name="HowToTestWithoutGmake" id=
"HowToTestWithoutGmake"><strong>Running The Tests From The Command Line
@ -1313,7 +1314,8 @@ Data set name type : PDS</samp>
</pre>
<h3><a name="HowToBuildOS400" href="#HowToBuildOS400" id=
"HowToBuildOS400">How To Build And Install On i5/OS (OS/400 iSeries)</a></h3>
"HowToBuildOS400">How To Build And Install On i5/OS (OS/400
iSeries)</a></h3>
<p>Before you start building ICU, ICU requires the following:</p>
@ -1427,9 +1429,9 @@ ADDENVVAR ENVVAR(OUTPUTDIR) VALUE('<i>libraryname</i>')</samp>
need. On operating systems that do not have a standard C++ ABI (name
mangling) for compilers, it is recommended to do this special packaging
anyway. More details on customizing ICU are available in the <a href=
"http://oss.software.ibm.com/icu/userguide/index.html">User's Guide</a>.
The <a href="#SourceCode">ICU Source Code Organization</a> section of this
readme.html gives a more complete description of the libraries.</p>
"http://icu.sourceforge.net/userguide/">User's Guide</a>. The <a href=
"#SourceCode">ICU Source Code Organization</a> section of this readme.html
gives a more complete description of the libraries.</p>
<table border="1" cellpadding="3" summary=
"ICU has several libraries for you to use.">
@ -1456,7 +1458,7 @@ ADDENVVAR ENVVAR(OUTPUTDIR) VALUE('<i>libraryname</i>')</samp>
<td>Data required by the Common and I18n libraries. There are many ways
to package and <a href=
"http://oss.software.ibm.com/icu/userguide/icudata.html">customize this
"http://icu.sourceforge.net/userguide/icudata.html">customize this
data</a>, but by default this is all you need.</td>
</tr>
@ -1589,15 +1591,17 @@ ADDENVVAR ENVVAR(OUTPUTDIR) VALUE('<i>libraryname</i>')</samp>
<h5>Solaris Deadlock Issues in Solaris 8 (2.8) and Earlier</h5>
<p>Solaris 8, and earlier, has outstanding thread deadlocking issues that
<strong>may</strong> be problematic for applications using either native, or POSIX,
threading on these platforms. Sun states that Solaris 9 <strong>does not</strong> have the
deadlock problems. Deadlocks <strong>may</strong> occur either during initialization of the
Solaris threading library, or at any other time.</p>
<strong>may</strong> be problematic for applications using either native,
or POSIX, threading on these platforms. Sun states that Solaris 9
<strong>does not</strong> have the deadlock problems. Deadlocks
<strong>may</strong> occur either during initialization of the Solaris
threading library, or at any other time.</p>
<p>Sun Microsystems has provided a Sun Alert Notification regarding the
issue. Users <strong>should</strong> consider applying the latest OS patches to their
Solaris installations in order to help avoid deadlock. Further information
regarding the issue, and links to applicable patches, may be found at:</p>
issue. Users <strong>should</strong> consider applying the latest OS
patches to their Solaris installations in order to help avoid deadlock.
Further information regarding the issue, and links to applicable patches,
may be found at:</p>
<p>[1] "<i>Applications Linked to libthread May Hang</i>", Sun Alert
Notification, Sun Microsystems, Inc., 04-Sep-2002<br>
@ -1605,23 +1609,25 @@ ADDENVVAR ENVVAR(OUTPUTDIR) VALUE('<i>libraryname</i>')</samp>
"http://sunsolve.sun.com/pub-cgi/retrieve.pl?doc=fsalert%2F46867&amp;zone_32=4663077">
http://sunsolve.sun.com/pub-cgi/retrieve.pl?doc=fsalert%2F46867&amp;zone_32=4663077</a></p>
<p>Sun is <strong>not</strong> providing patches for Solaris 6 (2.6), or earlier.</p>
<p>Sun is <strong>not</strong> providing patches for Solaris 6 (2.6), or
earlier.</p>
<p>Sun states that by applying the patch users will avoid the deadlock
issues. However, with all applicable patches applied, deadlock <strong>may</strong> still be
seen, as demonstrated by the ICU Mutex unit tests. The unit test will hang
indefinitely. No bug exists in ICU. However, a latent bug still exists in
Solaris, which Sun Microsystems has yet to resolve. In order to avoid this,
users are <strong>suggested</strong> to modify their LD_LIBRARY_PATH according to the
guidelines specified by Sun Microsystems in the Sun Alert Notification.</p>
issues. However, with all applicable patches applied, deadlock
<strong>may</strong> still be seen, as demonstrated by the ICU Mutex unit
tests. The unit test will hang indefinitely. No bug exists in ICU. However,
a latent bug still exists in Solaris, which Sun Microsystems has yet to
resolve. In order to avoid this, users are <strong>suggested</strong> to
modify their LD_LIBRARY_PATH according to the guidelines specified by Sun
Microsystems in the Sun Alert Notification.</p>
<h5>Linking on Solaris</h5>
<p>In order to avoid synchronization and threading issues, developers are
<strong>suggested</strong> to strictly follow the compiling and linking guidelines for
multithreaded applications, specified in the following document from Sun
Microsystems. Most notably, pay strict attention to the following
statements from Sun:</p>
<strong>suggested</strong> to strictly follow the compiling and linking
guidelines for multithreaded applications, specified in the following
document from Sun Microsystems. Most notably, pay strict attention to the
following statements from Sun:</p>
<blockquote>
<p>To use libthread, specify -lthread before -lc on the ld command line,
@ -1719,7 +1725,7 @@ ADDENVVAR ENVVAR(OUTPUTDIR) VALUE('<i>libraryname</i>')</samp>
<p>If you are using ICU's Makefiles to build ICU on a new platform, there
are a few places where you will need to add or modify some files. If you
need more help, you can always ask the <a href=
"http://oss.software.ibm.com/icu/archives/">icu4c-support mailing list</a>.
"http://icu.sourceforge.net/contacts.html">icu4c-support mailing list</a>.
Once you have finished porting ICU to a new platform, it is recommended
that you contribute your changes back to ICU via the icu4c-support mailing
list. This will make it easier for everyone to benefit from your work.</p>
@ -1735,7 +1741,7 @@ ADDENVVAR ENVVAR(OUTPUTDIR) VALUE('<i>libraryname</i>')</samp>
share the same endianness and the same charset family. This assertion does
not include platform dependent DLLs/shared/static libraries. For details
see the User Guide <a href=
"http://oss.software.ibm.com/icu/userguide/icudata.html">ICU Data</a>
"http://icu.sourceforge.net/userguide/icudata.html">ICU Data</a>
chapter.</p>
<p>ICU 2.8 removes the requirement that ICU be completely built in the
@ -1799,7 +1805,8 @@ ADDENVVAR ENVVAR(OUTPUTDIR) VALUE('<i>libraryname</i>')</samp>
<ul>
<li>XP_CPLUSPLUS for C++ only.</li>
<li>Generic types like UBool, int8_t, int16_t, int32_t, int64_t, uint64_t etc.</li>
<li>Generic types like UBool, int8_t, int16_t, int32_t, int64_t,
uint64_t etc.</li>
<li>U_EXPORT and U_IMPORT for specifying dynamic library import and
export</li>
@ -1919,7 +1926,7 @@ ADDENVVAR ENVVAR(OUTPUTDIR) VALUE('<i>libraryname</i>')</samp>
</ol>
<hr>
<p>Copyright &copy; 1997-2004 International Business Machines Corporation
<p>Copyright &copy; 1997-2005 International Business Machines Corporation
and others. All Rights Reserved.<br>
IBM Globalization Center of Competency - San Jos&eacute;<br>
5600 Cottle Road<br>