From: Michael Meffie <mmeffie@sinenomine.net>
Date: Wed, 28 Dec 2016 15:57:10 +0000 (-0500)
Subject: hints for doing an out of tree build
X-Git-Url: http://git.openafs.org/?p=openafs-wiki.git;a=commitdiff_plain;h=f1eed95e187ec879846e98611d167c995386def5

hints for doing an out of tree build
---

diff --git a/archive/HowToBuildOpenAFSFromSource.mdwn b/archive/HowToBuildOpenAFSFromSource.mdwn
index 032dbb2..269e3ce 100644
--- a/archive/HowToBuildOpenAFSFromSource.mdwn
+++ b/archive/HowToBuildOpenAFSFromSource.mdwn
@@ -444,5 +444,21 @@ Some make targets of interest
 - make distclean - remove build and configure artifacts
 - make tests - make the (old) afs test suite
 
+## Out of Tree Builds ##
+
+You may want to avoid cluttering your source tree with build artifacts, or
+perhaps your source is in /afs and you want to write build artifacts on a
+local, fast temporary file system.  No configure hacking is needed to do
+perform an out of tree build.  If building from a git checkout, first build a
+configure script as usual, then change the current working directory to your
+local build directory and run configure and then make.
+
+
+    $ mkdir /tmp/mybuild
+    $ cd /tmp/mybuild
+    $ ( cd /afs/mycell/myfiles/openafs && ./regen.sh )  # if no configure
+    $ /afs/mycell/myfiles/openafs/configure $options
+    $ make
+