ssh: introduce a 'simple' ssh variant
[gitweb.git] / Documentation / config.txt
index b78747abc66c325fadb2a69db95ce0bbdf262663..0460af37e2617d0ab7ab8f33c3d9d745237da606 100644 (file)
@@ -2084,12 +2084,31 @@ ssh.variant::
        Depending on the value of the environment variables `GIT_SSH` or
        `GIT_SSH_COMMAND`, or the config setting `core.sshCommand`, Git
        auto-detects whether to adjust its command-line parameters for use
-       with plink or tortoiseplink, as opposed to the default (OpenSSH).
+       with ssh (OpenSSH), plink or tortoiseplink, as opposed to the default
+       (simple).
 +
 The config variable `ssh.variant` can be set to override this auto-detection;
-valid values are `ssh`, `plink`, `putty` or `tortoiseplink`. Any other value
-will be treated as normal ssh. This setting can be overridden via the
-environment variable `GIT_SSH_VARIANT`.
+valid values are `ssh`, `simple`, `plink`, `putty` or `tortoiseplink`. Any
+other value will be treated as normal ssh. This setting can be overridden via
+the environment variable `GIT_SSH_VARIANT`.
++
+The current command-line parameters used for each variant are as
+follows:
++
+--
+
+* `ssh` - [-p port] [-4] [-6] [-o option] [username@]host command
+
+* `simple` - [username@]host command
+
+* `plink` or `putty` - [-P port] [-4] [-6] [username@]host command
+
+* `tortoiseplink` - [-P port] [-4] [-6] -batch [username@]host command
+
+--
++
+Except for the `simple` variant, command-line parameters are likely to
+change as git gains new features.
 
 i18n.commitEncoding::
        Character encoding the commit messages are stored in; Git itself