From 062702c8cf478234eb87e4ef616a3a79bde09b09 Mon Sep 17 00:00:00 2001
From: giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>
Date: Sat, 23 Sep 2006 22:31:09 +0000
Subject: Add explanation of separate build tree

git-svn-id: http://svn.code.sf.net/p/netpbm/code/trunk@68 9d0c8265-081b-0410-96cb-a4ca84ce46f8
---
 doc/INSTALL | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

(limited to 'doc/INSTALL')

diff --git a/doc/INSTALL b/doc/INSTALL
index c83b725d..ee62a906 100644
--- a/doc/INSTALL
+++ b/doc/INSTALL
@@ -213,6 +213,28 @@ normal build (there's a question for that in the Configure program).
 See below.
 
 
+SEPARATE BUILD TREE
+-------------------
+
+While it's traditional to build a Unix package by adding object files
+to the same tree with the source files, it's actually much cleaner to
+keep your source tree exactly as you got it and put the built files in
+a separate directory, called the build tree.
+
+To do this, just create an empty directory and run 'configure' in it,
+then 'make':
+
+  mkdir netpbmbuild
+  cd netpbmbuild
+  /usr/src/netpbm/configure
+  ...
+  make
+
+But if you plan to modify Netpbm source code, you'll probably find it
+more convenient to build the traditional way, with a single tree for
+source and build.
+
+
 MERGE BUILD
 -----------
 
-- 
cgit 1.4.1