A few documentation issues, and a question

[Clément Pit-Claudel]

Hi all,

tramp-find-executable says this:

  "Searches for PROGNAME in $PATH and all directories mentioned in DIRLIST. […]
Returns the absolute file name of PROGNAME, if found, and nil otherwise. […]"

But when a program in in the PATH, tramp returns the program name prefixed with 
a backslash instead:

(tramp-find-executable "sh")
⇒ "\\sh"

This wouldn't be much of an issue, except for the fact that this syntax isn't 
compatible with tramp-sh-process-file-handler (it quotes the program name).  
Which one is right? The docs, or the behavior (I'd vote for fixing the behavior 
:)

(Btw, is that check with `which \%s | wc -w` right? Wouldn't it break if the 
program can be found in a directory that contains a space?)

Another doc bug:

tramp-tramp-file-p says:

"Return t if NAME is a string with Tramp file name syntax."

but it returns an int, not t.  Maybe it should use string-match-p instead of 
string-match?

Thanks!
Clément.