From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#4637: 23.1; (elisp)Time of Day doc Date: Sun, 4 Oct 2009 17:46:21 -0700 Message-ID: <05DE305EC24445608371F11CF7F0007F@us.oracle.com> Reply-To: Drew Adams , 4637@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1254704849 9089 80.91.229.12 (5 Oct 2009 01:07:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 5 Oct 2009 01:07:29 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Oct 05 03:07:22 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1Muc2r-00011j-Iq for geb-bug-gnu-emacs@m.gmane.org; Mon, 05 Oct 2009 03:07:21 +0200 Original-Received: from localhost ([127.0.0.1]:45628 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Muc2r-0002Ft-LO for geb-bug-gnu-emacs@m.gmane.org; Sun, 04 Oct 2009 21:07:21 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Muc2l-0002F5-HF for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 21:07:15 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Muc2h-0002Dm-RQ for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 21:07:15 -0400 Original-Received: from [199.232.76.173] (port=49562 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Muc2h-0002Dc-G5 for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 21:07:11 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:40429) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Muc2g-0000wn-PJ for bug-gnu-emacs@gnu.org; Sun, 04 Oct 2009 21:07:11 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n95178ij002908; Sun, 4 Oct 2009 18:07:08 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n950t80X032436; Sun, 4 Oct 2009 17:55:08 -0700 Resent-Date: Sun, 4 Oct 2009 17:55:08 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Mon, 05 Oct 2009 00:55:07 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 4637 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.125470358831292 (code B ref -1); Mon, 05 Oct 2009 00:55:07 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 5 Oct 2009 00:46:28 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-Received: from abhmt015.oracle.com by acsmt354.oracle.com with ESMTP id 20189455811254703570; Sun, 04 Oct 2009 17:46:10 -0700 Original-Received: from dradamslap1 (/24.5.184.158) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 04 Oct 2009 17:46:09 -0700 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) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Sun, 04 Oct 2009 21:07:15 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:31678 Archived-At: 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)'