aboutsummaryrefslogtreecommitdiffstats
path: root/docs/CommandGuide
diff options
context:
space:
mode:
authorAndrew Trick <atrick@apple.com>2011-04-14 05:05:36 +0000
committerAndrew Trick <atrick@apple.com>2011-04-14 05:05:36 +0000
commitb57b06647ead66113a97d84c3b3d332afe807dd6 (patch)
treea9eb667cd07bcef12db78c5f9554736f79a78c5c /docs/CommandGuide
parentdf2ef9015f8a02eee25c45a9be648540641610c2 (diff)
downloadexternal_llvm-b57b06647ead66113a97d84c3b3d332afe807dd6.zip
external_llvm-b57b06647ead66113a97d84c3b3d332afe807dd6.tar.gz
external_llvm-b57b06647ead66113a97d84c3b3d332afe807dd6.tar.bz2
Documented bugpoint --compile-custom --compile-command.
I've used it a few times to reduce unit tests and gotten one request for information on it. It's not easy to use correctly because bugpoint doesn't tell you when you're doing it wrong. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@129507 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs/CommandGuide')
-rw-r--r--docs/CommandGuide/bugpoint.pod18
1 files changed, 16 insertions, 2 deletions
diff --git a/docs/CommandGuide/bugpoint.pod b/docs/CommandGuide/bugpoint.pod
index 39f2d33..632a2b3 100644
--- a/docs/CommandGuide/bugpoint.pod
+++ b/docs/CommandGuide/bugpoint.pod
@@ -21,7 +21,7 @@ distribution.
=head1 OPTIONS
-=over
+=over
=item B<--additional-so> F<library>
@@ -87,7 +87,7 @@ mis-management.
=item B<-find-bugs>
Continually randomize the specified passes and run them on the test program
-until a bug is found or the user kills B<bugpoint>.
+until a bug is found or the user kills B<bugpoint>.
=item B<-help>
@@ -147,6 +147,20 @@ This option defines the command to use with the B<--run-custom> and
B<--safe-custom> options to execute the bitcode testcase. This can
be useful for cross-compilation.
+=item B<--compile-command> I<command>
+
+This option defines the command to use with the B<--compile-custom>
+option to compile the bitcode testcase. This can be useful for
+testing compiler output without running any link or execute stages. To
+generate a reduced unit test, you may add CHECK directives to the
+testcase and pass the name of a compile-command script in this form:
+
+ llc "$@"
+ not FileCheck [bugpoint input file].ll < bugpoint-test-program.s
+
+This script will "fail" as long as FileCheck passes. So the result
+will be the minimum bitcode that passes FileCheck.
+
=item B<--safe-path> I<path>
This option defines the path to the command to execute with the