diff mbox series

[bug#60392,2/2] doc: give example of when to use describe in .guix-channel file

Message ID 2179575812ab418c3a98f102d2d4448b64c20b87.1672270580.git.karl@hallsby.com
State New
Headers show
Series : describe .guix-channel directory field | expand

Commit Message

Karl Hallsby Dec. 28, 2022, 11:40 p.m. UTC
---
 doc/guix.texi | 5 +++++
 1 file changed, 5 insertions(+)
diff mbox series

Patch

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