Re: [PATCH] GDB command-line switches and annotations docs

[Eli Zaretskii <eliz at delorie dot com>]

Elena Zannoni writes:

> > (Are there plans to make gdbmi.texi be part of the manual as well?)
> > 
>
> Eventually yes (Andrew?), right now it is not in prime time form yet. It is
> still very rough work in progress.

IMHO, it is much better to link between the two right now, and make
any necessary corrections later.  As far as I could see, gdbmi.texi is
in quite a good shape, it just lacks a few menus and @node lines to
make it a valid Texinfo file.  Most of the work can be done in Emacs
automatically.

The current situation, where a large part opf the package is not
documented at all, is IMHO much worse.

I can throw together a few patches as outlined above, if that would
help.

> I was planning on removing the -async option, it is now redundant.

It's much easier to remove part of the docs than to write it ;-)
Anyway, if -noasync stays, you will need some of what I wrote under
its description.

> The behavior you describe is the ultimate goal, we are only
> about 50% there.

The truth is, I still don't know enough about the event loop's
interaction with the target side to write the docs about it.  But I
thought there was no better way to get attention to its being
undocumented than to throw some patches on you-all ;-).  I do think
that refining the description should be the job of someone who knows
the fine details.