From: Reid Spencer <rspencer@reidspencer.com>
Date: Fri, 17 Dec 2004 07:46:45 +0000 (+0000)
Subject: Describe the new "reconfigure" and "spotless" targets.
X-Git-Url: http://demsky.eecs.uci.edu/git/?a=commitdiff_plain;h=f13a269179e38ad39a7c2911cbe9e222263057a9;p=oota-llvm.git

Describe the new "reconfigure" and "spotless" targets.


git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@19013 91177308-0d34-0410-b5e6-96231b3b80d8
---

diff --git a/docs/MakefileGuide.html b/docs/MakefileGuide.html
index 7e70f3aabed..64fe536cb6f 100644
--- a/docs/MakefileGuide.html
+++ b/docs/MakefileGuide.html
@@ -54,6 +54,8 @@
       <li><a href="#install">install</a></li>
       <li><a href="#preconditions">preconditions</a></li>
       <li><a href="#printvars">printvars</a></li>
+      <li><a href="#reconfigure">reconfigure</a></li>
+      <li><a href="#spotless">spotless</a></li>
       <li><a href="#tags">tags</a></li>
       <li><a href="#uninstall">uninstall</a></li>
     </ol>
@@ -519,6 +521,28 @@
   the makefile variables so that you can double check how things are set. </p>
 </div>
 
+<!-- ======================================================================= -->
+<div class="doc_subsection"><a name="reconfigure">reconfigure</a></div>
+<div class="doc_text">
+  <p>This utility target will force a reconfigure of LLVM or your project. It 
+  simply runs <tt>$(BUILD_OBJ_ROOT)/config.status --recheck</tt> to rerun the
+  configuration tests and rebuild the configured files. This isn't generally
+  useful as the makefiles will reconfigure themselves whenever its necessary.
+  </p>
+</div>
+
+<!-- ======================================================================= -->
+<div class="doc_subsection"><a name="spotless">spotless</a></div>
+<div class="doc_text">
+  <p>This utility target, only available when <tt>$(BUILD_OBJ_ROOT)</tt> is not 
+  the same as <tt>$(BUILD_SRC_ROOT)</tt>, will completely clean the
+  <tt>$(BUILD_OBJ_ROOT)</tt> directoy by removing its content entirely and 
+  reconfiguring the directory. This returns the <tt>$(BUILD_OBJ_ROOT)</tt> 
+  directory to a completely fresh state. All content in the directory except 
+  configured files and top-level makefiles will be lost.
+  <font color="red">Use with caution.</font></p>
+</div>
+
 <!-- ======================================================================= -->
 <div class="doc_subsection"><a name="tags">tags</a></div>
 <div class="doc_text">