From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: Replace trivial pcase occurrences in the Emacs sources Date: Mon, 29 Oct 2018 09:28:25 -0400 Message-ID: References: <87h9iunkcg.fsf@web.de> <87h8hc4xw2.fsf_-_@web.de> <83tvlcsnee.fsf@gnu.org> <86mur137n8.fsf@gmail.com> <20181029130132.GB4195@ACM> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1540819604 15209 195.159.176.226 (29 Oct 2018 13:26:44 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 29 Oct 2018 13:26:44 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Oct 29 14:26:40 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 1gH7Z1-0003sV-VX for ged-emacs-devel@m.gmane.org; Mon, 29 Oct 2018 14:26:40 +0100 Original-Received: from localhost ([::1]:45593 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gH7b8-0006mQ-Da for ged-emacs-devel@m.gmane.org; Mon, 29 Oct 2018 09:28:50 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58022) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gH7b2-0006mH-7I for emacs-devel@gnu.org; Mon, 29 Oct 2018 09:28:44 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gH7az-0006vZ-JU for emacs-devel@gnu.org; Mon, 29 Oct 2018 09:28:44 -0400 Original-Received: from [195.159.176.226] (port=53265 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gH7az-0006sU-8M for emacs-devel@gnu.org; Mon, 29 Oct 2018 09:28:41 -0400 Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1gH7Yi-0003YP-TC for emacs-devel@gnu.org; Mon, 29 Oct 2018 14:26:20 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 22 Original-X-Complaints-To: usenet@blaine.gmane.org Cancel-Lock: sha1:+aBuP+3vrrC6K/z8dRaS/XWGfHI= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 195.159.176.226 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:230765 Archived-At: > 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. I understand this in theory, but I don't know what it means in this concrete case. > I've had such questions in the past, and had to answer them by time > consuming guessing, reading the source of pcase-..., and > experimentation. Do you remember them enough to describe the problems, so we can try and improve the doc accordingly? > Adequate documentation would have saved me a great deal of time, > frustration, and uncertainty. I don't doubt it. But I'm sadly not able to guess what those problems might be. Stefan