From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: [PATCH] Add a new function to convert a time value to the
	canonical format.
Date: Tue, 23 Apr 2019 20:11:22 +0300
Message-ID: <837ebk4pfp.fsf@gnu.org>
References: <20190423124613.36743-1-phst@google.com> <83o94w50j9.fsf@gnu.org>
	<CAArVCkQvNV9Gj1i4q=3c4uJiwBCYJWsrJq+XszQcTh8PNt987Q@mail.gmail.com>
	<83lg00502c.fsf@gnu.org>
	<70396a58-87ba-b7bd-e555-80ee2a7aebb2@cs.ucla.edu>
Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226";
	logging-data="26219"; mail-complaints-to="usenet@blaine.gmane.org"
Cc: phst@google.com, p.stephani2@gmail.com, emacs-devel@gnu.org
To: Paul Eggert <eggert@cs.ucla.edu>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Apr 23 19:11:41 2019
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Envelope-to: ged-emacs-devel@m.gmane.org
Original-Received: from lists.gnu.org ([209.51.188.17])
	by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>)
	id 1hIyxJ-0006jQ-Hx
	for ged-emacs-devel@m.gmane.org; Tue, 23 Apr 2019 19:11:41 +0200
Original-Received: from localhost ([127.0.0.1]:56939 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>)
	id 1hIyxI-00046m-Cr
	for ged-emacs-devel@m.gmane.org; Tue, 23 Apr 2019 13:11:40 -0400
Original-Received: from eggs.gnu.org ([209.51.188.92]:34526)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <eliz@gnu.org>) id 1hIyxB-00046h-NV
	for emacs-devel@gnu.org; Tue, 23 Apr 2019 13:11:34 -0400
Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:38430)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <eliz@gnu.org>)
	id 1hIyxA-0001ab-L3; Tue, 23 Apr 2019 13:11:33 -0400
Original-Received: from [176.228.60.248] (port=3257 helo=home-c4e4a596f7)
	by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256)
	(Exim 4.82) (envelope-from <eliz@gnu.org>)
	id 1hIyx6-00019a-Q5; Tue, 23 Apr 2019 13:11:31 -0400
In-reply-to: <70396a58-87ba-b7bd-e555-80ee2a7aebb2@cs.ucla.edu> (message from
	Paul Eggert on Tue, 23 Apr 2019 09:20:34 -0700)
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-devel/>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org
Original-Sender: "Emacs-devel" <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Xref: news.gmane.org gmane.emacs.devel:235833
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/235833>

> From: Paul Eggert <eggert@cs.ucla.edu>
> Date: Tue, 23 Apr 2019 09:20:34 -0700
> Cc: phst@google.com, emacs-devel@gnu.org
> 
> On 4/23/19 6:21 AM, Eli Zaretskii wrote:
> > No need to apologize.
> >
> > How about a patch for the ELisp manual to mention this use case?
> 
> The manual already says this:
> 
> You can convert a time value into
> a human-readable string using @code{format-time-string}, into a Lisp
> timestamp using @code{encode-time}, and into other forms using
> @code{decode-time} and @code{float-time}.

I guess I misunderstood what TIMEVAL stood for in (encode-time timeval t).