summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2019-11-25 22:03:37 +0100
committerLudovic Courtès <ludo@gnu.org>2019-11-26 00:16:36 +0100
commit6a893fa8692ef32a1dbef219d87b2336e26f1423 (patch)
tree83a110cb78bde94e5194036f35a0704639292131 /doc
parentcf1e6f5f9016b3471f10581ee840c26398f44736 (diff)
downloadpatches-6a893fa8692ef32a1dbef219d87b2336e26f1423.tar
patches-6a893fa8692ef32a1dbef219d87b2336e26f1423.tar.gz
doc: cookbook: Add cross-references to the Guile manual.
* doc/guix-cookbook.texi (A Scheme Crash Course): Add cross-reference to the Guile manual.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix-cookbook.texi19
1 files changed, 11 insertions, 8 deletions
diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi
index 0a33efc73a..7c3860fbf5 100644
--- a/doc/guix-cookbook.texi
+++ b/doc/guix-cookbook.texi
@@ -187,9 +187,10 @@ A list structure can be created with the @code{list} procedure:
@end lisp
@item
-The @emph{quote} disables evaluation of a parenthesized expression: the first
-term is not called over the other terms. Thus it effectively returns a list
-of terms.
+The @dfn{quote} disables evaluation of a parenthesized expression: the
+first term is not called over the other terms (@pxref{Expression Syntax,
+quote,, guile, GNU Guile Reference Manual}). Thus it effectively
+returns a list of terms.
@lisp
'(display (string-append "Hello " "Guix" "\n"))
@@ -200,9 +201,9 @@ of terms.
@end lisp
@item
-The @dfn{quasiquote} disables evaluation of a parenthesized expression until
-a comma re-enables it. Thus it provides us with fine-grained control over
-what is evaluated and what is not.
+The @dfn{quasiquote} disables evaluation of a parenthesized expression
+until @dfn{unquote} (a comma) re-enables it. Thus it provides us with
+fine-grained control over what is evaluated and what is not.
@lisp
`(2 a 5 7 (2 ,a 5 ,(+ a 4)))
@@ -213,7 +214,8 @@ Note that the above result is a list of mixed elements: numbers, symbols (here
@code{a}) and the last element is a list itself.
@item
-Multiple variables can be named locally with @code{let}:
+Multiple variables can be named locally with @code{let} (@pxref{Local
+Bindings,,, guile, GNU Guile Reference Manual}):
@lisp
(define x 10)
@@ -249,7 +251,8 @@ the build stage. Note that it is merely a convention, like @code{_} in C.
Scheme treats @code{%} exactly the same as any other letter.
@item
-Modules are created with @code{define-module}. For instance
+Modules are created with @code{define-module} (@pxref{Creating Guile
+Modules,,, guile, GNU Guile Reference Manual}). For instance
@lisp
(define-module (guix build-system ruby)