From: Richard M. Stallman <rms@gnu.org>
Date: Sat, 26 Mar 2005 01:53:30 +0000 (+0000)
Subject: (Emacs Server): Document server-name.
X-Git-Tag: ttn-vms-21-2-B4~1512
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=82b9073df188cb7c2b1e9e91a73194118391b062;p=emacs.git

(Emacs Server): Document server-name.
(Invoking emacsclient): Document -s option for server names.
---

diff --git a/man/misc.texi b/man/misc.texi
index 5ef15d45d87..56855e1d62c 100644
--- a/man/misc.texi
+++ b/man/misc.texi
@@ -1247,6 +1247,14 @@ kills it if the file name matches the regular expression
   If you set the variable @code{server-window} to a window or a frame,
 @kbd{C-x #} displays the server buffer in that window or in that frame.
 
+@vindex server-name
+  You can run multiple Emacs servers on the same machine by giving
+each one a unique ``server name'', using the variable
+@code{server-name}.  For example, @kbd{M-x set-variable RET
+server-name RET foo} sets the server name to @samp{foo}.  The
+@code{emacsclient} program can visit a server by name using the
+@samp{-s} option.
+
   While @code{mail} or another application is waiting for
 @code{emacsclient} to finish, @code{emacsclient} does not read terminal
 input.  So the terminal that @code{mail} was using is effectively
@@ -1329,6 +1337,9 @@ open the given files with the option @samp{--display=@var{DISPLAY}}.
 This can be used typically when connecting from home to an Emacs
 server running on your machine at your workplace.
 
+If there is more than one Emacs server running, you can specify a
+server name with the option @samp{-s @var{name}}.
+
 You can also use @code{emacsclient} to execute any piece of Emacs Lisp
 code, using the option @samp{--eval}.  When this option is given, the
 rest of the arguments is not taken as a list of files to visit but as