diff options
| author | Chris Lattner <sabre@nondot.org> | 2003-10-18 21:34:15 +0000 |
|---|---|---|
| committer | Chris Lattner <sabre@nondot.org> | 2003-10-18 21:34:15 +0000 |
| commit | 634ec56986f5832804ce1fef6ddd66fac6103b8c (patch) | |
| tree | 0dfbf96c86779a2b9937e7c8e6889b01deee858c | |
| parent | b715497a564bac60fef22d8927eff7a03ce0698c (diff) | |
| download | external_llvm-634ec56986f5832804ce1fef6ddd66fac6103b8c.zip external_llvm-634ec56986f5832804ce1fef6ddd66fac6103b8c.tar.gz external_llvm-634ec56986f5832804ce1fef6ddd66fac6103b8c.tar.bz2 | |
Add bugpoint advice section
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@9244 91177308-0d34-0410-b5e6-96231b3b80d8
| -rw-r--r-- | docs/CommandGuide/bugpoint.html | 31 |
1 files changed, 30 insertions, 1 deletions
diff --git a/docs/CommandGuide/bugpoint.html b/docs/CommandGuide/bugpoint.html index 8d83863..04f45b5 100644 --- a/docs/CommandGuide/bugpoint.html +++ b/docs/CommandGuide/bugpoint.html @@ -105,6 +105,35 @@ being miscompiled. This module assumes that the selected code generator is working properly.<p> +<a name="bugpoint notes"> +<h4>Advice for using <tt>bugpoint</tt></h4> + +<tt>bugpoint</tt> can be a remarkably useful tool, but it sometimes works in +non-obvious ways. Here are some hints and tips:<p> + +<ol> +<li>In code generator and miscompilation debugging modes, <tt>bugpoint</tt> only + works with programs that have deterministic output. Thus, if the program + outputs the date, time, or any other "random" data, it should be masked out. + +<li>In code generator and miscompilation debugging modes, debugging will go + faster if you manually modify the program or its inputs to reduce the + runtime, but still exhibit the problem. + +<li><tt>bugpoint</tt> is extremely useful when working on a new optimization: + it helps track down regressions quickly. To avoid having to relink + <tt>bugpoint</tt> every time you change your optization however, have + <tt>bugpoint</tt> dynamically load your optimization with the <a + href="#opt_load"><tt>-load</tt></a> option. + +<li><tt>bugpoint</tt> can generate a lot of output and run for a long period of + time. It is often useful to capture the output of the program to file. For + example:<br> + <tt>bugpoint ..... |& tee bugpoint.log</tt><p> + +</ol> + + <h3>OPTIONS</h3> <ul> @@ -141,7 +170,7 @@ working properly.<p> Specify the contents of <stdin> when the program must be executed. <p> - <li> <tt>-load <plugin.so></tt><br> + <a name="opt_load"><li> <tt>-load <plugin.so></tt><br> Load the dynamic object plugin.so. This object should register new optimization passes. Once loaded, the object will add new command line options to enable various optimizations. To see the new complete list |