This is the mail archive of the gdb-patches@sources.redhat.com 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: [RFA] Enhance GDB to break inside DSO init code


> Why, oh why do people go to such great lengths to explain this in a
> mail message and/or in the comments to the code, but not as a patch to
> gdbint.texinfo?  Why not invest a small additional effort (Texinfo
> markup) to improve our documentation together with fixing a bug?

To me, explainations about the code belong in the code. When reading
some code I don't know about, I appreciate explainations located right
besides the code I'm trying to understand. I usually don't remember to
look into gdbint or any other document, and besides, it's incovenient
to have to search it, to see if there would be any additional info
there.

If I had to make a suggestion, I would embed all the information from
gdbint inside the code, and make gdbint a document generated from the
code.

-- 
Joel


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