This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [PATCH] New annotation for threads
> > Documenting a feature helps and encourages it's use.
>
> Then you should submit a patch to remove all docs of annotations from
> the manual, and try to convince us to accept it. Not documenting just
> one piece is inconsistent and doesn't make sense.
The difference, of course, is that all the current documentation was presumably
written before annotations were deprecated and before MI existed. Indeed, a
long time ago Andrew Cagney moved the description for most annotations out of
the GDB manual into a separate file called annotate.texinfo.
> > For this reason, and because annotations is deprecated, I was
> > intending not to document it. Why do you think it should be
> > documented?
>
> Because annotations are generally documented, and because they are
> still part of GDB. As long as annotations are part of GDB, I will
> object to any user-visible change in them that is not documented in
> the manual.
I will do this then as it will be easier to document it than try to argue that
it's not desirable.
--
Nick http://www.inet.net.nz/~nickrob