From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#39668: 26.2; timer-list and timer-idle-list are undocumented in the Elisp manual Date: Tue, 18 Feb 2020 21:26:12 +0200 Message-ID: <83r1yrlmsr.fsf@gnu.org> References: <83sgj7lp5o.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="70322"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 39668@debbugs.gnu.org To: ndame Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Feb 18 20:27:49 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1j48X6-000IBU-Et for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 18 Feb 2020 20:27:48 +0100 Original-Received: from localhost ([::1]:40792 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j48X5-000804-Ei for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 18 Feb 2020 14:27:47 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52631) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j48WN-0007Zo-Oq for bug-gnu-emacs@gnu.org; Tue, 18 Feb 2020 14:27:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j48WM-0005ww-OG for bug-gnu-emacs@gnu.org; Tue, 18 Feb 2020 14:27:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:35312) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1j48WM-0005wS-KE for bug-gnu-emacs@gnu.org; Tue, 18 Feb 2020 14:27:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1j48WM-0001v9-Fq for bug-gnu-emacs@gnu.org; Tue, 18 Feb 2020 14:27:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 18 Feb 2020 19:27:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 39668 X-GNU-PR-Package: emacs Original-Received: via spool by 39668-submit@debbugs.gnu.org id=B39668.15820539977349 (code B ref 39668); Tue, 18 Feb 2020 19:27:02 +0000 Original-Received: (at 39668) by debbugs.gnu.org; 18 Feb 2020 19:26:37 +0000 Original-Received: from localhost ([127.0.0.1]:41285 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j48Vx-0001uT-K2 for submit@debbugs.gnu.org; Tue, 18 Feb 2020 14:26:37 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:36185) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j48Vw-0001uH-Ea for 39668@debbugs.gnu.org; Tue, 18 Feb 2020 14:26:36 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:52520) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1j48Vq-000514-V6; Tue, 18 Feb 2020 14:26:31 -0500 Original-Received: from [176.228.60.248] (port=3083 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1j48Vi-0000zN-EG; Tue, 18 Feb 2020 14:26:29 -0500 In-reply-to: (message from ndame on Tue, 18 Feb 2020 18:45:56 +0000 (GMT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:176205 Archived-At: > Date: Tue, 18 Feb 2020 18:45:56 +0000 (GMT) > From: ndame > Cc: "39668@debbugs.gnu.org" <39668@debbugs.gnu.org> > > I needed to access the list of the active timers from an elisp program. > Since timers are available from elisp, the list of timers should be > available too, like the list of buffers, etc. > > I was suprised that I did not find this in the manual. Since timers are > part of the public elisp api, I expect timer lists also to be part of the > public api. We don't describe those lists intentionally, because messing with them can produce unexpected results. Think about that: while you are modifying the list of timers, some timer might expire, and Emacs will run it, and modify the list as result. (We do have protection from at least the simplest forms of such races, but still, we don't like to have Lisp programs manipulate those lists.) Why do you need to access the active timers?