From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.devel Subject: Re: Decoded time accessors Date: Mon, 08 Jul 2019 00:20:02 +0200 Message-ID: References: <20190707214326.GD4053@ACM> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="262259"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: emacs-devel@gnu.org To: Alan Mackenzie Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jul 08 00:20:17 2019 Return-path: 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.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hkFW4-00165n-Dx for ged-emacs-devel@m.gmane.org; Mon, 08 Jul 2019 00:20:16 +0200 Original-Received: from localhost ([::1]:37218 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hkFW3-0001KB-4U for ged-emacs-devel@m.gmane.org; Sun, 07 Jul 2019 18:20:15 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53611) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hkFVx-0001Jq-Cm for emacs-devel@gnu.org; Sun, 07 Jul 2019 18:20:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hkFVw-00083k-9d for emacs-devel@gnu.org; Sun, 07 Jul 2019 18:20:09 -0400 Original-Received: from quimby.gnus.org ([80.91.231.51]:40168) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hkFVw-00082J-2c for emacs-devel@gnu.org; Sun, 07 Jul 2019 18:20:08 -0400 Original-Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=stories) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hkFVq-00030m-QZ; Mon, 08 Jul 2019 00:20:05 +0200 Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAMFBMVEUwQ7YXI28HBQwEAgUJ CiEKDS88T8MCAAEPEjyFf5UYKYMUHl4aMJgfN6oICBkQGFI/Bk3WAAACPklEQVQ4jXXUMWjbUBAG 4Js6tYPGukPhOVBPGvQGdw7PkC4ZUgsEBtdTIEOWetCWobVBoYOhUMijQ8nqeumWVoPjNdjQriZe FA0tgQedNah39yRZbumBMdbHf3fvgQxSSs8Te43p9YPjqk70MUgqce9MlxsA2BqIpvTuvN8ILFUM VNtrNZ9/caaz5aYu0A9Vd9groNYNfBWNzrISvm8Tvh+9aRFMlysCqMHLyX9A5VnsNGa41l9wkOcx JmYWiiHQ8YOIoIGworW2EO2CfT7gxCSPed/Vdt8tNEqAfxJ0W1WvAShca5JnNYASKJHVpvOUU05E JdiToAweEgQTu+90OaPxj8jWoDoEmCDhG+ZaF61oLYfnY61KCEqgkMXbGwt4ECwbYtgsQNmD5Ew2 Q3BjgSSzmUt70DWkDDiFhMdQYPODIWDJKEGnWd5uVguEThmJ+Srtygsw6lxThMGxCaxLMCmCXyV4 YazPCPpjr9qLj4mrOU/B/aU/BJ+qvXgz58l8DO5XrfUF7UUZpnl+aAy4+FxfYa+xUoruP54nJhEM 7xoB7jXyhEToKiHSxDUgMDDp4V7jg8cXkd8XwhXG2Fbp6BWefvxNX+1LYauEEd7LKDpMjyy4wra6 73fxjju+6uP7aBNuAp7WP43i6uw3ZSEI8lwr1yCZ1Jg7euubTCC1PqKeSZvfeOlJO4daJfTf8Czc k+1deC/DUOJHhPQth5IHwdmLt+FOlSBa/KsmkptB4obh6/rjYQE4tfa02S46iT/gvShPS5dcvAAA AABJRU5ErkJggg== In-Reply-To: <20190707214326.GD4053@ACM> (Alan Mackenzie's message of "Sun, 7 Jul 2019 21:43:26 +0000") X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 80.91.231.51 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:238399 Archived-At: Alan Mackenzie writes: > My limited experience of this is that people don't bother to write the > necessary doc strings, or don't bother to write them properly, so one is > left guessing at the precise semantics. For example the doc string for > `file-attribute-size' is poor, whereas the doc string for > `file-attribute' is better, though still not perfect. To understand the > former, one must read _both_ doc strings. This is not a win. If you see code with (if (> (file-attribute-size (file-attributes "some/file")) 1000) ...) then I think the meaning of that would be pretty obvious to everybody? The doc string could be more verbose, but I think it describes the semantics pretty clearly? ---- file-attribute-size is a compiled Lisp function in =E2=80=98files.el=E2=80= =99. (file-attribute-size ATTRIBUTES) Probably introduced at or before Emacs version 26.1. The integer size (in bytes) in ATTRIBUTES returned by =E2=80=98file-attribu= tes=E2=80=99. --=20 (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no