bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#18318: 24.4.50; doc of `file-readable-p'


From: Lars Ingebrigtsen
Subject: bug#18318: 24.4.50; doc of `file-readable-p'
Date: Sat, 30 Apr 2016 15:39:12 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux)

Drew Adams <drew.adams@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





reply via email to

[Prev in Thread] Current Thread [Next in Thread]