summary refs log tree commit diff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2020-10-15 23:50:11 +0200
committerLudovic Courtès <ludo@gnu.org>2020-10-15 23:51:04 +0200
commitc0001b8bfca3409e25bd0e7d8925df2132e91d06 (patch)
treee2eecf97b205215c14cb95bafd0b041d5bacaf1b
parent850a2f7417468b8894d17a5659fac83d06fcce41 (diff)
downloadguix-c0001b8bfca3409e25bd0e7d8925df2132e91d06.tar.gz
doc: cookbook: Clarify what keywords are.
* doc/guix-cookbook.texi (A Scheme Crash Course): Clarify what keywords
are.
-rw-r--r--doc/guix-cookbook.texi6
1 files changed, 4 insertions, 2 deletions
diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi
index 2845391db4..eb73bd33d6 100644
--- a/doc/guix-cookbook.texi
+++ b/doc/guix-cookbook.texi
@@ -250,8 +250,10 @@ definitions.
 @end lisp
 
 @item
-The keyword syntax is @code{#:}; it is used to create unique identifiers.
-@pxref{Keywords,,, guile, GNU Guile Reference Manual}.
+@dfn{Keywords} are typically used to identify the named parameters of a
+procedure.  They are prefixed by @code{#:} (hash, colon) followed by
+alphanumeric characters: @code{#:like-this}.
+@xref{Keywords,,, guile, GNU Guile Reference Manual}.
 
 @item
 The percentage @code{%} is typically used for read-only global variables in