From 96d408186bed962f6636eac216510ec2bd706eff Mon Sep 17 00:00:00 2001 From: Waleed Khan Date: Fri, 31 Mar 2023 14:02:41 -0700 Subject: Fix formatting for `msvc` tool documentation --- doc/manual.asciidoc | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc index 2479aac..22601e1 100644 --- a/doc/manual.asciidoc +++ b/doc/manual.asciidoc @@ -324,20 +324,19 @@ Where `ENVFILE` is a binary file that contains an environment block suitable for CreateProcessA() on Windows (i.e. a series of zero-terminated strings that look like NAME=VALUE, followed by an extra zero terminator). Note that this uses the local codepage encoding. - ++ This tool also supports a deprecated way of parsing the compiler's output when -the `/showIncludes` flag is used, and generating a GCC-compatible depfile from it. +the `/showIncludes` flag is used, and generating a GCC-compatible depfile from it: + ---- +---- ninja -t msvc -o DEPFILE [-p STRING] -- cl.exe /showIncludes ---- +---- + - When using this option, `-p STRING` can be used to pass the localized line prefix that `cl.exe` uses to output dependency information. For English-speaking regions this is `"Note: including file: "` without the double quotes, but will be different for other regions. - ++ Note that Ninja supports this natively now, with the use of `deps = msvc` and `msvc_deps_prefix` in Ninja files. Native support also avoids launching an extra tool process each time the compiler must be called, which can speed up builds -- cgit v1.2.1