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.
 
 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.
 
 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):
 ##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.
 
 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
 ##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