diff options
| author | Steven R. Loomis <srloomis@us.ibm.com> | 2016-04-08 19:03:24 -0700 |
|---|---|---|
| committer | Steven R. Loomis <srloomis@us.ibm.com> | 2016-05-04 16:04:22 -0700 |
| commit | 03a8637f7934b12516d36ea3c5c9fb2443bdfb8d (patch) | |
| tree | 0449150d3ebb6b08516072e2cd6c770d5e6fae0a /BUILDING.md | |
| parent | 2bbd1cd6004b3e1467e30d860385a85dad01fe24 (diff) | |
| download | node-new-03a8637f7934b12516d36ea3c5c9fb2443bdfb8d.tar.gz | |
tools: Check in tools for shrinking ICU size, change default to small-icu
* Change configure default to "small-icu" (Intl on, English only)
* add "--without-intl" and "vcbuild without-intl" options, equivalent
to --with-intl=none
* update BUILDING.md with above changes
* Checks in tools that generate the deps/icu-small source directory
from ICU source
* Tools and process for updating ICU documented in tools/icu/README.md
Fixes: https://github.com/nodejs/node/issues/3476
PR-URL: https://github.com/nodejs/node/pull/6088
Reviewed-By: James M Snell <jasnell@gmail.com>
Diffstat (limited to 'BUILDING.md')
| -rw-r--r-- | BUILDING.md | 38 |
1 files changed, 12 insertions, 26 deletions
diff --git a/BUILDING.md b/BUILDING.md index 0d55a2047f..da52875e7b 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -117,29 +117,14 @@ $ make ### `Intl` (ECMA-402) support: -[Intl](https://github.com/nodejs/node/wiki/Intl) support is not -enabled by default. +[Intl](https://github.com/nodejs/node/wiki/Intl) support is +enabled by default, with English data only. +#### Default: `small-icu` (English only) support -#### "small" (English only) support - -This option will build with "small" (English only) support, but -the full `Intl` (ECMA-402) APIs. With `--download=all` it will -download the ICU library as needed. - -##### Unix / OS X: - -```text -$ ./configure --with-intl=small-icu --download=all -``` - -##### Windows: - -```text -> vcbuild small-icu download-all -``` - -The `small-icu` mode builds with English-only data. You can add full +By default, only English data is included, but +the full `Intl` (ECMA-402) APIs. It does not need to download +any dependencies to function. You can add full data at runtime. *Note:* more docs are on @@ -148,7 +133,8 @@ data at runtime. #### Build with full ICU support (all locales supported by ICU): With the `--download=all`, this may download ICU if you don't have an -ICU in `deps/icu`. +ICU in `deps/icu`. (The embedded `small-icu` included in the default +Node.js source does not include all locales.) ##### Unix / OS X: @@ -164,19 +150,19 @@ $ ./configure --with-intl=full-icu --download=all #### Building without Intl support -The `Intl` object will not be available. This is the default at -present, so this option is not normally needed. +The `Intl` object will not be available, nor some other APIs such as +`String.normalize`. ##### Unix / OS X: ```text -$ ./configure --with-intl=none +$ ./configure --without-intl ``` ##### Windows: ```text -> vcbuild intl-none +> vcbuild without-intl ``` #### Use existing installed ICU (Unix / OS X only): |