Issue 5164: Doc: Add usage of OpenType font feature

[lilypond.git] / Documentation / changes.tely

diff --git a/Documentation/changes.tely b/Documentation/changes.tely
index 3f3413c5ae3a50bdfe7947115b7c63ec006cf038..482bbbdd659d598db0ef027dc0336ccce51bf063 100644 (file)
--- a/Documentation/changes.tely
+++ b/Documentation/changes.tely
@@ -1063,6 +1063,33 @@ the next font listed will be used instead for that character.
 For details of alias definitions, please see
 to @code{00-lilypond-fonts.conf} under the installed directory.
 
+@item
+When using OpenType fonts, font features can be used.
+Note: Not all OpenType fonts have all functions.
+
+@lilypond[quote,verbatim]
+% True small caps
+\markup { Normal Style: Hello HELLO }
+\markup { \caps { Small Caps: Hello } }
+\markup { \override #'(font-features . ("smcp"))
+          { True Small Caps: Hello } }
+
+% Number styles
+\markup { Normal Number Style: 0123456789 }
+\markup { \override #'(font-features . ("onum"))
+          { Old Number Style: 0123456789 } }
+
+% Stylistic Alternates
+\markup { \override #'(font-features . ("salt 0"))
+          { Stylistic Alternates 0: εφπρθ } }
+\markup { \override #'(font-features . ("salt 1"))
+          { Stylistic Alternates 1: εφπρθ } }
+
+% Multiple features
+\markup { \override #'(font-features . ("onum" "smcp" "salt 1"))
+          { Multiple features: Hello 0123456789 εφπρθ } }
+@end lilypond
+
 @end itemize
 
 @ifhtml