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:25:09 -0800 Message-ID: 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 1450762146 23850 80.91.229.3 (22 Dec 2015 05:29:06 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 22 Dec 2015 05:29:06 +0000 (UTC) Cc: Michael Heerdegen , acm@muc.de, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Dec 22 06:28:56 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 1aBFVH-0000FJ-HK for ged-emacs-devel@m.gmane.org; Tue, 22 Dec 2015 06:28:55 +0100 Original-Received: from localhost ([::1]:48777 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBFVG-0005Oa-PD for ged-emacs-devel@m.gmane.org; Tue, 22 Dec 2015 00:28:54 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50073) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBFUn-0005M4-QC 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 1aBFUm-0000l8-Ra for emacs-devel@gnu.org; Tue, 22 Dec 2015 00:28:25 -0500 Original-Received: from mail-pf0-x22f.google.com ([2607:f8b0:400e:c00::22f]:35189) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBFUe-0000iF-HY; Tue, 22 Dec 2015 00:28:16 -0500 Original-Received: by mail-pf0-x22f.google.com with SMTP id 78so27572403pfw.2; Mon, 21 Dec 2015 21:28:16 -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=KRa1xF3b6eDbKBW6awnFWYxPawN3jwWbVXzSnpFRqRk=; b=oi7ZFv27n5CP5NKYiuM5hX5n5NfM9GUoKjYVt0Pi4FNlNjUqqr3+7v4p8XzYxh3bDu m50uTOSb0FDJJNScUMR846n4RDtuz7HO4v2gph0N+QtrYoSMKUU1Xd5dAP3p3Gjdj+iC PC42s/zIssyD0QBGO8x8iYRAC1LswB/uaugRagvTF+AXknTa7SU44tW9OokiCv7n2rn5 1p95yt2pCJMTzcT7LGoP3NzSWoNvfyOYd1aXQgOLyImicwuIEXzcoOyG6/Q+MPGGPaJz oe8+5OZ1U6Nb6MsD2b9jAcKxyS1Hdj4QbGAjse310EEYYdtuQSlKO2M8xMzJYNBOxJKm qQjw== X-Received: by 10.98.32.74 with SMTP id g71mr2711123pfg.46.1450762095763; Mon, 21 Dec 2015 21:28:15 -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 w72sm38078695pfi.75.2015.12.21.21.28.10 (version=TLS1 cipher=AES128-SHA bits=128/128); Mon, 21 Dec 2015 21:28:12 -0800 (PST) X-Google-Original-From: "John Wiegley" Original-Received: by Vulcan.local (Postfix, from userid 501) id 074A811A46D4B; Mon, 21 Dec 2015 21:28:10 -0800 (PST) In-Reply-To: <83fuyyv10w.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 19 Dec 2015 18:47:11 +0200") User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin) Mail-Followup-To: Eli Zaretskii , Michael Heerdegen , acm@muc.de, emacs-devel@gnu.org X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400e:c00::22f 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:196643 Archived-At: >>>>> Eli Zaretskii writes: > 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. Agreed. After I have absorbed all feedback on my proposed tutorial, I'll recast it into the language of the Elisp manual and include it there. -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2