From f8a07fa6b1cf138d1bf58a966bf4f10fa1dfee1d Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 5 Jan 2018 17:05:42 +0200 Subject: [PATCH] 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 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 -- 2.39.5