Refine documentation (commentary, README.md).

diff --git a/README.md b/README.md
index 4252d3beff1b57c19d118997e05f3b73542a1be5..4f3bcda0b5ea323ec2b71752c8bc5ab213e2b2fc 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 multishell.el
 =============
 
-Facilitate interaction with multiple local and remote Emacs shell buffers.
+Facilitate use of multiple local and remote Emacs shell buffers.
 
 I use the emacs shell a *lot*. On top of emacs' powerful shell and tramp
 facilities, use a `multishell` (customization-activated) key binding to:

diff --git a/multishell.el b/multishell.el
index b3f55ad62e74e0a0fa8c0e9cf028010dc1b17244..c6834db5a776d967e2251f4fdb118f4b15c7f3e6 100644 (file)
--- a/multishell.el
+++ b/multishell.el
@@ -1,4 +1,4 @@
-;;; multishell.el --- manage interaction with multiple local and remote shells
+;;; multishell.el --- facilitate use of multiple local and remote shell buffers
 
 ;; Copyright (C) 1999-2016 Free Software Foundation, Inc. and Ken Manheimer
 
@@ -21,7 +21,7 @@
 ;; * Append a path to a new shell name to launch a shell in that directory,
 ;; * ... and use a path with Emacs tramp syntax to launch a remote shell.
 ;;
-;;   For example: 
+;;   For example:
 ;;
 ;;   * `/ssh:example.net:/` for a shell buffer in / on
 ;;     example.net; the buffer will be named "*example.net*".
@@ -29,13 +29,13 @@
 ;;   * `#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 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.) 
+;; (NOTE - there's a sporadic problem when opening a shell pointed at a
+;; remote homedir, eg `/ssh:example.net:` or `/ssh:example.net:~`. It
+;; sometimes fails, particularly for remote+sudo with homedir syntax. Until
+;; fixed, you may need to start remote+sudo shells with an explicit path,
+;; then cd ~. If you set up `multishell`s persistent dir-tracking history,
+;; you'll be able to use completion to start that shell in the right place,
+;; in your subsequent sessions.)
 ;;
 ;; See the `multishell-pop-to-shell` docstring for details.
 ;;
@@ -45,6 +45,9 @@
 ;;
 ;; See the `multishell-pop-to-shell' docstring for details.
 ;;
+;; Please use [the repository](https://github.com/kenmanheimer/EmacsMultishell)
+;; issue tracker to report problems, suggestions, etc.
+;;
 ;;; Change Log:
 ;;
 ;; * 2016-01-16 1.0.5 Ken Manheimer: