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: The poor state of documentation of pcase like things. Date: Thu, 24 Dec 2015 20:10:40 +0100 Message-ID: <877fk3d5n3.fsf@web.de> References: <20151216202605.GA3752@acm.fritz.box> <87mvt859cw.fsf@russet.org.uk> <87poy2tqrc.fsf@web.de> <87mvt6nsxr.fsf@russet.org.uk> <87oadmkuwd.fsf@web.de> <874mfenltp.fsf@russet.org.uk> <87oadltfcc.fsf@web.de> <8737uxgdh1.fsf@russet.org.uk> <87poxvivsz.fsf@web.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1450984265 4912 80.91.229.3 (24 Dec 2015 19:11:05 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 24 Dec 2015 19:11:05 +0000 (UTC) Cc: emacs-devel@gnu.org To: phillip.lord@russet.org.uk (Phillip Lord) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Dec 24 20:10:56 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 1aCBHr-0000Wv-Iq for ged-emacs-devel@m.gmane.org; Thu, 24 Dec 2015 20:10:55 +0100 Original-Received: from localhost ([::1]:33128 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aCBHq-0004Hp-Dh for ged-emacs-devel@m.gmane.org; Thu, 24 Dec 2015 14:10:54 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56537) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aCBHn-0004HV-4M for emacs-devel@gnu.org; Thu, 24 Dec 2015 14:10:52 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aCBHi-0000Pq-61 for emacs-devel@gnu.org; Thu, 24 Dec 2015 14:10:51 -0500 Original-Received: from mout.web.de ([212.227.17.12]:50763) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aCBHh-0000PS-Si for emacs-devel@gnu.org; Thu, 24 Dec 2015 14:10:46 -0500 Original-Received: from drachen.dragon ([90.186.2.171]) by smtp.web.de (mrweb101) with ESMTPSA (Nemesis) id 0MhDYL-1ZqPAb1Cfx-00MNWC; Thu, 24 Dec 2015 20:10:44 +0100 In-Reply-To: (John Wiegley's message of "Thu, 24 Dec 2015 09:51:08 -0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-Provags-ID: V03:K0:fnFpXtarctIkSB7/rJXX9h6ob0L6goyUWyZlbvMNdZwMAvvmjNR mlUCrLfzP6lmMUsj1tqBeZToDVJKs1kphUgSC+b6UgswqZTE5uQDyvSireEBSfPHiTY6n+w XZU+acVKIF7PPA2GX2SsrS1tGkyKdfTtINgEUTlEMsRBEkWDdmBsOLl2+NlORyOl6PnpeDM 5O9xjVXeoTL0AcD8FsFVw== X-UI-Out-Filterresults: notjunk:1;V01:K0:RBCSA0gHmxI=:F8hbuHUVYbGRUkUktbLp0V zyufcBZQPYVG+lCYfnZ3fBz6rF8vqYi0T/2BMVIQ2rBWRvfLuHKsprTdBQ3AmkevZYbNdZkzM qAZouc+YVl4iLmAvEOgj0/ePkzWMAtc6sTuTaJ308+Fg3u79VwmhOSC1I3i4LA/gJt5Rtz7S5 cI+nI5POsB1ur9AIn7kpLr0ANH/rahd324BbkxuqH9mK1dg0t2smIRu0lqv7IAwyKyY12UdJy Zc2LuAIR8pN0/O26iS4SjHH0P1CxOohR+O1AW+3qr4RxKBDAwvqTDumbhhAqFmEswgheEdltP oD14Wh5cxa6u6yYFSwX/9ulFxejS+H5D1byosco6EZaMhjRRXtqNwPYda1+mBg9cQg3/Ecc66 wpFzBebtmOrp/Fq/i9VAYK9KxX3+/EUK32DU8IDg2TYPHhlOdfAOftdQxp8Kdl6vOJ2/JirIs pUud3hUbaXe03JG3ZzZiFhZLKy15XlPpbcCK6s9nDZCLOJXwNcInHVurYWrPr0cxDWIbkM7bm oaMFXcJtLFiLhSGIOEqJ1mIfqc44oglrsn0hepyzqt2GLnRMax3njdJbouvu6j7ba/XFLM/za yseK81uH7nK4bdgbdhby+8BzlRHhZU+giZV4OGnptgx4BnrMB89w0iStTyxftNkmj3mADRd6a /LPIOpNfI7bOCwl5I+xjCoqQ0q8PFpdcjeSNDiSpvma/i/avRLsjfNDjm23ZCBjy0ayqBg5AR jvgjUXRCUuzPfCRmyotrTxZ3pGzia9ut0zLus7m9r2xN1FGvxgIJvlCrPXaFSvmgjoPNy8mR X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 212.227.17.12 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:196786 Archived-At: John Wiegley writes: > They are both terrible names. Even knowing exactly what they, they > don't help me to think about pcase. Indeed. The doc of pcase now uses only "QPAT" as name of a meta variable describing the syntax of `. I find that acceptable, but a better name might be good. The manual needs to be updated anyway... though this paragraph: ,---------------------------------------------------------------------- | There are two kinds of patterns involved in =E2=80=98pcase=E2=80=99, c= alled | _U-patterns_ and _Q-patterns_. The UPATTERN mentioned above are | U-patterns and can take the following forms: |=20 | =E2=80=98`QPATTERN=E2=80=99 | [...] `---------------------------------------------------------------------- somewhat makes me smile ;-) Michael.