[Emacs-diffs] /srv/bzr/emacs/emacs-24 r107828: * doc/emacs/misc.texi (emacsclient Options): Document "client frame" concept

[Chong Yidong]

------------------------------------------------------------
revno: 107828
committer: Chong Yidong <address@hidden>
branch nick: emacs-24
timestamp: Sat 2012-04-14 12:48:50 +0800
message:
  * doc/emacs/misc.texi (emacsclient Options): Document "client frame" concept
  and its effect on C-x C-c more carefully.
modified:
  doc/emacs/ChangeLog
  doc/emacs/misc.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2012-04-14 02:42:22 +0000
+++ b/doc/emacs/ChangeLog       2012-04-14 04:48:50 +0000
@@ -1,3 +1,8 @@
+2012-04-14  Chong Yidong  <address@hidden>
+
+       * misc.texi (emacsclient Options): Document "client frame" concept
+       and its effect on C-x C-c more carefully.
+
 2012-04-14  Glenn Morris  <address@hidden>
 
        * frames.texi (Scroll Bars):

=== modified file 'doc/emacs/misc.texi'
--- a/doc/emacs/misc.texi       2012-04-10 06:54:43 +0000
+++ b/doc/emacs/misc.texi       2012-04-14 04:48:50 +0000
@@ -1502,16 +1502,22 @@
 the @samp{-a} option.  If both are present, the latter takes
 precedence.
 
address@hidden client frame
 @item -c
-Create a new graphical frame, instead of using an existing Emacs
-frame.  Emacs can create a graphical frame even if it was started in a
-text-only terminal, provided it is able to connect to a graphical
-display.  If Emacs is unable to connect to a graphical display, and on
-systems, such as MS-Windows (@pxref{Windows Startup, emacsclient}),
-where it cannot create graphical frames when started from a text-only
-terminal, it creates a new text-only terminal frame (@pxref{Frames}).
-If you omit a filename argument while supplying the @samp{-c} option,
-the new frame displays the @file{*scratch*} buffer (@pxref{Buffers}).
+Create a new graphical @dfn{client frame}, instead of using an
+existing Emacs frame.  If you omit a filename argument while supplying
+the @samp{-c} option, the new frame displays the @file{*scratch*}
+buffer (@pxref{Buffers}).  See below for the special behavior of
address@hidden C-c} in a client frame.
+
+On GNU and Unix systems, Emacs can create a graphical frame even if it
+was started in a text-only terminal, provided it is able to connect to
+a graphical display.  On systems such as MS-Windows, it cannot create
+graphical frames if it was started from a text terminal
+(@pxref{Windows Startup, emacsclient}).  If Emacs cannot connect to a
+graphical display for any reason, it instead creates a new client
+frame on the text terminal from which you invoked
address@hidden (@pxref{Non-Window Terminals}).
 
 @item -F @var{alist}
 @itemx address@hidden
@@ -1593,28 +1599,31 @@
 @item -t
 @itemx --tty
 @itemx -nw
-Create a new Emacs frame on the current text-only terminal, instead of
-using an existing Emacs frame.  Emacs can open a text-only terminal
-even if it was started in another text-only terminal, or on a
-graphical display.  On systems, such as MS-Windows, where this is
-impossible, Emacs will create a new frame, either GUI or text-only, on
-the same terminal where it was started (@pxref{Windows Startup,
-emacsclient}).  If you omit a filename argument while supplying this
-option, the new frame displays the @file{*scratch*} buffer.
address@hidden
+Create a new client frame on the current text terminal, instead of
+using an existing Emacs frame.  This is similar to the @samp{-c}
+option, above, except that it creates a text terminal frame
+(@pxref{Non-Window Terminals}).  If you omit a filename argument while
+supplying this option, the new frame displays the @file{*scratch*}
+buffer (@pxref{Buffers}).  See below for the special behavior of
address@hidden C-c} in a client frame.
+
+On GNU and Unix systems, Emacs can open a text terminal even if it was
+started in another text terminal, or on a graphical display.  On
+systems where this is impossible, such as MS-Windows, Emacs instead
+creates a new frame on the same terminal where it was started
+(@pxref{Windows Startup, emacsclient}).
 @end table
 
-  If you type @kbd{C-x C-c} (@code{save-buffers-kill-terminal}) in an
-Emacs frame created with @command{emacsclient}, via the @samp{-c} or
address@hidden options, Emacs deletes the frame instead of killing the
-Emacs process itself.  On a text-only terminal frame created with the
address@hidden option, this returns control to the terminal.  Emacs also
-marks all the server buffers for the client as finished, as though you
-had typed @kbd{C-x #} in all of them.
-
-  When Emacs is started as a daemon, all frames are considered client
-frames, so @kbd{C-x C-c} will never kill Emacs.  To kill the Emacs
-process, type @kbd{M-x kill-emacs}.
+  If you type @kbd{C-x C-c} in a client frame created by
address@hidden (via the @samp{-c} or @samp{-t} options), that
+command does not kill the main Emacs session as it normally does
+(@pxref{Exiting}).  Instead, Emacs deletes the client frame; and if
address@hidden was waiting for server edits to finish, Emacs
+marks the client's server buffers as finished (as though you had typed
address@hidden #} in all of them), allowing @command{emacsclient} to regain
+control and exit.  When Emacs is started as a daemon, all frames are
+considered client frames, so @kbd{C-x C-c} will never kill Emacs.  To
+kill the Emacs process, type @kbd{M-x kill-emacs}.
 
 @node Printing, Sorting, Emacs Server, Top
 @section Printing Hard Copies