[Emacs-diffs] /srv/bzr/emacs/trunk r107738: Add details about emacsclient -c and -t on MS-Windows.

[Eli Zaretskii]

------------------------------------------------------------
revno: 107738
fixes bug(s): http://debbugs.gnu.org/11091
committer: Eli Zaretskii <address@hidden>
branch nick: trunk
timestamp: Mon 2012-04-02 20:33:41 +0300
message:
  Add details about emacsclient -c and -t on MS-Windows.
  
   doc/emacs/msdog.texi (Windows Startup): Add description of emacsclient
   operation under -c and -t on MS-Windows.
   doc/emacs/misc.texi (emacsclient Options): Add cross-reference to "Windows
   Startup".
modified:
  doc/emacs/ChangeLog
  doc/emacs/misc.texi
  doc/emacs/msdog.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2012-04-02 04:18:06 +0000
+++ b/doc/emacs/ChangeLog       2012-04-02 17:33:41 +0000
@@ -1,3 +1,11 @@
+2012-04-02  Eli Zaretskii  <address@hidden>
+
+       * msdog.texi (Windows Startup): Add description of emacsclient
+       operation under -c and -t on MS-Windows.
+
+       * misc.texi (emacsclient Options): Add cross-reference to "Windows
+       Startup".  (Bug#11091)
+
 2012-04-02  Dani Moncayo  <address@hidden>  (tiny change)
 
        * custom.texi (Changing a Variable): Fix example.

=== modified file 'doc/emacs/misc.texi'
--- a/doc/emacs/misc.texi       2012-04-01 20:47:58 +0000
+++ b/doc/emacs/misc.texi       2012-04-02 17:33:41 +0000
@@ -1507,12 +1507,11 @@
 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, where it cannot create graphical frames
-when started from a text-only terminal, it creates a new text-only
-terminal frame (@pxref{Frames}) on the same terminal where it was
-started.  If you omit a filename argument while supplying the
address@hidden option, the new frame displays the @samp{*scratch*} buffer
-(@pxref{Buffers}).
+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 @samp{*scratch*} buffer (@pxref{Buffers}).
 
 @item -F @var{alist}
 @itemx address@hidden
@@ -1599,9 +1598,10 @@
 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.  If you omit a filename
-argument while supplying this option, the new frame displays the
address@hidden buffer.  @xref{Buffers}.
+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 @samp{*scratch*} buffer.
address@hidden
 @end table
 
   If you type @kbd{C-x C-c} (@code{save-buffers-kill-terminal}) in an

=== modified file 'doc/emacs/msdog.texi'
--- a/doc/emacs/msdog.texi      2012-02-28 08:17:21 +0000
+++ b/doc/emacs/msdog.texi      2012-04-02 17:33:41 +0000
@@ -109,6 +109,21 @@
 the program that invoked @command{emacsclient}.
 @end enumerate
 
address@hidden emacsclient, on MS-Windows
+Note that, due to limitations of MS-Windows, Emacs cannot have both
+GUI and text-mode frames in the same session.  It also cannot open
+text-mode frames on more than a single @dfn{Command Prompt} window,
+because each Windows program can have only one console at any given
+time.  For these reasons, if you invoke @command{emacsclient} with the
address@hidden option, and the Emacs server runs in a text-mode session,
+Emacs will always create a new text-mode frame in the same
address@hidden Prompt} window where it was started; a GUI frame will be
+created only if the server runs in a GUI session.  Similarly, if you
+invoke @command{emacsclient} with the @option{-t} option, Emacs will
+create a GUI frame if the server runs in a GUI session, or a text-mode
+frame when the session runs in text-only mode in a @dfn{Command
+Prompt} window.  @xref{emacsclient Options}.
+
 @node Text and Binary
 @section Text Files and Binary Files
 @cindex text and binary files on MS-DOS/MS-Windows