procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve documentation of ':lang' in font specs

Browse source 
* src/font.c (Ffont_spec): Doc fix: elaborate on the values and
use of the ':lang' property of the font spec.
* doc/emacs/frames.texi (Fonts): Document the language names that
can be in the STYLE part of XLFD.
* doc/lispref/display.texi (Low-Level Font): Document the ':lang'
property.
This commit is contained in:
Eli Zaretskii 2015-06-13 13:23:42 +03:00
parent 2f6956a038
commit f75d189ed8
3 changed files with 17 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
doc/emacs/frames.texi
View file

@ -703,7 +703,10 @@ The font width---normally @samp{normal}, @samp{condensed},
other values.
@item style
An optional additional style name. Usually it is empty---most XLFDs
have two hyphens in a row at this point.
have two hyphens in a row at this point. The style name can also
specify a two-letter ISO-639 language name, like @samp{ja} or
@samp{ko}; some fonts that support CJK scripts have that spelled out
in the style name part.
@item pixels
The font height, in pixels.
@item height

9
doc/lispref/display.texi
View file

@ -3419,6 +3419,15 @@ The charset registry and encoding of the font, such as
@item :script
The script that the font must support (a symbol).
@item :lang
The language that the font should support. The value should be a
symbol whose name is a two-letter ISO-639 language name. On X, the
value is matched against the ``Additional Style'' field of the XLFD
name of a font, if it is non-empty. On MS-Windows, fonts matching the
spec are required to support codepages needed for the language.
Currently, only a small set of CJK languages is supported with this
property: @samp{ja}, @samp{ko}, and @samp{zh}.
@item :otf
@cindex OpenType font
The font must be an OpenType font that supports these OpenType

6
src/font.c
View file

@ -3857,8 +3857,10 @@ listed in the variable `script-representative-chars'.
`:lang'
VALUE must be a symbol of two-letter ISO-639 language names,
e.g. `ja'.
VALUE must be a symbol whose name is a two-letter ISO-639 language
name, e.g. `ja'. The value is matched against the "Additional Style"
field of the XLFD spec of a font, if it's non-empty, on X, and
against the codepages supported by the font on w32.
`:otf'