From unknown Sat Aug 16 22:47:00 2025 X-Loop: owner@emacsbugs.donarmstrong.com Subject: bug#2768: 23.0.60; Misleading function description for float-time Reply-To: David Kastrup , 2768@debbugs.gnu.org Resent-From: David Kastrup Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Tue, 24 Mar 2009 10:10:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-Emacs-PR-Message: report 2768 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.123788908326775 (code B ref -1); Tue, 24 Mar 2009 10:10:03 +0000 Received: (at submit) by emacsbugs.donarmstrong.com; 24 Mar 2009 10:04:43 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.1 required=4.0 tests=FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n2OA4d1h026769 for ; Tue, 24 Mar 2009 03:04:40 -0700 Received: from mx10.gnu.org ([199.232.76.166]:34966) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1Lm3Us-0008LQ-Pg for emacs-pretest-bug@gnu.org; Tue, 24 Mar 2009 06:04:38 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1Lm3Up-0004pX-F0 for emacs-pretest-bug@gnu.org; Tue, 24 Mar 2009 06:04:38 -0400 Received: from mail.quinscape.de ([212.29.44.217]:60968) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Lm3Uo-0004or-S1 for emacs-pretest-bug@gnu.org; Tue, 24 Mar 2009 06:04:35 -0400 Received: (qmail-ldap/ctrl 13084 invoked from network); 24 Mar 2009 10:04:32 -0000 Received: from unknown (HELO lola.quinscape.zz) ([10.0.3.43]) (envelope-sender ) by quinx.quinscape.de (qmail-ldap-1.03) with SMTP for ; 24 Mar 2009 10:04:32 -0000 Received: by lola.quinscape.zz (Postfix, from userid 1001) id 033FA8F85A; Tue, 24 Mar 2009 11:04:31 +0100 (CET) From: David Kastrup To: emacs-pretest-bug@gnu.org Date: Tue, 24 Mar 2009 11:04:31 +0100 Message-ID: <86zlfbck40.fsf@lola.quinscape.zz> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-AntiVirus: checked by AntiVir MailGate (version: 2.1.3-2; AVE: 7.9.0.120; VDF: 7.1.2.206; host: quinscape.de) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Please write in English if possible, because the Emacs maintainers usually do not have translators to read other languages for them. Your bug report will be posted to the emacs-pretest-bug@gnu.org mailing list. Please describe exactly what actions triggered the bug and the precise symptoms of the bug: The DOC string for float-time says float-time is a built-in function in `C source code'. (float-time &optional specified-time) Return the current time, as a float number of seconds since the epoch. If specified-time is given, it is the time to convert to float instead of the current time. The argument should have the form (HIGH LOW . IGNORED). Thus, you can use times obtained from `current-time' and from `file-attributes'. specified-time can also have the form (HIGH . LOW), but this is considered obsolete. WARNING: Since the result is floating point, it may not be exact. Do not use this function if precise time stamps are required. [back] However, the argument "IGNORED" is not ignored but rather specifies microseconds that _do_ appear in the resulting time value. While the doc string does not explicitly specify what happens to "IGNORED", its name strongly suggests a different (and undesirable) behavior. In GNU Emacs 23.0.60.2 (i686-pc-linux-gnu, GTK+ Version 2.12.9) of 2009-01-13 on lisa Windowing system distributor `The X.Org Foundation', version 11.0.10400090 configured using `configure '--prefix=/usr/local/emacs-21' '--without-toolkit-scroll-bars'' Important settings: value of $LC_ALL: nil value of $LC_COLLATE: nil value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: en_US.UTF-8 value of $XMODIFIERS: nil locale-coding-system: utf-8-unix default-enable-multibyte-characters: t Major mode: Message Minor modes in effect: mml-mode: t gnus-message-citation-mode: t TeX-PDF-mode: t server-mode: t desktop-save-mode: t tooltip-mode: t mouse-wheel-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t global-auto-composition-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t abbrev-mode: t -- David Kastrup From unknown Sat Aug 16 22:47:00 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.420 (Entity 5.420) X-Loop: owner@emacsbugs.donarmstrong.com From: help-debbugs@gnu.org (Emacs bug Tracking System) To: David Kastrup Subject: bug#2768 closed by Chong Yidong (Re: 23.0.60; Misleading function description for float-time) Message-ID: References: <877i2eyg3v.fsf@cyd.mit.edu> <86zlfbck40.fsf@lola.quinscape.zz> X-Emacs-PR-Message: they-closed 2768 X-Emacs-PR-Package: emacs Reply-To: 2768@debbugs.gnu.org Date: Tue, 24 Mar 2009 17:45:04 +0000 Content-Type: multipart/mixed; boundary="----------=_1237916704-23402-1" This is a multi-part message in MIME format... ------------=_1237916704-23402-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" This is an automatic notification regarding your bug report which was filed against the emacs package: #2768: 23.0.60; Misleading function description for float-time It has been closed by Chong Yidong . Their explanation is attached below along with your original report. If this explanation is unsatisfactory and you have not received a better one in a separate message then please contact Chong Yidong by replying to this email. --=20 2768: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D2768 Emacs Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1237916704-23402-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 2768-done) by emacsbugs.donarmstrong.com; 24 Mar 2009 17:38:40 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.0 required=4.0 tests=none autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from cyd.mit.edu (CYD.MIT.EDU [18.115.2.24]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n2OHcbJJ022075 for <2768-done@emacsbugs.donarmstrong.com>; Tue, 24 Mar 2009 10:38:38 -0700 Received: by cyd.mit.edu (Postfix, from userid 1000) id B47D957E205; Tue, 24 Mar 2009 13:40:04 -0400 (EDT) From: Chong Yidong To: David Kastrup Cc: 2768-done@debbugs.gnu.org Subject: Re: 23.0.60; Misleading function description for float-time Date: Tue, 24 Mar 2009 13:40:04 -0400 Message-ID: <877i2eyg3v.fsf@cyd.mit.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii > the argument "IGNORED" is not ignored but rather specifies > microseconds that _do_ appear in the resulting time value. While the > doc string does not explicitly specify what happens to "IGNORED", its > name strongly suggests a different (and undesirable) behavior. I've corrected this. Thanks very much for pointing it out. ------------=_1237916704-23402-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by emacsbugs.donarmstrong.com; 24 Mar 2009 10:04:43 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.1 required=4.0 tests=FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n2OA4d1h026769 for ; Tue, 24 Mar 2009 03:04:40 -0700 Received: from mx10.gnu.org ([199.232.76.166]:34966) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1Lm3Us-0008LQ-Pg for emacs-pretest-bug@gnu.org; Tue, 24 Mar 2009 06:04:38 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1Lm3Up-0004pX-F0 for emacs-pretest-bug@gnu.org; Tue, 24 Mar 2009 06:04:38 -0400 Received: from mail.quinscape.de ([212.29.44.217]:60968) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Lm3Uo-0004or-S1 for emacs-pretest-bug@gnu.org; Tue, 24 Mar 2009 06:04:35 -0400 Received: (qmail-ldap/ctrl 13084 invoked from network); 24 Mar 2009 10:04:32 -0000 Received: from unknown (HELO lola.quinscape.zz) ([10.0.3.43]) (envelope-sender ) by quinx.quinscape.de (qmail-ldap-1.03) with SMTP for ; 24 Mar 2009 10:04:32 -0000 Received: by lola.quinscape.zz (Postfix, from userid 1001) id 033FA8F85A; Tue, 24 Mar 2009 11:04:31 +0100 (CET) From: David Kastrup To: emacs-pretest-bug@gnu.org Subject: 23.0.60; Misleading function description for float-time Date: Tue, 24 Mar 2009 11:04:31 +0100 Message-ID: <86zlfbck40.fsf@lola.quinscape.zz> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-AntiVirus: checked by AntiVir MailGate (version: 2.1.3-2; AVE: 7.9.0.120; VDF: 7.1.2.206; host: quinscape.de) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Please write in English if possible, because the Emacs maintainers usually do not have translators to read other languages for them. Your bug report will be posted to the emacs-pretest-bug@gnu.org mailing list. Please describe exactly what actions triggered the bug and the precise symptoms of the bug: The DOC string for float-time says float-time is a built-in function in `C source code'. (float-time &optional specified-time) Return the current time, as a float number of seconds since the epoch. If specified-time is given, it is the time to convert to float instead of the current time. The argument should have the form (HIGH LOW . IGNORED). Thus, you can use times obtained from `current-time' and from `file-attributes'. specified-time can also have the form (HIGH . LOW), but this is considered obsolete. WARNING: Since the result is floating point, it may not be exact. Do not use this function if precise time stamps are required. [back] However, the argument "IGNORED" is not ignored but rather specifies microseconds that _do_ appear in the resulting time value. While the doc string does not explicitly specify what happens to "IGNORED", its name strongly suggests a different (and undesirable) behavior. In GNU Emacs 23.0.60.2 (i686-pc-linux-gnu, GTK+ Version 2.12.9) of 2009-01-13 on lisa Windowing system distributor `The X.Org Foundation', version 11.0.10400090 configured using `configure '--prefix=/usr/local/emacs-21' '--without-toolkit-scroll-bars'' Important settings: value of $LC_ALL: nil value of $LC_COLLATE: nil value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: en_US.UTF-8 value of $XMODIFIERS: nil locale-coding-system: utf-8-unix default-enable-multibyte-characters: t Major mode: Message Minor modes in effect: mml-mode: t gnus-message-citation-mode: t TeX-PDF-mode: t server-mode: t desktop-save-mode: t tooltip-mode: t mouse-wheel-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t global-auto-composition-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t abbrev-mode: t -- David Kastrup ------------=_1237916704-23402-1--