summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPaul Smith <psmith@gnu.org>2013-09-22 17:10:35 -0400
committerPaul Smith <psmith@gnu.org>2013-09-22 17:10:35 -0400
commit1a1624b03ebf0f520758d670545e97867ff1a799 (patch)
tree9d37ecd654330e2208421534e9d2d88896b779f9 /doc
parent6f64c399845d6187cf0bf2b6486e1089ebd239a4 (diff)
downloadmake-1a1624b03ebf0f520758d670545e97867ff1a799.tar.gz
Allow loaded objects to opt out of the "auto-rebuild" feature.
Diffstat (limited to 'doc')
-rw-r--r--doc/make.texi7
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/make.texi b/doc/make.texi
index 62c71910..f89f8b77 100644
--- a/doc/make.texi
+++ b/doc/make.texi
@@ -10910,7 +10910,8 @@ The @code{load} directive and extension capability is considered a
``technology preview'' in this release of GNU make. We encourage you
to experiment with this feature and we appreciate any feedback on it.
However we cannot guarantee to maintain backward-compatibility in the
-next release.
+next release. Consider using GNU Guile instead for extending GNU make
+(@pxref{Guile Function, ,The @code{guile} Function}).
@end quotation
@end cartouche
@@ -10978,7 +10979,9 @@ same directive.
The initializing function will be provided the file name and line
number of the invocation of the @code{load} operation. It should
return a value of type @code{int}, which must be @code{0} on failure
-and non-@code{0} on success.
+and non-@code{0} on success. If the return value is @code{-1}, then
+GNU make will @emph{not} attempt to rebuild the object file
+(@pxref{Remaking Loaded Objects, ,How Loaded Objects Are Remade}).
For example: