code.delx.au - gnu-emacs-elpa/blob - README.md

   1 multishell.el
   2 =============
   3
   4 Facilitate interaction with multiple local and remote Emacs shell buffers.
   5
   6 I use the emacs shell a *lot*. On top of emacs' powerful shell and tramp
   7 facilities, use a `multishell` (customization-activated) key binding to:
   8
   9 * Get to the input point from wherever you are in a shell buffer,
  10 * ... or to one of your shell buffers if you're not currently in one.
  11 * Use universal arguments to launch and choose among alternate shell buffers,
  12 * ... and select which is default.
  13 * Append a path to a new shell name to launch a shell in that directory,
  14 * ... and use a path with Emacs tramp syntax to launch a remote shell.
  15
  16   For example:
  17
  18   * `/ssh:example.net:/` for a shell buffer in / on
  19     example.net; the buffer will be named "*example.net*".
  20
  21   * `#ex/ssh:example.net|sudo:root@example.net:/etc` for a root shell
  22     starting in /etc on example.net named "*#ex*".
  23
  24 (NOTE that there is a frequent problem with specifying a remote homedir
  25 using tramp syntax, eg `/ssh:example.net:` or `/ssh:example.net:~`. That
  26 sometimes fails on an obscure bug - particularly for remote+sudo with
  27 homedir syntax. Until fixed, you may need to start remote+sudo shells with
  28 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.)
  29
  30 Customize-group `multishell` to select and activate a keybinding and set
  31 various behaviors. Customize-group `savehist` to preserve buffer
  32 names/paths across emacs sessions.
  33
  34 See the `multishell-pop-to-shell` docstring for details.