summary refs log tree commit diff
diff options
context:
space:
mode:
authorRichard Sent <richard@freakingpenguin.com>2024-06-17 21:02:29 -0400
committerMaxim Cournoyer <maxim.cournoyer@gmail.com>2024-06-24 08:51:45 -0400
commit5f88f71c2d2a77f136747305c981e431a8601eaa (patch)
treebdd75c1f0b9334b52f9bdbfbaa9fbb3f0f59d4d8
parentfc921acbef5a3864d525020afe524ccc8d66b4b5 (diff)
downloadguix-5f88f71c2d2a77f136747305c981e431a8601eaa.tar.gz
doc: Add message for common error about make check-system.
* doc/contributing.texi (Running the Test Suite): Mention that make clean-go
may need to be run before running make check-system when previous builds were
run with different work trees.

Change-Id: I4b68d3a05f1425505816db969284487d725840d6
Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
Fixes: https://issues.guix.gnu.org/47573.
-rw-r--r--doc/contributing.texi14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/contributing.texi b/doc/contributing.texi
index 880086506f..178659c26f 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -411,6 +411,20 @@ computationally intensive or rather cheap, depending on whether
 substitutes are available for their dependencies (@pxref{Substitutes}).
 Some of them require a lot of storage space to hold VM images.
 
+If you encounter an error like:
+
+@example
+Compiling Scheme modules...
+ice-9/eval.scm:142:16: In procedure compile-top-call:
+error: all-system-tests: unbound variable
+hint: Did you forget `(use-modules (gnu tests))'?
+@end example
+
+@noindent
+there may be inconsistencies in the work tree from previous builds.  To
+resolve this, try running @command{make clean-go} followed by
+@command{make}.
+
 Again in case of test failures, please send @email{bug-guix@@gnu.org}
 all the details.