From 5f88f71c2d2a77f136747305c981e431a8601eaa Mon Sep 17 00:00:00 2001 From: Richard Sent Date: Mon, 17 Jun 2024 21:02:29 -0400 Subject: 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 Fixes: https://issues.guix.gnu.org/47573. --- doc/contributing.texi | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'doc') 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. -- cgit v1.2.3