From 3bfdf1c3821367539598bfba0640965291c3f360 Mon Sep 17 00:00:00 2001 From: Ludovic Courtès Date: Wed, 15 Dec 2021 00:21:30 +0100 Subject: 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(-) (limited to 'doc') diff --git a/doc/guix.texi b/doc/guix.texi index 2e7e02c701..7b1a64deb9 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{} 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}). -- cgit 1.4.1