aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorArun Isaac2022-03-21 11:24:56 +0530
committerArun Isaac2022-03-21 11:24:56 +0530
commit37adb811e9b28b06d958ea7183e85b46f384c0cd (patch)
tree49666e32373ebceab09d8540aa3ff72fa52c7281
parentb77ed6489b38a6061617e1358a85872485f4038b (diff)
downloadguix-forge-37adb811e9b28b06d958ea7183e85b46f384c0cd.tar.gz
guix-forge-37adb811e9b28b06d958ea7183e85b46f384c0cd.tar.lz
guix-forge-37adb811e9b28b06d958ea7183e85b46f384c0cd.zip
doc: Clarify double reference of (guix build utils).
* doc/forge.skb (Tutorial): Clarify double reference of (guix build utils).
-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)