Add some documentation (Harfbuzz, OpenType SVG).

2 files changed, 5 insertions, 3 deletions

diff --git a/src/display/drawing-text.cpp b/src/display/drawing-text.cpp
index b92886691..ab75026b7 100644
--- a/src/display/drawing-text.cpp
+++ b/src/display/drawing-text.cpp
@@ -575,7 +575,7 @@ unsigned DrawingText::_renderItem(DrawingContext &dc, Geom::IntRect const &/*are
             dc.newPath(); // Clear text-decoration path
         }
 
-        // accumulate the path that represents the glyphs
+        // Accumulate the path that represents the glyphs and/or draw SVG glyphs.
         for (auto & i : _children) {
             DrawingGlyphs *g = dynamic_cast<DrawingGlyphs *>(&i);
             if (!g) throw InvalidItemException();
@@ -615,7 +615,7 @@ unsigned DrawingText::_renderItem(DrawingContext &dc, Geom::IntRect const &/*are
             }
         }
 
-        // Draw the glyphs.
+        // Draw the glyphs (non-SVG glyphs).
         {
             Inkscape::DrawingContext::Save save(dc);
             dc.transform(_ctm);
diff --git a/src/libnrtype/OpenTypeUtil.cpp b/src/libnrtype/OpenTypeUtil.cpp
index 0662c339b..5e5e439bd 100644
--- a/src/libnrtype/OpenTypeUtil.cpp
+++ b/src/libnrtype/OpenTypeUtil.cpp
@@ -254,6 +254,7 @@ void readOpenTypeGsubTable (const FT_Face ft_face,
     hb_face_destroy (hb_face);
 }
 
+// Harfbuzz now as API for variations (Version 2.2, Nov 29 2018).
 // Make a list of all Variation axes with ranges.
 void readOpenTypeFvarAxes(const FT_Face ft_face,
                           std::map<Glib::ustring, OTVarAxis>& axes) {
@@ -289,6 +290,7 @@ void readOpenTypeFvarAxes(const FT_Face ft_face,
 }
 
 
+// Harfbuzz now as API for named variations (Version 2.2, Nov 29 2018).
 // Make a list of all Named instances with axis values.
 void readOpenTypeFvarNamed(const FT_Face ft_face,
                            std::map<Glib::ustring, OTVarInstance>& named) {
@@ -330,7 +332,7 @@ void readOpenTypeFvarNamed(const FT_Face ft_face,
 void readOpenTypeSVGTable(const FT_Face ft_face,
                           std::map<int, SVGTableEntry>& glyphs) {
 
-    // Harfbuzz has some support for SVG fonts but it is not yet exposed to user.
+    // Harfbuzz has some support for SVG fonts but it is not exposed until version 2.1 (Oct 30, 2018).
     // We do it the hard way!
     hb_face_t *hb_face = hb_ft_face_create_cached (ft_face);
     hb_blob_t *hb_blob = hb_face_reference_table (hb_face, HB_OT_TAG_SVG);