diff options
author | Brad King <brad.king@kitware.com> | 2021-03-01 17:35:51 (GMT) |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2021-03-01 18:05:46 (GMT) |
commit | a510f532f6ac0ec05703afade6e2bfdecbc6d00a (patch) | |
tree | 8c5fc18fc6b28628352dfaeb9b67da6adbf0140a /doc | |
parent | 1a8015038d9a8c6bf0c04a42588fb2a26861be63 (diff) | |
download | Ninja-a510f532f6ac0ec05703afade6e2bfdecbc6d00a.zip Ninja-a510f532f6ac0ec05703afade6e2bfdecbc6d00a.tar.gz Ninja-a510f532f6ac0ec05703afade6e2bfdecbc6d00a.tar.bz2 |
wincodepage: minimize to indicate UTF-8 or not
The ANSI code page identifier is more information than generator
programs actually need. The encoding of `build.ninja` is always
either UTF-8 or the system-wide ANSI code page. Reduce the output
to provide no more information than the generator programs need.
The Console code page can be obtained in other ways, so drop it.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/manual.asciidoc | 18 |
1 files changed, 11 insertions, 7 deletions
diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc index 204cc6d..54403ac 100644 --- a/doc/manual.asciidoc +++ b/doc/manual.asciidoc @@ -308,17 +308,21 @@ 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: +`wincodepage`:: Available on Windows hosts (_since Ninja 1.11_). +Prints the Windows code page whose encoding is expected in the build file. +The output has the form: + ---- -ANSI code page: %u -Console code page: %u +Build file encoding: <codepage> ---- + -where each `%u` is an integer code page identifier, expressed in decimal. -_Available since Ninja 1.11._ +Additional lines may be added in future versions of Ninja. ++ +The `<codepage>` is one of: + +`UTF-8`::: Encode as UTF-8. + +`ANSI`::: Encode to the system-wide ANSI code page. Writing your own Ninja files ---------------------------- |