[PATCH] Document GIT_SSH environment variable alongside other variables

Shawn O. Pearce· Aug 4, 2007, 06:06 UTC · lore

The GIT_SSH environment variable has survived for quite a while without being documented, but has been mentioned on list and on my day-job repositories can only be accessed via magic supplied through the wonderous hack that is GIT_SSH.

Advertising it alongside other "low level magic" such as GIT_PAGER and GIT_MERGE_VERBOSITY will certainly help others who need to spread their own pixie dust to make things work.

Signed-off-by: Shawn O. Pearce <spearce@spearce.org>
---
 Documentation/git.txt |   16 ++++++++++++++++
 1 files changed, 16 insertions(+), 0 deletions(-)

Show changes to Documentation/git.txt +16 −0

diff --git a/Documentation/git.txt b/Documentation/git.txt
index 4c4d174..18f8b6a 100644
--- a/Documentation/git.txt
+++ b/Documentation/git.txt
@@ -421,6 +421,22 @@ other
 	to an empty string or to the value "cat", git will not launch
 	a pager.
 
+'GIT_SSH'::
+	If this environment variable is set then gitlink:git-fetch[1]
+	and gitlink:git-push[1] will use this command instead
+	of `ssh` when they need to connect to a remote system.
+	The 'GIT_SSH' command will be given exactly two arguments:
+	the 'username@host' (or just 'host') from the URL and the
+	shell command to execute on that remote system.
++
+To pass options to the program that you want to list in GIT_SSH
+you will need to wrap the program and options into a shell script,
+then set GIT_SSH to refer to the shell script.
++
+Usually it is easier to configure any desired options through your
+personal `.ssh/config` file.  Please consult your ssh documentation
+for further details.
+
 'GIT_FLUSH'::
 	If this environment variable is set to "1", then commands such
 	as git-blame (in incremental mode), git-rev-list, git-log,

-- 
1.5.3.rc3.941.gaac97

Jakub Narebski· Aug 5, 2007, 22:16 UTC · re: Shawn O. Pearce · lore

Re: [PATCH] Document GIT_SSH environment variable alongside other variables

Shawn O. Pearce wrote:

> The GIT_SSH environment variable has survived for quite a while
> without being documented, but has been mentioned on list and on
> my day-job repositories can only be accessed via magic supplied
> through the wonderous hack that is GIT_SSH.

Thanks a lot.

By the way, I plan on documenting existing environmental variables used by git better (for after 1.5.3). First, separate "Environmental variables" section in Documentation/git.txt into separate file (similar to the config.txt file), named environment.txt. Second, add to the list of variables links to variables which are documented in other manpages, similarly to how for example GIT_AUTHOR_NAME etc. are described. Then add one by one environmental variables which are not documented at all: GIT_SSH_PUSH/GIT_SSH_PULL, GIT_CURL_VERBOSITY, GIT_REFLOG_ACTION, GIT_GRAFT_FILE and GIT_TEMPLATE_DIR.

-- 
Jakub Narebski
Poland

patchDocument GIT_SSH environment variable alongside other variables