From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: John Wiegley Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Mon, 21 Dec 2015 21:28:03 -0800 Message-ID: References: <20151216202605.GA3752@acm.fritz.box> <877fkatpct.fsf@web.de> <83d1u2v0bw.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1450762155 24031 80.91.229.3 (22 Dec 2015 05:29:15 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 22 Dec 2015 05:29:15 +0000 (UTC) Cc: Michael Heerdegen , acm@muc.de, kaushal.modi@gmail.com, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Dec 22 06:28:59 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 1aBFVK-0000N9-A5 for ged-emacs-devel@m.gmane.org; Tue, 22 Dec 2015 06:28:58 +0100 Original-Received: from localhost ([::1]:48779 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBFVJ-0005U5-6n for ged-emacs-devel@m.gmane.org; Tue, 22 Dec 2015 00:28:57 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50126) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBFUp-0005Oe-Jp for emacs-devel@gnu.org; Tue, 22 Dec 2015 00:28:28 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aBFUo-0000n6-KG for emacs-devel@gnu.org; Tue, 22 Dec 2015 00:28:27 -0500 Original-Received: from mail-pf0-x22e.google.com ([2607:f8b0:400e:c00::22e]:35203) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBFUi-0000jH-3J; Tue, 22 Dec 2015 00:28:20 -0500 Original-Received: by mail-pf0-x22e.google.com with SMTP id 78so27573324pfw.2; Mon, 21 Dec 2015 21:28:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:mail-followup-to:mime-version:content-type; bh=BMlben4zAmODuR+KGT3BYcptEMj8OiehVvlLRQwoMQQ=; b=zCiGcTUmrFjwyiCgz/Ahm4qJdgr2eQ+8zMetiI3AMT82KCz+HKGpkLjSWYsxSWqGBY vNhCMCEbxRr89sVMQyQXVO0pwb9kYo3FiF13rfXmWz8fRG3Xya/+ec+bmfRVbzK495sL LR/ImU53Uehv377BdqNXJmOjvjv8AAZ/5Nj7TRCeUuSbdqQfsW7by1k0nIhS3RIxFMS5 tfeRZ96pjKzJ97vRRPtiYzUwA6loChZUsJoAjxSW0dRbBwI9vE0QrvYnjY1ie5fWHxsf L6k31m9dZFLlUWEAWhf1IPVsCdJau3SzHlwRj2T9MNsCTc3PkXUj5CibwjrxGrWTUwaD kTKQ== X-Received: by 10.98.31.69 with SMTP id f66mr32732709pff.78.1450762099606; Mon, 21 Dec 2015 21:28:19 -0800 (PST) Original-Received: from Vulcan.local (76-234-68-79.lightspeed.frokca.sbcglobal.net. [76.234.68.79]) by smtp.gmail.com with ESMTPSA id zo4sm30399214pac.28.2015.12.21.21.28.12 (version=TLS1 cipher=AES128-SHA bits=128/128); Mon, 21 Dec 2015 21:28:12 -0800 (PST) X-Google-Original-From: "John Wiegley" Original-Received: by Vulcan.local (Postfix, from userid 501) id 5F75A11A46D51; Mon, 21 Dec 2015 21:28:10 -0800 (PST) In-Reply-To: <83d1u2v0bw.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 19 Dec 2015 19:02:11 +0200") User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin) Mail-Followup-To: Eli Zaretskii , Michael Heerdegen , acm@muc.de, emacs-devel@gnu.org, kaushal.modi@gmail.com X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400e:c00::22e 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:196646 Archived-At: >>>>> Eli Zaretskii 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. I'm at least fine with de-emphasizing them. They convey no information at all (is it "Quoted" and "Unquoted"? What does that really mean, since they both have meanings in terms of matching, beyond their quotation level). So in a word, the two terms are almost worst than nothing. I prefer logical and explicit matches, where a logical match compares an entity against some form of query, while an explicit match is the special case of a query by `eq'. -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2