From 48fd5d7b288b750e80599d0c5ba31d724237c31d Mon Sep 17 00:00:00 2001
From: "Steven R. Loomis"
Date: Wed, 1 Apr 2009 01:58:16 +0000
Subject: [PATCH] ICU-6362 document cross compile. update css
X-SVN-Rev: 25705
---
icu4c/icu4c.css | 223 +++++++++++++++++++++++++++++++++++++++-------
icu4c/readme.html | 81 +++++++++++------
2 files changed, 245 insertions(+), 59 deletions(-)
diff --git a/icu4c/icu4c.css b/icu4c/icu4c.css
index b90de44d6f9..86c378ca9bd 100644
--- a/icu4c/icu4c.css
+++ b/icu4c/icu4c.css
@@ -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
+}
\ No newline at end of file
diff --git a/icu4c/readme.html b/icu4c/readme.html
index 3d4ae11cc1d..51f6f246510 100644
--- a/icu4c/readme.html
+++ b/icu4c/readme.html
@@ -12,27 +12,14 @@
-
+
-
+
International Components for Unicode
ICU 4.2 ReadMe
- Version: 2009 February 19th
+
Version: 2009 March 31th
Copyright © 1997-2009 International Business Machines Corporation and
others. All Rights Reserved.
@@ -54,7 +41,7 @@
How To Build And Install ICU
-
+
How To Package ICU
Important Notes About Using ICU
-
-
+
Here are some useful links regarding ICU and internationalization in
general.
@@ -289,8 +278,7 @@
your software product. You need at least the data ([lib]icudt
)
and the common ([lib]icuuc
) libraries in order to use ICU.
-
+
The following files describe the code drop.
@@ -317,7 +305,7 @@
-
The following directories contain source code and data files.
@@ -532,7 +520,7 @@
-
Here is a status of functionality of ICU on several different platforms.
@@ -1290,6 +1278,45 @@ CHGJOB CCSID(37)
iSeries Information Center for more details regarding the running of multiple threads
on IBM i.
+
+
+
+ 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.
+ 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).
+ 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.
+ The autoconf docs use the term "build" for A, and "host" for B. More details at: http://www.gnu.org/software/autoconf/manual/html_node/Specifying-Names.html
+ Three initially-empty directories will be used in this example:
+
+
+ /icu a copy of the ICU source
+
+
+ /buildA an empty directory, it will contain ICU built for A (MacOSX in this case)
+
+
+ /buildB an empty directory, it will contain ICU built for B (HaikuOS in this case)
+
+
+
+
+ Check out or unpack the ICU source code into the /icu directory.You will have the directories /icu/source, etc.
+ Build ICU in /buildA normally (using runConfigureICU or configure):
+cd /buildA
+sh /icu/source/runConfigureICU MacOSX
+gnumake
+
+
+ Set PATH or other variables as needed, such as CPPFLAGS.
+ Build ICU in /buildB
+ Note: "--with-cross-build
" takes an absolute path.
+cd /buildB
+sh /icu/source/configure --host=i586-pc-haiku --with-cross-build=/buildA
+gnumake
+
+ Tests and testdata can be built with "gnumake tests".
+
+
+
Here is an example of libraries that are frequently packaged.
@@ -1731,7 +1758,7 @@ CHGJOB CCSID(37)
- Copyright © 1997-2008 International Business Machines Corporation and
+
Copyright © 1997-2009 International Business Machines Corporation and
others. All Rights Reserved.
IBM Globalization Center of Competency - San José
4400 North First Street