From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Thien-Thi Nguyen Newsgroups: gmane.emacs.bugs Subject: bug#31311: 27.0; doc of `pcase' Date: Sat, 26 May 2018 09:58:50 +0200 Message-ID: <87k1rq26h1.fsf@gnuvola.org> References: <83wowqrmp8.fsf@gnu.org> <87efixlv8g.fsf@web.de> <83muxlsvfm.fsf@gnu.org> <871sexlqvw.fsf@web.de> <83k1sps9n3.fsf@gnu.org> <87wowpndoo.fsf@gmail.com> <87fu3c6cm3.fsf@gnuvola.org> <83zi1kqynx.fsf@gnu.org> <871seh3yw8.fsf@gnuvola.org> <877eo9kmid.fsf@web.de> <87y3gl574j.fsf@gnuvola.org> <87po1xc5lb.fsf@web.de> <87muwz6ftl.fsf@gnuvola.org> <874lj7r5mx.fsf@web.de> <878t8e2lw1.fsf@gnuvola.org> <83in7ecrxo.fsf@gnu.org> <87r2m22ndx.fsf@gnuvola.org> <83lgc9aupx.fsf@gnu.org> Reply-To: 31311@debbugs.gnu.org NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" X-Trace: blaine.gmane.org 1527331031 19223 195.159.176.226 (26 May 2018 10:37:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 26 May 2018 10:37:11 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) To: 31311@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat May 26 12:37:06 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fMWZN-0004sf-Bb for geb-bug-gnu-emacs@m.gmane.org; Sat, 26 May 2018 12:37:05 +0200 Original-Received: from localhost ([::1]:48431 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fMWbU-0000qc-A8 for geb-bug-gnu-emacs@m.gmane.org; Sat, 26 May 2018 06:39:16 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51169) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fMWbK-0000pO-92 for bug-gnu-emacs@gnu.org; Sat, 26 May 2018 06:39:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fMWbH-0007o7-2f for bug-gnu-emacs@gnu.org; Sat, 26 May 2018 06:39:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:41146) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fMWbG-0007o1-Vk for bug-gnu-emacs@gnu.org; Sat, 26 May 2018 06:39:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fMWbG-0002i0-DG for bug-gnu-emacs@gnu.org; Sat, 26 May 2018 06:39:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Thien-Thi Nguyen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 26 May 2018 10:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31311 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 31311-submit@debbugs.gnu.org id=B31311.152733113310391 (code B ref 31311); Sat, 26 May 2018 10:39:02 +0000 Original-Received: (at 31311) by debbugs.gnu.org; 26 May 2018 10:38:53 +0000 Original-Received: from localhost ([127.0.0.1]:49041 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fMWb7-0002hW-ET for submit@debbugs.gnu.org; Sat, 26 May 2018 06:38:53 -0400 Original-Received: from mail.agora-net.com ([67.59.132.6]:39527) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fMWb4-0002hG-TP for 31311@debbugs.gnu.org; Sat, 26 May 2018 06:38:51 -0400 Original-Received: from ttn by mail.agora-net.com with local (Exim 4.82) (envelope-from ) id 1fMWb3-0003kK-SA; Sat, 26 May 2018 06:38:50 -0400 Original-Received: from ttn by zigzag.favinet with local (Exim 4.80) (envelope-from ) id 1fMU6Q-00053u-8p; Sat, 26 May 2018 09:59:02 +0200 In-Reply-To: <83lgc9aupx.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 24 May 2018 19:23:22 +0300") X-SA-Exim-Connect-IP: X-SA-Exim-Mail-From: ttn@gnuvola.org X-SA-Exim-Scanned: No (on mail.agora-net.com); SAEximRunCond expanded to false X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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" Xref: news.gmane.org gmane.emacs.bugs:146566 Archived-At: --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable () Eli Zaretskii () Thu, 24 May 2018 19:23:22 +0300 The documentation of 'pcase' is inside Conditionals not because it expands to 'cond', but because it can be perceived as a kind-of generalization of 'cond' (and the current text even says so explicitly). Yes. Commit 81d1eaff54ad corrects the count of conditional forms, mentions this relationship, and adds xref. > [because of "sequencing patterns", pcase > should follow "Combining Conditions"] I think you read too much into the tree-like structure of the manual, in particular it sounds like you assume many people will read all the sections of this chapter in strict depth-first order. When the output format is text or PDF, depth-first is the order of presentation. I was thinking about that use-case primarily, for this portion of the reasoning. But that is not what happens in most use cases. People usually read just the part(s) they need to understand the particular feature they need to use in their programs. When read like this, the order matters much less. What does matter is that details and "advanced" features are at lower levels, so that first reading doesn't require people to negotiate too many obstacles unnecessarily, which would prevent them from easily grasping the higher-level picture and main ideas. Agreed. Random-access readers need less help. So I personally don't see too many serious reasons to promote this subsection to the level of a section; quite the contrary. But neither am I willing to make yet another dispute out of a minor issue such as this. If you feel strongly about this, feel free to do it. Ack. My feelings are strong but not validated by experience (in this case). If people complain, i'll gladly change it back. P.S. Your messages in this thread have a Mail-Followup-To header that [...] causes Rmail to produce both To and CC headers to the bug address when I reply, and I'm forced to manually remove one of them, which is an annoyance. Would it be possible for you to avoid using that header, please? TIA. Sure, no problem. =2D-=20 Thien-Thi Nguyen ----------------------------------------------- (defun responsep (query) (pcase (context query) (`(technical ,ml) (correctp ml)) ...)) 748E A0E8 1CB8 A748 9BFA =2D-------------------------------------- 6CE4 6703 2224 4C80 7502 --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) iEYEARECAAYFAlsJE78ACgkQZwMiJEyAdQKnVACg0zwf9651WsKnccybnhBY1cRH oGQAn0QV9TAC95RnUfc89b6ujmEIERsT =Go4X -----END PGP SIGNATURE----- --=-=-=--