llvm-project/llvm/docs/CommandGuide
Joel E. Denny 31b373963f [lit] Report line number for failed RUN command
(Relands r333584, reverted in 333592.)

When debugging test failures with -vv (or -v in the case of the
internal shell), this makes it easier to locate the RUN line that
failed.  For example, clang's test/Driver/linux-ld.c has 892 total RUN
lines, and clang's test/Driver/arm-cortex-cpus.c has 424 RUN lines
after concatenation for line continuations.

When reading the generated shell script, this also makes it easier to
locate the RUN line that produced each command.

To support reporting RUN line numbers in the case of the internal
shell, this patch extends the internal shell to support the null
command, ":", except pipelines are not supported.

To support reporting RUN line numbers in the case of windows cmd.exe
as the external shell, this patch extends -vv to set "echo on" instead
of "echo off" in bat files.  (Support for windows cmd.exe as a lit
external shell will likely be dropped later, but I found out too
late.)

Reviewed By: delcypher,	asmith, stella.stamenova, jmorse, lebedev.ri, rnk

Differential Revision: https://reviews.llvm.org/D44598

llvm-svn: 333614
2018-05-31 00:55:32 +00:00
..
FileCheck.rst Add a -D flag to FileCheck to define variables 2017-11-07 13:24:44 +00:00
bugpoint.rst bugpoint: add flag -verbose-errors 2016-07-15 23:15:06 +00:00
dsymutil.rst [dsymutil] Upstream emitting of papertrail warnings. 2018-04-02 10:40:43 +00:00
index.rst Re-land r329156 "Add llvm-exegesis tool." 2018-04-04 11:37:06 +00:00
lit.rst [lit] Report line number for failed RUN command 2018-05-31 00:55:32 +00:00
llc.rst [MC] Fix -stack-size-section on ARM 2018-01-17 09:01:29 +00:00
lli.rst [docs] Update code block for compatibility with Sphinx 1.5.1 2017-11-06 11:47:24 +00:00
llvm-ar.rst
llvm-as.rst
llvm-bcanalyzer.rst
llvm-build.rst
llvm-config.rst
llvm-cov.rst [llvm-cov] Implement -ignore-filename-regex= option for excluding source files. 2018-04-09 15:20:35 +00:00
llvm-diff.rst
llvm-dis.rst
llvm-dwarfdump.rst Remove duplicate option from documentation. 2017-12-09 19:09:59 +00:00
llvm-exegesis-analysis.png [llvm-exegesis] Show sched class details in analysis. 2018-05-24 10:47:05 +00:00
llvm-exegesis.rst [llvm-exegesis] Show sched class details in analysis. 2018-05-24 10:47:05 +00:00
llvm-extract.rst
llvm-lib.rst
llvm-link.rst
llvm-mca.rst Fix typo in declaring code-block snippet 2018-05-17 16:58:42 +00:00
llvm-nm.rst llvm-nm: Add support for symbol demangling (-C/--demangle) 2017-06-29 18:29:05 +00:00
llvm-pdbutil.rst [docs] Update code block for compatibility with Sphinx 1.5.1 2017-11-06 11:47:24 +00:00
llvm-profdata.rst [ProfileData] Add new option to dump topn hottest functions 2017-07-11 20:30:43 +00:00
llvm-readobj.rst
llvm-stress.rst
llvm-symbolizer.rst
opt.rst Rename DEBUG macro to LLVM_DEBUG. 2018-05-14 12:53:11 +00:00
tblgen.rst