GNU bug report logs - #34055
27.0.50; Documentation of `visited-file-modtime' is inconsistent

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 34055 in the body.
You can then email your comments to 34055 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "N. Jackson" <nljlistbox2 <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 27.0.50; Documentation of `visited-file-modtime' is inconsistent
Date: Sat, 12 Jan 2019 20:36:33 -0500

In the Elisp manual (info "(elisp)Modification Time") the
documentation of `visited-file-modtime' is inconsistent with its doc
string.

The Elisp manual says

  If the buffer is not visiting a file, this function returns −1.

However, it appears (IIUC) that the function only returns -1 when
the buffer _is_ visiting a file and that file does not exist; the
doc string has it right.

[This was reported in [1] but it remains unfixed in current master.]

[1] https://lists.gnu.org/archive/html/emacs-devel/2018-03/msg00448.html


In GNU Emacs 27.0.50 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.22.30)
 of 2019-01-12 built on moondust.localdomain
Repository revision: c48ea7c08c95185ddce266744a1959e0ce6b04e1
Repository branch: master
Windowing system distributor 'Fedora Project', version 11.0.11906000
System Description: Fedora 28 (Workstation Edition)

Message #10 received at 34055-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: "N. Jackson" <nljlistbox2 <at> gmail.com>
Cc: 34055-done <at> debbugs.gnu.org
Subject: Re: bug#34055: 27.0.50;
 Documentation of `visited-file-modtime' is inconsistent
Date: Sun, 13 Jan 2019 17:42:12 +0200

> From: "N. Jackson" <nljlistbox2 <at> gmail.com>
> Date: Sat, 12 Jan 2019 20:36:33 -0500
> 
> 
> In the Elisp manual (info "(elisp)Modification Time") the
> documentation of `visited-file-modtime' is inconsistent with its doc
> string.
> 
> The Elisp manual says
> 
>   If the buffer is not visiting a file, this function returns −1.
> 
> However, it appears (IIUC) that the function only returns -1 when
> the buffer _is_ visiting a file and that file does not exist; the
> doc string has it right.
> 
> [This was reported in [1] but it remains unfixed in current master.]

Thanks, fixed.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.