procyberian/emacs
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; Improve cross-references in description of 'pcase'

Browse source 
* doc/lispref/control.texi (pcase Macro, Backquote Patterns):
Improve cross-references.
This commit is contained in:
Eli Zaretskii 2023-11-16 21:55:10 +02:00
parent 42181b65df
commit c20ae7a30f
1 changed files with 6 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

7
doc/lispref/control.texi
View file

@ -597,6 +597,10 @@ Two symbols to avoid are @code{t}, which behaves like @code{_}
Likewise, it makes no sense to bind keyword symbols Likewise, it makes no sense to bind keyword symbols
(@pxref{Constant Variables}). (@pxref{Constant Variables}).
@item `@var{qpat}
A backquote-style pattern. @xref{Backquote Patterns}, for the
details.
@item (cl-type @var{type}) @item (cl-type @var{type})
Matches if @var{expval} is of type @var{type}, which is a type Matches if @var{expval} is of type @var{type}, which is a type
descriptor as accepted by @code{cl-typep} (@pxref{Type Predicates,,,cl,Common descriptor as accepted by @code{cl-typep} (@pxref{Type Predicates,,,cl,Common
@ -1235,7 +1239,8 @@ The first three clauses use backquote-style patterns.
@code{`(add ,x ,y)} is a pattern that checks that @code{form} @code{`(add ,x ,y)} is a pattern that checks that @code{form}
is a three-element list starting with the literal symbol @code{add}, is a three-element list starting with the literal symbol @code{add},
then extracts the second and third elements and binds them then extracts the second and third elements and binds them
to symbols @code{x} and @code{y}, respectively. to symbols @code{x} and @code{y}, respectively. This is known as
@dfn{destructuring}, see @ref{Destructuring with pcase Patterns}.
The clause body evaluates @code{x} and @code{y} and adds the results. The clause body evaluates @code{x} and @code{y} and adds the results.
Similarly, the @code{call} clause implements a function call, Similarly, the @code{call} clause implements a function call,
and the @code{fn} clause implements an anonymous function definition. and the @code{fn} clause implements an anonymous function definition.