> Here's a hint - the better vendors auto-generate these headers from the VHDL.

Yes! And the hateful naming might come straight from the RTL where digital designers have their own notions about what is a pretty name ;-)

> They are often right even when the documentation isn't.

More so -- if you decide for changing these names, one day debugging a complex issue will require talking to RTL people and everybody will be instantly lost -- your names won't be meaning much to them.