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


Stefan= Monnier <monnier@iro.umontr= eal.ca> schrieb am Mo., 25. Mai 2015 um 04:27=C2=A0Uhr:
>=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--