From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Sat, 19 Dec 2015 18:24:11 +0100 Message-ID: <87vb7uuzb8.fsf@web.de> References: <20151216202605.GA3752@acm.fritz.box> <87fuyytq6b.fsf@web.de> <83fuyyv10w.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1450545887 25120 80.91.229.3 (19 Dec 2015 17:24:47 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 19 Dec 2015 17:24:47 +0000 (UTC) Cc: acm@muc.de, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 19 18:24:37 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 1aALFE-000895-0A for ged-emacs-devel@m.gmane.org; Sat, 19 Dec 2015 18:24:36 +0100 Original-Received: from localhost ([::1]:38095 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aALFD-00005B-61 for ged-emacs-devel@m.gmane.org; Sat, 19 Dec 2015 12:24:35 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52931) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aALF0-0008W2-1D for emacs-devel@gnu.org; Sat, 19 Dec 2015 12:24:22 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aALEz-0001gQ-9Q for emacs-devel@gnu.org; Sat, 19 Dec 2015 12:24:21 -0500 Original-Received: from mout.web.de ([212.227.15.14]:57710) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aALEv-0001g3-C6; Sat, 19 Dec 2015 12:24:17 -0500 Original-Received: from drachen.dragon ([90.186.0.6]) by smtp.web.de (mrweb003) with ESMTPSA (Nemesis) id 0MduO5-1ZpEXo3Prx-00PacA; Sat, 19 Dec 2015 18:24:14 +0100 In-Reply-To: <83fuyyv10w.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 19 Dec 2015 18:47:11 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-Provags-ID: V03:K0:y7gVyKnuE/xlMgr7hX4JtQTKD6LsccofSI0eJYYFnyV+FntZ5/6 Cef3hxEekKuOKSh2Upv01+WN1ptdG6S+WNBodhqpXPcEy+T8NFbXSDoZamSGCH0zKuszy5r AMLkGGqjMDtJrVGyG9DnuUNtlPrMa+LcONtDuBv1QhRW1KkLIORbPBKDNci2Uo2jHqGNcO2 02i1dDWTN2rRA6oQ/Qpxg== X-UI-Out-Filterresults: notjunk:1;V01:K0:ZuxZABe2AFI=:HLeHuu5lBnnaVGcTNgRpj/ 4T/uOKHLeyvvAEqJ6AqT4sr7VArYbnGVxdF+fyvAFT2DSW8YmmNDQ5v/hZaHTvncfD8pBeIAA CjMC9BfL06+QZdXfpCCrSTyB4/IYI7vyPu/jpS55tajqUinWPYIsLRQBUFBqvkOinbL+ry0+z J7Ooo6o1V+OJivU/ZNsWTJfLFLhwKnISMsZhihqF0y0oJo2xNdq0LlDGyus3rWPJnO1f0bfjC QewSmrvK80YoamHus+xYVao7m0WhrFjPUByGY+DWMFu4vrBXJJ01pkBRT5k/2IZZNYlblkHn/ j6X+oCSHa7UdmX+lU7Jov0dfZV8tSDZcBwBODcRhaKM1ofaYY0TBbBZAMabfOH5zWqEuKwtMN G3XrHpgAY0PlCK54iBfQFT7PPpOPYKST+Ngdu7xAqEu2PUOaUSCDCrYSo+VFZVj2wwoD37z8H jZGVfvGZCcpOeyk+BhOe6xZ2abOeKNmbPvcQPgJ9E11U3b6MNCVc1We4CS+lorObx2+pGFzvE gRvZ/VIRWQc5X42ckGSMty0Abu/arm27hhQQ+PduLBttuZ2t837o4LLF1gUkZiBtBDspa6ufZ 9WBSkyC+d3Y+A+gb6ayX+xp9b6jLSUmJaQllDXl35fCYmojQhOibXP7OICKl1ZMLXG0YUSAFE AKpiEyXT6ohtLb7/JO5ZxuMlMjEFYEmpwWdekvnkKWfr37jPUoQ4WfpYRQAhbp/+VEbFbR3iY 8gOHL1lyz+1E+PWx464MdIAJU2tjgNOYtuwNlM8xMAJ2B71TrHXnVbAv9LvhSDqumx85bjFH X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 212.227.15.14 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:196516 Archived-At: Eli Zaretskii writes: > > A tutorial is missing though, clearly. > > Tutorials are always good to have, but they cannot replace good > documentation in the manual. We should strive to provide manuals that > are self-contained and don't require any tutorial reading for > acquiring a full understanding of an issue and an unimpeded capability > of using it in Lisp programs. I agree. Michael.