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:07:54 +0000
Message-ID:
References:
NNTP-Posting-Host: plane.gmane.org
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary=047d7bacb0eefe5fc6051906d830
X-Trace: ger.gmane.org 1434892162 11276 80.91.229.3 (21 Jun 2015 13:09:22 GMT)
X-Complaints-To: usenet@ger.gmane.org
NNTP-Posting-Date: Sun, 21 Jun 2015 13:09:22 +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:13 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 1Z6ezp-0007es-AS
for geb-bug-gnu-emacs@m.gmane.org; Sun, 21 Jun 2015 15:09:13 +0200
Original-Received: from localhost ([::1]:36306 helo=lists.gnu.org)
by lists.gnu.org with esmtp (Exim 4.71)
(envelope-from )
id 1Z6ezo-0004tr-B3
for geb-bug-gnu-emacs@m.gmane.org; Sun, 21 Jun 2015 09:09:12 -0400
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55048)
by lists.gnu.org with esmtp (Exim 4.71)
(envelope-from ) id 1Z6ezj-0004tk-Uh
for bug-gnu-emacs@gnu.org; Sun, 21 Jun 2015 09:09:09 -0400
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
(envelope-from ) id 1Z6ezf-0007Ah-3W
for bug-gnu-emacs@gnu.org; Sun, 21 Jun 2015 09:09:07 -0400
Original-Received: from debbugs.gnu.org ([140.186.70.43]:51651)
by eggs.gnu.org with esmtp (Exim 4.71)
(envelope-from ) id 1Z6eze-0007Ab-VF
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 1Z6eze-0006B5-H1
for bug-gnu-emacs@gnu.org; Sun, 21 Jun 2015 09:09:02 -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:02 +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.143489209423674
(code B ref 20642); Sun, 21 Jun 2015 13:09:02 +0000
Original-Received: (at 20642) by debbugs.gnu.org; 21 Jun 2015 13:08:14 +0000
Original-Received: from localhost ([127.0.0.1]:53094 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.80)
(envelope-from )
id 1Z6eyq-00069l-UP
for submit@debbugs.gnu.org; Sun, 21 Jun 2015 09:08:13 -0400
Original-Received: from mail-wg0-f52.google.com ([74.125.82.52]:32804)
by debbugs.gnu.org with esmtp (Exim 4.80)
(envelope-from ) id 1Z6eyo-00069X-1z
for 20642@debbugs.gnu.org; Sun, 21 Jun 2015 09:08:11 -0400
Original-Received: by wgwi7 with SMTP id i7so1839568wgw.0
for <20642@debbugs.gnu.org>; Sun, 21 Jun 2015 06:08:04 -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=YvwxRjWnshUw+LuXlaMvcCApRRBFzEU0QjuK+YKFoWk=;
b=uQU4FVs0z4yyVmGWcVtCdrqDQe78aB4mh2jJzxkxYr2l7Md2E/SDm8/CV4QJ2X/CZ0
Yo90k29oETX8xH7jOb4LO5KIu5mqPUcrUK++qDe6yU0Z84zqLWmJO5/yG4qnyo9BohL0
EnJYJQH47y5nrpzaRtkGo4/8klf3PP7x5cq4VqnD0RlQVBN1QEK3TYwPtx54kH4x6FiL
SMSEvSGtTygx9RM6w7FF4ED7Kc7DdlOK0Y5f3jCnMvBuRZESv4McSs4Wi8Et7hFVmJZy
I17cAcWmODUwaf7iF7f8wVgRvJTC+f4uoUxeBBtp/RmJd0xpNVJGovcWz73xZ7shwQck
dDsg==
X-Received: by 10.194.52.37 with SMTP id q5mr43453888wjo.122.1434892084598;
Sun, 21 Jun 2015 06:08:04 -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:104167
Archived-At:
--047d7bacb0eefe5fc6051906d830
Content-Type: text/plain; charset=UTF-8
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.
--047d7bacb0eefe5fc6051906d830
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
>=C2=A0 =C2=A0 Perform ML-style pattern matc=
hing 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.
--047d7bacb0eefe5fc6051906d830--