emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Uncomprehensible DOC string


From: David Kastrup
Subject: Uncomprehensible DOC string
Date: Wed, 07 May 2008 13:32:17 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (gnu/linux)

We have

    start-file-process is a compiled Lisp function in `simple.el'.

    (start-file-process name buffer program &rest program-args)

    Start a program in a subprocess.  Return the process object for it.
    Similar to `start-process', but may invoke a file handler based on
    `default-directory'.  The current working directory of the
    subprocess is `default-directory'.

    program and program-args might be file names.  They are not
    objects of file handler invocation.

There is no mention what it means to invoke a file handler, what calling
the file handler is supposed to be good for, what the file handler is
actually going to handle (we just know that it is chosen _based_ on
default-directory, not what it is supposed to work on), and there is no
cross reference to manual or other DOC strings that would explain about
what a file handler actually is.

Nobody will get _any_ clue about why he should use start-file-process
rather than start-process, and what will be affected in what manner.

-- 
David Kastrup




reply via email to

[Prev in Thread] Current Thread [Next in Thread]