mirror of
https://git.in.rschanz.org/ryan77627/guix.git
synced 2024-12-24 05:18:07 -05:00
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'.
This commit is contained in:
parent
d68cc7fe96
commit
3bfdf1c382
1 changed files with 8 additions and 14 deletions
|
@ -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}).
|
||||
|
|
Loading…
Reference in a new issue