]> code.delx.au - gnu-emacs-elpa/blob - README.md
Migrate multishell to its own repository.
[gnu-emacs-elpa] / 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, multishell.el turns emacs into a versatile tool for conducting
8 operations and development across numerous hosts.
9
10 Using the include customization binding, you can use a keystroke to:
11
12 * Get to the input point from wherever you are in a shell buffer,
13 * ... or to one of your shell buffers if you're not currently in one.
14 * Use universal arguments to launch and choose among alternate shell buffers,
15 * ... and select which is default.
16 * Append a path to a new shell name to launch a shell in that directory,
17 * ... and use a path with Emacs tramp syntax to launch a remote shell.
18
19 For example:
20
21 * '/ssh:example.net:/' for a shell buffer in / on
22 example.net; the buffer will be named "*example.net*".
23
24 * '#ex/ssh:example.net|sudo:root@example.net:/etc' for a root shell
25 starting in /etc on example.net named "*#ex*".
26
27 (NOTE that there is a problem with specifying a remote homedir using
28 tramp syntax, eg '/ssh:example.net:'. That sometimes fails on an obscure
29 bug - particularly for remote+sudo with homedir syntax. Until fixed, you
30 may need to start remote+sudo shells with an explicit path, then cd ~.)
31
32 Customize-group `multishell` to select and activate a keybinding and set
33 various behaviors. Customize-group `savehist` to preserve buffer
34 names/paths across emacs sessions.
35
36 See the `multishell-pop-to-shell` docstring for details.