[Emacs-ada-mode] updated ada-mode with manual

[The masked-coder known as Randux]

Hello Stephe,

> >> > And what about a bit about GVD in the debugging section along with
> >> > gdb and ddd? 
> >> 
> >> I haven't gotten to that section yet.
> >> 
> >> > It's still very useful in 3.15p and perhaps other pre-GPS
> >> > installations. 
> >> 
> >> This is _Emacs_ ada-mode. Emacs makes a perfectly fine front end for
> >> gdb. "We don't need no GVD _or_ GPS" :).
> >
> > I haven't seen what Emacs can do with gdb, 
> 
> Give it a try first.
> 
> > but gvd is really quite nice if a bit clumsy. Have you tried it?
> 
> I think I tried GVD when it first came out. GPS is better, but Emacs
> is good enough for my debugging needs. It is nice to be able to just
> point the mouse at a variable and see the value. But the other
> benefits of Emacs outweigh that.
> 
> > I found GPS so riddled with usability problems that I finally deleted
> > it. But I've a copy of gvd that works with 3.15p and I used it
> > recently. If I do anything with GNAT GPL I'd like to be able to use
> > Emacs for editing the code and gvd for debugging it without using
> > GPS...
> 
> That is certainly possible. I don't think the Emacs ada-mode manual
> needs to talk about it.

I don't understand where this is going...gvd is a GUI (running on top of gdb) specifically designed for source level debugging GNAT Ada.  Since I saw that ddd was mentioned in the doc and gvd was not mentioned, I suggested we include some information on gvd as it's certainly more preferable/usable than ddd when the topic is GUI debuggers for Ada.  GPS is not better than gvd- GPS is the IDE, gvd is just the GUI for gdb...two completely different animals.  If gvd could somehow be considered not relevant, than I also don't understand the relevance of ddd in the doc...that's all.

> > I notice that the C-c C-c is still broken (doesn't support the
> > helloworlda/b scenario posted earlier). 
> 
> I gather you mean typing C-c C-c in hello_a compiles A, then in
> hello_b compiles B, then in hellow_a compiles b again.
> 
> That's not a bug, that's a feature. It is useful in the much more
> common case of multiple file projects.
> 
> I proposed one change related to this:
> 
>     I'd also like to add a menu command "set main" to just set the
>     main file.
> 
> Would that fix the problem?

I thought we agreed earlier that it was "unexpected behavior" and you were planning to fix it. I don't think adding a requirement for the user to do something extra is a fix for this- it's not very intuitive that when I'm looking at a buffer and press C-c C-c  that it should just build anything other than what I'm looking at.  If this isn't a usability flaw of the highest order, then I can't think of a better example!

> If not, what, specifically, would you like to change in the Emacs
> ada-mode menu? And how would it impact compiling multiple-file projects?

As I've mentioned, not only am I not qualified to speak on the topic of multi-file Ada projects, but I think the least amount of automation the better it will be for the user and for the maintainer.

There should be one key and one menu item to build *this* item I'm looking at.  I'm in a buffer, I want to do a gnatmake on *this* buffer.

> > Also uncomment seems broken (but was also broken in the ada-mode
> > supplied in Emacs 21.4). 
> 
> Yes, it does not delete the correct number of spaces.

For me it's totally broken.  It does nothing at all except produce this error message:

Wrong type argument: number-or-marker-p, (-1)

> > Lastly, is there a way to verify which version of Ada-mode we're
> > using? I've followed the installation instructions but how do I know
> > I'm getting your updates and not the previous ada-mode?
> 
> I guess I should add a version function just for that.

Thanks.

> For now, look at the title of the buffer created by Ada | Project |
> edit. My latest says "*Edit Ada Mode Project*"; earlier versions say
> "*Customize Ada Mode*".
> 
> You can also use M-x locate-library ada-mode; that gives the full path
> to ada-mode.el

Thanks for the info.

Rand