[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
- bug#18318: 24.4.50; doc of `file-readable-p',
Lars Ingebrigtsen <=