From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: master b342815: Improve define-function omitted-arg documentation Date: Fri, 27 May 2016 10:52:00 -0700 Organization: UCLA Computer Science Department Message-ID: References: <20160527164722.20278.19217@vcs.savannah.gnu.org> <20160527164723.4A992220156@vcs.savannah.gnu.org> <27d1o7ph7e.fsf@fencepost.gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1464371584 4477 80.91.229.3 (27 May 2016 17:53:04 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 27 May 2016 17:53:04 +0000 (UTC) To: Glenn Morris , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri May 27 19:52:49 2016 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 1b6LwG-0005tU-LZ for ged-emacs-devel@m.gmane.org; Fri, 27 May 2016 19:52:48 +0200 Original-Received: from localhost ([::1]:47235 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6LwF-0000l5-Jl for ged-emacs-devel@m.gmane.org; Fri, 27 May 2016 13:52:47 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36815) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6Lve-0000kM-Qw for emacs-devel@gnu.org; Fri, 27 May 2016 13:52:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b6Lva-0007vz-M7 for emacs-devel@gnu.org; Fri, 27 May 2016 13:52:10 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:36098) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6Lva-0007vO-Fp; Fri, 27 May 2016 13:52:06 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 9F08216138E; Fri, 27 May 2016 10:52:01 -0700 (PDT) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id wXOl8xgDpRCH; Fri, 27 May 2016 10:52:00 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 9808D1613D2; Fri, 27 May 2016 10:52:00 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id ZfVV-WxolY7W; Fri, 27 May 2016 10:52:00 -0700 (PDT) Original-Received: from penguin.cs.ucla.edu (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 57D6F16138E; Fri, 27 May 2016 10:52:00 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.1.0 In-Reply-To: <27d1o7ph7e.fsf@fencepost.gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 131.179.128.68 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:204086 Archived-At: On 05/27/2016 10:02 AM, Glenn Morris wrote: > >> IMO all the stuff about t is an internal implementation detail that has >> no place in the documentation. > Ach, blast, I see it was mentioned briefly before. Yes, and I'm afraid the topic needs to be covered in the documentation. I was confused by the old, terser doc, and Eli was I think right in suggesting that define-function's atypical design be covered more clearly. Alternatively, I suppose we could improve define-function's design.... > Prejudiced against Fortran, are we? Guilty as charged. :-) Though there were other reasons for that part of the change: the old Fortrannish documentation mentioned gud-find-c-expr, a function that is no longer in GNU Emacs. Plus, the old doc had a complicated song-and-dance about hooks, whereas the new simple.el example is, well, simpler. > We previously decided against doing this: http://debbugs.gnu.org/8646 Sorry, I wasn't aware of that old decision. I made the change because of a more-recent statement by the current maintainer that we should strive to eliminate warnings rather than continue to live with the current chatter, which too often leads developers to ignore warnings. See: https://lists.gnu.org/archive/html/bug-gnu-emacs/2015-11/msg00902.html