diff options
author | Ludovic Courtès <ludo@gnu.org> | 2021-12-15 00:21:30 +0100 |
---|---|---|
committer | Ludovic Courtès <ludo@gnu.org> | 2021-12-15 00:41:08 +0100 |
commit | 3bfdf1c3821367539598bfba0640965291c3f360 (patch) | |
tree | a83b4958c772b403d3e514268a5f39427b2a0a4a /doc/guix.texi | |
parent | d68cc7fe96c308775138c5af8aaf4436d35beb41 (diff) | |
download | guix-3bfdf1c3821367539598bfba0640965291c3f360.tar guix-3bfdf1c3821367539598bfba0640965291c3f360.tar.gz |
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'.
Diffstat (limited to 'doc/guix.texi')
-rw-r--r-- | doc/guix.texi | 22 |
1 files changed, 8 insertions, 14 deletions
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{<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}). |