summaryrefslogtreecommitdiff
path: root/doc/api/util.md
diff options
context:
space:
mode:
authorSteven R. Loomis <srloomis@us.ibm.com>2019-09-30 11:17:49 -0700
committerRich Trott <rtrott@gmail.com>2019-10-03 15:21:26 -0700
commit1a25e901b7c380929f0d08599f49dd77897a627f (patch)
tree3fdac9d1df5970cf8870bf5a9a5ae1cb45fa890a /doc/api/util.md
parenta71fb978a40b5251fdb012bab5e03598d5397a10 (diff)
downloadandroid-node-v8-1a25e901b7c380929f0d08599f49dd77897a627f.tar.gz
android-node-v8-1a25e901b7c380929f0d08599f49dd77897a627f.tar.bz2
android-node-v8-1a25e901b7c380929f0d08599f49dd77897a627f.zip
tools: support full-icu by default
Instead of an English-only icudt64l.dat in the repo, we now have icudt64l.dat.gz with all locales. - updated READMEs and docs - shrinker now copies source, and compresses (bzip2) the ICU data file - configure expects deps/icu-small to be full ICU with a full compressed data file Fixes: https://github.com/nodejs/node/issues/19214 Co-Authored-By: Richard Lau <riclau@uk.ibm.com> Co-Authored-By: Jan Olaf Krems <jan.krems@gmail.com> Co-Authored-By: James M Snell <jasnell@gmail.com> PR-URL: https://github.com/nodejs/node/pull/29522 Reviewed-By: Jan Krems <jan.krems@gmail.com> Reviewed-By: Jiawen Geng <technicalcute@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Michael Dawson <michael_dawson@ca.ibm.com> Reviewed-By: Michaƫl Zasso <targos@protonmail.com>
Diffstat (limited to 'doc/api/util.md')
-rw-r--r--doc/api/util.md42
1 files changed, 20 insertions, 22 deletions
diff --git a/doc/api/util.md b/doc/api/util.md
index 7fcb595dcd..118c2a4d0d 100644
--- a/doc/api/util.md
+++ b/doc/api/util.md
@@ -932,26 +932,9 @@ Per the [WHATWG Encoding Standard][], the encodings supported by the
one or more aliases may be used.
Different Node.js build configurations support different sets of encodings.
-While a very basic set of encodings is supported even on Node.js builds without
-ICU enabled, support for some encodings is provided only when Node.js is built
-with ICU and using the full ICU data (see [Internationalization][]).
+(see [Internationalization][])
-#### Encodings Supported Without ICU
-
-| Encoding | Aliases |
-| ----------- | --------------------------------- |
-| `'utf-8'` | `'unicode-1-1-utf-8'`, `'utf8'` |
-| `'utf-16le'` | `'utf-16'` |
-
-#### Encodings Supported by Default (With ICU)
-
-| Encoding | Aliases |
-| ----------- | --------------------------------- |
-| `'utf-8'` | `'unicode-1-1-utf-8'`, `'utf8'` |
-| `'utf-16le'` | `'utf-16'` |
-| `'utf-16be'` | |
-
-#### Encodings Requiring Full ICU Data
+#### Encodings Supported by Default (With Full ICU Data)
| Encoding | Aliases |
| ----------------- | -------------------------------- |
@@ -990,6 +973,21 @@ with ICU and using the full ICU data (see [Internationalization][]).
| `'shift_jis'` | `'csshiftjis'`, `'ms932'`, `'ms_kanji'`, `'shift-jis'`, `'sjis'`, `'windows-31j'`, `'x-sjis'` |
| `'euc-kr'` | `'cseuckr'`, `'csksc56011987'`, `'iso-ir-149'`, `'korean'`, `'ks_c_5601-1987'`, `'ks_c_5601-1989'`, `'ksc5601'`, `'ksc_5601'`, `'windows-949'` |
+#### Encodings Supported when Node.js is built with the `small-icu` option
+
+| Encoding | Aliases |
+| ----------- | --------------------------------- |
+| `'utf-8'` | `'unicode-1-1-utf-8'`, `'utf8'` |
+| `'utf-16le'` | `'utf-16'` |
+| `'utf-16be'` | |
+
+#### Encodings Supported when ICU is disabled
+
+| Encoding | Aliases |
+| ----------- | --------------------------------- |
+| `'utf-8'` | `'unicode-1-1-utf-8'`, `'utf8'` |
+| `'utf-16le'` | `'utf-16'` |
+
The `'iso-8859-16'` encoding listed in the [WHATWG Encoding Standard][]
is not supported.
@@ -1005,9 +1003,9 @@ changes:
* `encoding` {string} Identifies the `encoding` that this `TextDecoder` instance
supports. **Default:** `'utf-8'`.
* `options` {Object}
- * `fatal` {boolean} `true` if decoding failures are fatal. This option is only
- supported when ICU is enabled (see [Internationalization][]). **Default:**
- `false`.
+ * `fatal` {boolean} `true` if decoding failures are fatal.
+ This option is not supported when ICU is disabled
+ (see [Internationalization][]). **Default:** `false`.
* `ignoreBOM` {boolean} When `true`, the `TextDecoder` will include the byte
order mark in the decoded result. When `false`, the byte order mark will
be removed from the output. This option is only used when `encoding` is