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.
This commit is contained in:
Richard Sent 2024-06-17 21:02:29 -04:00 committed by Maxim Cournoyer
parent fc921acbef
commit 5f88f71c2d
No known key found for this signature in database
GPG key ID: 1260E46482E63562

View file

@ -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.