Re: Uncomprehensible DOC string

[David Kastrup <dak@gnu.org>]

Michael Albinus <michael.albinus@gmx.de> writes:

> David Kastrup <dak@gnu.org> writes:
>
>> No, but saying a file name handler will be called based on
>> default-directory without telling what the file name handler is actually
>> supposed to be processing is not much use I think.  The command?  The
>> command line arguments?  The executable?
>
> _The_ file name handler, which belongs to `default-directory', will be
> applied.

To what will it be applied?

> Currently, there ought to be only one implementation of such a file
> name handler, `tramp-handle-start-file-process'. _This_ file name
> handler runs the command on the corresponding remote host.

So what the file name handler will be employed for is executing the
program on potentially remote host.  This information is _absent_ from
the DOC string, and it shouldn't.  In contrast, what a file name handler
_is_, is best left to the info documentation.

-- 
David Kastrup