From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: The poor state of documentation of pcase like things. Date: Thu, 17 Dec 2015 17:06:05 +0000 Message-ID: <20151217170605.GA1888@acm.fritz.box> References: <20151216202605.GA3752@acm.fritz.box> <87lh8t6uqr.fsf@russet.org.uk> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1450372840 4573 80.91.229.3 (17 Dec 2015 17:20:40 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 17 Dec 2015 17:20:40 +0000 (UTC) Cc: emacs-devel@gnu.org To: Phillip Lord Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Dec 17 18:20:33 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 1a9cEC-0003eB-Pv for ged-emacs-devel@m.gmane.org; Thu, 17 Dec 2015 18:20:32 +0100 Original-Received: from localhost ([::1]:55215 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9cEC-0002h6-3s for ged-emacs-devel@m.gmane.org; Thu, 17 Dec 2015 12:20:32 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36837) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9byC-0000yY-8M for emacs-devel@gnu.org; Thu, 17 Dec 2015 12:04:01 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a9by8-000300-3s for emacs-devel@gnu.org; Thu, 17 Dec 2015 12:04:00 -0500 Original-Received: from mail.muc.de ([193.149.48.3]:40240) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a9by7-0002zt-Qu for emacs-devel@gnu.org; Thu, 17 Dec 2015 12:03:56 -0500 Original-Received: (qmail 58198 invoked by uid 3782); 17 Dec 2015 17:03:54 -0000 Original-Received: from acm.muc.de (p5B146235.dip0.t-ipconnect.de [91.20.98.53]) by colin.muc.de (tmda-ofmipd) with ESMTP; Thu, 17 Dec 2015 18:03:52 +0100 Original-Received: (qmail 3055 invoked by uid 1000); 17 Dec 2015 17:06:05 -0000 Content-Disposition: inline In-Reply-To: <87lh8t6uqr.fsf@russet.org.uk> User-Agent: Mutt/1.5.23 (2014-03-12) X-Delivery-Agent: TMDA/1.1.12 (Macallan) X-Primary-Address: acm@muc.de X-detected-operating-system: by eggs.gnu.org: FreeBSD 9.x X-Received-From: 193.149.48.3 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:196426 Archived-At: Hello, Phillip. On Thu, Dec 17, 2015 at 01:59:56PM +0000, Phillip Lord wrote: > Alan Mackenzie writes: > > Some of these doc strings are patronising indeed. They all seem to say, > > implicitly, "the author's time is far too valuable to waste in writing > > meaningful documentation". > I think it's probably better to make your points (which are reasonable) > without making such aspersions. The author in question has been > extremely generous with their time. I'm aware of this, and I'm not making any such asperesions. I'm merely trying to point out how these doc strings will be perceived by users, should they still be in their current state at the 25.1 release. [ .... ] > Phil -- Alan Mackenzie (Nuremberg, Germany).