Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(1640)

Unified Diff: docs/i18n_support.md

Issue 1347153006: [Docs] Add wiki content to Markdown docs (Closed) Base URL: https://chromium.googlesource.com/v8/v8.git@master
Patch Set: Created 5 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
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
+```
« docs/building_with_gyp.md ('K') | « docs/handling_of_ports.md ('k') | docs/javascript.md » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698