what is the point of bfd/doc/ header generation rules

[Alan Modra]

On Wed, Dec 01, 2021 at 11:57:10PM -0500, Mike Frysinger wrote:
> bfd/doc/ has a few curious files that i can't seem to find docs on or any
> references to.  are they just uncommon maintainer-esque rules ?  or are
> they obsolete things that i can delete ?
> 
> specifically, what is the point of:
> $ cd bfd/doc/
> $ make libbfd.h libcoff.h bfd.h

See the headers rule in bfd/Makefile.am.  The above files are made in
bfd/doc when regenerating bfd/libbfd.h, bfd/libcoff.h, and
bfd/bfd-in2.h.

-- 
Alan Modra
Australia Development Lab, IBM