[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] fix/bug-31311-pcase-doc b93c07e 3/3: (docstring) add inlin
From: |
Thien-Thi Nguyen |
Subject: |
[Emacs-diffs] fix/bug-31311-pcase-doc b93c07e 3/3: (docstring) add inline Issue re sub-patterns of structural patterns |
Date: |
Sat, 12 May 2018 06:48:18 -0400 (EDT) |
branch: fix/bug-31311-pcase-doc
commit b93c07ef0266d5cf88eae51e184ad9abf7112f1a
Author: Thien-Thi Nguyen <address@hidden>
Commit: Thien-Thi Nguyen <address@hidden>
(docstring) add inline Issue re sub-patterns of structural patterns
OT1H, nested lists (e.g.) can be considered a "structural pattern
w/o leading backquote". OTOH, that "w/o leading backquote" is lame.
Maybe resolution is: Limit "begins w/ backquote" to top-level.
---
lisp/emacs-lisp/pcase.el | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/lisp/emacs-lisp/pcase.el b/lisp/emacs-lisp/pcase.el
index 4cdde70..3628e8a 100644
--- a/lisp/emacs-lisp/pcase.el
+++ b/lisp/emacs-lisp/pcase.el
@@ -145,7 +145,11 @@ FUN can refer to variables bound earlier in the pattern.
On the other hand, a structural pattern specifies a template,
and allows for elements of that template to be either constants
-or sub-patterns (of either category). A structural pattern
+or sub-patterns (of either category).
+
+ Issue: Is ``of either category'' correct?
+
+A structural pattern
begins with `backquote' and logical sub-pattern elements are
introduced by a comma. For example: