Re: Uncomprehensible DOC string

[David Kastrup]

Michael Albinus <address@hidden> writes:

> David Kastrup <address@hidden> writes:
>
>> That addresses the last partial sentence of my report.  What about the
>> rest?  There is no sense to leave a fragmentary explanation in the DOC
>> string when you need to read up the function's behavior elsewhere,
>> anyhow.  The manual reference should be there to explain the _terms_
>> used in the DOC string, but the DOC string should still be _complete_
>> once the terms are clear.
>
> I'll try to be a little bit more comprehensive in the doc
> string. However, I don't believe that the doc string of
> `start-file-process' is the place to explain what are file name
> handlers at all.

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?

-- 
David Kastrup