From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: Replace trivial pcase occurrences in the Emacs sources Date: Mon, 29 Oct 2018 13:01:32 +0000 Message-ID: <20181029130132.GB4195@ACM> References: <87h9iunkcg.fsf@web.de> <87h8hc4xw2.fsf_-_@web.de> <83tvlcsnee.fsf@gnu.org> <86mur137n8.fsf@gmail.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: blaine.gmane.org 1540818664 10628 195.159.176.226 (29 Oct 2018 13:11:04 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 29 Oct 2018 13:11:04 +0000 (UTC) User-Agent: Mutt/1.10.1 (2018-07-13) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Oct 29 14:11:00 2018 Return-path: Envelope-to: ged-emacs-devel@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 1gH7Jr-0002dG-BC for ged-emacs-devel@m.gmane.org; Mon, 29 Oct 2018 14:10:59 +0100 Original-Received: from localhost ([::1]:45504 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gH7Lx-0004Km-Q4 for ged-emacs-devel@m.gmane.org; Mon, 29 Oct 2018 09:13:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53656) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gH7KQ-00037a-6w for emacs-devel@gnu.org; Mon, 29 Oct 2018 09:11:37 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gH7KH-00065R-0U for emacs-devel@gnu.org; Mon, 29 Oct 2018 09:11:29 -0400 Original-Received: from colin.muc.de ([193.149.48.1]:50171 helo=mail.muc.de) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1gH7KG-0005yn-JI for emacs-devel@gnu.org; Mon, 29 Oct 2018 09:11:24 -0400 Original-Received: (qmail 34642 invoked by uid 3782); 29 Oct 2018 13:11:15 -0000 Original-Received: from acm.muc.de (p5B1478E3.dip0.t-ipconnect.de [91.20.120.227]) by colin.muc.de (tmda-ofmipd) with ESMTP; Mon, 29 Oct 2018 14:11:13 +0100 Original-Received: (qmail 6026 invoked by uid 1000); 29 Oct 2018 13:01:32 -0000 Content-Disposition: inline In-Reply-To: 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 [fuzzy] X-Received-From: 193.149.48.1 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:230764 Archived-At: Hello, Stefan. On Sun, Oct 28, 2018 at 17:44:57 -0400, Stefan Monnier wrote: > > pcase-lambda, pcase-let, pcase-let*, and pcase-dolist still have no > > meaningful documentation, > Not sure what kind of documentation would be more meaningful, sorry. Doc strings which specify fully the arguments to these macros, including their semantics, and say what the macros do. The current doc strings (at least some of them) for these macros don't do this. Entries in the elisp manual. These don't exist at all. (Or, if they do, they don't have index entries.) > Do you happen to have concrete questions about them which aren't answered > by their docstrings? I've had such questions in the past, and had to answer them by time consuming guessing, reading the source of pcase-..., and experimentation. Adequate documentation would have saved me a great deal of time, frustration, and uncertainty. [ .... ] > Stefan -- Alan Mackenzie (Nuremberg, Germany).