From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: John Wiegley Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Mon, 21 Dec 2015 21:20:27 -0800 Message-ID: References: <20151216202605.GA3752@acm.fritz.box> <87fuz0ydvb.fsf@russet.org.uk> <83poy4xm60.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1450762184 24495 80.91.229.3 (22 Dec 2015 05:29:44 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 22 Dec 2015 05:29:44 +0000 (UTC) Cc: kaushal.modi@gmail.com, acm@muc.de, emacs-devel@gnu.org, Phillip Lord To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Dec 22 06:29:25 2015 Return-path: Envelope-to: ged-emacs-devel@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 1aBFVk-00017E-N3 for ged-emacs-devel@m.gmane.org; Tue, 22 Dec 2015 06:29:24 +0100 Original-Received: from localhost ([::1]:48785 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBFVk-000796-56 for ged-emacs-devel@m.gmane.org; Tue, 22 Dec 2015 00:29:24 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50059) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBFUn-0005LZ-G8 for emacs-devel@gnu.org; Tue, 22 Dec 2015 00:28:26 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aBFUl-0000kW-Bi for emacs-devel@gnu.org; Tue, 22 Dec 2015 00:28:25 -0500 Original-Received: from mail-pa0-x232.google.com ([2607:f8b0:400e:c03::232]:34730) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBFUa-0000hL-O1; Tue, 22 Dec 2015 00:28:12 -0500 Original-Received: by mail-pa0-x232.google.com with SMTP id uo6so6432320pac.1; Mon, 21 Dec 2015 21:28:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:mail-followup-to:mime-version:content-type; bh=5RloEZEgdITr8+OmA+JqWwGB/1VIzRlW1BUhebj5hLg=; b=NEKL7zn6Vv+wcik0yDRju4zMXZh0KhIuMcxe7bitYDTuZYSSsMxDVUdZsq1KJj6Pgi HduO6xTVh9Eow3FEJnyHpBq2tIXNPzRjGz7z9NY574g82rqH3dFSqZqKyafdX/ZS4e9w 6mu/SQl0GnQHu+1O5TXPxiBnDKjhmpwYi1XjzxdhGulhtWR7Mcz7yv+sgUddOvoyP5rH Juiny2ng1oBr4EXji9/ODtoA7To3qY1YJKxg9mZQvTRFSD95MVVNEeAdwZBSrUyqFC+Y jeda2vnZcOBaeMottUS9nbPHH9n3P85q+H4LQg9pWgXM9zFoYLbV0aljrF3YQLgjGruH 14pg== X-Received: by 10.66.55.6 with SMTP id n6mr32734594pap.33.1450762092256; Mon, 21 Dec 2015 21:28:12 -0800 (PST) Original-Received: from Vulcan.local (76-234-68-79.lightspeed.frokca.sbcglobal.net. [76.234.68.79]) by smtp.gmail.com with ESMTPSA id rz10sm42844114pac.29.2015.12.21.21.28.10 (version=TLS1 cipher=AES128-SHA bits=128/128); Mon, 21 Dec 2015 21:28:10 -0800 (PST) X-Google-Original-From: "John Wiegley" Original-Received: by Vulcan.local (Postfix, from userid 501) id 793DE11A46D42; Mon, 21 Dec 2015 21:28:09 -0800 (PST) In-Reply-To: <83poy4xm60.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 18 Dec 2015 09:15:19 +0200") User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin) Mail-Followup-To: Eli Zaretskii , phillip.lord@russet.org.uk (Phillip Lord), acm@muc.de, emacs-devel@gnu.org, kaushal.modi@gmail.com X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400e:c03::232 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:196647 Archived-At: >>>>> Eli Zaretskii writes: > Bottom line: what we do need is make the description clear and > complete. Where it appears is orders of magnitude less important. This is quite true. The sort of user who wishes to understand `pcase' will find the documentation for it, wherever it is the table of contents. -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2