From 89c2ed2a1c5d23f19c7c6874659ed3f7ff71a818 Mon Sep 17 00:00:00 2001 From: Alexander Neumann Date: Sat, 30 Sep 2017 10:24:28 +0200 Subject: [PATCH] manual: Document that sftp does not expand tilde --- doc/manual.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/manual.rst b/doc/manual.rst index 011e71f36..b0beb8df3 100644 --- a/doc/manual.rst +++ b/doc/manual.rst @@ -146,6 +146,11 @@ You can also specify a relative (read: no slash (``/``) character at the beginning) directory, in this case the dir is relative to the remote user's home directory. +.. note:: Please be aware that sftp servers do not expand the tilde characte + (``~``) normally used as an alias for a user's home directory. If you + want to specify a path relative to the user's home directory, pass a + relative path to the sftp backend. + The backend config string does not allow specifying a port. If you need to contact an sftp server on a different port, you can create an entry in the ``ssh`` file, usually located in your user's home directory at