Re: Starting multiple GUD session; doc problem

[Nick Roberts <nickrob@snap.net.nz>]

Stephen Leake writes:
 > I just tried to start two gdb sessions in one CVS Emacs session for
 > the first time (I've done this many times in Emacs 21). I got the
 > error message:
 > 
 >  "gdb: Multiple debugging is only supported with "gdb --fullname"
 > 
 > So I dutifully added "--fullname" to the gdb command line:
 >
 >     gdb --annotate=3 --fullname gds-main_models_test.exe 

Well, I'm not sure that's dutiful, it means start with "gdb --fullname"
_instead of_ "gdb --annotate=3" but if other's find it ambiguous too
I'll change it.

 > and got the same error message. I read the GUD and GDB entries in the
 > Emacs manual, and the help message for `gdb'; no success.

Was this not clear:

    You can also run GDB in text command mode, like other debuggers.  To
 do this, set `gud-gdb-command-name' to `"gdb --fullname"' or edit the
 startup command in the minibuffer to say that.  You need to do use text
 command mode to run multiple debugging sessions within one Emacs
 session.

 >                                                            Finally I
 > read the Emacs lisp source code for gud, and found this comment in
 > gud.el (gud-gdb-marker-filter):
 > 
 >     ;; Check for annotations and change gud-minor-mode to 'gdba if
 >     ;; they are found.

This comment is not for users.

 > It seems the real issue is the presence or absence of "--annotate=3",
 > not the presence of "--fullname". In fact, "--fullname" is not
 > necessary if compilation-search-path is set to include the source
 > directories.

That's not true.  If "--annotate=3" is not used the option "--fullname" is
necessary for the Emacs to display the current line in the source buffer.

 > So I suggest the attached patch to the Emacs manual (building.texi)
 > and a couple gud doc strings.
 >...

 >   ;;;###autoload
 >   (defun gdba (command-line)
 > !   "Run gdb on program FILE in buffer *gud-FILE*.
 >   The directory containing FILE becomes the initial working directory
 >   and source-file directory for your debugger.
 >   
 > --- 214,220 ----
 >   
 >   ;;;###autoload
 >   (defun gdba (command-line)
 > !   "Run gdb in GUI mode on program FILE in buffer *gud-FILE*.
 >   The directory containing FILE becomes the initial working directory
 >   and source-file directory for your debugger.

The current doc string goes on to explain what how this function lays out the
buffers.  To the first time user what would GUI mode mean?

The other changes are wrong because "--fullname" is needed.  Perhaps some
confusion arises over the term "text command mode".  It refers to the way that
it works in Emacs 21: GUD buffer + source buffer.  Perhaps you think it means
just GUD buffer i.e like the command line in a terminal.  Perhaps it would help
to refer to "text command mode" in the section "Debugger Operation" (it
currently says "using the textual interface").


-- 
Nick                                           http://www.inet.net.nz/~nickrob