From: Eli Zaretskii Date: Fri, 5 Jan 2018 15:05:42 +0000 (+0200) Subject: Improve documentation of 'gdb-many-windows' X-Git-Tag: emacs-26.0.91~39 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=f8a07fa6b1;p=emacs.git 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'. --- 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