GNU bug report logs - #52505
[PATCH 1/2] Guix Documentation Meetup Patches

Previous Next

Full log

Message #11 received at 52505 <at> debbugs.gnu.org (full text, mbox):

From: jgart <jgart <at> dismail.de>
To: 52505 <at> debbugs.gnu.org
Cc: Julien Lepiller <julien <at> lepiller.eu>, Ryan Prior <rprior <at> protonmail.com>,
 Guix Together <jgart <at> dismail.de>, Blake Shaw <blake <at> nonconstructivism.com>
Subject: [PATCH 2/2] doc: Mention how to remedy "source file ... newer than
 compiled error".
Date: Wed, 15 Dec 2021 06:20:42 -0500

From: Guix Together <jgart <at> dismail.de>

* doc/contributing.texi (Running Guix Before It Is Installed): Mention
how to remedy "source file ... newer than compiled" error by running
`make -j`.

Co-authored-by: jgart <jgart <at> dismail.de>
Co-authored-by: Julien Lepiller <julien <at> lepiller.eu>
Co-authored-by: Ryan Prior <rprior <at> protonmail.com>
Co-authored-by: Blake Shaw <blake <at> nonconstructivism.com>
---
 doc/contributing.texi | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 1bcb550aac..fa8dd376d2 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -243,6 +243,24 @@ local source tree; it simply updates the @file{~/.config/guix/current}
 symlink (@pxref{Invoking guix pull}).  Run @command{git pull} instead if
 you want to upgrade your local source tree.
 
+Sometimes, especially if you have recently updated your repository,
+running @command{./pre-inst-env} will print a message similar to the
+following example:
+
+@example
+;;; note: source file /home/user/projects/guix/guix/progress.scm
+;;;       newer than compiled /home/user/projects/guix/guix/progress.go
+@end example
+
+This is only a note and you can safely ignore it. You can get rid of
+the message by running @command{make -j}. Until you do, Guile will run
+slightly slower because it will interpret the code instead of using
+prepared Guile object (@code{.go}) files.
+
+You can run @command{make} automatically as you work using
+@command{watchexec} from the @code{watchexec} package. For example,
+to build again each time you update a package file, you can run
+@command{watchexec -w gnu/packages make -j}.
 
 @node The Perfect Setup
 @section The Perfect Setup
-- 
2.34.0

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.