summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2018-01-05 17:05:42 +0200
committerEli Zaretskii <eliz@gnu.org>2018-01-05 17:05:42 +0200
commitf8a07fa6b1cf138d1bf58a966bf4f10fa1dfee1d (patch)
tree9dce9f90554335e6139527ceb16bb6134737704e
parentf82400798ee4f7b0945c7b14e15c806108a504cb (diff)
downloademacs-f8a07fa6b1cf138d1bf58a966bf4f10fa1dfee1d.tar.gz
emacs-f8a07fa6b1cf138d1bf58a966bf4f10fa1dfee1d.tar.bz2
emacs-f8a07fa6b1cf138d1bf58a966bf4f10fa1dfee1d.zip
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'.
-rw-r--r--doc/emacs/building.texi8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index 6af2d9d7545..eb8d2027cf8 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
+@code{gdb-many-windows} to disrupt that, it is better to invoke
+@kbd{M-x 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 gdb-display-@var{buffertype}-buffer} or