[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
FYI: Rewrite the m4_include-for-relative-file explanation
From: |
Alexandre Duret-Lutz |
Subject: |
FYI: Rewrite the m4_include-for-relative-file explanation |
Date: |
Wed, 16 Jun 2004 21:16:35 +0200 |
User-agent: |
Gnus/5.1003 (Gnus v5.10.3) Emacs/21.3.50 (gnu/linux) |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- FYI: Rewrite the m4_include-for-relative-file explanation,
Alexandre Duret-Lutz <=