summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2021-03-01 17:35:51 (GMT)
committerBrad King <brad.king@kitware.com>2021-03-01 18:05:46 (GMT)
commita510f532f6ac0ec05703afade6e2bfdecbc6d00a (patch)
tree8c5fc18fc6b28628352dfaeb9b67da6adbf0140a /doc
parent1a8015038d9a8c6bf0c04a42588fb2a26861be63 (diff)
downloadNinja-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.asciidoc18
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
----------------------------