Document :otf font-spec property.

* display.texi (Low-Level Font): Document :otf font-spec property.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index f155c9575fad7cb707b60503556050689b791a3e..26314eadc8ebe09ed564b171baeb74687a84784c 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2010-02-27  Chong Yidong  <cyd@stupidchicken.com>
+
+       * display.texi (Low-Level Font): Document :otf font-spec property.
+
 2010-02-01  Stefan Monnier  <monnier@iro.umontreal.ca>
 
        * display.texi (Line Height): Avoid obsolete special default variables

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 91a71c54a6d19491f5d33943ccc1e6c66f5fcac6..68631dcdefcd47d2a29bd38a6531fc841941f4d1 100644 (file)
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -3068,6 +3068,26 @@ The charset registry and encoding of the font, such as
 
 @item :script
 The script that the font must support (a symbol).
+
+@item :otf
+The font must be an OpenType font that supports these OpenType
+features, provided Emacs is compiled with support for @samp{libotf} (a
+library for performing complex text layout in certain scripts).  The
+value must be a list of the form
+
+@smallexample
+@code{(@var{script-tag} @var{langsys-tag} @var{gsub} @var{gpos})}
+@end smallexample
+
+where @var{script-tag} is the OpenType script tag symbol;
+@var{langsys-tag} is the OpenType language system tag symbol, or
+@code{nil} to use the default language system; @code{gsub} is a list
+of OpenType GSUB feature tag symbols, or @code{nil} if none is
+required; and @code{gpos} is a list of OpenType GPOS feature tag
+symbols, or @code{nil} if none is required.  If @code{gsub} or
+@code{gpos} is a list, a @code{nil} element in that list means that
+the font must not match any of the remaining tag symbols.  The
+@code{gpos} element may be omitted.
 @end table
 @end defun