guix-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

03/04: doc: Do not explain quote/quasiquote in the context of inputs.


From: guix-commits
Subject: 03/04: doc: Do not explain quote/quasiquote in the context of inputs.
Date: Tue, 14 Dec 2021 18:42:24 -0500 (EST)

civodul pushed a commit to branch master
in repository guix.

commit 3bfdf1c3821367539598bfba0640965291c3f360
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Wed Dec 15 00:21:30 2021 +0100

    doc: Do not explain quote/quasiquote in the context of inputs.
    
    * doc/guix.texi (Defining Packages): Move reference to
    quote/quasiquote from 'inputs' to 'arguments'.
---
 doc/guix.texi | 22 ++++++++--------------
 1 file changed, 8 insertions(+), 14 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 2e7e02c..7b1a64d 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -6999,8 +6999,16 @@ The @code{arguments} field specifies options for the 
build system
 @cindex quoting
 @findex '
 @findex quote
+@cindex backquote (quasiquote)
+@findex `
+@findex quasiquote
+@cindex comma (unquote)
+@findex ,
+@findex unquote
 What about these quote (@code{'}) characters?  They are Scheme syntax to
 introduce a literal list; @code{'} is synonymous with @code{quote}.
+Sometimes you'll also see @code{`} (a backquote, synonymous with
+@code{quasiquote}) and @code{,} (a comma, synonymous with @code{unquote}).
 @xref{Expression Syntax, quoting,, guile, GNU Guile Reference Manual},
 for details.  Here the value of the @code{arguments} field is a list of
 arguments passed to the build system down the road, as with @code{apply}
@@ -7019,20 +7027,6 @@ build-time or run-time dependencies of the package.  
Here, we add
 an input, a reference to the @code{gawk}
 variable; @code{gawk} is itself bound to a @code{<package>} object.
 
-@cindex backquote (quasiquote)
-@findex `
-@findex quasiquote
-@cindex comma (unquote)
-@findex ,
-@findex unquote
-@findex ,@@
-@findex unquote-splicing
-Again, @code{`} (a backquote, synonymous with @code{quasiquote}) allows
-us to introduce a literal list in the @code{inputs} field, while
-@code{,} (a comma, synonymous with @code{unquote}) allows us to insert a
-value in that list (@pxref{Expression Syntax, unquote,, guile, GNU Guile
-Reference Manual}).
-
 Note that GCC, Coreutils, Bash, and other essential tools do not need to
 be specified as inputs here.  Instead, @code{gnu-build-system} takes care
 of ensuring that they are present (@pxref{Build Systems}).



reply via email to

[Prev in Thread] Current Thread [Next in Thread]