[freetype2] master b1286b3: Document `FT_Face_Rec_::box' with variable fonts (#54969).

[Werner LEMBERG]

branch: master
commit b1286b32a9f2bcba3f22c9857ba6df30733b7845
Author: Ben Wagner <bungeman@google.com>
Commit: Werner Lemberg <wl@gnu.org>

    Document `FT_Face_Rec_::box' with variable fonts (#54969).
    
    As pointed out in the "Note:" in the section of
    
      
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.
    
    Document that `FT_Face_Rec_::box' does not vary with OpenType variable
    fonts.
---
 include/freetype/freetype.h | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index 3966278..ba3950e 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -958,6 +958,9 @@ FT_BEGIN_HEADER
    *     Note that the bounding box might be off by (at least) one pixel for
    *     hinted fonts.  See @FT_Size_Metrics for further discussion.
    *
+   *     Note that the bounding box does not vary in OpenType variable fonts
+   *     and should only be used in relation to the default instance.
+   *
    *   units_per_EM ::
    *     The number of font units per EM square for this face.  This is
    *     typically 2048 for TrueType fonts, and 1000 for Type~1 fonts.  Only