GNU bug report logs - #60392
[PATCH 0/2] [DOCUMENTATION]: describe .guix-channel directory field

Previous Next

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

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

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

From: Karl Hallsby <karl <at> hallsby.com>
To: guix-patches <at> debbugs.gnu.org,
	guix-patches <at> gnu.org
Cc: Karl Hallsby <karl <at> hallsby.com>
Subject: [PATCH 0/2] [DOCUMENTATION]: describe .guix-channel directory field
Date: Wed, 28 Dec 2022 17:39:32 -0600

This patch series includes additional information about why one would want to
use the directory field of the .guix-channel file for a channel, and some 
nuances that come from it.

Karl Hallsby (2):
  doc: describe format of channel that uses directory field
  doc: give example of when to use describe in .guix-channel file

 doc/guix.texi | 11 +++++++++++
 1 file changed, 11 insertions(+)


base-commit: 4ca649e978f08335fcabdcef693a7049082b5373
-- 
2.37.1

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

From: Karl Hallsby <karl <at> hallsby.com>
To: 60392 <at> debbugs.gnu.org,
	guix-patches <at> gnu.org
Cc: Karl Hallsby <karl <at> hallsby.com>
Subject: [PATCH 1/2] doc: describe format of channel that uses directory field
Date: Wed, 28 Dec 2022 17:40:58 -0600

---
 doc/guix.texi | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 053cd1ad41..7c02e2d392 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -5614,6 +5614,12 @@ add a meta-data file @file{.guix-channel} that contains:
   (directory "guix"))
 @end lisp
 
+The modules must be @b{underneath} the specified directory, as the
+@code{directory} changes Guile's @code{load-path}.  For example, if
+@file{.guix-channel} has @code{(directory "base")}, then a module
+defined as @code{(define-module (gnu packages fun))} must be located at
+@code{base/gnu/packages/fun.scm}.
+
 @node Declaring Channel Dependencies
 @section Declaring Channel Dependencies
 
-- 
2.37.1

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

From: Karl Hallsby <karl <at> hallsby.com>
To: 60392 <at> debbugs.gnu.org,
	guix-patches <at> gnu.org
Cc: Karl Hallsby <karl <at> hallsby.com>
Subject: [PATCH 2/2] doc: give example of when to use describe in
 .guix-channel file
Date: Wed, 28 Dec 2022 17:40:59 -0600

---
 doc/guix.texi | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 7c02e2d392..cb9d1d685c 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -5620,6 +5620,11 @@ The modules must be @b{underneath} the specified directory, as the
 defined as @code{(define-module (gnu packages fun))} must be located at
 @code{base/gnu/packages/fun.scm}.
 
+Doing this allows for only parts of a repository to be used as a
+channel, as Guix looks for valid Guile modules when pulling. For
+instance, by default @command{guix deploy} machine configuration files
+are not valid Guile modules, making @command{guix pull} fail.
+
 @node Declaring Channel Dependencies
 @section Declaring Channel Dependencies
 
-- 
2.37.1

Message #22 received at 60392-done <at> debbugs.gnu.org (full text, mbox):

From: Ricardo Wurmus <rekado <at> elephly.net>
To: 60392-done <at> debbugs.gnu.org
Subject: [PATCH 0/2] [DOCUMENTATION]: describe .guix-channel directory field
Date: Thu, 29 Dec 2022 20:02:11 +0100

Thank you for the patches!  I reworded the commit message and changed
the text of the example slightly before pushing.

Thanks!

-- 
Ricardo

Previous Next

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