Should read-file-name doc mention `file-name-handler-alist'?

Should read-file-name doc mention `file-name-handler-alist'?

[Lennart Borgman]

It seems to use it. Or am I wrong?

Re: Should read-file-name doc mention `file-name-handler-alist'?

[Kevin Rodgers]

Lennart Borgman wrote:
> It seems to use it. Or am I wrong?

Many, many functions use it, so I doubt it's worth documenting its
use everywhere.  From the Magic File Names node of the Emacs Lisp
manual:

| All the Emacs primitives for file access and file name transformation
| check the given file name against `file-name-handler-alist'.  If the
| file name matches REGEXP, the primitives handle that file by calling
| HANDLER.
...
|    Here are the operations that a magic file name handler gets to
| handle:
|
| `add-name-to-file', `copy-file', `delete-directory', `delete-file',
| `diff-latest-backup-file', `directory-file-name', `directory-files',
| `dired-call-process', `dired-compress-file', `dired-uncache',
| `expand-file-name', `file-accessible-directory-p',
| `file-attributes', `file-directory-p', `file-executable-p',
| `file-exists-p',
| `file-local-copy', `file-modes', `file-name-all-completions',
| `file-name-as-directory', `file-name-completion', `file-name-directory',
| `file-name-nondirectory', `file-name-sans-versions',
| `file-newer-than-file-p', `file-ownership-preserved-p',
| `file-readable-p', `file-regular-p', `file-symlink-p', `file-truename',
| `file-writable-p', `find-backup-file-name', `get-file-buffer',
| `insert-directory', `insert-file-contents', `load', `make-directory',
| `make-symbolic-link', `rename-file', `set-file-modes',
| `set-visited-file-modtime', `shell-command',
| `unhandled-file-name-directory', `vc-registered',
| `verify-visited-file-modtime',
| `write-region'.

Does read-file-name actually check file-name-handler-alist directly,
or via one or more of those primitives?

-- 
Kevin Rodgers

Re: Should read-file-name doc mention `file-name-handler-alist'?

[Richard Stallman]

We don't talk about file name handlers in the doc strings of all the
individual primitives that use them.