From unknown Wed Sep 10 10:35:47 2025 X-Loop: owner@emacsbugs.donarmstrong.com Subject: bug#4637: 23.1; (elisp)Time of Day doc Reply-To: "Drew Adams" , 4637@debbugs.gnu.org Resent-From: "Drew Adams" Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Mon, 05 Oct 2009 00:55:07 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-Emacs-PR-Message: report 4637 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.125470358831292 (code B ref -1); Mon, 05 Oct 2009 00:55:07 +0000 Received: (at submit) by emacsbugs.donarmstrong.com; 5 Oct 2009 00:46:28 +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=-2.4 required=4.0 tests=AWL,FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n950kR7E031288 for ; Sun, 4 Oct 2009 17:46:28 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Mubic-0006C5-Qd for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 20:46:26 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MubiY-0006AU-7l for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 20:46:26 -0400 Received: from [199.232.76.173] (port=46517 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MubiY-0006AR-2x for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 20:46:22 -0400 Received: from acsinet11.oracle.com ([141.146.126.233]:21698) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MubiX-000642-H1 for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 20:46:21 -0400 Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by acsinet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n950kQxV030882 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 5 Oct 2009 00:46:28 GMT Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n94NQQmN005479 for ; Mon, 5 Oct 2009 00:46:15 GMT Received: from abhmt015.oracle.com by acsmt354.oracle.com with ESMTP id 20189455811254703570; Sun, 04 Oct 2009 17:46:10 -0700 Received: from dradamslap1 (/24.5.184.158) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 04 Oct 2009 17:46:09 -0700 From: "Drew Adams" To: Date: Sun, 4 Oct 2009 17:46:21 -0700 Message-ID: <05DE305EC24445608371F11CF7F0007F@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcpFVUH7uz4Wzp4HTBW6oHo6/N/+HA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: acsmt353.oracle.com [141.146.40.153] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090206.4AC941D7.00C7:SCFMA4539814,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) The doc for `current-time-string', `current-time-zone', and `float-time' says the "argument should be a list whose first two elements are integers." This says nothing about the rest of the list. Does it mean that the rest is ignored and could be anything (any number of elements of any types)? If so, please state that clearly. Or should we rather be saying that the argument has the same form as what is returned by either `current-time' or `file-attributes' (for a time attribute), both of which are described in detail? IOW, is it any list of at least two numbers, with the elements past #2 being ignored, or is it a list of either two or three numbers? In the latter case, if three numbers, is the third number (microsecs) used or ignored? This is not clear, and the doc strings do not clear it up. Also, there are 4 occurrences of the term `file-attributes', but only three of them are followed by a cross reference to node `Definition of file-attributes'. Either all four should have the cross reference or we should include only one cross reference for the whole node. In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600) of 2009-07-29 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4)' From unknown Wed Sep 10 10:35:47 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.427 (Entity 5.427) X-Loop: owner@emacsbugs.donarmstrong.com From: help-debbugs@gnu.org (Emacs bug Tracking System) To: "Drew Adams" Subject: bug#4637 closed by Chong Yidong (Re: 23.1; (elisp)Time of Day doc) Message-ID: References: <878wfcjsi4.fsf@stupidchicken.com> <05DE305EC24445608371F11CF7F0007F@us.oracle.com> X-Emacs-PR-Message: they-closed 4637 X-Emacs-PR-Package: emacs Reply-To: 4637@debbugs.gnu.org Date: Thu, 15 Oct 2009 20:55:05 +0000 Content-Type: multipart/mixed; boundary="----------=_1255640105-15792-1" This is a multi-part message in MIME format... ------------=_1255640105-15792-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: #4637: 23.1; (elisp)Time of Day doc 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 4637: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D4637 Emacs Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1255640105-15792-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 4637-done) by emacsbugs.donarmstrong.com; 15 Oct 2009 20:45:46 +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.4 required=4.0 tests=AWL autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from pantheon-po39.its.yale.edu (pantheon-po39.its.yale.edu [130.132.50.100]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n9FKjiHs015026 for <4637-done@emacsbugs.donarmstrong.com>; Thu, 15 Oct 2009 13:45:45 -0700 Received: from furry (dhcp128036014244.central.yale.edu [128.36.14.244]) (authenticated bits=0) by pantheon-po39.its.yale.edu (8.12.11.20060308/8.12.11) with ESMTP id n9FKjc6r025741 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 15 Oct 2009 16:45:39 -0400 Received: by furry (Postfix, from userid 1000) id 1E830C070; Thu, 15 Oct 2009 16:45:39 -0400 (EDT) From: Chong Yidong To: "Drew Adams" Cc: 4637-done@debbugs.gnu.org Subject: Re: 23.1; (elisp)Time of Day doc Date: Thu, 15 Oct 2009 16:45:39 -0400 Message-ID: <878wfcjsi4.fsf@stupidchicken.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-YaleITSMailFilter: Version 1.2c (attachment(s) not renamed) > The doc for `current-time-string', `current-time-zone', and > `float-time' says the "argument should be a list whose first two > elements are integers." > This says nothing about the rest of the list. Does it mean that the > rest is ignored and could be anything (any number of elements of any > types)? If so, please state that clearly. The microseconds part is ignored. I've checked in a clarification; thanks. ------------=_1255640105-15792-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by emacsbugs.donarmstrong.com; 5 Oct 2009 00:46:28 +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=-2.4 required=4.0 tests=AWL,FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n950kR7E031288 for ; Sun, 4 Oct 2009 17:46:28 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Mubic-0006C5-Qd for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 20:46:26 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MubiY-0006AU-7l for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 20:46:26 -0400 Received: from [199.232.76.173] (port=46517 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MubiY-0006AR-2x for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 20:46:22 -0400 Received: from acsinet11.oracle.com ([141.146.126.233]:21698) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MubiX-000642-H1 for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 20:46:21 -0400 Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by acsinet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n950kQxV030882 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 5 Oct 2009 00:46:28 GMT Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n94NQQmN005479 for ; Mon, 5 Oct 2009 00:46:15 GMT Received: from abhmt015.oracle.com by acsmt354.oracle.com with ESMTP id 20189455811254703570; Sun, 04 Oct 2009 17:46:10 -0700 Received: from dradamslap1 (/24.5.184.158) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 04 Oct 2009 17:46:09 -0700 From: "Drew Adams" To: Subject: 23.1; (elisp)Time of Day doc Date: Sun, 4 Oct 2009 17:46:21 -0700 Message-ID: <05DE305EC24445608371F11CF7F0007F@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcpFVUH7uz4Wzp4HTBW6oHo6/N/+HA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: acsmt353.oracle.com [141.146.40.153] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090206.4AC941D7.00C7:SCFMA4539814,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) The doc for `current-time-string', `current-time-zone', and `float-time' says the "argument should be a list whose first two elements are integers." This says nothing about the rest of the list. Does it mean that the rest is ignored and could be anything (any number of elements of any types)? If so, please state that clearly. Or should we rather be saying that the argument has the same form as what is returned by either `current-time' or `file-attributes' (for a time attribute), both of which are described in detail? IOW, is it any list of at least two numbers, with the elements past #2 being ignored, or is it a list of either two or three numbers? In the latter case, if three numbers, is the third number (microsecs) used or ignored? This is not clear, and the doc strings do not clear it up. Also, there are 4 occurrences of the term `file-attributes', but only three of them are followed by a cross reference to node `Definition of file-attributes'. Either all four should have the cross reference or we should include only one cross reference for the whole node. In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600) of 2009-07-29 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4)' ------------=_1255640105-15792-1--