From: Steven R. Loomis Date: Tue, 1 Jul 2014 20:51:25 +0000 (+0000) Subject: ICU-10842 readme updates for 54m1. CSS updates. X-Git-Tag: milestone-59-0-1~1812 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9ecbb465f2bef06431ea50333f561f4519be730c;p=icu ICU-10842 readme updates for 54m1. CSS updates. X-SVN-Rev: 35979 --- diff --git a/icu4c/icu4c.css b/icu4c/icu4c.css index b43f5facaf5..58fe1f3a44f 100644 --- a/icu4c/icu4c.css +++ b/icu4c/icu4c.css @@ -1,6 +1,6 @@ /* * Default CSS style sheet for the ICU4C Open Source readme - * Copyright (C) 2005-2011, International Business Machines + * Copyright (C) 2005-2014, International Business Machines * Corporation and others. All Rights Reserved. */ @@ -8,7 +8,7 @@ body,p,li,ol,ul,th,td { font-size: 1em; - font-family: "Arial", "Helvetica", sans-serif; + font-family: "Helvetica Neue", Arial, Helvetica, Geneva, sans-serif; } body { @@ -19,10 +19,33 @@ body.draft { background-image: url(images/draftbg.png); } +body .only-milestone, +body .only-draft, +body .only-rc { + display: none; +} + +body.milestone .only-milestone { + display: inherit !important; +} + +body.draft .only-draft { + display: inherit !important; +} + +body.rc .only-rc { + display: inherit !important; +} + + .mainbody { padding: 1em; } + +h1,h2,h3,h4,h5 { + font-family: Georgia, "Times New Roman", Times, serif; +} /* * Customize the headers to have less space around them than usual */ @@ -34,25 +57,17 @@ h1 { padding-top: .5em; font-weight: 700; font-size: 20pt; - font-family: Georgia, "Times New Roman", Times, serif; - border-width: 2px; - border-style: solid; text-align: center; - width: 100%; - font-size: 200%; + font-size: 2em; font-weight: bold; } h2 { - 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: 2em; - font-family: Georgia, "Times New Roman", Times, serif; - background-color: #eee; page-break-before: always; } @@ -67,16 +82,12 @@ h2 a:hover { } h3 { - border-top: 1px solid gray; - color: #1e1c46; margin-bottom: 0pt; - margin-top: 12pt; padding-left: 0; margin-left: 1em; - margin-top: 0.2em; - padding-bottom: 0.4em; + margin-top: 1em; + padding-bottom: 0.2em; font-size: 1.5em; - font-family: Georgia, "Times New Roman", Times, serif; } h3 a { @@ -95,7 +106,6 @@ h4 { margin-top: 12pt; font-size: 1.0em; font-weight: bolder; - font-family: Georgia, "Times New Roman", Times, serif; } h4 a { @@ -121,6 +131,18 @@ p,pre,table,ul,ol,dl { margin-left: 2em; } +p { + margin-top: 0.5em; + margin-bottom: 0.5em; +} + +/* + * Add a little bit of space above li's + */ +li { + margin-top: 0.25em; +} + /* * Navigation sidebar on the left hand of most pages */ @@ -264,6 +286,18 @@ td.release-line,th.release-line { margin-left: 1em; } + +p.note::before { + content: 'Note:'; + font-weight: bold; + margin-right: 1em; +} +p.note { + border: 1px solid gray; + padding: 0.5em; + background-color: #fdfdd9; +} + samp { margin-left: 1em; margin-right: 2em; @@ -425,34 +459,39 @@ div.indent { } ul.TOC { - list-style-type: none; - padding-left: 1em; - font-size: larger; + font-size: medium; } -ul.TOC li a { - font-weight: bold; +ul.TOC, +ul.TOC li, +ul.TOC li ul, +ul.TOC li ul li { + margin-left: 0.25em; + margin-top: 0.25em; } -ul.TOC li ul li a { - font-weight: normal; - list-style-type: none; - font-size: small; +ul.TOC li { + padding-left: 1em; + margin-left: 0.25em; } - -ul.TOC li ul { - margin-left: 0; - padding-left: 2em; - font-weight: normal; - list-style-type: none; +ul.TOC li li { + padding-left: 1em; + margin-left: 0.25em; } pre.samp,samp { + margin-top: 0.5em; + margin-bottom: 0.5em; margin-left: 1em; border-style: groove; padding: 1em; display: block; - background-color: #EEEEEE + background-color: #f9fbfa; + font-family: "Source Code Pro", "Everson Mono", "Courier New", Courier, mono; + border-radius: 12px; + border-bottom-color: gray; + border-right-color: gray; + white-space: pre-wrap; } td.proto { diff --git a/icu4c/license.html b/icu4c/license.html index 44057bf8348..ca377d4ea34 100644 --- a/icu4c/license.html +++ b/icu4c/license.html @@ -4,6 +4,7 @@ ICU License - ICU 1.8.1 and later + diff --git a/icu4c/readme.html b/icu4c/readme.html index 41d91e9f8b1..d2b0924664e 100644 --- a/icu4c/readme.html +++ b/icu4c/readme.html @@ -13,18 +13,39 @@ + + + + +

Note: This is a draft readme.

+ +

+ DRAFT + International Components for Unicode
+ + Release Candidate + (Milestone Release) + ICU 54.1 (m1) ReadMe +

- -

International Components for Unicode
- ICU 54.1 (m1) ReadMe

- -

Note: This is a development milestone release of ICU4C 54 - This milestone is intended for those wishing to get an early look at ICU 54 new features and API changes. + + +

This is a development milestone release of ICU + This milestone is intended for those wishing to get an early look at new features and API changes. It is not recommended for production use.

- - -

Last updated: 2014-June-25
+ +

This is a release candidate version of ICU4C. + It is not recommended for production use.

+ +

Last updated: 2014-July-01
Copyright © 1997-2014 International Business Machines Corporation and others. All Rights Reserved.

@@ -213,53 +234,31 @@

What is new in this release?

-

To see which APIs are new or changed in this release, view the ICU4C API Change Report.

+

API Changes

+

See the API Change Report for a complete + list of APIs added, removed, or changed in this release.

-

-

The following list concentrates on changes that affect existing - applications migrating from previous ICU releases. - For more news about this release, see the - ICU download page. - -

- -

Layout Engine deprecation

+

Deprecation: Layout Engine

The LayoutEngine is now deprecated. Please see the User's Guide for more details and migration recommendations. - Passing "--enable-layout" to configure is required to enable the layout - engine, it is not built by default.

- - -

ICU4C now requires C99

-

ICU4C must be built with compilers (or compiler options) that support C99 (ISO/IEC 9899:1999).

- -

Collation code re-implemented

- + Passing "--enable-layout" to configure is now required to + enable the layout engine, as it is not built by default.

+ +

Deprecation: Collation Short Strings

+

The collation short naming scheme and its API functions are deprecated. + Use ucol_open() with language tag collation keywords instead (see Collation API Details). For example, ucol_open("de-u-co-phonebk-ka-shifted", &errorCode) + for German Phonebook order with "ignore punctuation" mode.

+ + +

Full release notes and the latest updates

+

The previous list concentrates on changes that affect existing + applications migrating from previous ICU releases. + For more news about this release, as well as late-breaking news, see the + ICU download page.

- +

How To Download the Source Code

@@ -359,7 +358,12 @@ <ICU>/source/layout/ - Contains the ICU layout engine (not a rasterizer). + Contains the ICU complex text layout engine. (Deprecated) + + + <ICU>/source/layoutex/ + + Contains the ICU paragraph layout engine. @@ -551,7 +555,8 @@ (This is for historical reasons: Originally, ICU4C did not use namespaces, and some compilers did not support them. The default "using" statement preserves source code compatibility.)
- We recommend you turn this off via -DU_USING_ICU_NAMESPACE=0 + If this compatibility is not an issue, we recommend you turn this off + via -DU_USING_ICU_NAMESPACE=0 or by modifying unicode/uversion.h: 
Index: source/common/unicode/uversion.h
 ===================================================================
@@ -733,11 +738,10 @@
     
+        
Cygwin 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)

 
     
The steps are:

 
@@ -776,14 +780,11 @@
        
 	
  • So, for example:
 				 
    
-		<ICU>\source\allinone\icucheck.bat  x86 Debug
-		
-				
      or 
    
-		<ICU>\source\allinone\icucheck.bat  x86 Release
-		
-				
      or 
    
-		<ICU>\source\allinone\icucheck.bat  x64 Release
-		
    • 
+		<ICU>\source\allinone\icucheck.bat  x86 Debug
+				or
+		<ICU>\source\allinone\icucheck.bat  x86 Release
+				or
+		<ICU>\source\allinone\icucheck.bat  x64 Release
 		
 
          
    Running the Tests from within Visual Studio
    
@@ -985,36 +986,36 @@
 
     
      
       
    1. Decompress the icu-X.Y.tgz (or
-      icu-X.Y.tar.gz) file. For example, "gunzip -d <
-      icu-X.Y.tgz | tar xvf -"
      2. 
+      icu-X.Y.tar.gz) file. For example, gunzip -d < icu-X.Y.tgz | tar xvf -
 
-      
    2. Change directory to the "icu/source".
      3. 
+      
    3. Change directory to icu/source.
+          cd icu/source
+          
      4. 
 
-      
    4. Run "chmod +x runConfigureICU configure install-sh" because
-      these files may have the wrong permissions.
      5. 
+      
    5. Some files may have the wrong permissions.chmod +x runConfigureICU configure install-sh
      6. 
 
       
    6. Run the runConfigureICU
       script for your platform. (See configuration
       note below).
      7. 
 
-      
    7. Type "gmake" (or "make" if GNU make is the default make on
+      
    8. Now build: gmake (or just make if GNU make is the default make on
       your platform) to compile the libraries and all the data files. The proper
       name of the GNU make command is printed at the end of the configuration
-      run, as in "You must use gmake to compile ICU".
+      run, as in "You must use gmake to compile ICU".
       
      
       Note that the compilation command output may be simplified on your platform.  If this is the case, you will see just:
-      
      gcc ... stubdata.c
      
+      gcc ... stubdata.c
       rather than
-      
      gcc  -DU_NO_DEFAULT_INCLUDE_UTF_HEADERS=1 -D_REENTRANT -I../common -DU_ATTRIBUTE_DEPRECATED= -O2 -Wall -std=c99 -pedantic -Wshadow -Wpointer-arith -Wmissing-prototypes -Wwrite-strings -c -DPIC -fPIC -o stubdata.o stubdata.c
      
-      .
      
+      gcc  -DU_NO_DEFAULT_INCLUDE_UTF_HEADERS=1 -D_REENTRANT -I../common -DU_ATTRIBUTE_DEPRECATED= -O2 -Wall -std=c99 -pedantic -Wshadow -Wpointer-arith -Wmissing-prototypes -Wwrite-strings -c -DPIC -fPIC -o stubdata.o stubdata.c
+      
      
       If you need to see the whole compilation line,  use "gmake VERBOSE=1". The full compilation line will print if an error occurs.
       
      9. 
 
-      
    9. Optionally, type "gmake check" to run the test suite, which
+      
    10. Optionally,gmake check will run the test suite, which
       checks for ICU's functionality integrity (See testing note below).
      11. 
 
-      
    11. Type "gmake install" to install ICU. If you used the --prefix=
+      
    12. To install, gmake install to install ICU. If you used the --prefix=
       option on configure or runConfigureICU, ICU will be installed to the
       directory you specified. (See installation
       note below).
      13. 
@@ -1324,7 +1325,7 @@ gnumake
 		
 		
    13. Set PATH or other variables as needed, such as CPPFLAGS.
      14. 
 		
    14. Build ICU in /buildB
      
-			
      Note: "--with-cross-build" takes an absolute path.
      
+			
      "--with-cross-build" takes an absolute path.
      
 
      cd /buildB
 sh /icu/source/configure --host=i586-pc-haiku --with-cross-build=/buildA
 gnumake