From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#37875: 27.0.50; `run-with-timer' not documented in (elisp)Timers Date: Tue, 29 Oct 2019 13:37:08 +0100 Message-ID: <871ruv20ej.fsf@gnus.org> References: <7a3175eb-dc19-afe7-b5fa-964eabf31ace@orcon.net.nz> <87v9sg0wtq.fsf@web.de> <87o8y0986h.fsf@gnus.org> <831ruwst2u.fsf@gnu.org> <87wocn23y1.fsf@gnus.org> <83pnifpwb1.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="80854"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: michael_heerdegen@web.de, psainty@orcon.net.nz, 37875@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Oct 29 13:38:13 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iPQlI-000Kvm-Uq for geb-bug-gnu-emacs@m.gmane.org; Tue, 29 Oct 2019 13:38:13 +0100 Original-Received: from localhost ([::1]:56384 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iPQlH-0002gi-8V for geb-bug-gnu-emacs@m.gmane.org; Tue, 29 Oct 2019 08:38:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47388) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iPQl9-0002ez-TL for bug-gnu-emacs@gnu.org; Tue, 29 Oct 2019 08:38:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iPQl8-00050m-R0 for bug-gnu-emacs@gnu.org; Tue, 29 Oct 2019 08:38:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:38185) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iPQl8-00050e-Nh for bug-gnu-emacs@gnu.org; Tue, 29 Oct 2019 08:38:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iPQl8-0007tj-IV for bug-gnu-emacs@gnu.org; Tue, 29 Oct 2019 08:38:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 29 Oct 2019 12:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 37875 X-GNU-PR-Package: emacs Original-Received: via spool by 37875-submit@debbugs.gnu.org id=B37875.157235263530280 (code B ref 37875); Tue, 29 Oct 2019 12:38:02 +0000 Original-Received: (at 37875) by debbugs.gnu.org; 29 Oct 2019 12:37:15 +0000 Original-Received: from localhost ([127.0.0.1]:47006 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iPQkM-0007sK-UL for submit@debbugs.gnu.org; Tue, 29 Oct 2019 08:37:15 -0400 Original-Received: from quimby.gnus.org ([80.91.231.51]:55848) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iPQkL-0007sC-1G for 37875@debbugs.gnu.org; Tue, 29 Oct 2019 08:37:14 -0400 Original-Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iPQkG-0000gO-P9; Tue, 29 Oct 2019 13:37:11 +0100 In-Reply-To: <83pnifpwb1.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 29 Oct 2019 14:31:46 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:170367 Archived-At: Eli Zaretskii writes: >> Not really -- I wondered why there were two functions (run-with-timer >> and run-at-time) that are identical. > > Because they aren't identical, see Phil's response. run-after-delay > was just that: it would run the function after a delay of SECS, and > that argument isn't supposed to be anything but a number of seconds to > wait from NOW. I grepped through the tree -- people seem to use the two functions interchangeably (i.e., there are calls to run-with-timer with a t value for SECS etc). But, OK, if you want to have two functions that are identical (only differing in the doc string), then both functions should be documented in the lispref manual. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no