Remote file kitten: Integrate with the ssh kitten

docs/changelog.rst

@@ -49,6 +49,10 @@ Detailed list of changes
 
 - Fix a regression in the previous release that caused mouse move events to be incorrectly reported as drag events even when a button is not pressed (:iss:`4992`)
 
+- remote file kitten: Integrate with the ssh kitten for improved performance
+  and robustness. Re-uses the control master connection of the ssh kitten to
+  avoid round-trip latency.
+
 - Fix tab selection when closing a new tab not correct in some scenarios (:iss:`4987`)
 
 - A new action :ac:`open_url` to open the specified URL (:pull:`5004`)

docs/kittens/remote_file.rst

@@ -27,13 +27,16 @@ supports hyperlinks.
 .. versionadded:: 0.19.0
 
 .. note::
-   Nested SSH sessions are not supported. The kitten will always try to copy
-   remote files from the first SSH host. This is because there is no way for
+   For best results, use this kitten with the :doc:`ssh kitten <./ssh>`.
+   Otherwise, nested SSH sessions are not supported. The kitten will always try to copy
+   remote files from the first SSH host. This is because, without the ssh
+   kitten, there is no way for
    |kitty| to detect and follow a nested SSH session robustly. Use the
    :doc:`transfer` kitten for such situations.
 
 .. note::
-   If you have not setup automatic password-less SSH access, then, when editing
+   If you have not setup automatic password-less SSH access, and are not using
+   the ssh kitten, then, when editing
    starts you will be asked to enter your password just once, thereafter the SSH
    connection will be re-used.