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

Previous Next

Package: guix-patches;

Reported by: jgart <jgart <at> dismail.de>

Date: Wed, 15 Dec 2021 11:17:01 UTC

Severity: normal

Tags: patch

Done: Nicolas Goaziou <mail <at> nicolasgoaziou.fr>

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 52505 in the body.
You can then email your comments to 52505 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Wed, 15 Dec 2021 11:17:01 GMT) Full text and rfc822 format available.

Acknowledgement sent to jgart <jgart <at> dismail.de>:
New bug report received and forwarded. Copy sent to guix-patches <at> gnu.org. (Wed, 15 Dec 2021 11:17:02 GMT) Full text and rfc822 format available.

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

From: jgart <jgart <at> dismail.de>
To: Guix Patches <guix-patches <at> gnu.org>
Subject: [PATCH 1/2] Guix Documentation Meetup Patches
Date: Wed, 15 Dec 2021 06:16:23 -0500
Hi Guixers,

We had a great turnout for the first Guix Documentation Meetup.

Here are two patches that we worked on.

Let's keep it going :)

all best,

jgart




Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Wed, 15 Dec 2021 11:22:02 GMT) Full text and rfc822 format available.

Message #8 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 1/2] doc: Explain the use of make clean-go when an ABI
 mismatch occurs.
Date: Wed, 15 Dec 2021 06:20:41 -0500
From: Guix Together <jgart <at> dismail.de>

* doc/contributing.texi (Building from Git): Adds section on using
make clean-go.

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 | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index db1c4c6921..1bcb550aac 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
-- 
2.34.0





Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Wed, 15 Dec 2021 11:22:02 GMT) Full text and rfc822 format available.

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





Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Wed, 15 Dec 2021 12:40:01 GMT) Full text and rfc822 format available.

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

From: zimoun <zimon.toutoune <at> gmail.com>
To: jgart <jgart <at> dismail.de>
Cc: 52505 <at> debbugs.gnu.org, Julien Lepiller <julien <at> lepiller.eu>,
 Ryan Prior <rprior <at> protonmail.com>, Blake Shaw <blake <at> nonconstructivism.com>
Subject: Re: [bug#52505] [PATCH 2/2] doc: Mention how to remedy "source file
 ... newer than compiled error".
Date: Wed, 15 Dec 2021 13:39:25 +0100
Hi,

On Wed, 15 Dec 2021 at 12:36, jgart via Guix-patches via
<guix-patches <at> gnu.org> wrote:
>
> 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(+)

Cool!


> +the message by running @command{make -j}. Until you do, Guile will run

[...]

> +@command{watchexec -w gnu/packages make -j}.

Personally, I would not recommand inside the manual the command "make
-j", but instead "make" or "make -j4" (4 or whatever number); as it
was done in "guix environment" section [1].

1: <https://guix.gnu.org/manual/devel/en/guix.html#Invoking-guix-environment>


Cheers,
simon




Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Wed, 15 Dec 2021 13:09:01 GMT) Full text and rfc822 format available.

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

From: Nicolas Goaziou <mail <at> nicolasgoaziou.fr>
To: jgart via Guix-patches via <guix-patches <at> gnu.org>
Cc: 52505 <at> debbugs.gnu.org, Julien Lepiller <julien <at> lepiller.eu>,
 Ryan Prior <rprior <at> protonmail.com>, jgart <jgart <at> dismail.de>,
 Blake Shaw <blake <at> nonconstructivism.com>
Subject: Re: [bug#52505] [PATCH 1/2] doc: Explain the use of make clean-go
 when an ABI mismatch occurs.
Date: Wed, 15 Dec 2021 14:08:36 +0100
Hello,

jgart via Guix-patches via <guix-patches <at> gnu.org> writes:

> +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
                                                    ^^^
You need to put two spaces at the end of sentences.

Regards,
-- 
Nicolas Goaziou




Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Wed, 15 Dec 2021 13:09:02 GMT) Full text and rfc822 format available.

Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Wed, 15 Dec 2021 13:15:02 GMT) Full text and rfc822 format available.

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

From: Nicolas Goaziou <mail <at> nicolasgoaziou.fr>
To: jgart via Guix-patches via <guix-patches <at> gnu.org>
Cc: 52505 <at> debbugs.gnu.org, Julien Lepiller <julien <at> lepiller.eu>,
 Ryan Prior <rprior <at> protonmail.com>, jgart <jgart <at> dismail.de>,
 Blake Shaw <blake <at> nonconstructivism.com>
Subject: Re: [bug#52505] [PATCH 2/2] doc: Mention how to remedy "source file
 ... newer than compiled error".
Date: Wed, 15 Dec 2021 14:14:13 +0100
Hello,

jgart via Guix-patches via <guix-patches <at> gnu.org> writes:

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

@code{.go} -> @file{.go}

> +You can run @command{make} automatically as you work using
> +@command{watchexec} from the @code{watchexec} package.

I'm not sure about the policy for the packages (assuming there is one).
I think @code{watchexec} should be used for the Guix variable containing
the package, and capitalized Watchexec may be appropriate for the
package name, which may not be the same as the variable.

Anyway, I'm just thinking out loud. In this situation.

> For example, to build again each time you update a package file, you
> can run +@command{watchexec -w gnu/packages make -j}.

According to the Texinfo manual, entire shell commands may use @samp.
@command is for the command name. Thus:

@command{watchexec -w gnu/packages make -j} -> @samp{watchexec -w gnu/packages make -j}

Regards,
-- 
Nicolas Goaziou




Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Wed, 15 Dec 2021 13:15:02 GMT) Full text and rfc822 format available.

Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Wed, 15 Dec 2021 22:37:02 GMT) Full text and rfc822 format available.

Message #29 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 v2 1/2] doc: Explain the use of make clean-go when an ABI
 mismatch occurs.
Date: Wed, 15 Dec 2021 17:34:55 -0500
From: Guix Together <jgart <at> dismail.de>

Hi all,

Here is version 2 with your requested changes. Let me know if there is anything else I might have missed.

Thank you for the review.

all best,

jgart

* doc/contributing.texi (Building from Git): Adds section on using
make clean-go.

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 | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index db1c4c6921..164e353884 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
-- 
2.34.0





Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Wed, 15 Dec 2021 22:37:02 GMT) Full text and rfc822 format available.

Message #32 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 v2 2/2] doc: Mention how to remedy "source file ... newer than
 compiled error".
Date: Wed, 15 Dec 2021 17:34:56 -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 164e353884..a9bb310dab 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 -j4}. Until you do, Guile will run
+slightly slower because it will interpret the code instead of using
+prepared Guile object (@file{.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
+@samp{watchexec -w gnu/packages make -j4}.
 
 @node The Perfect Setup
 @section The Perfect Setup
-- 
2.34.0





Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Thu, 16 Dec 2021 06:49:01 GMT) Full text and rfc822 format available.

Message #35 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 v3 1/2] doc: Explain the use of make clean-go when an ABI
 mismatch occurs.
Date: Thu, 16 Dec 2021 01:46:49 -0500
From: Guix Together <jgart <at> dismail.de>

Hi Guixers,

Here is version 3 of our Documentation patchset. 

Ryan had pointed out some other "two spaces after sentence" issues offlist.

all best,

jgart

* doc/contributing.texi (Building from Git): Adds section on using
make clean-go.

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 | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index db1c4c6921..164e353884 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
-- 
2.34.0





Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Thu, 16 Dec 2021 06:50:02 GMT) Full text and rfc822 format available.

Message #38 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 v3 2/2] doc: Mention how to remedy "source file ... newer than
 compiled error".
Date: Thu, 16 Dec 2021 01:46:50 -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 164e353884..f3182b1564 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 -j4}.  Until you do, Guile will run
+slightly slower because it will interpret the code instead of using
+prepared Guile object (@file{.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
+@samp{watchexec -w gnu/packages make -j4}.
 
 @node The Perfect Setup
 @section The Perfect Setup
-- 
2.34.0





Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Fri, 28 Jan 2022 09:17:01 GMT) Full text and rfc822 format available.

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

From: Nicolas Goaziou <mail <at> nicolasgoaziou.fr>
To: jgart via Guix-patches via <guix-patches <at> gnu.org>
Cc: 52505-done <at> debbugs.gnu.org, jgart <jgart <at> dismail.de>
Subject: Re: [bug#52505] [PATCH 1/2] Guix Documentation Meetup Patches
Date: Fri, 28 Jan 2022 10:16:07 +0100
Hello,

jgart via Guix-patches via <guix-patches <at> gnu.org> writes:

> Here are two patches that we worked on.

Applied v3. Thank you!

Regards,
-- 
Nicolas Goaziou




Reply sent to Nicolas Goaziou <mail <at> nicolasgoaziou.fr>:
You have taken responsibility. (Fri, 28 Jan 2022 09:17:02 GMT) Full text and rfc822 format available.

Notification sent to jgart <jgart <at> dismail.de>:
bug acknowledged by developer. (Fri, 28 Jan 2022 09:17:02 GMT) Full text and rfc822 format available.

Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Thu, 03 Feb 2022 00:44:02 GMT) Full text and rfc822 format available.

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

From: jgart <jgart <at> dismail.de>
To: Nicolas Goaziou <mail <at> nicolasgoaziou.fr>
Cc: 52505-done <at> debbugs.gnu.org,
 jgart via Guix-patches via <guix-patches <at> gnu.org>
Subject: Re: [bug#52505] [PATCH 1/2] Guix Documentation Meetup Patches
Date: Wed, 2 Feb 2022 19:43:08 -0500
On Fri, 28 Jan 2022 10:16:07 +0100 Nicolas Goaziou <mail <at> nicolasgoaziou.fr> wrote:
> Hello,
> 
> jgart via Guix-patches via <guix-patches <at> gnu.org> writes:
> 
> > Here are two patches that we worked on.
> 
> Applied v3. Thank you!

Thanks Nicolas!

much appreciated,

jgart




Information forwarded to guix-patches <at> gnu.org:
bug#52505; Package guix-patches. (Thu, 03 Feb 2022 00:44:02 GMT) Full text and rfc822 format available.

bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Thu, 03 Mar 2022 12:24:05 GMT) Full text and rfc822 format available.

This bug report was last modified 2 years and 27 days ago.

Previous Next


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