[Emacs-diffs] emacs-26 f8a07fa: Improve documentation of 'gdb-many-windows'

[Eli Zaretskii]

branch: emacs-26
commit f8a07fa6b1cf138d1bf58a966bf4f10fa1dfee1d
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Improve documentation of 'gdb-many-windows'
    
    * doc/emacs/building.texi (GDB User Interface Layout): Add advice
    for using a separate frame for 'gdb-many-windows'.
---
 doc/emacs/building.texi | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index 6af2d9d..eb8d202 100644
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -916,6 +916,14 @@ layout by typing @kbd{M-x gdb-restore-windows}.  To toggle
 between the many windows layout and a simple layout with just the GUD
 interaction buffer and a source file, type @kbd{M-x gdb-many-windows}.
 
+  If you have an elaborate window setup, and don't want
address@hidden to disrupt that, it is better to invoke
address@hidden gdb} in a separate frame to begin with, then the arrangement
+of windows on your original frame will not be affected.  A separate
+frame for GDB sessions can come in especially handy if you work on a
+text-mode terminal, where the screen estate for windows could be at a
+premium.
+
   You may also specify additional GDB-related buffers to display,
 either in the same frame or a different one.  Select the buffers you
 want by typing @code{M-x address@hidden or