Fixed typo in ControlMaster section of remoteusage

[notmuch-wiki] / remoteusage.mdwn

diff --git a/remoteusage.mdwn b/remoteusage.mdwn
index d43a8cdb60308c3ca604d14d9ca30185a19c2bcc..c6e3ff6abd52a798b31609e125f527512c7be8b0 100644 (file)
--- a/remoteusage.mdwn
+++ b/remoteusage.mdwn
@@ -44,29 +44,35 @@ entries. This is currently necessary so that the emacs process-filter
 doesn't chop off messages. It's an obvious hack, and hopefully won't
 be necessary in the furture.
 
-       #!/usr/bin/env bash
-       
-       SSH_BIN="/path/to/ssh/on/client"
-       USER="user_name"
-       HOST="server_name"
-       NOTMUCH_REMOTE_BIN="/path/to/notmuch/on/server"
-       
-       if [ $1 = "search" ]; then
-           COUNT=0;
-           OUT=`$SSH_BIN $USER@$HOST $NOTMUCH_REMOTE_BIN $@`
-           echo "$OUT" | while read line; do
-               COUNT=`expr $COUNT + 1`
-               echo "$line";
-               if [ $COUNT = 10 ]; then
-                   sleep 0.1;
-               fi
-           done
-       else
-           $SSH_BIN $USER@$HOST $NOTMUCH_REMOTE_BIN $@
-       fi
-       
+    #!/usr/bin/env bash
+    
+    SSH_BIN="/path/to/ssh/on/client"
+    USER="user_name"
+    HOST="server_name"
+    NOTMUCH_REMOTE_BIN="/path/to/notmuch/on/server"
+    
+    if [ $1 = "search" ]; then
+        COUNT=0;
+        OUT=`$SSH_BIN $USER@$HOST $NOTMUCH_REMOTE_BIN $@`
+        echo "$OUT" | while read line; do
+            COUNT=`expr $COUNT + 1`
+            echo "$line";
+            if [ $COUNT = 10 ]; then
+                sleep 0.1;
+            fi
+        done
+    else
+        $SSH_BIN $USER@$HOST $NOTMUCH_REMOTE_BIN $@
+    fi
+       
 Save this to a file, "remote-notmuch.sh", in your path.
 
+Now you can run "remote-notmuch.sh new". You can call the script
+anything you like. If you don't have a notmuch instance on your client
+computer, you can even call it "notmuch" and have totally transparent
+usage. (Since I run "new" from an emacs keybinding, I've never
+bothered with this renaming.)
+
 ##Configure your emacs client##
 
 Add the following to your .emacs (this is on your client machine):
@@ -91,6 +97,28 @@ files, via TRAMP, so that it can extract attachments and parse
 HTML. Work is afoot to make notmuch handle these tasks itself, so this
 part should soon be unecessary.
 
+##A tip to speed things up##
+If you have openssh >= 0.4, you can make use of the "ControlMaster"
+feature. This allows you to reuse an existing connection. Therefore
+if you keep a connection open, you won't have to authenticate every
+time.
+
+Add the following to your ~/.ssh/config file:
+
+    Host server_name 
+    ControlMaster auto
+    ControlPath ~/.ssh/master-%r@%h:%p
+    
+You can also se the Host to "*", if you want to use it for all
+connections. I usually have an interactive ssh connection to my home
+computer open, so I don't need to do anything more. But if not, you
+can always run:
+
+    ssh -Nf server_name
+
+which will open up a background connection, which you can then reuse
+for all of your notmuch commands.
+
 ##Problems##
 Some things won't work perfectly, and there might be some unexpected
 mismatches between normal usage and this sort of usage. If you're