[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
07/16: doc: cookbook: Add cross-references to the Guile manual.
From: |
guix-commits |
Subject: |
07/16: doc: cookbook: Add cross-references to the Guile manual. |
Date: |
Mon, 25 Nov 2019 18:17:08 -0500 (EST) |
civodul pushed a commit to branch master
in repository guix.
commit 6a893fa8692ef32a1dbef219d87b2336e26f1423
Author: Ludovic Courtès <address@hidden>
Date: Mon Nov 25 22:03:37 2019 +0100
doc: cookbook: Add cross-references to the Guile manual.
* doc/guix-cookbook.texi (A Scheme Crash Course): Add cross-reference to
the Guile manual.
---
doc/guix-cookbook.texi | 19 +++++++++++--------
1 file changed, 11 insertions(+), 8 deletions(-)
diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi
index 0a33efc..7c3860f 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)
- branch master updated (5d297ca -> 54a80b5), guix-commits, 2019/11/25
- 01/16: tests: Avoid (catch 'srfi-34 …) form., guix-commits, 2019/11/25
- 07/16: doc: cookbook: Add cross-references to the Guile manual.,
guix-commits <=
- 06/16: doc: cookbook: Use @result{} & co. instead of a '>' prompt., guix-commits, 2019/11/25
- 03/16: doc: cookbook: Use @lisp for Scheme snippets., guix-commits, 2019/11/25
- 09/16: Use 'offload?' instead of 'build-hook?' internally., guix-commits, 2019/11/25
- 14/16: gnu: Add libdbi., guix-commits, 2019/11/25
- 08/16: guix build, daemon: Rename "--no-build-hook" to "--no-offload"., guix-commits, 2019/11/25
- 12/16: gnu: Add libhx., guix-commits, 2019/11/25
- 10/16: guix build: '--keep-failed' implies '--no-offload'., guix-commits, 2019/11/25
- 02/16: tests: Avoid unnecessary use of 'mock'., guix-commits, 2019/11/25
- 04/16: doc: cookbook: Add cross-reference about ./pre-inst-env., guix-commits, 2019/11/25
- 11/16: daemon: boost::format: Fix typo "referred"., guix-commits, 2019/11/25