Response files

1 files changed, 20 insertions, 0 deletions

diff --git a/doc/manual.asciidoc b/doc/manual.asciidoc
index 3291095..0387c97 100644
--- a/doc/manual.asciidoc
+++ b/doc/manual.asciidoc
@@ -498,6 +498,26 @@ aborting due to a missing input.
  This may cause the output's reverse dependencies to be removed from the
  list of pending build actions.
 
+`rspfile`
+`rspfile_content`:: if present (both), Ninja will use a response file
+  for the given command, i.e. write the selected string (`rspfile_content`)
+  to the given file (`rspfile`) before calling the command and delete
+  the file after successful execution of the command.
++
+This is particularly useful on Windows OS, where the maximal length of 
+a command line is limited and response files must be used instead.
++
+Use it like in the following example:
++
+----
+rule link
+  command = link.exe /OUT$out [usual link flags here] @$out.rsp
+  rspfile = $out.rsp
+  rspfile_content = $in
+  
+build myapp.exe: link a.obj b.obj [possibly many other .obj files]
+----
+
 Additionally, the special `$in` and `$out` variables expand to the
 space-separated list of files provided to the `build` line referencing
 this `rule`.