Sometimes, a binary (shared binary for instance) might come with its header files spread over several directories. In that case we must be able to let abidiff know about all the header files directories by specifying the --headers-dir1 (or --headers-dir2) several times on the command line, just like what can be done with --debug-info-dir{1,2}. The same thing must be supported for the --headers-dir option of abidw.
There is code in the branch https://sourceware.org/git/?p=libabigail.git;a=shortlog;h=refs/heads/dodji/mult-headers to support this. That is, one can specify --headers-dir{1,2} several times on the command line of abidiff and it should do the right thing. I guess this needs some more testing before it can be folded into master.
This feature landed in the master branch of the git repository at https://sourceware.org/git/?p=libabigail.git;a=commit;h=ee2b54ddd9eb79297e90dd4252dc5c672073c9fc and should be available in the 1.8 version of libabigail.
Thank you! This is a great addition to abidiff.