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


Nick Roberts wrote:
 > Thanks, but please add a corresponding bit to the user manual.  The
 > existing annotations are described there.

I plan to represent this patch with a test shortly. Documenting a feature
helps and encourages it's use. For this reason, and because annotations is
deprecated, I was intending not to document it. Why do you think it should be
documented?
If it's in the code and expected to be maintained, then it should be documented. How many times on this list have people been scratching their heads trying to figure out what an undocumented bit of code was supposed to do? These "deprecated" things seem to have a way of lasting longer than anyone's memories. :-)

Stan


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