Tweak some docs now that the default build is called Debug+Asserts.

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@107862 91177308-0d34-0410-b5e6-96231b3b80d8
This commit is contained in:
Duncan Sands 2010-07-08 08:27:18 +00:00
parent fb31ccb68c
commit 67f8a7bc26
2 changed files with 13 additions and 13 deletions

View File

@ -1137,13 +1137,13 @@ platforms or configurations using the same source tree.</p>
named after the build type:</p> named after the build type:</p>
<dl> <dl>
<dt>Debug Builds <dt>Debug Builds with assertions enabled (the default)
<dd> <dd>
<dl> <dl>
<dt>Tools <dt>Tools
<dd><tt><i>OBJ_ROOT</i>/Debug/bin</tt> <dd><tt><i>OBJ_ROOT</i>/Debug+Asserts/bin</tt>
<dt>Libraries <dt>Libraries
<dd><tt><i>OBJ_ROOT</i>/Debug/lib</tt> <dd><tt><i>OBJ_ROOT</i>/Debug+Asserts/lib</tt>
</dl> </dl>
<br><br> <br><br>

View File

@ -195,7 +195,7 @@ include $(LEVEL)/Makefile.common
<p>This makefile specifies that all of the <tt>.cpp</tt> files in the current <p>This makefile specifies that all of the <tt>.cpp</tt> files in the current
directory are to be compiled and linked together into a directory are to be compiled and linked together into a
<tt>Debug/lib/Hello.so</tt> shared object that can be dynamically loaded by <tt>Debug+Asserts/lib/Hello.so</tt> shared object that can be dynamically loaded by
the <tt>opt</tt> or <tt>bugpoint</tt> tools via their <tt>-load</tt> options. the <tt>opt</tt> or <tt>bugpoint</tt> tools via their <tt>-load</tt> options.
If your operating system uses a suffix other than .so (such as windows or If your operating system uses a suffix other than .so (such as windows or
Mac OS/X), the appropriate extension will be used.</p> Mac OS/X), the appropriate extension will be used.</p>
@ -332,7 +332,7 @@ is supplied as fourth argument. </p>
<p>Now that it's all together, compile the file with a simple "<tt>gmake</tt>" <p>Now that it's all together, compile the file with a simple "<tt>gmake</tt>"
command in the local directory and you should get a new command in the local directory and you should get a new
"<tt>Debug/lib/Hello.so</tt> file. Note that everything in this file is "<tt>Debug+Asserts/lib/Hello.so</tt> file. Note that everything in this file is
contained in an anonymous namespace: this reflects the fact that passes are self contained in an anonymous namespace: this reflects the fact that passes are self
contained units that do not need external interfaces (although they can have contained units that do not need external interfaces (although they can have
them) to be useful.</p> them) to be useful.</p>
@ -358,7 +358,7 @@ through our transformation like this (or course, any bitcode file will
work):</p> work):</p>
<div class="doc_code"><pre> <div class="doc_code"><pre>
$ opt -load ../../../Debug/lib/Hello.so -hello &lt; hello.bc &gt; /dev/null $ opt -load ../../../Debug+Asserts/lib/Hello.so -hello &lt; hello.bc &gt; /dev/null
Hello: __main Hello: __main
Hello: puts Hello: puts
Hello: main Hello: main
@ -375,7 +375,7 @@ interesting way, we just throw away the result of <tt>opt</tt> (sending it to
<tt>opt</tt> with the <tt>-help</tt> option:</p> <tt>opt</tt> with the <tt>-help</tt> option:</p>
<div class="doc_code"><pre> <div class="doc_code"><pre>
$ opt -load ../../../Debug/lib/Hello.so -help $ opt -load ../../../Debug+Asserts/lib/Hello.so -help
OVERVIEW: llvm .bc -&gt; .bc modular optimizer OVERVIEW: llvm .bc -&gt; .bc modular optimizer
USAGE: opt [options] &lt;input bitcode&gt; USAGE: opt [options] &lt;input bitcode&gt;
@ -403,7 +403,7 @@ the execution time of your pass along with the other passes you queue up. For
example:</p> example:</p>
<div class="doc_code"><pre> <div class="doc_code"><pre>
$ opt -load ../../../Debug/lib/Hello.so -hello -time-passes &lt; hello.bc &gt; /dev/null $ opt -load ../../../Debug+Asserts/lib/Hello.so -hello -time-passes &lt; hello.bc &gt; /dev/null
Hello: __main Hello: __main
Hello: puts Hello: puts
Hello: main Hello: main
@ -1418,7 +1418,7 @@ how our <a href="#basiccode">Hello World</a> pass interacts with other passes.
Lets try it out with the <tt>gcse</tt> and <tt>licm</tt> passes:</p> Lets try it out with the <tt>gcse</tt> and <tt>licm</tt> passes:</p>
<div class="doc_code"><pre> <div class="doc_code"><pre>
$ opt -load ../../../Debug/lib/Hello.so -gcse -licm --debug-pass=Structure &lt; hello.bc &gt; /dev/null $ opt -load ../../../Debug+Asserts/lib/Hello.so -gcse -licm --debug-pass=Structure &lt; hello.bc &gt; /dev/null
Module Pass Manager Module Pass Manager
Function Pass Manager Function Pass Manager
Dominator Set Construction Dominator Set Construction
@ -1455,7 +1455,7 @@ passes.</p>
World</a> pass in between the two passes:</p> World</a> pass in between the two passes:</p>
<div class="doc_code"><pre> <div class="doc_code"><pre>
$ opt -load ../../../Debug/lib/Hello.so -gcse -hello -licm --debug-pass=Structure &lt; hello.bc &gt; /dev/null $ opt -load ../../../Debug+Asserts/lib/Hello.so -gcse -hello -licm --debug-pass=Structure &lt; hello.bc &gt; /dev/null
Module Pass Manager Module Pass Manager
Function Pass Manager Function Pass Manager
Dominator Set Construction Dominator Set Construction
@ -1496,7 +1496,7 @@ href="#getAnalysisUsage"><tt>getAnalysisUsage</tt></a> method to our pass:</p>
<p>Now when we run our pass, we get this output:</p> <p>Now when we run our pass, we get this output:</p>
<div class="doc_code"><pre> <div class="doc_code"><pre>
$ opt -load ../../../Debug/lib/Hello.so -gcse -hello -licm --debug-pass=Structure &lt; hello.bc &gt; /dev/null $ opt -load ../../../Debug+Asserts/lib/Hello.so -gcse -hello -licm --debug-pass=Structure &lt; hello.bc &gt; /dev/null
Pass Arguments: -gcse -hello -licm Pass Arguments: -gcse -hello -licm
Module Pass Manager Module Pass Manager
Function Pass Manager Function Pass Manager
@ -1737,8 +1737,8 @@ want:</p>
<div class="doc_code"><pre> <div class="doc_code"><pre>
(gdb) <b>break llvm::PassManager::run</b> (gdb) <b>break llvm::PassManager::run</b>
Breakpoint 1 at 0x2413bc: file Pass.cpp, line 70. Breakpoint 1 at 0x2413bc: file Pass.cpp, line 70.
(gdb) <b>run test.bc -load $(LLVMTOP)/llvm/Debug/lib/[libname].so -[passoption]</b> (gdb) <b>run test.bc -load $(LLVMTOP)/llvm/Debug+Asserts/lib/[libname].so -[passoption]</b>
Starting program: opt test.bc -load $(LLVMTOP)/llvm/Debug/lib/[libname].so -[passoption] Starting program: opt test.bc -load $(LLVMTOP)/llvm/Debug+Asserts/lib/[libname].so -[passoption]
Breakpoint 1, PassManager::run (this=0xffbef174, M=@0x70b298) at Pass.cpp:70 Breakpoint 1, PassManager::run (this=0xffbef174, M=@0x70b298) at Pass.cpp:70
70 bool PassManager::run(Module &amp;M) { return PM-&gt;run(M); } 70 bool PassManager::run(Module &amp;M) { return PM-&gt;run(M); }
(gdb) (gdb)