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: Sat, 19 Dec 2015 19:02:11 +0200 Message-ID: <83d1u2v0bw.fsf@gnu.org> References: <20151216202605.GA3752@acm.fritz.box> <877fkatpct.fsf@web.de> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1450544531 1785 80.91.229.3 (19 Dec 2015 17:02:11 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 19 Dec 2015 17:02:11 +0000 (UTC) Cc: acm@muc.de, emacs-devel@gnu.org, kaushal.modi@gmail.com To: Michael Heerdegen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 19 18:02:06 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 1aAKtR-0000n5-8U for ged-emacs-devel@m.gmane.org; Sat, 19 Dec 2015 18:02:05 +0100 Original-Received: from localhost ([::1]:38045 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAKtQ-0004Jx-10 for ged-emacs-devel@m.gmane.org; Sat, 19 Dec 2015 12:02:04 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47572) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAKtC-0004Gf-GH for emacs-devel@gnu.org; Sat, 19 Dec 2015 12:01:51 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aAKt9-0004uL-C9 for emacs-devel@gnu.org; Sat, 19 Dec 2015 12:01:50 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:43913) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aAKt9-0004uF-92; Sat, 19 Dec 2015 12:01:47 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3725 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aAKt8-0000qG-BR; Sat, 19 Dec 2015 12:01:46 -0500 In-reply-to: <877fkatpct.fsf@web.de> (message from Michael Heerdegen on Sat, 19 Dec 2015 16:44:34 +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:196512 Archived-At: > From: Michael Heerdegen > Date: Sat, 19 Dec 2015 16:44:34 +0100 > Cc: Alan Mackenzie , Emacs developers > > John Wiegley writes: > > I think we should not emphasize QPatterns and UPatterns too much, > because today, ``' is just a pcase macro. When not using ``' is pcase, > we speak of just PATTERNs. If we want to do that, we need to rewrite both the ELisp manual and the doc string to never use these. With the current text of the manual, you simply cannot ignore them. (Personally, I think trying to stop using them is futile, since so many people who actively use 'pcase' use these terms freely in their messages and other text they write. But that's me.) > If there are still examples like > > > (pcase value > > (`1 (message "Matched a 1")) > > (`2 (message "Matched a 2")) > > (`"Hello" (message "Matched the string Hello"))) > > in the info manual, they should be changed to not use backquote. There are quite a few of these there.