]> code.delx.au - gnu-emacs-elpa/commitdiff
README tweaks
authorKen Manheimer <ken.manheimer@gmail.com>
Mon, 18 Jan 2016 00:49:34 +0000 (19:49 -0500)
committerKen Manheimer <ken.manheimer@gmail.com>
Mon, 18 Jan 2016 00:49:34 +0000 (19:49 -0500)
README.md

index be5e78de0a16a8377daaffb4b7c8c297025e1831..485d22d847f6c265dd7bf06f6b8c9bc4edc875ed 100644 (file)
--- a/README.md
+++ b/README.md
@@ -4,10 +4,7 @@ multishell.el
 Facilitate interaction with multiple local and remote Emacs shell buffers.
 
 I use the emacs shell a *lot*. On top of emacs' powerful shell and tramp
-facilities, multishell.el turns emacs into a versatile tool for conducting
-operations and development across numerous hosts.
-
-Using the include customization binding, you can use a keystroke to:
+facilities, use a `multishell` (customization-activated) key binding to:
 
 * Get to the input point from wherever you are in a shell buffer,
 * ... or to one of your shell buffers if you're not currently in one.
@@ -18,16 +15,17 @@ Using the include customization binding, you can use a keystroke to:
 
   For example: 
 
-  * '/ssh:example.net:/' for a shell buffer in / on
+  * `/ssh:example.net:/` for a shell buffer in / on
     example.net; the buffer will be named "*example.net*".
 
-  * '#ex/ssh:example.net|sudo:root@example.net:/etc' for a root shell
+  * `#ex/ssh:example.net|sudo:root@example.net:/etc` for a root shell
     starting in /etc on example.net named "*#ex*".
 
-(NOTE that there is a problem with specifying a remote homedir using
-tramp syntax, eg '/ssh:example.net:'. That sometimes fails on an obscure
-bug - particularly for remote+sudo with homedir syntax. Until fixed, you
-may need to start remote+sudo shells with an explicit path, then cd ~.)
+(NOTE that there is a frequent problem with specifying a remote homedir
+using tramp syntax, eg `/ssh:example.net:` or `/ssh:example.net:~`. That
+sometimes fails on an obscure bug - particularly for remote+sudo with
+homedir syntax. Until fixed, you may need to start remote+sudo shells with
+an explicit path, then cd ~. With `multishell`s dir-tracking persistent history, you'll be able to use completion to start that shell in the right place, in your subsequent sessions.)
 
 Customize-group `multishell` to select and activate a keybinding and set
 various behaviors. Customize-group `savehist` to preserve buffer