Skip to content

Commit 47c0467

Browse files
authored
Merge pull request #2660 from jyn514/doc
Document some additional `-t` tool flags
2 parents ad7ae63 + 9746811 commit 47c0467

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

doc/manual.asciidoc

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -270,6 +270,8 @@ and a web browser will be opened. This can be changed as follows:
270270
ninja -t browse --port=8000 --no-browser mytarget
271271
----
272272
+
273+
Use `--help` to see a full list of options.
274+
+
273275
`graph`:: output a file in the syntax used by `graphviz`, an automatic
274276
graph layout tool. Use it like:
275277
+
@@ -296,10 +298,11 @@ than the _depth_ mode.
296298
297299
`commands`:: given a list of targets, print a list of commands which, if
298300
executed in order, may be used to rebuild those targets, assuming that all
299-
output files are out of date.
301+
output files are out of date. Use `-s` to only print the final command, not the chain.
300302
301303
`inputs`:: given a list of targets, print a list of all inputs used to
302-
rebuild those targets.
304+
rebuild those targets. For compatibility reasons, inputs are shell-quoted by default.
305+
Use `--no-shell-escape` to disable quoting. See `ninja -t inputs --help` for all options.
303306
_Available since Ninja 1.11._
304307
305308
`multi-inputs`:: print one or more sets of inputs required to build targets.
@@ -364,13 +367,13 @@ build file. _Available since Ninja 1.10._
364367
C family language compiler rule whose first input is the name of the
365368
source file, prints on standard output a compilation database in the
366369
http://clang.llvm.org/docs/JSONCompilationDatabase.html[JSON format] expected
367-
by the Clang tooling interface.
370+
by the Clang tooling interface. Use `-x` to expand `@rspfile` response file invocations.
368371
_Available since Ninja 1.2._
369372
370373
`compdb-targets`:: like `compdb`, but takes a list of targets instead of rules,
371374
and expects at least one target. The resulting compilation database contains
372375
all commands required to build the indicated targets, and _only_ those
373-
commands.
376+
commands. Use `-x` to expand `@rspfile` response file invocations.
374377
375378
`deps`:: show all dependencies stored in the `.ninja_deps` file. When given a
376379
target, show just the target's dependencies. _Available since Ninja 1.4._

0 commit comments

Comments
 (0)