From: Alexandre Duret-Lutz <adl@gnu.org>
Date: Tue, 23 Jul 2002 19:57:09 +0000 (+0000)
Subject: * doc/autoconf.texi (Limitations of Make): Mention the special
X-Git-Tag: AUTOCONF-2.53c~48
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=7665fdb00ef2d8493d9aea8cac98aaa41d7ad4a8;p=thirdparty%2Fautoconf.git

* doc/autoconf.texi (Limitations of Make): Mention the special
handling of the obj/ directory by BSD make.
---

diff --git a/ChangeLog b/ChangeLog
index 81538c166..1036c9aac 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2002-07-22  Alexandre Duret-Lutz  <duret_g@epita.fr>
+
+	* doc/autoconf.texi (Limitations of Make): Mention the special
+	handling of the obj/ directory by BSD make.
+
 2002-07-20  Kevin Ryde  <user42@zip.com.au>
 
 	* doc/autoconf.texi (Limitations of Make): Add HP-UX IA-64 trailing
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 3fea6e8d8..74986f874 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -10395,6 +10395,31 @@ all:
         # foo
 @end example
 
+@item The @file{obj/} subdirectory.
+@cindex @file{obj/}, subdirectory
+@cindex BSD make and @file{obj/}
+
+Never name one of your subdirectories @file{obj/} if you don't like
+surprises.
+
+If an @file{obj/} directory exists, BSD make will enter it
+before reading @file{Makefile}.  Hence the @file{Makefile} in the
+current directory will not be read.
+
+@example
+% @kbd{cat Makefile}
+all:
+        echo Hello
+% @kbd{cat obj/Makefile}
+all:
+        echo World
+% @kbd{make}      # GNU make
+echo Hello
+Hello
+% @kbd{pmake}     # BSD make
+echo World
+World
+@end example
 
 @item @code{VPATH}
 @cindex @code{VPATH}