Subject: [PATCH v3 3/5] gnu: guile-g-golf: Document --no-grafts requirement.

From: Florian Pelz <[email-masked]>
Date: Mon, 17 Feb 2025 11:01:42 +0100

Note that packages are unaffected.

* gnu/packages/guile-xyz.scm: Tell about grafts bug.

Change-Id: Ic0b2c63daa07c693171965d90410aef5a2e41d49
---
 gnu/packages/guile-xyz.scm | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/gnu/packages/guile-xyz.scm b/gnu/packages/guile-xyz.scm
index 921d8b46d6..9877e01748 100644
--- a/gnu/packages/guile-xyz.scm
+++ b/gnu/packages/guile-xyz.scm
@@ -2603,7 +2603,12 @@ (define-public guile-g-golf
 modern applications in Guile Scheme.  It comprises a direct binding to the
 GObject Introspection API and higher-level functionality for importing Gnome
 libraries and making GObject classes (and methods) available in Guile's
-object-oriented programming system, GOOPS.")
+object-oriented programming system, GOOPS.
+
+Note: Currently, when developing with G-Golf in @code{guix shell}, there is a
+@uref{https://bugs.gnu.org/75157, grafts bug in Guix}.  To avoid it, use Guix'
+@code{--no-grafts} option.  Guix packages that use @code{wrap-program} are
+unaffected.")
     (license license:lgpl3+)))
 
 (define-public g-golf
-- 
2.48.1