X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=remoteusage%2Faboriginal.mdwn;h=68d454cbf5df6fdf03ad25aec25c3aee9900b77f;hb=a8a5256252717a0e6690925634f2a632df956cd5;hp=ccaded1c6101895c9416d5372f4790fb602b2170;hpb=72251dc226ae254962ca0b0ac8c0039e8570c864;p=obsolete%2Fnotmuch-wiki

diff --git a/remoteusage/aboriginal.mdwn b/remoteusage/aboriginal.mdwn
index ccaded1..68d454c 100644
--- a/remoteusage/aboriginal.mdwn
+++ b/remoteusage/aboriginal.mdwn
@@ -23,8 +23,8 @@ Write the following code to a file, for example `remote-notmuch.sh`.
 	# http://notmuchmail.org/remoteusage/aboriginal/
 
 	set -eu
-	# To trace execution, outcomment next line. Note that emacs input may ...
-	#exec 2>>remote-errors; echo -- >&2; set -x # ... change (no stderr).
+	# To trace execution, uncomment next line.
+	#BASH_XTRACEFD=6; exec 6>>remote-errors; echo -- >&6; set -x
 
 	readonly SSH_CONTROL_SOCK='~'/.ssh/master-user@host:22
 
@@ -73,12 +73,15 @@ using the following command line:
 (replace `[user@]remotehost` with your login info). Doing this the
 above wrapper script can be run unmodified. After the above command has
 been run on **one terminal**, enter `chmod +x remote-notmuch.sh` in
-**another terminal** and then test the script with `./remote-notmuch.sh help`
+**another terminal** and then test the script with
 
-Note that the '~' is inside single quotes for a reason. In this
-case shell never expand it to `$HOME` -- ssh does it by not reading
-`$HOME` but checking the real user home directory from `/etc/passwd`.
-For security purposes this is just how it should be.
+        ./remote-notmuch.sh help
+
+Note that the '~' in the ssh command line above is inside single quotes
+for a reason. In this case shell never expand it to `$HOME` -- ssh does
+it by not reading `$HOME` but checking the real user home directory
+from `/etc/passwd`.  For security purposes this is just how it should
+be.
 
 ## Tune
 
@@ -133,3 +136,19 @@ machine, checking/inotifying when new mail arrives. When mail arrives it
 could send message back to local host, where a graphical client (to be written)
 pops up on display providing info about received mail (and exiting this
 graphical client connection to remote host is terminated).
+
+## Troubleshooting
+
+If you experience strange output when using from emacs first attempt to just
+run
+
+        ./remote-notmuch.sh help
+
+from command line and observe output. If it looks as it should be next uncomment
+the line
+
+        #BASH_XTRACEFD=6; exec 6>>remote-errors; echo -- >&6; set -x
+
+in `./remote-notmuch.sh` and attempt to use it from emacs again -- and then
+examine the contents of `remote-errors` in the working directory emacs was
+started.