From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Philipp Stephani Newsgroups: gmane.emacs.bugs Subject: bug#20642: 24.5; Please improve documentation for `pcase' Date: Sun, 21 Jun 2015 13:08:34 +0000 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=f46d041828465e5325051906db61 X-Trace: ger.gmane.org 1434892167 11312 80.91.229.3 (21 Jun 2015 13:09:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 21 Jun 2015 13:09:27 +0000 (UTC) Cc: 20642@debbugs.gnu.org To: Stefan Monnier Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jun 21 15:09:19 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1Z6ezu-0007jG-HP for geb-bug-gnu-emacs@m.gmane.org; Sun, 21 Jun 2015 15:09:18 +0200 Original-Received: from localhost ([::1]:36308 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z6ezt-00051K-Sr for geb-bug-gnu-emacs@m.gmane.org; Sun, 21 Jun 2015 09:09:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55077) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z6ezp-0004xF-0y for bug-gnu-emacs@gnu.org; Sun, 21 Jun 2015 09:09:14 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z6ezf-0007Ar-EY for bug-gnu-emacs@gnu.org; Sun, 21 Jun 2015 09:09:12 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:51652) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z6ezf-0007Al-B4 for bug-gnu-emacs@gnu.org; Sun, 21 Jun 2015 09:09:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Z6ezf-0006BC-5M for bug-gnu-emacs@gnu.org; Sun, 21 Jun 2015 09:09:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Philipp Stephani Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 21 Jun 2015 13:09:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20642 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 20642-submit@debbugs.gnu.org id=B20642.143489213323727 (code B ref 20642); Sun, 21 Jun 2015 13:09:03 +0000 Original-Received: (at 20642) by debbugs.gnu.org; 21 Jun 2015 13:08:53 +0000 Original-Received: from localhost ([127.0.0.1]:53097 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z6ezU-0006Ad-6u for submit@debbugs.gnu.org; Sun, 21 Jun 2015 09:08:52 -0400 Original-Received: from mail-wi0-f170.google.com ([209.85.212.170]:33266) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z6ezR-0006AP-W2 for 20642@debbugs.gnu.org; Sun, 21 Jun 2015 09:08:50 -0400 Original-Received: by wiwl6 with SMTP id l6so14946155wiw.0 for <20642@debbugs.gnu.org>; Sun, 21 Jun 2015 06:08:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-type; bh=tBWN1lYE/bPNmXFhBf64yiTjmB4Y5cxId0/gRhxxrEw=; b=vDMwsm00FyT/+ULtYVGuPlI0bmw15wdTV1Wscqi2USpqfslB7UojdNBTXdSc2SF9Mq SkMgVNUAIrWs8uvfFFNjAE6Z33RpUPCRJxppDgyW/xjXVtYIW9yNDDwT1iB7r070/Qyh /JoEDyVpq20hDbYViryyhJ10QsOBR+yNI6sqWcLs5OFxhebQTT6STLoyBqgtrA9qSrPc nIUDrkGCLPD1puqiSw9x0xDR5qtgk2AXiUlkXOPYXI28r+txVN3zLVgQ5XvofT754/Qv YmUR3EstPi5eVhPFvXEyaNov+ekRONT7FJo76ZHOcXGSnNaiuKSK6w/MVYf0QZALTIoG POtg== X-Received: by 10.180.81.106 with SMTP id z10mr22871648wix.22.1434892124441; Sun, 21 Jun 2015 06:08:44 -0700 (PDT) In-Reply-To: X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:104168 Archived-At: --f46d041828465e5325051906db61 Content-Type: text/plain; charset=UTF-8 Philipp Stephani schrieb am So., 21. Juni 2015 um 15:07 Uhr: > Stefan Monnier schrieb am Mo., 25. Mai 2015 um > 04:27 Uhr: > >> > Perform ML-style pattern matching on EXP. >> > Users are probably not aware what 'ML-style pattern matching' is. >> >> Indeed. But this "ML-style" is the only useful thing I can think >> to add to this first line. I don't think removing it will help anyone. >> >> > Please add an introduction without referring to ML. >> >> Feel free to suggest a replacement, but remember it has to fit on >> a single line. >> >> > CASES is a list of elements of the form (UPATTERN CODE...). >> > Please document the motivation for the existence and nomenclature or >> > UPatterns and QPatterns. >> >> In Emacs-25, the docstring has been indirectly modified, so the QPAT now >> is only documented in a separate section about the backquote pattern. >> You might like to take a look in that version, to see if it makes more >> sense that way. >> >> >> > I think the current wording is better, thanks. > Sorry, wanted to say "the *new* wording (in Emacs 25) is better". --f46d041828465e5325051906db61 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable


Philip= p Stephani <p.stephani2@gmail.c= om> schrieb am So., 21. Juni 2015 um 15:07=C2=A0Uhr:
Stefan Monnier <monnier@iro.umontreal.ca> schrieb am Mo., 25. Mai 2= 015 um 04:27=C2=A0Uhr:
>=C2=A0 = =C2=A0 Perform ML-style pattern matching on EXP.
> Users are probably not aware what 'ML-style pattern matching' = is.

Indeed.=C2=A0 But this "ML-style" is the only useful thing I can = think
to add to this first line.=C2=A0 I don't think removing it will help an= yone.

> Please add an introduction without referring to ML.

Feel free to suggest a replacement, but remember it has to fit on
a single line.

>=C2=A0 =C2=A0 CASES is a list of elements of the form (UPATTERN CODE...= ).
> Please document the motivation for the existence and nomenclature or > UPatterns and QPatterns.

In Emacs-25, the docstring has been indirectly modified, so the QPAT now is only documented in a separate section about the backquote pattern.
You might like to take a look in that version, to see if it makes more
sense that way.



I think the current wording is better, thanks.

Sorry, wanted to say "the *new= * wording (in Emacs 25) is better".=C2=A0
--f46d041828465e5325051906db61--