FYI: Rewrite the m4_include-for-relative-file explanation

[Alexandre Duret-Lutz]

I'm installing this on HEAD.

2004-06-16  Alexandre Duret-Lutz  <address@hidden>

        For Debian Bug#254372:
        * doc/automake.texi (Invoking aclocal): Rewrite the paragraph
        explaining m4_include is used for relative files.

Index: doc/automake.texi
===================================================================
RCS file: /cvs/automake/automake/doc/automake.texi,v
retrieving revision 1.37
diff -u -r1.37 automake.texi
--- doc/automake.texi   31 May 2004 21:28:36 -0000      1.37
+++ doc/automake.texi   16 Jun 2004 19:05:05 -0000
@@ -1505,16 +1505,18 @@
 completely ignored by @command{aclocal}, use @samp{##} as the comment
 leader.
 
-When @command{aclocal} detects that the file containing the macro
-definition is in a subdirectory of your package, it will use
address@hidden instead of copying it; this makes the package
-smaller and eases dependency tracking.  This only works if the
-subdirectory containing the macro was specified as a relative search
-path with @command{aclocal}'s @code{-I} argument.  (@pxref{Local
-Macros} for an example.)  Any macro which is found in a system-wide
-directory, or via an absolute search path will be copied.
+When a file selected by @command{aclocal} is located in a subdirectory
+specified as a relative search path with @command{aclocal}'s @code{-I}
+argument, @command{aclocal} assumes the file belongs to the package
+and uses @code{m4_include} instead of copying it into
address@hidden  This makes the package smaller, eases dependency
+tracking, and cause the file to be distributed automatically.
+(@pxref{Local Macros} for an example.)  Any macro which is found in a
+system-wide directory, or via an absolute search path will be copied.
+So use @code{-I `pwd`/reldir} instead of @code{-I reldir} whenever
+some relative directory need to be considered outside the package.
 
-The contents of @file{acinclude.m4}, if it exists, are also
+The contents of @file{acinclude.m4}, if this file exists, are also
 automatically included in @file{aclocal.m4}.  We recommend against
 using @file{acinclude.m4} in new packages (@pxref{Local Macros}).
 
-- 
Alexandre Duret-Lutz