Mention named instances in the var-fonts section

2 years ago · a390590451
parent 37e90c64c1
commit a390590451
1 changed files with 12 additions and 1 deletions
--- a/docs/usermanual-fonts-and-faces.xml
+++ b/docs/usermanual-fonts-and-faces.xml
@ -474,6 +474,17 @@
      however, shaping with a variable font is just like shaping a
      static font.
    </para>
+    <para>
+      In addition to providing the variation axes themselves, fonts may also
+      pre-define certain variation coordinates as named instances. HarfBuzz
+      makes these coordinates (and their associated names) available via
+      <function>hb_ot_var_named_instance_get_design_coords()</function> and
+      <function>hb_ot_var_named_instance_get_subfamily_name_id()</function>.
+    </para>
+    <para>
+      Applications should treat named instances like multiple independent,
+      static fonts.
+    </para>
  </section>

 </chapter>