aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/forge.skb9
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/forge.skb b/doc/forge.skb
index 68fa2a4..5c388b1 100644
--- a/doc/forge.skb
+++ b/doc/forge.skb
@@ -105,6 +105,15 @@ using ,(code [with-imported-modules]). In addition, it needs a number
of packages which we make available using ,(code [with-packages]). And
finally, within the body of the G-expression, we have commands cloning
the git repository, building the source and running the tests.])
+ (p [The attentive reader may notice what looks like ,(code [(guix
+build utils)]) being referenced twice—once with ,(code
+[with-imported-modules]) and again with ,(code [use-modules]). This is
+not a mistake. G-expressions are serialized into Guile scripts. ,(code
+[with-imported-modules]) ensures that code for ,(code [(guix build
+utils)]) is available and is in the ,(ref :url
+"https://www.gnu.org/software/guile/manual/html_node/Load-Paths.html"
+:text "load path"). ,(code [use-modules]) actually imports ,(code
+[(guix build utils)]) when the script runs.])
(prog (source :language scheme
:file "doc/snippets/tutorial.scm"
:start 11 :stop 22)