organicmaps/icu
13
Fork 0
mirror of https://github.com/unicode-org/icu.git synced 2025-04-14 17:24:01 +00:00
Code Issues 1 Projects Releases Wiki Activity Actions 1

ICU-6362 document cross compile. update css

Browse source 
X-SVN-Rev: 25705
This commit is contained in:
Steven R. Loomis 2009-04-01 01:58:16 +00:00
parent 9bcb031af8
commit 48fd5d7b28
2 changed files with 245 additions and 59 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

223
icu4c/icu4c.css
View file

@ -1,10 +1,11 @@
/*
* Default CSS style sheet for the ICU Open Source site
* Default CSS style sheet for the ICU4C Open Source readme
* Copyright (C) 2005-2009, International Business Machines
* Corporation and others. All Rights Reserved.
*/
/* Global styles */
body,p,li,ol,ul,th,td {
font-size: 10pt;
font-family: "Arial", "Helvetica", sans-serif;
@ -25,51 +26,106 @@ body.draft {
/*
* Customize the headers to have less space around them than usual
*/
h1 {
margin-bottom: 5pt;
margin-top: 5pt;
margin-bottom: .5em;
margin-top: .5em;
padding-bottom: .5em;
padding-top: .5em;
font-weight: 700;
font-size: 20pt;
font-family: "Arial", "Helvetica", sans-serif;
font-family: Georgia, "Times New Roman", Times, serif;
border-width: 2px;
border-style: solid;
text-align: center;
width: 100%;
font-size: 200%;
font-weight: bold;
}
h2 {
margin-bottom: 0pt;
border-top: 2px solid #22d;
border-left: 2px solid #22d;
margin-bottom: 0.5em;
padding-left: 4px;
margin-top: 12pt;
font-weight: 700;
font-size: 14pt;
font-family: "Arial", "Helvetica", sans-serif;
font-size: 2em;
font-family: Georgia, "Times New Roman", Times, serif;
background-color: #eee;
page-break-before: always;
}
h2 a {
text-decoration: none;
color: black;
}
h2 a:hover {
color: blue;
text-decoration: underline;
}
h3 {
background-color: #666666;
border-top: 1px solid gray;
color: White;
margin-bottom: 0pt;
margin-top: 12pt;
padding-left: 0.75em;
font-size: 1em;
font-family: "Arial", "Helvetica", sans-serif;
padding-left: 0;
margin-left: 1em;
margin-top: 0.2em;
padding-bottom: 0.4em;
font-size: 1.5em;
font-family: Georgia, "Times New Roman", Times, serif;
}
h3 a {
text-decoration: none;
color: black;
}
h3 a:hover {
color: blue;
text-decoration: underline;
}
h4 {
margin-left: 1.5em;
margin-bottom: 0pt;
margin-top: 12pt;
font-size: 1em;
font-family: "Arial", "Helvetica", sans-serif;
font-size: 1.0em;
font-weight: bolder;
font-family: Georgia, "Times New Roman", Times, serif;
}
h4 a {
text-decoration: none;
color: black;
}
h4 a:hover {
color: blue;
text-decoration: underline;
}
h5, h6 {
margin-left: 1.8em;
margin-bottom: 0pt;
margin-top: 12pt;
padding-left: 0.75em;
font-size: x-small;
font-family: "Arial", "Helvetica", sans-serif;
font-family: Georgia, "Times New Roman", Times, serif;
}
p,pre,table,ul,ol,dl {
margin-left: 2em;
}
/*
* Navigation sidebar on the left hand of most pages
*/
td.sidebar1 {
td.sidebar1 {
background-color: #99CCFF;
font-weight: 700;
margin-top: 0px;
@ -79,7 +135,7 @@ td.sidebar1 {
white-space: nowrap;
}
td.sidebar2 {
td.sidebar2 {
background-color: #99CCFF;
margin-top: 0px;
margin-bottom: 0px;
@ -92,7 +148,8 @@ td.sidebar2 {
text-decoration: none;
display: block;
}
td.sidebar2:hover {
td.sidebar2:hover {
background-color: #EEEEFF;
padding-top: 1px;
padding-bottom: 1px;
@ -105,26 +162,31 @@ a.sidebar2 {
display: block;
width: 100%;
}
a.sidebar2:link {
color: #000099;
display: block;
}
a.sidebar2:hover {
background-color: #EEEEFF;
display: block;
}
.underlinehover:hover {
background-color: #EEEEFF;
text-decoration: underline;
}
/* This is the faded header at the top */
td.fadedtop {
background-color: #006699;
background-image: url(http://www.icu-project.org/images/gr100.gif);
}
/* Related site on the left */
p.relatedsite {
color: White;
font-weight: 700;
@ -136,45 +198,55 @@ p.relatedsite {
}
/* Related site on the left */
p.sidebar3 {
margin-top: 0.75em;
margin-bottom: 0;
padding-left: 0.8em;
}
a.sidebar3 {
font-size: 0.9em;
text-decoration: none;
}
a.sidebar3:link {
text-decoration: none;
color: White;
}
a.sidebar3:hover {
text-decoration: underline;
}
/* FAQ */
li.faq_contents {
font-weight: 500;
}
p.faq_q {
font-weight: 700;
font-weight: 700;
margin-bottom: 0px;
}
p.faq_a {
margin-top: 0px;
}
/* News items */
table.newsItem {
padding-left: 1em;
padding-right: 1em;
border-width: medium;
}
th.newsItem {
background-color: #666666;
color: White;
}
td.newsItem {
background-color: #CCCCCC;
}
@ -183,13 +255,15 @@ td.release-line,th.release-line {
padding-left: 0.5em;
padding-right: 0.5em;
white-space: nowrap;
border:1px;
border: 1px;
}
.note {
font-style: italic;
font-size: small;
margin-left: 1em;
}
samp {
margin-left: 1em;
margin-right: 2em;
@ -198,6 +272,7 @@ samp {
display: block;
background-color: #EEEEEE
}
table.rtable caption {
margin-left: 2px;
margin-right: 2px;
@ -206,18 +281,21 @@ table.rtable caption {
background-color: #dee2ff;
text-align: left;
}
table.rtable tr th {
background-color: #dee2ff;
text-align: left;
}
table.rtable tr td {
background-color: #c0c0fd;
padding: 3px;
}
/* APIChangeReport specific things */
.row0 {
background-color: white;
background-color: white;
}
.row1 {
@ -225,39 +303,41 @@ table.rtable tr td {
}
.verchange {
color: red;
color: red;
font-weight: bold;
font-size: large;
font-size: large;
}
.stabchange {
color: red;
font-size: large;
color: red;
font-size: large;
}
.bigwarn {
color: red;
background-color: white;
font-size: x-large;
margin: 0.5 em;
font-size: x-large;
margin: 0.5 em;
}
table.genTable {
border-collapse: collapse;
border: 1px solid black;
border: 1px solid black;
}
/* 'everything inc version */
table.gentable td {
border: 1px solid gray;
padding: 0.25em;
font-size: small;
border: 1px solid gray;
padding: 0.25em;
font-size: small;
}
/* not version */
table.genTable td.file,
table.genTable td.proto {
border: none;
border: none;
font-size: medium;
}
@ -267,9 +347,88 @@ table.genTable td.file {
}
div.other .row0 {
background-color: white;
background-color: white;
}
div.other .row1 {
background-color: #ddf;
}
table.docTable {
border-collapse: collapse;
border: 1px solid black;
}
/* 'everything inc version */
table.docTable td,
table.docTable th {
border: 1px solid gray;
padding: 0.25em;
font-size: small;
}
/* not version */
table.docTable td.file,
table.docTable td.proto {
border: none;
font-size: medium;
}
table.docTable td.file {
font-family: monospace;
font-weight: bold;
}
abbr {
border-bottom: 1px dashed #0B0;
}
h2.TOC {
page-break-before: auto;
}
body.readme {
}
caption {
font-weight: bold;
text-align: left
}
div.indent {
margin-left: 2em
}
ul.TOC {
list-style-type: none;
padding-left: 1em;
font-size: larger;
}
ul.TOC li a {
font-weight: bold;
}
ul.TOC li ul li a {
font-weight: normal;
list-style-type: none;
font-size: small;
}
ul.TOC li ul {
margin-left: 0;
padding-left: 2em;
font-weight: normal;
list-style-type: none;
}
pre.samp,samp {
margin-left: 1em;
border-style: groove;
padding: 1em;
display: block;
background-color: #EEEEEE
}

81
icu4c/readme.html
View file

@ -12,27 +12,14 @@
<meta name="DESCRIPTION" content=
"The introduction to the International Components for Unicode with instructions on building, installation, usage and other information about ICU." />
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<style type="text/css">
/*<![CDATA[*/
h1 {border-width: 2px; border-style: solid; text-align: center; width: 100%; font-size: 200%; font-weight: bold}
h2 {margin-top: 2em; text-decoration: underline; page-break-before: always}
h2.TOC {page-break-before: auto}
h3 {margin-top: 2em; text-decoration: underline}
h4 {text-decoration: underline}
h5 {text-decoration: underline}
caption {font-weight: bold; text-align: left}
div.indent {margin-left: 2em}
ul.TOC {list-style-type: none}
samp {margin-left: 1em; border-style: groove; padding: 1em; display: block; background-color: #EEEEEE}
/*]]>*/
</style>
<link type="text/css" href="./icu4c.css" rel="stylesheet"/>
</head>
<body>
<body class="readme">
<h1>International Components for Unicode<br />
<abbr title="International Components for Unicode">ICU</abbr> 4.2 ReadMe</h1>
<p>Version: 2009 February 19th<br />
<p>Version: 2009 March 31th<br />
Copyright &copy; 1997-2009 International Business Machines Corporation and
others. All Rights Reserved.</p>
<!-- Remember that there is a copyright at the end too -->
@ -54,7 +41,7 @@
<li>
<a href="#HowToBuild">How To Build And Install ICU</a>
<ul class="TOC">
<ul >
<li><a href="#HowToBuildSupported">Supported Platforms</a></li>
<li><a href="#HowToBuildWindows">Windows</a></li>
@ -66,15 +53,18 @@
<li><a href="#HowToBuildZOS">z/OS (os/390)</a></li>
<li><a href="#HowToBuildOS400">IBM i family (IBM i, i5/OS, OS/400)</a></li>
<li><a href="#HowToCrossCompileICU">How to Cross Compile ICU</a></li>
</ul>
</li>
<li><a href="#HowToPackage">How To Package ICU</a></li>
<li>
<a href="#ImportantNotes">Important Notes About Using ICU</a>
<ul class="TOC">
<ul >
<li><a href="#ImportantNotesMultithreaded">Using ICU in a Multithreaded
Environment</a></li>
@ -87,7 +77,7 @@
<li>
<a href="#PlatformDependencies">Platform Dependencies</a>
<ul class="TOC">
<ul >
<li><a href="#PlatformDependenciesNew">Porting To A New
Platform</a></li>
@ -148,8 +138,7 @@
The ICU homepage also links to related information about writing
internationalized software.</p>
<table border="1" cellpadding="3" width="100%" summary=
"These are some useful links regarding ICU and internationalization in general.">
<table class="docTable" summary="These are some useful links regarding ICU and internationalization in general.">
<caption>
Here are some useful links regarding ICU and internationalization in
general.
@ -289,8 +278,7 @@
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>
<table border="1" cellpadding="0" width="100%" summary=
"The following files describe the code drop.">
<table class="docTable" summary="The following files describe the code drop.">
<caption>
The following files describe the code drop.
</caption>
@ -317,7 +305,7 @@
<p><br />
</p>
<table border="1" cellpadding="0" width="100%" summary=
<table class="docTable" summary=
"The following directories contain source code and data files.">
<caption>
The following directories contain source code and data files.
@ -532,7 +520,7 @@
<h3><a name="HowToBuildSupported" href="#HowToBuildSupported" id=
"HowToBuildSupported">Supported Platforms</a></h3>
<table border="1" cellpadding="3" summary=
<table class="docTable" summary=
"ICU can be built on many platforms.">
<caption>
Here is a status of functionality of ICU on several different platforms.
@ -1290,6 +1278,45 @@ CHGJOB CCSID(37)</samp>
iSeries Information Center</a> for more details regarding the running of multiple threads
on IBM i.</li>
</ol>
<!-- cross -->
<h3><a name="HowToCrossCompileICU" href="#HowToCrossCompileICU" id="HowToCrossCompileICU">How To Cross Compile ICU</a></h3>
<p>This section will explain how to build ICU on one platform, but to produce binaries intended to run on another. This is commonly known as a cross compile.</p>
<p>Normally, in the course of a build, ICU needs to run the tools that it builds in order to generate and package data and test-data.In a cross compilation setting, ICU is built on a different system from that which it eventually runs on. An example might be, if you are building for a small/headless system (such as an embedded device), or a system where you can't easily run the ICU command line tools (any non-UNIX-like system).</p>
<p>To reduce confusion, we will here refer to the "A" and the "B" system.System "A" is the actual system we will be running on- the only requirements on it is are it is able to build ICU from the command line targetting itself (with configure or runConfigureICU), and secondly, that it also contain the correct toolchain for compiling and linking for the resultant platform, referred to as the "B" system.</p>
<p>The autoconf docs use the term "build" for A, and "host" for B. More details at: <a href="http://www.gnu.org/software/autoconf/manual/html_node/Specifying-Names.html#Specifying-Names">http://www.gnu.org/software/autoconf/manual/html_node/Specifying-Names.html</a></p>
<p>Three initially-empty directories will be used in this example:</p>
<table summary="Three directories used in this example" class="docTable">
<tr>
<th align=left>/icu</th><td>a copy of the ICU source</td>
</tr>
<tr>
<th align=left>/buildA</th><td>an empty directory, it will contain ICU built for A<br>(MacOSX in this case)</td>
</tr>
<tr>
<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):
<pre class="samp">cd /buildA
sh /icu/source/runConfigureICU <strong>MacOSX</strong>
gnumake
</pre>
</li>
<li>Set PATH or other variables as needed, such as CPPFLAGS.</li>
<li>Build ICU in /buildB<br>
<div class="note"><b>Note:</b> "<code>--with-cross-build</code>" takes an absolute path.</div>
<pre class="samp">cd /buildB
sh /icu/source/configure --host=<strong>i586-pc-haiku</strong> --with-cross-build=<strong>/buildA</strong>
gnumake</pre>
</li>
<li>Tests and testdata can be built with "gnumake tests".</li>
</ol>
<!-- end cross -->
<!-- end build environment -->
<h2><a name="HowToPackage" href="#HowToPackage" id="HowToPackage">How To
@ -1326,7 +1353,7 @@ CHGJOB CCSID(37)</samp>
"#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=
<table class="docTable" summary=
"ICU has several libraries for you to use.">
<caption>
Here is an example of libraries that are frequently packaged.
@ -1731,7 +1758,7 @@ CHGJOB CCSID(37)</samp>
</ul>
<hr />
<p>Copyright &copy; 1997-2008 International Business Machines Corporation and
<p>Copyright &copy; 1997-2009 International Business Machines Corporation and
others. All Rights Reserved.<br />
IBM Globalization Center of Competency - San Jos&eacute;<br />
4400 North First Street<br />