From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: master b342815: Improve define-function omitted-arg documentation Date: Fri, 27 May 2016 21:51:07 +0300 Message-ID: <83lh2vz65g.fsf@gnu.org> References: <20160527164722.20278.19217@vcs.savannah.gnu.org> <20160527164723.4A992220156@vcs.savannah.gnu.org> <27d1o7ph7e.fsf@fencepost.gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1464375124 27508 80.91.229.3 (27 May 2016 18:52:04 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 27 May 2016 18:52:04 +0000 (UTC) Cc: eggert@cs.ucla.edu, emacs-devel@gnu.org To: Glenn Morris Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri May 27 20:51:59 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 1b6MrX-0001rw-Ec for ged-emacs-devel@m.gmane.org; Fri, 27 May 2016 20:51:59 +0200 Original-Received: from localhost ([::1]:47405 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6MrW-00034j-Fn for ged-emacs-devel@m.gmane.org; Fri, 27 May 2016 14:51:58 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48577) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6Mql-0002wa-5N for emacs-devel@gnu.org; Fri, 27 May 2016 14:51:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b6Mqj-0005wr-5W for emacs-devel@gnu.org; Fri, 27 May 2016 14:51:10 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:57749) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6Mqe-0005uZ-2R; Fri, 27 May 2016 14:51:04 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3589 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1b6Mqb-00074Q-MB; Fri, 27 May 2016 14:51:02 -0400 In-reply-to: <27d1o7ph7e.fsf@fencepost.gnu.org> (message from Glenn Morris on Fri, 27 May 2016 13:02:29 -0400) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e 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:204088 Archived-At: > From: Glenn Morris > Date: Fri, 27 May 2016 13:02:29 -0400 > Cc: Paul Eggert > > 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. Not only mentioned, it also needs to be used when you want to specify FILEONLY, but leave the argument least unspecified. So we cannot hide that, I think. I agree that the special meaning of omitting ARGLIST could be described differently, but I find the text that Paul installed clear and definitely adequate,