Re: Uncomprehensible DOC string

[David Kastrup]

Michael Albinus <address@hidden> writes:

> David Kastrup <address@hidden> writes:
>
>>> _The_ file name handler, which belongs to `default-directory', will be
>>> applied.
>>
>> To what will it be applied?
>
> ???
>
> To the arguments auf `start-file-process', of course.

You just stated that it will _not_ be applied to all arguments of
start-file-process.

> Like every other file name handler. That's why the doc strings says
> "Similar to `start-process'".

Why would "every other" file name handler be applied to all arguments of
start-file-process?

One file name handler is chosen based on the _default_ directory (rather
than the executable name), and it is not applied to arguments of
start-file-process, but rather is used for starting the process with the
given arguments on the system indicated by the default directory.

At least that is what I think I understand.  What the word "file" in
"start-file-process" is supposed to be about, I have no clue whatsoever.
Something like "start-nonlocal-process" or "start-handled-process" or
"start-process-anywhere" seems to be more informative.

-- 
David Kastrup