From 55b09624ff4252618425060705fa315a66d46c7f Mon Sep 17 00:00:00 2001
From: bringert <bringert@cs.chalmers.se>
Date: Thu, 17 Nov 2005 15:57:09 +0000
Subject: [PATCH] Document version requirements for ssh.

---
 doc/darcs.html | 13 ++++++++++---
 doc/darcs.txt  | 13 ++++++++++---
 src/INSTALL    |  2 +-
 3 files changed, 21 insertions(+), 7 deletions(-)

diff --git a/doc/darcs.html b/doc/darcs.html
index d21a6134d..ab1b7951d 100644
--- a/doc/darcs.html
+++ b/doc/darcs.html
@@ -159,6 +159,13 @@ functionality. This allows several ssh instances to use the connection
 established by one existing instance.
 </P>
 <P>
+<B>NOTE: You need OpenSSH version 4 or newer for this to work.</B> You
+can check your OpenSSH version with <CODE>ssh -V</CODE>. If you have an older
+version of OpenSSH, you need to remove the ControlPath line below,
+and you can skip the "Setting up an ssh ControlMaster connection"
+step. You will be typing in your password a lot...
+</P>
+<P>
 Add this to <CODE>~/.ssh/config</CODE> (create the file if it does not exist,
 replace <CODE>bringert</CODE> with your own username on the
 Chalmers system):
@@ -286,9 +293,9 @@ the section above on setting up your <CODE>$PATH</CODE> on the Chalmers system.
 <H2>I get the error "(sftp) failed to fetch files."</H2>
 <P>
 There seems to be a problem with how darcs 1.0.4 calls sftp, which
-means that normal password authentication does not work. Either
-use Darcs 1.0.3, and be prepared to enter your password many times,
-or use the ssh ControlMaster feature as desctribed above.
+means that normal password authentication does not work. Either use
+Darcs 1.0.3 on your client, and be prepared to enter your password
+many times, or use the ssh ControlMaster feature as described above.
 </P>
 <A NAME="toc18"></A>
 <H2>I get the error "Not a repository: gfreposerver:..."</H2>
diff --git a/doc/darcs.txt b/doc/darcs.txt
index 107ca4776..4bdb9bf6f 100644
--- a/doc/darcs.txt
+++ b/doc/darcs.txt
@@ -113,6 +113,13 @@ action on the remote repository, you can use ssh's ControlMaster
 functionality. This allows several ssh instances to use the connection
 established by one existing instance.
 
+**NOTE: You need OpenSSH version 4 or newer for this to work.** You
+can check your OpenSSH version with ``ssh -V``. If you have an older
+version of OpenSSH, you need to remove the ControlPath line below,
+and you can skip the "Setting up an ssh ControlMaster connection"
+step. You will be typing in your password a lot...
+
+
 Add this to ``~/.ssh/config`` (create the file if it does not exist,
 replace ``bringert`` with your own username on the
 Chalmers system):
@@ -229,9 +236,9 @@ the section above on setting up your ``$PATH`` on the Chalmers system.
 == I get the error "(sftp) failed to fetch files." ==
 
 There seems to be a problem with how darcs 1.0.4 calls sftp, which
-means that normal password authentication does not work. Either
-use Darcs 1.0.3, and be prepared to enter your password many times,
-or use the ssh ControlMaster feature as desctribed above.
+means that normal password authentication does not work. Either use
+Darcs 1.0.3 on your client, and be prepared to enter your password
+many times, or use the ssh ControlMaster feature as described above.
 
 == I get the error "Not a repository: gfreposerver:..." ==
 
diff --git a/src/INSTALL b/src/INSTALL
index da4757135..aa5d5e91a 100644
--- a/src/INSTALL
+++ b/src/INSTALL
@@ -11,7 +11,7 @@ To make and install GF2 (Version 2.1, 8/11/2004).
 
      ghc --version
 
-3. If you are building from CVS, run autoconf (in src/):
+3. If you are building the darcs version, run autoconf (in src/):
 
      autoconf