[Git][NTPsec/ntpsec][master] Add "Caveat for Crossbuilders" to INSTALL.

[Eric S. Raymond]

Eric S. Raymond pushed to branch master at NTPsec / ntpsec


Commits:
dc470214 by Eric S. Raymond at 2017-08-15T15:15:08-04:00
Add "Caveat for Crossbuilders" to INSTALL.

- - - - -


1 changed file:

- INSTALL


Changes:

=====================================
INSTALL
=====================================
--- a/INSTALL
+++ b/INSTALL
@@ -182,6 +182,28 @@ on your system that waf configure doesn't know about - that is,
 other headers always need to be included before it in C programs.
 Please report this as a bug, along with your platform details.
 
+== Caveat for Crossbuilders ==
+
+If you see a build failure with the message "error: No repo or cache
+detected.", you have collided with an unusual feature of our build recipe.
+
+To generate the version.h file, the uses a script called
+'autorevision.sh' which needs one of two preconditions.  Either (1)
+you are building in a local repository clone, or (2) you are building
+from an unpacked release tarball containing a file
+wafhelpers/.autorevision-cache containing version information.
+
+The motivation for this behavior is to have a version string that
+makes sense on every build from either the repository or a release
+tarball.  It means, however, that if you try to build when waf can see
+neither of these things, you'll get the "No repo or cache detected"
+error.  This can happen when atrempting to use a remote buildroot for
+cross-compilation or other purposes
+
+There are a couple of possible workarounds.  One is to do your remote build
+from a release tarball.  Another is to do a ./waf configure and build in the
+source directory before attempting a buildroot build.
+
 == Installation Names ==
 
 By default, `waf install' will install the package's files in



View it on GitLab: https://gitlab.com/NTPsec/ntpsec/commit/dc47021451d47c05a2cb162e1ab6b5e5c81f3314

---
View it on GitLab: https://gitlab.com/NTPsec/ntpsec/commit/dc47021451d47c05a2cb162e1ab6b5e5c81f3314
You're receiving this email because of your account on gitlab.com.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ntpsec.org/pipermail/vc/attachments/20170815/22282a68/attachment.html>