GNU bug report logs -
#2768
23.0.60; Misleading function description for float-time
Previous Next
Reported by: David Kastrup <dak <at> gnu.org>
Date: Tue, 24 Mar 2009 10:10:03 UTC
Severity: normal
Done: Chong Yidong <cyd <at> stupidchicken.com>
Bug is archived. No further changes may be made.
Full log
View this message in rfc822 format
[Message part 1 (text/plain, inline)]
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 <cyd <at> stupidchicken.com>.
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 <cyd <at> stupidchicken.com> by
replying to this email.
--
2768: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=2768
Emacs Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
> 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.
[Message part 3 (message/rfc822, inline)]
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 <at> 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
This bug report was last modified 16 years and 122 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.