Document FT_Face_Rec_::bbox as unreliable / deprecated.
Migrated from: [SAVANNAH-54969]
bungeman reported:
As pointed out in the Note in the section https://docs.microsoft.com/en-us/typography/opentype/spec/otvaroverview#variation-data-tables-and-miscellaneous-requirements
"... the xMin, yMin, xMax, yMax, macStyle and lowestRecPPEM fields in the font header ('head') table are not supported by variation data and should only be used in relation to the default instance for the font. Also, variations for values in the kerning ('kern') table are not supported, variable fonts should handle kerning using the GPOS table."
Unfortunately, this means that there is no longer any reliable 'fast union of all glyph bounds' available in an OpenType font. As a result, any user of these values may get very unexpected results if they are relying on this bbox having a sensible value.
Obviously, this field cannot be removed or given bad values for now, but this should be noted so this field isn't carried over into a future FreeType 3 and so existing users know its limitations (can't be used a a generic fast bounding box for quick rejection).