diff options
author | Brad King <brad.king@kitware.com> | 2021-02-26 14:21:03 (GMT) |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2021-02-26 15:31:27 (GMT) |
commit | 706e16bee5f6b5fccd284476a9157ecc8c39f12c (patch) | |
tree | 78ae9af75529605ffc98631e9a8bd28e9c981b9d /doc | |
parent | 212cd97679e783de77230b009b23dd11344644ac (diff) | |
download | Ninja-706e16bee5f6b5fccd284476a9157ecc8c39f12c.zip Ninja-706e16bee5f6b5fccd284476a9157ecc8c39f12c.tar.gz Ninja-706e16bee5f6b5fccd284476a9157ecc8c39f12c.tar.bz2 |
Add tool to print code page information on Windows
Since commit 00459e2b (Use UTF-8 on Windows 10 Version 1903, fix #1195,
2021-02-17), `ninja` does not always expect `build.ninja` to be encoded
in the system's ANSI code page. The expected encoding now depends on
how `ninja` is built and the version of Windows on which it is running.
Add a `-t wincodepage` tool that generators can use to ask `ninja`
what encoding it expects.
Issue: #1195
Diffstat (limited to 'doc')
-rw-r--r-- | doc/manual.asciidoc | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc index 0ac0ebb..204cc6d 100644 --- a/doc/manual.asciidoc +++ b/doc/manual.asciidoc @@ -308,6 +308,18 @@ file. _Available since Ninja 1.10._ if they have one). It can be used to know which rule name to pass to +ninja -t targets rule _name_+ or +ninja -t compdb+. +`wincodepage`:: available on Windows hosts. Prints the ANSI code page +used by `ninja`, whose encoding is expected in `build.ninja`. Also prints +the Console code page for reference. The output has the form: ++ +---- +ANSI code page: %u +Console code page: %u +---- ++ +where each `%u` is an integer code page identifier, expressed in decimal. +_Available since Ninja 1.11._ + Writing your own Ninja files ---------------------------- |