[docs] Expand lit documentation on response files
authorPetr Hosek <phosek@google.com>
Mon, 29 Aug 2022 06:50:10 +0000 (06:50 +0000)
committerPetr Hosek <phosek@google.com>
Mon, 29 Aug 2022 06:51:01 +0000 (06:51 +0000)
This was requested in https://reviews.llvm.org/D132437.

llvm/docs/CommandGuide/lit.rst

index 31e2726..b9d8675 100644 (file)
@@ -44,7 +44,10 @@ supplementing or overriding the command-line options supplied to :program:`lit`
 by ``check`` targets defined by a project's build system.
 
 :program:`lit` can also read options from response files which are specified as
-inputs using the ``@path/to/file.rsp`` syntax.
+inputs using the ``@path/to/file.rsp`` syntax. Arguments read from a file must
+be one per line and are treated as if they were in the same place as the
+original file referencing argument on the command line. A response file can
+reference other response files.
 
 Users interested in the :program:`lit` architecture or designing a
 :program:`lit` testing implementation should see :ref:`lit-infrastructure`.