From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.devel Subject: Re: Semantic of pcase `seq' and `map' patterns Date: Sat, 17 Oct 2015 14:21:34 +0200 Message-ID: <876125fzxt.fsf@web.de> References: <87wpyaet7r.fsf@web.de> <87y4iqh7x0.fsf@web.de> <87oajmld49.fsf@gnu.org> <87oajlyif9.fsf@gnu.org> <87a8v53wll.fsf@web.de> <87k2qsxr73.fsf_-_@web.de> <87bnc4mh2q.fsf@petton.fr> <874mhwxne8.fsf_-_@web.de> <87si5gw6f3.fsf@web.de> <87twpwkx8e.fsf@petton.fr> <87mvvow5fr.fsf@web.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1445084518 23057 80.91.229.3 (17 Oct 2015 12:21:58 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 17 Oct 2015 12:21:58 +0000 (UTC) Cc: emacs-devel@gnu.org To: Nicolas Petton Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Oct 17 14:21:49 2015 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1ZnQUf-0002sn-GG for ged-emacs-devel@m.gmane.org; Sat, 17 Oct 2015 14:21:49 +0200 Original-Received: from localhost ([::1]:58144 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZnQUe-0003z8-IV for ged-emacs-devel@m.gmane.org; Sat, 17 Oct 2015 08:21:48 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60448) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZnQUa-0003yv-BG for emacs-devel@gnu.org; Sat, 17 Oct 2015 08:21:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZnQUX-0006v6-8n for emacs-devel@gnu.org; Sat, 17 Oct 2015 08:21:44 -0400 Original-Received: from mout.web.de ([212.227.17.11]:53625) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZnQUX-0006uk-2Z for emacs-devel@gnu.org; Sat, 17 Oct 2015 08:21:41 -0400 Original-Received: from drachen.dragon ([90.186.0.242]) by smtp.web.de (mrweb101) with ESMTPSA (Nemesis) id 0Le4Lg-1aLb7k3Yom-00pqId; Sat, 17 Oct 2015 14:21:37 +0200 In-Reply-To: <87mvvow5fr.fsf@web.de> (Michael Heerdegen's message of "Mon, 12 Oct 2015 16:02:32 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-Provags-ID: V03:K0:rKVJ23xkZxWvwz54Jolp1+jXOr/rfg3xKzUONuWVT8XkNjFKm3R Ov0EAxzaSjon59LtbReXO3aBXrQHAVX3HzjhDaObOHVh2lhcvp8Hm/J7jEKmdKd4KHL+Ind 1BpTFRH8rEkT9UDG6R4k06ZTzrxbghWskaSqXBUfo842+lzSiV9CUXbjW2TarncFO6YK4Xf MFGwYtxn1jkhqtM2fuPeg== X-UI-Out-Filterresults: notjunk:1;V01:K0:fUvrdYnSCvA=:qr00bq36maT+BWkM0jQCBG XSIgsDipdtK/LVc91YJW+x0Hu4MdYAmg2b5arhVrN4M8Bk46M83A1dJQurA1EQwSxWfyUUS2+ /OLUEKYtZmOk7Lsk8m0q1clackHgUW0b/DwrX9uRov6EEQ1+4l2wDV5kjwuxvRAsa4JybeNwk GVaqs+QRsfRvfEyOR5VySoOG7Typ5R8S2s9goib+4g5ZxjuUrpSabuCD8OQLnpMS4OzM/Uh98 2eVhh3Cb38rQXx//Gedv0Q7hXM1+RY9J7UsbW4rXOeSVhZ1FkMRTQ7x50/AEfyL9BfI9e4W9Q uhWPSOVqtB40H3rgqXDHqfqxW+9vqvRKk6DFhUBWpibw4dUNDwmBJn8yauYDxGcpz2q2v0fwZ eVIFKSlVzqTv2eeH7IZQEc8ez+0nBalgTzhw/Pq/dy/sV6Rggl8cO3/ROiLxNdonS5H/t4EN6 8xPEQHIm62DTSf5ao9bolyQr37XEGxXq7ZoRBLwIV0tZYjcdyzQxP6Fe2NzxW/UpkEl1PAlOS 7DWXGrrzbgfYPc4HIY1IBYQgvNeSz/CKHHTow6GUYlRFk63ivi7t3lSCKAnpHO+QpsjUn3UOu NyxvZrX6f3HU6KdPv9VZYL1jFU4jkr9mxYzw7En2XpXDiISpT1jWrgLg19FYUhITXn2ExqT0L 12rplFyZiO3AC1j8tbhrW3e0k8YtOJ22odFCRgmC3lARVBKZHjYnDjK/fC9OZYHd5GAExJ34U EYDFJSm1yYzm1xM1JgcmzBPN11lPeUz59aJkwAyJwY5LZ/gomwI4Yv08G0l+TORGV8fwqJCG X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 212.227.17.11 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:191819 Archived-At: Michael Heerdegen writes: > > Sure, using "&rest": > > So that's missing in the doc of the pcase pattern, too, since it's not > an obvious thing. Thanks for the fixes. But isn't the "&rest" part still missing? And now, the second sentence for the docstring of the `map' pcase pattern says: "Matches if the object is a map (list, hash-table or array), and each PATTERN matches the corresponding elements of the map." where PATTERN is unclear for what it stands. Of course, you can derive it from the context if you think about it, but that should not be necessary. Sorry for being obtrusive. Maybe your changes were not final so far, sorry then. It's just that the docstrings of the `pcase-defmacro' defined stuff are prominently displayed in the help buffer for `pcase', and lots of people have trouble understanding the complex pcase semantic. It shoul be our goal to make the pcase docstring as unambiguous and fluent to read as possible. Thanks, Michael.