From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: phillip.lord@russet.org.uk (Phillip Lord) Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Sat, 19 Dec 2015 22:06:27 +0000 Message-ID: <87zix6m6u4.fsf@russet.org.uk> References: <20151216202605.GA3752@acm.fritz.box> <87fuyytq6b.fsf@web.de> <87y4cqs9vn.fsf@web.de> <87h9jensod.fsf@russet.org.uk> <87k2oakuof.fsf@web.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1450562818 26967 80.91.229.3 (19 Dec 2015 22:06:58 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 19 Dec 2015 22:06:58 +0000 (UTC) Cc: Alan Mackenzie , emacs-devel@gnu.org To: Michael Heerdegen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 19 23:06:52 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 1aAPeN-0003EP-U4 for ged-emacs-devel@m.gmane.org; Sat, 19 Dec 2015 23:06:52 +0100 Original-Received: from localhost ([::1]:38891 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAPeM-0002HJ-RS for ged-emacs-devel@m.gmane.org; Sat, 19 Dec 2015 17:06:50 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57841) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAPe5-0002FF-Bi for emacs-devel@gnu.org; Sat, 19 Dec 2015 17:06:34 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aAPe2-0007IP-4n for emacs-devel@gnu.org; Sat, 19 Dec 2015 17:06:33 -0500 Original-Received: from cheviot22.ncl.ac.uk ([128.240.234.22]:43424) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAPe1-0007I2-VH for emacs-devel@gnu.org; Sat, 19 Dec 2015 17:06:30 -0500 Original-Received: from smtpauth-vm.ncl.ac.uk ([10.8.233.129] helo=smtpauth.ncl.ac.uk) by cheviot22.ncl.ac.uk with esmtp (Exim 4.63) (envelope-from ) id 1aAPdz-0000uh-G5; Sat, 19 Dec 2015 22:06:28 +0000 Original-Received: from cpc6-benw10-2-0-cust45.gate.cable.virginm.net ([92.238.179.46] helo=localhost) by smtpauth.ncl.ac.uk with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.63) (envelope-from ) id 1aAPdz-0006Be-IP; Sat, 19 Dec 2015 22:06:27 +0000 In-Reply-To: <87k2oakuof.fsf@web.de> (Michael Heerdegen's message of "Sat, 19 Dec 2015 22:14:24 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 128.240.234.22 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:196533 Archived-At: Michael Heerdegen writes: > phillip.lord@russet.org.uk (Phillip Lord) writes: > >> I'd also rename "pcase.el" to "p.el" but hey, that's a different >> story. > > and `pcase-let' to `plet' etc. A valid issue IMHO. The standard would be "p-case" and "p-let" I think. A standard (short) suffix for "exhaustive" (which I interpret to mean "must match or error") would be nice also. That would make the entry points p-case p-let p-let* p-dolist p-lambda as well as p-case-ex p-let-ex and so on. Once the semantics of p-lambda is clear, it would probably also make sense to add "p-defun". And possibly "p-macro". Although this would then clash with the current "pcase-macro" which would naturally translate to p-macro also. So, I'd call this "p-defpattern". Against this, there is a slight concern about proliferation of single symbol packages (dash, s, f and the like) in the outside world. Phil