NEWS for release 0.23.4

[notmuch-wiki] / remoteusage.mdwn

diff --git a/remoteusage.mdwn b/remoteusage.mdwn
index 8eb99e4248a001715a476b5d6bbb37b27e07b4fb..770164d10ab43d9d7070fbdc957ffd38cbca4090 100644 (file)
--- a/remoteusage.mdwn
+++ b/remoteusage.mdwn
@@ -26,12 +26,15 @@ server), `bash`, and `ssh` on another computer (let's call that computer
 
 3. password-free login (public key authentication) from client to
 server. [Here](http://www.debian-administration.org/articles/152) is a
-good page on how to set it up.
+good page on how to set it up (<del>3</del>).
 
 4. a reasonably fast connection. (This isn't really *necessary*, but if
 your connection is too slow, this won't be very pleasant to use, and
 certainly won't seem transparent.)
 
+(<del>3</del>) If you don't want / cannot use password-free login,
+[[This|remoteusage/124]] page provides yet another alternative.
+
 ## Configure `ssh` on the client computer ##
 
 Add this to your `~/.ssh/config`:
@@ -40,12 +43,12 @@ Add this to your `~/.ssh/config`:
         HostName example.com
         User remoteuser
         ControlMaster auto
-        ControlPath /home/user/.ssh/%h_%p_%r
+        ControlPath ~/.ssh/master-%h@%p:%r
         ControlPersist 15m
-        IdentityFile /home/user/.ssh/example.com.id_rsa
+        IdentityFile ~/.ssh/example.com.id_rsa
 
 Replace `example.com` with your server. Replace `remoteuser` with the
-username on the server. Replace `/home/user` with your home directory.
+username on the server.
 
 The `Control*` options keep the connection open in the background to not
 require authentication every time. The `ControlPersist` option defines
@@ -66,6 +69,8 @@ Save this to a file, for example `remote-notmuch.sh`, in your `PATH`:
     printf -v ARGS "%q " "$@"
     exec ssh notmuch notmuch ${ARGS}
 
+and give it execute permissons: `chmod +x remote-notmuch.sh`
+
 Now you can run `remote-notmuch.sh new`, or other notmuch commands. You
 can call the script anything you like. (You could also call it `notmuch`
 or symlink `~/bin/notmuch` to it for transparent usage.)
@@ -77,8 +82,8 @@ script:
 
     (setq notmuch-command "/path/to/your/remote-notmuch.sh")
 
-If you use Fcc, you may want to do something like this on the client, to
-Bcc mails to yourself:
+If you use Fcc and Notmuch older than 0.23, you may want to do something like
+this on the client, to Bcc mails to yourself:
 
     (setq notmuch-fcc-dirs nil)
     (add-hook 'message-header-setup-hook
@@ -86,6 +91,8 @@ Bcc mails to yourself:
                     (notmuch-user-name)
                     (notmuch-user-primary-email))))))
 
+Starting from 0.23, Fcc is also done through notmuch-command.
+
 ## Problems ##
 
 Some things probably won't work perfectly, and there might be some
@@ -94,5 +101,6 @@ you're using this approach and run into any problems, please feel free
 to list them here. And, of course, if you improve on any of these
 approaches, please do edit this page and let people know!
 
-If you have issues, you may want to try the [[old remote usage
-instructions|remoteusage-old]].
+If you have issues, you may want to try the
+[[old remote usage instructions|remoteusage/old]] or
+[[yet another alternative|remoteusage/124]].