GNU bug report logs - #18318
24.4.50; doc of `file-readable-p'

Previous Next

Full log

View this message in rfc822 format

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 18318 <at> debbugs.gnu.org
Subject: bug#18318: 24.4.50; doc of `file-readable-p'
Date: Sat, 30 Apr 2016 15:39:12 +0200

Drew Adams <drew.adams <at> oracle.com> writes:

> The doc - both Elisp manual and doc string, should explicitly point out
> that this returns non-nil for a directory, IOW, a non-nil value does not
> mean that the file can be, say, inserted into a buffer.
>
> In addition, it would be better to change the parameter name to
> FILE-OR-DIR (or even FILE-OR-DIR-NAME).  It is all to easy to not
> realize, when reading this, that this does not test for a non-directory
> file that is readable.

Well, the function isn't about files or directories, but filenames.  It
can be a fifo, a device node, etc.  So I think the doc is fine as it is.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

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