[PATCH 1/2] bfd: move header updates up a directory

Tom Tromey tom@tromey.com
Sat Dec 4 18:21:42 GMT 2021


>> What if we got rid of chew?  The docs that it creates aren't really all
>> that usable, and the approach taken by it means that the canonical
>> definition of some types is in a comment, not normal code.

Mike> i don't have a vested interest in bfd, but i was looking at this with the
Mike> sim and was planning on pulling all the docs out of the source and into
Mike> the texi files directly.

This isn't unreasonable, at least if you plan to write the docs (gdb
converted one file to doxygen and then gave up... :); but I don't think
chew really does this.  It also puts the definitions of things into
comments, which is annoying to work with.  E.g., look at bfd/section.c
for ".typedef".  This snippet is extracted from the commeent into
bfd-in2.h.

Tom


More information about the Binutils mailing list