diff options
Diffstat (limited to 'doc/automake.texi')
| -rw-r--r-- | doc/automake.texi | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/doc/automake.texi b/doc/automake.texi index 738eb84cb..91e1d679a 100644 --- a/doc/automake.texi +++ b/doc/automake.texi @@ -7361,11 +7361,11 @@ rule to build @file{foo.h} first by lack of dependency information. @cindex @code{BUILT_SOURCES}, defined The @code{BUILT_SOURCES} variable is a workaround for this problem. A -source file listed in @code{BUILT_SOURCES} is made on @samp{make all} -or @samp{make check} (or even @samp{make install}) before other -targets are processed. However, such a source file is not -@emph{compiled} unless explicitly requested by mentioning it in some -other @code{_SOURCES} variable. +source file listed in @code{BUILT_SOURCES} is made when @samp{make +all}, @samp{make check}, @samp{make install}, @samp{make install-exec} +(or @code{make dist}) is run, before other targets are processed. +However, such a source file is not @emph{compiled} unless explicitly +requested by mentioning it in some other @code{_SOURCES} variable. So, to conclude our introductory example, we could use @samp{BUILT_SOURCES = foo.h} to ensure @file{foo.h} gets built before @@ -7380,12 +7380,12 @@ doesn't need to appear in @code{BUILT_SOURCES} (unless it is included by another source), because it's a known dependency of the associated object. -It might be important to emphasize that @code{BUILT_SOURCES} is -honored only by @samp{make all}, @samp{make check} and @samp{make -install}. This means you cannot build a specific target (e.g., -@samp{make foo}) in a clean tree if it depends on a built source. -However it will succeed if you have run @samp{make all} earlier, -because accurate dependencies are already available. +To emphasize, @code{BUILT_SOURCES} is honored only by @samp{make all}, +@samp{make check}, @samp{make install}, and @code{make install-exec} +(and @samp{make dist}). This means you cannot build an arbitrary +target (e.g., @samp{make foo}) in a clean tree if it depends on a +built source. However it will succeed if you have run @samp{make all} +earlier, because accurate dependencies are already available. The next section illustrates and discusses the handling of built sources on a toy example. |