From unknown Sun Aug 17 01:59:23 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20642: 24.5; Please improve documentation for `pcase' Resent-From: Philipp Stephani Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 24 May 2015 10:35:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 20642 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 20642@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.14324636732253 (code B ref -1); Sun, 24 May 2015 10:35:02 +0000 Received: (at submit) by debbugs.gnu.org; 24 May 2015 10:34:33 +0000 Received: from localhost ([127.0.0.1]:54276 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YwTEi-0000a7-UP for submit@debbugs.gnu.org; Sun, 24 May 2015 06:34:33 -0400 Received: from eggs.gnu.org ([208.118.235.92]:42619) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YwTEc-0000ZZ-Cx for submit@debbugs.gnu.org; Sun, 24 May 2015 06:34:27 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YwTEW-0003YS-1d for submit@debbugs.gnu.org; Sun, 24 May 2015 06:34:17 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: * X-Spam-Status: No, score=1.1 required=5.0 tests=BAYES_50, FREEMAIL_ENVFROM_END_DIGIT,FREEMAIL_FROM,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:49815) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YwTEV-0003YO-Ve for submit@debbugs.gnu.org; Sun, 24 May 2015 06:34:15 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:56124) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YwTEU-00048N-Hz for bug-gnu-emacs@gnu.org; Sun, 24 May 2015 06:34:15 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YwTEO-0003XZ-Nb for bug-gnu-emacs@gnu.org; Sun, 24 May 2015 06:34:14 -0400 Received: from mail-wg0-x22f.google.com ([2a00:1450:400c:c00::22f]:36224) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YwTEO-0003XV-D5 for bug-gnu-emacs@gnu.org; Sun, 24 May 2015 06:34:08 -0400 Received: by wgbgq6 with SMTP id gq6so51796341wgb.3 for ; Sun, 24 May 2015 03:34:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:subject:date:message-id:mime-version:content-type; bh=JEIB2h+wQrqaZ1E/eIolDod/xsP7/TyfyQDVmruiyOY=; b=FqM55034b+3SPS0HJ2AwW2LjPaYpENltk/4mUBYW5Pbyj0Y1vGb+bV4aKNzkQYHXLJ dEOscGxhpp6JxLHXMyyy8eNIDPxnenxeprnvRVwxgrJoWLsRek4ZOY+V2rLpfp3vsgZW +dsiS+6cl/zm2Wc186HfY4xx6+BsEUFy8sgbh+ugWbOwaqpghQ8+Y5ROgtRjOSrX4oiQ pnwffR10257iWtAXDa8Ugej/NxWjBQPV2UE7BsU8BJf/i1vBr9v9Y62dnhT7h1IeUGAy vvmYP9bv2xI1bR1L125CHieRgbMAbPliLCEYZwJOf6cqQy9+A90NkJPACCCcZ83P4CMz Tfng== X-Received: by 10.194.87.1 with SMTP id t1mr31318716wjz.24.1432463647813; Sun, 24 May 2015 03:34:07 -0700 (PDT) Received: from p (46.128.209.83.dynamic.cablesurf.de. [46.128.209.83]) by mx.google.com with ESMTPSA id bo5sm6691271wjc.43.2015.05.24.03.34.07 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 24 May 2015 03:34:07 -0700 (PDT) From: Philipp Stephani Date: Sun, 24 May 2015 12:34:06 +0200 Message-ID: MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -3.8 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.8 (---) Quoting the documentation of `pcase', some comments inline. Perform ML-style pattern matching on EXP. Users are probably not aware what 'ML-style pattern matching' is. Please add an introduction without referring to ML. CASES is a list of elements of the form (UPATTERN CODE...). Please document the motivation for the existence and nomenclature or UPatterns and QPatterns. UPatterns can take the following forms: _ matches anything. SELFQUOTING matches itself. This includes keywords, numbers, and strings. Please add exhaustive information about all the cases covered by the SELFQUOTING form. What kinds of forms does it comprise? There is overlap with the SYMBOL case below, which has very different semantics, so the distinction should be made as clear as possible. Please include information about the very common symbols nil and t. SYMBOL matches anything and binds it to SYMBOL. Please state explicitly in which cases this form applies. Given that _ and :foo are also symbols, it is clear that it doesn't apply to all symbols. Something like "all symbols except _, keywords, nil or t"? (or UPAT...) matches if any of the patterns matches. (and UPAT...) matches if all the patterns match. In the `and' form, please give and example for the following very common but non-obvious form: (and UPAT SYMBOL) e.g. (and (pred integerp) myvar), meaning to bind to a symbol only if some guard expression matches. In GNU Emacs 24.5.1 (x86_64-apple-darwin14.1.0, NS apple-appkit-1344.72) of 2015-04-12 on p Configured using: `configure --prefix=/usr/local/Cellar/emacs/24.5 --enable-locallisppath=/usr/local/share/emacs/site-lisp --infodir=/usr/local/Cellar/emacs/24.5/share/info/emacs --with-file-notification=gfile --with-dbus --with-gnutls --with-rsvg --with-imagemagick --without-popmail --with-ns --disable-ns-self-contained' Important settings: value of $LANG: de_DE.UTF-8 locale-coding-system: utf-8-unix Major mode: Emacs-Lisp Minor modes in effect: tooltip-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t Recent messages: Mark set Sending... Mark set [2 times] Sending via mail... Sending email Sending email done gnutls.c: [0] (Emacs) fatal error: The TLS connection was non-properly terminated. Sending...done Load-path shadows: None found. Features: (eieio-opt speedbar sb-image ezimage dframe find-func gnutls network-stream starttls tls mailalias smtpmail auth-source eieio byte-opt bytecomp byte-compile cl-extra cconv eieio-core password-cache cus-edit cus-start cus-load wid-edit cl-loaddefs cl-lib help-mode pp shadow sort gnus-util mail-extr emacsbug message format-spec rfc822 mml easymenu mml-sec mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils mailheader sendmail rfc2047 rfc2045 ietf-drums mm-util mail-prsvr mail-utils warnings help-fns files-x xterm time-date tooltip electric uniquify ediff-hook vc-hooks lisp-float-type mwheel ns-win tool-bar dnd fontset image regexp-opt fringe tabulated-list newcomment lisp-mode prog-mode register page menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core frame cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese case-table epa-hook jka-cmpr-hook help simple abbrev minibuffer nadvice loaddefs button faces cus-face macroexp files text-properties overlay sha1 md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote make-network-process dbusbind gfilenotify cocoa ns multi-tty emacs) Memory information: ((conses 16 118129 9719) (symbols 48 21487 0) (miscs 40 54 289) (strings 32 20379 5134) (string-bytes 1 568058) (vectors 16 11343) (vector-slots 8 377405 5190) (floats 8 77 427) (intervals 56 665 100) (buffers 960 19)) From debbugs-submit-bounces@debbugs.gnu.org Sun May 24 19:18:12 2015 Received: (at control) by debbugs.gnu.org; 24 May 2015 23:18:12 +0000 Received: from localhost ([127.0.0.1]:54980 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ywf9j-0001Mh-GH for submit@debbugs.gnu.org; Sun, 24 May 2015 19:18:12 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:39945 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ywf9d-0001M5-Am for control@debbugs.gnu.org; Sun, 24 May 2015 19:18:06 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1Ywf9c-000418-QW for control@debbugs.gnu.org; Sun, 24 May 2015 19:18:00 -0400 Date: Sun, 24 May 2015 19:18:00 -0400 Message-Id: Subject: control message for bug 20642 To: X-Mailer: mail (GNU Mailutils 2.1) From: Glenn Morris X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) forcemerge 18288 20642 From unknown Sun Aug 17 01:59:23 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20642: 24.5; Please improve documentation for `pcase' Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 25 May 2015 02: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: To: Philipp Stephani Cc: 20642@debbugs.gnu.org Received: via spool by 20642-submit@debbugs.gnu.org id=B20642.143251971626063 (code B ref 20642); Mon, 25 May 2015 02:09:02 +0000 Received: (at 20642) by debbugs.gnu.org; 25 May 2015 02:08:36 +0000 Received: from localhost ([127.0.0.1]:55096 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ywhod-0006mE-Sh for submit@debbugs.gnu.org; Sun, 24 May 2015 22:08:36 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.181]:15647) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YwhoY-0006lz-Fk for 20642@debbugs.gnu.org; Sun, 24 May 2015 22:08:31 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: A0AsEwA731xV/9N+3mhcgxCEAoVVuzcJh0sEAgKBPDkUAQEBAQEBAYEKQQWDXQEBAwFWIwULCw4mEhQYDSSINwjPIwEBAQcBAQEBHos6hQUHhC0BBJ8Xg2uSAiOEFCKCeAEBAQ X-IPAS-Result: A0AsEwA731xV/9N+3mhcgxCEAoVVuzcJh0sEAgKBPDkUAQEBAQEBAYEKQQWDXQEBAwFWIwULCw4mEhQYDSSINwjPIwEBAQcBAQEBHos6hQUHhC0BBJ8Xg2uSAiOEFCKCeAEBAQ X-IronPort-AV: E=Sophos;i="5.13,465,1427774400"; d="scan'208";a="122058065" Received: from 104-222-126-211.cpe.teksavvy.com (HELO fmsmemgm.homelinux.net) ([104.222.126.211]) by ironport2-out.teksavvy.com with ESMTP/TLS/DHE-RSA-AES256-SHA; 24 May 2015 22:08:21 -0400 Received: by fmsmemgm.homelinux.net (Postfix, from userid 20848) id D7686AE058; Sun, 24 May 2015 22:08:20 -0400 (EDT) From: Stefan Monnier Message-ID: References: Date: Sun, 24 May 2015 22:08:20 -0400 In-Reply-To: (Philipp Stephani's message of "Sun, 24 May 2015 12:34:06 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.3 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) > SELFQUOTING matches itself. This includes keywords, > numbers, and strings. > Please add exhaustive information about all the cases covered by the > SELFQUOTING form. Actually, it says it right there: keywords, numbers, and strings. Admittedly, it doesn't say it's exhaustive (partly because this set could be expanded in the future, tho at this point it seems unlikely). > SYMBOL matches anything and binds it to SYMBOL. > Please state explicitly in which cases this form applies. Given that _ > and :foo are also symbols, it is clear that it doesn't apply to all > symbols. Something like "all symbols except _, keywords, nil or t"? Keywords can't be bound since their value is constant. Same for nil and t. So that should be "obvious enough". As for _ I think it should also be obvious enough that between a rule "for _" and rule for "SYMBOL" the most specific rule should take precedence. Stefan From unknown Sun Aug 17 01:59:23 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20642: 24.5; Please improve documentation for `pcase' Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 25 May 2015 02:29: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: To: Philipp Stephani Cc: 20642@debbugs.gnu.org Received: via spool by 20642-submit@debbugs.gnu.org id=B20642.143252088627793 (code B ref 20642); Mon, 25 May 2015 02:29:02 +0000 Received: (at 20642) by debbugs.gnu.org; 25 May 2015 02:28:06 +0000 Received: from localhost ([127.0.0.1]:55101 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ywi7V-0007Dw-L7 for submit@debbugs.gnu.org; Sun, 24 May 2015 22:28:06 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.181]:49556) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ywi7P-0007Da-5d for 20642@debbugs.gnu.org; Sun, 24 May 2015 22:27:59 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: A0AsEwA731xV/9N+3mhcgxCEAoVVuzcJh0sEAgKBPDkUAQEBAQEBAYEKQQWDXQEBAwFWIwULCw4mEhQYDSSINwjPIwEBAQcBAQEBHos6hQUHhC0BBJ8Xg2uSAiOEFCKCeAEBAQ X-IPAS-Result: A0AsEwA731xV/9N+3mhcgxCEAoVVuzcJh0sEAgKBPDkUAQEBAQEBAYEKQQWDXQEBAwFWIwULCw4mEhQYDSSINwjPIwEBAQcBAQEBHos6hQUHhC0BBJ8Xg2uSAiOEFCKCeAEBAQ X-IronPort-AV: E=Sophos;i="5.13,465,1427774400"; d="scan'208";a="122059378" Received: from 104-222-126-211.cpe.teksavvy.com (HELO fmsmemgm.homelinux.net) ([104.222.126.211]) by ironport2-out.teksavvy.com with ESMTP/TLS/DHE-RSA-AES256-SHA; 24 May 2015 22:27:49 -0400 Received: by fmsmemgm.homelinux.net (Postfix, from userid 20848) id 7CF78AE058; Sun, 24 May 2015 22:27:49 -0400 (EDT) From: Stefan Monnier Message-ID: References: Date: Sun, 24 May 2015 22:27:49 -0400 In-Reply-To: (Philipp Stephani's message of "Sun, 24 May 2015 12:34:06 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.3 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) > 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. Stefan From unknown Sun Aug 17 01:59:23 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20642: 24.5; Please improve documentation for `pcase' 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: To: Stefan Monnier Cc: 20642@debbugs.gnu.org Received: via spool by 20642-submit@debbugs.gnu.org id=B20642.143489209423674 (code B ref 20642); Sun, 21 Jun 2015 13:09:02 +0000 Received: (at 20642) by debbugs.gnu.org; 21 Jun 2015 13:08:14 +0000 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 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 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) MIME-Version: 1.0 References: In-Reply-To: From: Philipp Stephani Date: Sun, 21 Jun 2015 13:07:54 +0000 Message-ID: Content-Type: multipart/alternative; boundary=047d7bacb0eefe5fc6051906d830 X-Spam-Score: -0.4 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.4 (/) --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-- From unknown Sun Aug 17 01:59:23 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20642: 24.5; Please improve documentation for `pcase' 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: To: Stefan Monnier Cc: 20642@debbugs.gnu.org Received: via spool by 20642-submit@debbugs.gnu.org id=B20642.143489213323727 (code B ref 20642); Sun, 21 Jun 2015 13:09:03 +0000 Received: (at 20642) by debbugs.gnu.org; 21 Jun 2015 13:08:53 +0000 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 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 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) MIME-Version: 1.0 References: In-Reply-To: From: Philipp Stephani Date: Sun, 21 Jun 2015 13:08:34 +0000 Message-ID: Content-Type: multipart/alternative; boundary=f46d041828465e5325051906db61 X-Spam-Score: -0.4 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.4 (/) --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-- From unknown Sun Aug 17 01:59:23 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Philipp Stephani Subject: bug#20642: closed (Re: bug#20642: 24.5; Please improve documentation for `pcase') Message-ID: References: X-Gnu-PR-Message: they-closed 20642 X-Gnu-PR-Package: emacs Reply-To: 20642@debbugs.gnu.org Date: Mon, 22 Jun 2015 01:20:05 +0000 Content-Type: multipart/mixed; boundary="----------=_1434936005-30976-1" This is a multi-part message in MIME format... ------------=_1434936005-30976-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #20642: 24.5; Please improve documentation for `pcase' which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 20642@debbugs.gnu.org. --=20 20642: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D20642 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1434936005-30976-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 20642-done) by debbugs.gnu.org; 22 Jun 2015 01:19:38 +0000 Received: from localhost ([127.0.0.1]:53728 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z6qOf-00082w-PS for submit@debbugs.gnu.org; Sun, 21 Jun 2015 21:19:38 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.181]:28595) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z6qOd-00082k-SG for 20642-done@debbugs.gnu.org; Sun, 21 Jun 2015 21:19:36 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: A0AsEwA731xV/zDyd0tcgxCEAoVVuzcJh0sEAgKBPDkUAQEBAQEBAYEKQQWDXQEBAwFWIwULCw4mEhQYDSSINwjPIwEBAQEGAQEBAR6LOoUFB4QtBZ8Xg2uQPYFFI4QUIoJ4AQEB X-IPAS-Result: A0AsEwA731xV/zDyd0tcgxCEAoVVuzcJh0sEAgKBPDkUAQEBAQEBAYEKQQWDXQEBAwFWIwULCw4mEhQYDSSINwjPIwEBAQEGAQEBAR6LOoUFB4QtBZ8Xg2uQPYFFI4QUIoJ4AQEB X-IronPort-AV: E=Sophos;i="5.13,465,1427774400"; d="scan'208";a="127902972" Received: from 75-119-242-48.dsl.teksavvy.com (HELO ceviche.home) ([75.119.242.48]) by ironport2-out.teksavvy.com with ESMTP/TLS/DHE-RSA-AES256-SHA; 21 Jun 2015 21:19:30 -0400 Received: by ceviche.home (Postfix, from userid 20848) id 4D663660F3; Sun, 21 Jun 2015 21:19:30 -0400 (EDT) From: Stefan Monnier To: Philipp Stephani Subject: Re: bug#20642: 24.5; Please improve documentation for `pcase' Message-ID: References: Date: Sun, 21 Jun 2015 21:19:30 -0400 In-Reply-To: (Philipp Stephani's message of "Sun, 21 Jun 2015 13:08:34 +0000") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.3 (/) X-Debbugs-Envelope-To: 20642-done Cc: 20642-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) > Sorry, wanted to say "the *new* wording (in Emacs 25) is better". Thanks, Stefan ------------=_1434936005-30976-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 24 May 2015 10:34:33 +0000 Received: from localhost ([127.0.0.1]:54276 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YwTEi-0000a7-UP for submit@debbugs.gnu.org; Sun, 24 May 2015 06:34:33 -0400 Received: from eggs.gnu.org ([208.118.235.92]:42619) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YwTEc-0000ZZ-Cx for submit@debbugs.gnu.org; Sun, 24 May 2015 06:34:27 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YwTEW-0003YS-1d for submit@debbugs.gnu.org; Sun, 24 May 2015 06:34:17 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: * X-Spam-Status: No, score=1.1 required=5.0 tests=BAYES_50, FREEMAIL_ENVFROM_END_DIGIT,FREEMAIL_FROM,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:49815) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YwTEV-0003YO-Ve for submit@debbugs.gnu.org; Sun, 24 May 2015 06:34:15 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:56124) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YwTEU-00048N-Hz for bug-gnu-emacs@gnu.org; Sun, 24 May 2015 06:34:15 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YwTEO-0003XZ-Nb for bug-gnu-emacs@gnu.org; Sun, 24 May 2015 06:34:14 -0400 Received: from mail-wg0-x22f.google.com ([2a00:1450:400c:c00::22f]:36224) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YwTEO-0003XV-D5 for bug-gnu-emacs@gnu.org; Sun, 24 May 2015 06:34:08 -0400 Received: by wgbgq6 with SMTP id gq6so51796341wgb.3 for ; Sun, 24 May 2015 03:34:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:subject:date:message-id:mime-version:content-type; bh=JEIB2h+wQrqaZ1E/eIolDod/xsP7/TyfyQDVmruiyOY=; b=FqM55034b+3SPS0HJ2AwW2LjPaYpENltk/4mUBYW5Pbyj0Y1vGb+bV4aKNzkQYHXLJ dEOscGxhpp6JxLHXMyyy8eNIDPxnenxeprnvRVwxgrJoWLsRek4ZOY+V2rLpfp3vsgZW +dsiS+6cl/zm2Wc186HfY4xx6+BsEUFy8sgbh+ugWbOwaqpghQ8+Y5ROgtRjOSrX4oiQ pnwffR10257iWtAXDa8Ugej/NxWjBQPV2UE7BsU8BJf/i1vBr9v9Y62dnhT7h1IeUGAy vvmYP9bv2xI1bR1L125CHieRgbMAbPliLCEYZwJOf6cqQy9+A90NkJPACCCcZ83P4CMz Tfng== X-Received: by 10.194.87.1 with SMTP id t1mr31318716wjz.24.1432463647813; Sun, 24 May 2015 03:34:07 -0700 (PDT) Received: from p (46.128.209.83.dynamic.cablesurf.de. [46.128.209.83]) by mx.google.com with ESMTPSA id bo5sm6691271wjc.43.2015.05.24.03.34.07 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 24 May 2015 03:34:07 -0700 (PDT) From: Philipp Stephani To: bug-gnu-emacs@gnu.org Subject: 24.5; Please improve documentation for `pcase' Date: Sun, 24 May 2015 12:34:06 +0200 Message-ID: MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -3.8 (---) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.8 (---) Quoting the documentation of `pcase', some comments inline. Perform ML-style pattern matching on EXP. Users are probably not aware what 'ML-style pattern matching' is. Please add an introduction without referring to ML. CASES is a list of elements of the form (UPATTERN CODE...). Please document the motivation for the existence and nomenclature or UPatterns and QPatterns. UPatterns can take the following forms: _ matches anything. SELFQUOTING matches itself. This includes keywords, numbers, and strings. Please add exhaustive information about all the cases covered by the SELFQUOTING form. What kinds of forms does it comprise? There is overlap with the SYMBOL case below, which has very different semantics, so the distinction should be made as clear as possible. Please include information about the very common symbols nil and t. SYMBOL matches anything and binds it to SYMBOL. Please state explicitly in which cases this form applies. Given that _ and :foo are also symbols, it is clear that it doesn't apply to all symbols. Something like "all symbols except _, keywords, nil or t"? (or UPAT...) matches if any of the patterns matches. (and UPAT...) matches if all the patterns match. In the `and' form, please give and example for the following very common but non-obvious form: (and UPAT SYMBOL) e.g. (and (pred integerp) myvar), meaning to bind to a symbol only if some guard expression matches. In GNU Emacs 24.5.1 (x86_64-apple-darwin14.1.0, NS apple-appkit-1344.72) of 2015-04-12 on p Configured using: `configure --prefix=/usr/local/Cellar/emacs/24.5 --enable-locallisppath=/usr/local/share/emacs/site-lisp --infodir=/usr/local/Cellar/emacs/24.5/share/info/emacs --with-file-notification=gfile --with-dbus --with-gnutls --with-rsvg --with-imagemagick --without-popmail --with-ns --disable-ns-self-contained' Important settings: value of $LANG: de_DE.UTF-8 locale-coding-system: utf-8-unix Major mode: Emacs-Lisp Minor modes in effect: tooltip-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t Recent messages: Mark set Sending... Mark set [2 times] Sending via mail... Sending email Sending email done gnutls.c: [0] (Emacs) fatal error: The TLS connection was non-properly terminated. Sending...done Load-path shadows: None found. Features: (eieio-opt speedbar sb-image ezimage dframe find-func gnutls network-stream starttls tls mailalias smtpmail auth-source eieio byte-opt bytecomp byte-compile cl-extra cconv eieio-core password-cache cus-edit cus-start cus-load wid-edit cl-loaddefs cl-lib help-mode pp shadow sort gnus-util mail-extr emacsbug message format-spec rfc822 mml easymenu mml-sec mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils mailheader sendmail rfc2047 rfc2045 ietf-drums mm-util mail-prsvr mail-utils warnings help-fns files-x xterm time-date tooltip electric uniquify ediff-hook vc-hooks lisp-float-type mwheel ns-win tool-bar dnd fontset image regexp-opt fringe tabulated-list newcomment lisp-mode prog-mode register page menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core frame cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese case-table epa-hook jka-cmpr-hook help simple abbrev minibuffer nadvice loaddefs button faces cus-face macroexp files text-properties overlay sha1 md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote make-network-process dbusbind gfilenotify cocoa ns multi-tty emacs) Memory information: ((conses 16 118129 9719) (symbols 48 21487 0) (miscs 40 54 289) (strings 32 20379 5134) (string-bytes 1 568058) (vectors 16 11343) (vector-slots 8 377405 5190) (floats 8 77 427) (intervals 56 665 100) (buffers 960 19)) ------------=_1434936005-30976-1-- From unknown Sun Aug 17 01:59:23 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Mario Valencia Subject: bug#18288: closed (Re: bug#20642: 24.5; Please improve documentation for `pcase') Message-ID: References: X-Gnu-PR-Message: they-closed 18288 X-Gnu-PR-Package: emacs Reply-To: 18288@debbugs.gnu.org Date: Mon, 22 Jun 2015 01:20:07 +0000 Content-Type: multipart/mixed; boundary="----------=_1434936007-30976-3" This is a multi-part message in MIME format... ------------=_1434936007-30976-3 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #20642: pcase documentation rewrite which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 18288@debbugs.gnu.org. --=20 20642: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D20642 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1434936007-30976-3 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 20642-done) by debbugs.gnu.org; 22 Jun 2015 01:19:38 +0000 Received: from localhost ([127.0.0.1]:53728 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z6qOf-00082w-PS for submit@debbugs.gnu.org; Sun, 21 Jun 2015 21:19:38 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.181]:28595) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Z6qOd-00082k-SG for 20642-done@debbugs.gnu.org; Sun, 21 Jun 2015 21:19:36 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: A0AsEwA731xV/zDyd0tcgxCEAoVVuzcJh0sEAgKBPDkUAQEBAQEBAYEKQQWDXQEBAwFWIwULCw4mEhQYDSSINwjPIwEBAQEGAQEBAR6LOoUFB4QtBZ8Xg2uQPYFFI4QUIoJ4AQEB X-IPAS-Result: A0AsEwA731xV/zDyd0tcgxCEAoVVuzcJh0sEAgKBPDkUAQEBAQEBAYEKQQWDXQEBAwFWIwULCw4mEhQYDSSINwjPIwEBAQEGAQEBAR6LOoUFB4QtBZ8Xg2uQPYFFI4QUIoJ4AQEB X-IronPort-AV: E=Sophos;i="5.13,465,1427774400"; d="scan'208";a="127902972" Received: from 75-119-242-48.dsl.teksavvy.com (HELO ceviche.home) ([75.119.242.48]) by ironport2-out.teksavvy.com with ESMTP/TLS/DHE-RSA-AES256-SHA; 21 Jun 2015 21:19:30 -0400 Received: by ceviche.home (Postfix, from userid 20848) id 4D663660F3; Sun, 21 Jun 2015 21:19:30 -0400 (EDT) From: Stefan Monnier To: Philipp Stephani Subject: Re: bug#20642: 24.5; Please improve documentation for `pcase' Message-ID: References: Date: Sun, 21 Jun 2015 21:19:30 -0400 In-Reply-To: (Philipp Stephani's message of "Sun, 21 Jun 2015 13:08:34 +0000") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.3 (/) X-Debbugs-Envelope-To: 20642-done Cc: 20642-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) > Sorry, wanted to say "the *new* wording (in Emacs 25) is better". Thanks, Stefan ------------=_1434936007-30976-3 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 18 Aug 2014 05:48:17 +0000 Received: from localhost ([127.0.0.1]:45899 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XJFnk-0003XA-JX for submit@debbugs.gnu.org; Mon, 18 Aug 2014 01:48:17 -0400 Received: from eggs.gnu.org ([208.118.235.92]:58929) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XJFnh-0003Wo-NU for submit@debbugs.gnu.org; Mon, 18 Aug 2014 01:48:14 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XJFnb-0003iO-OT for submit@debbugs.gnu.org; Mon, 18 Aug 2014 01:48:08 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=BAYES_40,FREEMAIL_FROM, HTML_MESSAGE,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:36515) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XJFnb-0003iJ-Lo for submit@debbugs.gnu.org; Mon, 18 Aug 2014 01:48:07 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:60650) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XJFna-0005w6-Oz for bug-gnu-emacs@gnu.org; Mon, 18 Aug 2014 01:48:07 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XJFna-0003hq-15 for bug-gnu-emacs@gnu.org; Mon, 18 Aug 2014 01:48:06 -0400 Received: from mail-wi0-x231.google.com ([2a00:1450:400c:c05::231]:49930) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XJFnZ-0003hQ-QK for bug-gnu-emacs@gnu.org; Mon, 18 Aug 2014 01:48:05 -0400 Received: by mail-wi0-f177.google.com with SMTP id ho1so3087302wib.4 for ; Sun, 17 Aug 2014 22:48:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:date:message-id:subject:from:to:content-type; bh=w+BaVfb9CMZadwu9j0j6fFueLTYgDxal9CdT3P9J0pk=; b=CPRgCmeGPs605/5TZ7r9y7QFLvXsNknqIzPp1GRselb1QZQy3Nj3FKyr5Ox8TsI/jp Tz9ciPC72GYMUqtuC96uWsiKsOpeNld4bP489yZJCaFAYBM+KluQ9JnHb4gPib5g4wf7 vXhJ+Mqk2+ea91OR/wzVSSB/FxTcI+gLxgJRo4UFYbq3j8KjL307sKpiYAlHy1iUpIue U0fZ1JROQ0GBYMEvKxOrbHHP1vqM2o0oUTuCn6HsI0ee5ZUBgogsOOzwXvjhPcVuYomN V0LxybfjQn8r21ahtA45A4wgb8KSrfYKlvq8YWB5CojaPgOknN0slxePiV9NCNIbJVN+ Iiag== MIME-Version: 1.0 X-Received: by 10.194.118.232 with SMTP id kp8mr39470584wjb.42.1408340883841; Sun, 17 Aug 2014 22:48:03 -0700 (PDT) Received: by 10.194.38.35 with HTTP; Sun, 17 Aug 2014 22:48:03 -0700 (PDT) Date: Mon, 18 Aug 2014 00:48:03 -0500 Message-ID: Subject: pcase documentation rewrite From: Mario Valencia To: bug-gnu-emacs@gnu.org Content-Type: multipart/alternative; boundary=089e0115f7061aa8990500e0eade X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) --089e0115f7061aa8990500e0eade Content-Type: text/plain; charset=UTF-8 The documentation in '(elisp) Pattern matching case statement' is very difficult to understand. Could somebody please rewrite it so mere mortals can read it? thnx --089e0115f7061aa8990500e0eade Content-Type: text/html; charset=UTF-8
The documentation in '(elisp) Pattern matching case statement' is very difficult to understand. Could somebody please rewrite it so mere mortals can read it? thnx
--089e0115f7061aa8990500e0eade-- ------------=_1434936007-30976-3--