Index: docs/i18n_support.md |
diff --git a/docs/i18n_support.md b/docs/i18n_support.md |
new file mode 100644 |
index 0000000000000000000000000000000000000000..a1eb1c8f0ad1be8968ab0edd8ac193c5e3a4b2dd |
--- /dev/null |
+++ b/docs/i18n_support.md |
@@ -0,0 +1,44 @@ |
+# ECMAScript 402 |
+ |
+V8 optionally implements the [ECMAScript 402](http://www.ecma-international.org/ecma-402/1.0/) API. The API is enabled by default, but can be turned off at compile time. |
+ |
+ |
+## Prerequisites |
+ |
+The i18n implementation adds a dependency on ICU. If you run |
+ |
+``` |
+make dependencies |
+``` |
+ |
+a suitable version of ICU is checked out into `third_party/icu`. |
+ |
+ |
+### Alternative ICU checkout |
+ |
+You can check out the ICU sources at a different location and define the gyp variable `icu_gyp_path` to point at the `icu.gyp` file. |
+ |
+ |
+### System ICU |
+ |
+Last but not least, you can compile V8 against a version of ICU installed in your system. To do so, specify the gyp variable `use_system_icu=1`. If you also have `want_separate_host_toolset` enabled, the bundled ICU will still be compiled to generate the V8 snapshot. The system ICU will only be used for the target architecture. |
+ |
+ |
+## Embedding V8 |
+ |
+If you embed V8 in your application, but your application itself doesn't use ICU, you will need to initialize ICU before calling into V8 by executing: |
+ |
+``` |
+v8::V8::InitializeICU(); |
+``` |
+ |
+It is safe to invoke this method if ICU was not compiled in, then it does nothing. |
+ |
+ |
+## Compiling without i18n support |
+ |
+To build V8 without i18n support use |
+ |
+``` |
+make i18nsupport=off native |
+``` |