This is the mail archive of the gdb-patches@sourceware.org mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]