Merge branch 'micro' into maint
[platform/upstream/automake.git] / PLANS / subdir-objects.txt
index e3aec6b..94c6305 100644 (file)
@@ -2,8 +2,8 @@ Summary
 -------
 
 We want to make the behaviour currently enabled by the 'subdir-objects'
-the default one, and in fact the *only* one, in Automake 1.14.
-See automake bug#13378: <http://debbugs.gnu.org/13351>.
+the default one, and in fact the *only* one, in Automake 2.0.
+See automake bug#13378: <http://debbugs.gnu.org/13378>.
 
 Details
 -------
@@ -24,44 +24,39 @@ Alas, since this also means changing the default behaviour of Automake
 ('subdir-objects' is not enabled by default, sadly), this means the
 transition path will be less smooth than I'd like.
 
-For automake 1.13.2 (ASAP)
---------------------------
+DONE for automake 1.13.2
+------------------------
 
-Fix the bug spotted by Nick Bowler:
+The bug spotted by Nick Bowler:
 
   <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=13378#35>
   <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=13378#44>
 
-and exposed in test case 't/ccnoco4.sh': currently, Automake-generated
-C compilation rules mistakenly pass the "-c -o" options combination
-unconditionally (even to losing compiler) when the 'subdir-objects' is
-used but sources are only present in the top-level directory.
+and exposed in test case 't/ccnoco4.sh' has been fixed (see commit
+v1.13.1-56-g34001a9).  The bug was due to the fact that Automake-generated
+C compilation rules mistakenly passed the "-c -o" options combination
+unconditionally (even to losing compiler) when the 'subdir-objects' was
+used but sources were only present in the top-level directory.
 
-For automake 1.13.2 (with more ease)
-------------------------------------
+DONE for automake 1.14
+----------------------
 
-Give a warning in the category 'unsupported' if the 'subdir-objects'
+We give a warning in the category 'unsupported' if the 'subdir-objects'
 option is not specified.  This should give the users enough forewarning
 about the planned change, and give them time to update their packages
 to the new semantic.
 
-This warning, when there are C sources in subdirs, should also mention the
-need to use AM_PROG_CC_C_O in configure.ac (thanks to Peter Breitenlohner
-for suggesting this).  This is not strictly required, but will make
-things a little simpler for the users, by giving a more complete feedback:
-<http://debbugs.gnu.org/cgi/bugreport.cgi?bug=13378#29>
+We also make sure to avoid the warning when it would be irrelevant, i.e.,
+if all source files sit in "current" directory (thanks to Peter Johansson
+for suggesting this).
 
-Be sure to avoid the warning when it would be irrelevant, i.e., if all
-source files sit in "current" directory (thanks to Peter Johansson for
-suggesting this).
+For automake 2.0
+----------------
 
-For automake 1.14
------------------
+Make the behaviour once activated by the 'subdir-object' option mandatory.
+With that change, we'll drop support for the "old" behaviour of having
+object files derived from sources in a subdirectory being placed in the
+current directory rather than in that same subdirectory.
 
-Flip the 'subdir-object' option on by default.  At the same time,
-drop support for the "old" behaviour of having object files derived
-from sources in a subdirectory being placed in the current directory
-rather than in that same subdirectory.
-
-Still keep the 'subdir-object' option supported (as a simple no-op
+Still keep the 'subdir-objects' option supported (as a simple no-op
 now), to save useless churn in our user's build systems.