summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorGuix Together <jgart@dismail.de>2021-12-16 01:46:49 -0500
committerNicolas Goaziou <mail@nicolasgoaziou.fr>2022-01-28 10:14:56 +0100
commit087ad097da798b2a019b7b469699b09b116d7d74 (patch)
treeabbca5e4ad5a026c95ea32af949781b2e69ba26a /doc
parent3da297997dad5b3525277fcecdca84f01d45b104 (diff)
downloadguix-087ad097da798b2a019b7b469699b09b116d7d74.tar.gz
doc: Explain the use of make clean-go when an ABI mismatch occurs.
* doc/contributing.texi (Building from Git): Adds section on using
make clean-go.

Co-authored-by: jgart <jgart@dismail.de>
Co-authored-by: Julien Lepiller <julien@lepiller.eu>
Co-authored-by: Ryan Prior <rprior@protonmail.com>
Co-authored-by: Blake Shaw <blake@nonconstructivism.com>
Signed-off-by: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Diffstat (limited to 'doc')
-rw-r--r--doc/contributing.texi12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/contributing.texi b/doc/contributing.texi
index 9f97788c0b..f258d79bd2 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -157,6 +157,18 @@ You are advised to run @command{make authenticate} after every
 changes to the repository.
 @end quotation
 
+After updating the repository, @command{make} might fail with an error
+similar to the following example:
+
+@example
+error: failed to load 'gnu/packages/dunst.scm':
+ice-9/eval.scm:293:34: In procedure abi-check: #<record-type <origin>>: record ABI mismatch; recompilation needed
+@end example
+
+This means that one of the record types that Guix defines (in this
+example, the @code{origin} record) has changed, and all of guix needs
+to be recompiled to take that change into account.  To do so, run
+@command{make clean-go} followed by @command{make}.
 
 @node Running Guix Before It Is Installed
 @section Running Guix Before It Is Installed