~ruther/guix-local

3bfdf1c3821367539598bfba0640965291c3f360 — Ludovic Courtès 4 years ago d68cc7f
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'.
1 files changed, 8 insertions(+), 14 deletions(-)

M doc/guix.texi
M doc/guix.texi => doc/guix.texi +8 -14
@@ 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}).