aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChong Yidong2011-07-12 18:09:28 -0400
committerChong Yidong2011-07-12 18:09:28 -0400
commitb7527639316b53c6d66f6fe80d6865526566aef2 (patch)
tree37e304d234cc2c85481905a933c488fcfd7b5a49
parent460c0fbaf95afc285c0d5f34c7a514bd56292902 (diff)
downloademacs-b7527639316b53c6d66f6fe80d6865526566aef2.tar.gz
emacs-b7527639316b53c6d66f6fe80d6865526566aef2.zip
Minor xref additions to Lisp manual.
* doc/lispref/display.texi (Face Attributes, Font Selection): Add references to the Fonts node in the Emacs manual. Fixes: debbugs:4178
-rw-r--r--doc/lispref/ChangeLog5
-rw-r--r--doc/lispref/display.texi40
2 files changed, 26 insertions, 19 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 5b0711d2546..1d1730e078d 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,5 +1,10 @@
12011-07-12 Chong Yidong <cyd@stupidchicken.com> 12011-07-12 Chong Yidong <cyd@stupidchicken.com>
2 2
3 * display.texi (Face Attributes, Font Selection): Add references
4 to the Fonts node in the Emacs manual (Bug#4178).
5
62011-07-12 Chong Yidong <cyd@stupidchicken.com>
7
3 * display.texi (Window Systems): `window-system' is 8 * display.texi (Window Systems): `window-system' is
4 terminal-local. 9 terminal-local.
5 10
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 7e966278383..10119e54670 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -1800,9 +1800,9 @@ height.
1800@cindex faces 1800@cindex faces
1801 1801
1802 A @dfn{face} is a collection of graphical attributes for displaying 1802 A @dfn{face} is a collection of graphical attributes for displaying
1803text: font family, foreground color, background color, optional 1803text: font, foreground color, background color, optional underlining,
1804underlining, and so on. Faces control how buffer text is displayed, 1804and so on. Faces control how buffer text is displayed, and how some
1805and how some parts of the frame, such as the mode-line, are displayed. 1805parts of the frame, such as the mode-line, are displayed.
1806@xref{Standard Faces,,, emacs, The GNU Emacs Manual}, for the list of 1806@xref{Standard Faces,,, emacs, The GNU Emacs Manual}, for the list of
1807faces Emacs normally comes with. 1807faces Emacs normally comes with.
1808 1808
@@ -2001,16 +2001,17 @@ attribute is ignored.
2001 2001
2002@table @code 2002@table @code
2003@item :family 2003@item :family
2004Font family name or fontset name (a string). If you specify a font 2004Font family or fontset (a string). @xref{Fonts,,, emacs, The GNU
2005family name, the wild-card characters @samp{*} and @samp{?} are 2005Emacs Manual}. If you specify a font family name, the wild-card
2006allowed. The function @code{font-family-list}, described below, 2006characters @samp{*} and @samp{?} are allowed. The function
2007returns a list of available family names. @xref{Fontsets}, for 2007@code{font-family-list}, described below, returns a list of available
2008information about fontsets. 2008family names. @xref{Fontsets}, for information about fontsets.
2009 2009
2010@item :foundry 2010@item :foundry
2011The name of the @dfn{font foundry} in which the font family specified 2011The name of the @dfn{font foundry} for the font family specified by
2012by the @code{:family} attribute is located (a string). The wild-card 2012the @code{:family} attribute (a string). The wild-card characters
2013characters @samp{*} and @samp{?} are allowed. 2013@samp{*} and @samp{?} are allowed. @xref{Fonts,,, emacs, The GNU
2014Emacs Manual}.
2014 2015
2015@item :width 2016@item :width
2016Relative proportionate character width, also known as the character 2017Relative proportionate character width, also known as the character
@@ -2684,14 +2685,15 @@ usually assign faces to around 400 to 600 characters at each call.
2684 Before Emacs can draw a character on a particular display, it must 2685 Before Emacs can draw a character on a particular display, it must
2685select a @dfn{font} for that character@footnote{In this context, the 2686select a @dfn{font} for that character@footnote{In this context, the
2686term @dfn{font} has nothing to do with Font Lock (@pxref{Font Lock 2687term @dfn{font} has nothing to do with Font Lock (@pxref{Font Lock
2687Mode}).}. Normally, Emacs automatically chooses a font based on the 2688Mode}).}. @xref{Fonts,,, emacs, The GNU Emacs Manual}. Normally,
2688faces assigned to that character---specifically, the face attributes 2689Emacs automatically chooses a font based on the faces assigned to that
2689@code{:family}, @code{:weight}, @code{:slant}, and @code{:width} 2690character---specifically, the face attributes @code{:family},
2690(@pxref{Face Attributes}). The choice of font also depends on the 2691@code{:weight}, @code{:slant}, and @code{:width} (@pxref{Face
2691character to be displayed; some fonts can only display a limited set 2692Attributes}). The choice of font also depends on the character to be
2692of characters. If no available font exactly fits the requirements, 2693displayed; some fonts can only display a limited set of characters.
2693Emacs looks for the @dfn{closest matching font}. The variables in 2694If no available font exactly fits the requirements, Emacs looks for
2694this section control how Emacs makes this selection. 2695the @dfn{closest matching font}. The variables in this section
2696control how Emacs makes this selection.
2695 2697
2696@defopt face-font-family-alternatives 2698@defopt face-font-family-alternatives
2697If a given family is specified but does not exist, this variable 2699If a given family is specified but does not exist, this variable