From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Narendra Joshi Newsgroups: gmane.emacs.devel Subject: Re: run-with-idle-timer Doc string Question Date: Sat, 22 Aug 2020 13:05:49 +0200 Message-ID: References: <20200821170639.17BFAC21316@raman-glaptop.localdomain> <835z9bbyy6.fsf@gnu.org> <24384.9384.974174.877940@retriever.mtv.corp.google.com> <831rjzbwzx.fsf@gnu.org> <8b818ae6-3db1-470c-b60d-a4ccd8a33f41@default> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="000000000000caf71f05ad7556d2" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="19521"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Eli Zaretskii , "T.V Raman" , Emacs Devel To: Drew Adams Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Aug 22 13:06:36 2020 Return-path: Envelope-to: ged-emacs-devel@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 1k9RM4-0004zX-9Q for ged-emacs-devel@m.gmane-mx.org; Sat, 22 Aug 2020 13:06:36 +0200 Original-Received: from localhost ([::1]:53394 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1k9RM3-0000JK-8u for ged-emacs-devel@m.gmane-mx.org; Sat, 22 Aug 2020 07:06:35 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55274) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1k9RLa-0008LM-8C for emacs-devel@gnu.org; Sat, 22 Aug 2020 07:06:06 -0400 Original-Received: from mail-wr1-x42a.google.com ([2a00:1450:4864:20::42a]:44139) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1k9RLY-0007xw-EH; Sat, 22 Aug 2020 07:06:05 -0400 Original-Received: by mail-wr1-x42a.google.com with SMTP id c15so4145387wrs.11; Sat, 22 Aug 2020 04:06:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=AU0iNP4U9gGy8IIESw5FTqThqkEXMqWlc99y+2D3QSk=; b=fpx2ZeQJNxLSuBp0h7tHq/i/c+M8Tln9A713sbvt8VbDCgY3FHbseG0+ITpjsbxJ4W 0rCQvJh5ZRzRP68/SQAiaSLv+Jaawsx6NvXNccoFJnJg4XXaAqQOsIxNnZ5+s7mhO3oY nr0b1MD9cdISTkJdr8uMzGe9jAH+ubk4cEeyO34fRVchOCCdvFF87Akul4fkQ6jSAaxj QaGvDB8VC6sKjhSTwe3WVGYrgmoLcoNHtWbJaPaB5HktLyyIq2FDyYuSJaOgP/GNrPX4 8KEwbF0SDGCc9IR9ArkNtUfXkTsK3Lq9NBvKLpoPwT5D5aNMNb4W8syjNOmlns+FFGEw JEUw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=AU0iNP4U9gGy8IIESw5FTqThqkEXMqWlc99y+2D3QSk=; b=ugCoahdak32Vz0Xj14qKdT6gMutl24nk9Kn7BZzYYv1guH3gPbYDN49UlvW0QD+za4 d+WQnfr6v/kR9c363Faxg5uWXeoMVzQ/WOyMAX6gBTxnADr6Ugy0YIXPwimHeWfoO3Ey m9QUcWpvQB1QIhAAeEKOXBDmh4dLb+7g3sWsyh+oPMTXNlA/9YG62MyDXj9u+7lLVaTV TcbjJocWbdI2eCOSW6WE8AT9BAHVs5OMao4Xa8+Fpz7cvT9RX7ovVZM5Sfh0dD2TSVCU QbQNDFxJcStXVW5+jn7df603ifBUm0vdK+ez0Y0+SGtOTTW6bFgXd8uLDJtjI9BPZfWA 8/dg== X-Gm-Message-State: AOAM530R/ukIO/Vky6Yw2BDPFSd9HOPEsv0E7gCQNgaqymFgzWh1bzQs zXmse8juxQH3v7Xr9yBioBaeauD1aEs/Rk966A== X-Google-Smtp-Source: ABdhPJwzGNZZJ9QJhJ85UhfYAIRI0lCeAiZl5p4MFjh0agTVpLgeXaNvz4MoGymHa/hMYhyOkGSl1SrfkBysPXGhEUg= X-Received: by 2002:adf:f011:: with SMTP id j17mr6430182wro.335.1598094362472; Sat, 22 Aug 2020 04:06:02 -0700 (PDT) In-Reply-To: <8b818ae6-3db1-470c-b60d-a4ccd8a33f41@default> Received-SPF: pass client-ip=2a00:1450:4864:20::42a; envelope-from=narendraj9@gmail.com; helo=mail-wr1-x42a.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -17 X-Spam_score: -1.8 X-Spam_bar: - X-Spam_report: (-1.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:254111 Archived-At: --000000000000caf71f05ad7556d2 Content-Type: text/plain; charset="UTF-8" It took me a long time to arrive at the fact that it is only possible to know that Emacs has already been idle for SECS seconds when we are executing a callback for a run-with-idle-timer call with a delay arg of SECS seconds. The docstring could state this in more detail. On Fri, 21 Aug 2020, 23:25 Drew Adams, wrote: > > I think the part that makes it a bit confusing is > > that we are talking about calling run-with-idle-timer > > with a lower value of SECS from an already executing > > callback for another run-with-idle-timer. > > Gee, what could possibly be confusing about that? ;-) > > (Especially if we don't say that explicitly.) > > > --000000000000caf71f05ad7556d2 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
It took me a long time to arrive at the fact that it is o= nly possible to know that Emacs has already been idle for SECS seconds when= we are executing a callback for a run-with-idle-timer call with a delay ar= g of SECS seconds. The docstring could state this in more detail.=C2=A0
On F= ri, 21 Aug 2020, 23:25 Drew Adams, <drew.adams@oracle.com> wrote:
> I think the part that makes it a bit confusing is
> that we are talking about calling run-with-idle-timer
> with a lower value of SECS from an already executing
> callback for another run-with-idle-timer.

Gee, what could possibly be confusing about that? ;-)

(Especially if we don't say that explicitly.)


--000000000000caf71f05ad7556d2--