guile-ssh
guile-ssh copied to clipboard
Documentation for open-remote-pipe* is misleading
The documentation claims
-- Scheme Procedure: open-remote-pipe* session mode prog [args...]
Execute PROG on the remote host with the given ARGS using a SESSION
with a pipe to it. Returns newly created channel port with the
specified MODE.
However what is actually executed is the equivalent of (string-append prog " " (string-join args " ")). That is quite surprising, given the signature of the procedure, so I believe it should be documented.
Working around it (and getting actual equivalent of open-pipe*) is not hard, but one has to know it is necessary and I find that somewhat hard to figure out from the current documentation.