Subject: [bug#76109] [PATCH] doc: Mention --check --no-grafts as a way to force-rebuild packages.

From: Rostislav Svoboda <[email-masked]>
Date: Fri, 7 Feb 2025 02:23:20 +0100

Adjusted! A new patch is attached.

Le ven. 7 févr. 2025 à 01:05, Leo Famulari <[email-masked]> a écrit :
>
> On Fri, Feb 07, 2025 at 12:43:36AM +0100, Rostislav Svoboda wrote:
> > * doc/guix.texi (On Trusting Binaries): Document that combining --check and
> > --no-grafts with 'guix build' forces the rebuild of a package.
>
> Thanks, this is really useful information that most people have had to
> learn by asking.
>
> > +@command{guix build --check}}).  To force a full rebuild of a package
> > +(ignoring security updates via grafts), use @option{--check} together
> > +with @option{--no-grafts} (@pxref{Common Build Options,
> > +@option{--no-grafts}}).
>
> Grafts are not always present in the codebase (hard to believe, I know),
> so can you adjust it to something like "(ignoring security updates via
> grafts, which are often present)"?
From 836a004c63236e76416702a50d9c2870644fe110 Mon Sep 17 00:00:00 2001
Message-ID: <836a004c6[email-masked]>
From: Rostislav Svoboda <[email-masked]>
Date: Thu, 6 Feb 2025 23:55:44 +0100
Subject: [PATCH] doc: Mention --check --no-grafts as a way to force-rebuild
 packages.

* doc/guix.texi (On Trusting Binaries): Document that combining --check and
--no-grafts with 'guix build' forces the rebuild of a package.

Change-Id: I4eb6be04243a52f70d0fc298f76e62f10e3d376e
---
 doc/guix.texi | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 9f1e4bf0f0..91f5a9e38b 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -3978,7 +3978,11 @@ On Trusting Binaries
 challenge}).  Similarly, the @option{--check} option of @command{guix
 build} allows users to check whether previously-installed substitutes
 are genuine by rebuilding them locally (@pxref{build-check,
-@command{guix build --check}}).
+@command{guix build --check}}).  To force a full rebuild of a package
+(ignoring security updates via grafts, if any grafts exist—which is
+not always the case), use @option{--check} together with
+@option{--no-grafts} (@pxref{Common Build Options,
+@option{--no-grafts}}).
 
 In the future, we want Guix to have support to publish and retrieve
 binaries to/from other users, in a peer-to-peer fashion.  If you would

base-commit: 8cf5eefbf3ca634fce98a832fc90e84ce91ef9d4
-- 
2.48.1