From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Sun, 03 Jan 2016 05:45:42 +0200 Message-ID: <83twmv9vh5.fsf@gnu.org> References: <20151216202605.GA3752@acm.fritz.box> <87io3m60bq.fsf@web.de> <877fk1nnk0.fsf@web.de> <8760zlue3j.fsf@gmail.com> <87vb7kajgv.fsf@web.de> <83y4c9ag06.fsf@gnu.org> <87bn95m9eg.fsf@fencepost.gnu.org> <5686CDFB.2010105@dancol.org> <83fuygcs5g.fsf@gnu.org> <87r3i0l6oq.fsf@fencepost.gnu.org> <87si2fwm38.fsf@web.de> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1451792765 24746 80.91.229.3 (3 Jan 2016 03:46:05 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 3 Jan 2016 03:46:05 +0000 (UTC) Cc: dak@gnu.org, dancol@dancol.org, emacs-devel@gnu.org To: Michael Heerdegen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jan 03 04:46:00 2016 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 1aFZcG-0001w9-BV for ged-emacs-devel@m.gmane.org; Sun, 03 Jan 2016 04:46:00 +0100 Original-Received: from localhost ([::1]:40398 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFZcF-0001YT-HP for ged-emacs-devel@m.gmane.org; Sat, 02 Jan 2016 22:45:59 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40441) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFZcC-0001YM-Jy for emacs-devel@gnu.org; Sat, 02 Jan 2016 22:45:57 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aFZc9-0000K1-EU for emacs-devel@gnu.org; Sat, 02 Jan 2016 22:45:56 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:33590) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFZc9-0000Jx-B2; Sat, 02 Jan 2016 22:45:53 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2137 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aFZc7-0002xs-LF; Sat, 02 Jan 2016 22:45:52 -0500 In-reply-to: <87si2fwm38.fsf@web.de> (message from Michael Heerdegen on Sun, 03 Jan 2016 01:19:55 +0100) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e 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:197407 Archived-At: > From: Michael Heerdegen > Cc: Eli Zaretskii , Daniel Colascione , emacs-devel@gnu.org > Date: Sun, 03 Jan 2016 01:19:55 +0100 > > I don't see how a pcase used like a cl-case - as in the quoted example - > is any harder to read or understand. Are you serious? We've just had a long discussion about its missing or incomplete or inadequate documentation, including a long dispute about whether it would be better to quote _. My summary of that discussion is that the syntax is complicated and quite weird. Using such a beast where it is not required makes reading harder because it requires the reader to understand its syntax, if nothing else.