diff options
| author | Chong Yidong | 2011-07-12 18:09:28 -0400 |
|---|---|---|
| committer | Chong Yidong | 2011-07-12 18:09:28 -0400 |
| commit | b7527639316b53c6d66f6fe80d6865526566aef2 (patch) | |
| tree | 37e304d234cc2c85481905a933c488fcfd7b5a49 | |
| parent | 460c0fbaf95afc285c0d5f34c7a514bd56292902 (diff) | |
| download | emacs-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/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/lispref/display.texi | 40 |
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 @@ | |||
| 1 | 2011-07-12 Chong Yidong <cyd@stupidchicken.com> | 1 | 2011-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 | |||
| 6 | 2011-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 |
| 1803 | text: font family, foreground color, background color, optional | 1803 | text: font, foreground color, background color, optional underlining, |
| 1804 | underlining, and so on. Faces control how buffer text is displayed, | 1804 | and so on. Faces control how buffer text is displayed, and how some |
| 1805 | and how some parts of the frame, such as the mode-line, are displayed. | 1805 | parts 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 |
| 1807 | faces Emacs normally comes with. | 1807 | faces 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 |
| 2004 | Font family name or fontset name (a string). If you specify a font | 2004 | Font family or fontset (a string). @xref{Fonts,,, emacs, The GNU |
| 2005 | family name, the wild-card characters @samp{*} and @samp{?} are | 2005 | Emacs Manual}. If you specify a font family name, the wild-card |
| 2006 | allowed. The function @code{font-family-list}, described below, | 2006 | characters @samp{*} and @samp{?} are allowed. The function |
| 2007 | returns a list of available family names. @xref{Fontsets}, for | 2007 | @code{font-family-list}, described below, returns a list of available |
| 2008 | information about fontsets. | 2008 | family names. @xref{Fontsets}, for information about fontsets. |
| 2009 | 2009 | ||
| 2010 | @item :foundry | 2010 | @item :foundry |
| 2011 | The name of the @dfn{font foundry} in which the font family specified | 2011 | The name of the @dfn{font foundry} for the font family specified by |
| 2012 | by the @code{:family} attribute is located (a string). The wild-card | 2012 | the @code{:family} attribute (a string). The wild-card characters |
| 2013 | characters @samp{*} and @samp{?} are allowed. | 2013 | @samp{*} and @samp{?} are allowed. @xref{Fonts,,, emacs, The GNU |
| 2014 | Emacs Manual}. | ||
| 2014 | 2015 | ||
| 2015 | @item :width | 2016 | @item :width |
| 2016 | Relative proportionate character width, also known as the character | 2017 | Relative 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 |
| 2685 | select a @dfn{font} for that character@footnote{In this context, the | 2686 | select a @dfn{font} for that character@footnote{In this context, the |
| 2686 | term @dfn{font} has nothing to do with Font Lock (@pxref{Font Lock | 2687 | term @dfn{font} has nothing to do with Font Lock (@pxref{Font Lock |
| 2687 | Mode}).}. Normally, Emacs automatically chooses a font based on the | 2688 | Mode}).}. @xref{Fonts,,, emacs, The GNU Emacs Manual}. Normally, |
| 2688 | faces assigned to that character---specifically, the face attributes | 2689 | Emacs automatically chooses a font based on the faces assigned to that |
| 2689 | @code{:family}, @code{:weight}, @code{:slant}, and @code{:width} | 2690 | character---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 |
| 2691 | character to be displayed; some fonts can only display a limited set | 2692 | Attributes}). The choice of font also depends on the character to be |
| 2692 | of characters. If no available font exactly fits the requirements, | 2693 | displayed; some fonts can only display a limited set of characters. |
| 2693 | Emacs looks for the @dfn{closest matching font}. The variables in | 2694 | If no available font exactly fits the requirements, Emacs looks for |
| 2694 | this section control how Emacs makes this selection. | 2695 | the @dfn{closest matching font}. The variables in this section |
| 2696 | control how Emacs makes this selection. | ||
| 2695 | 2697 | ||
| 2696 | @defopt face-font-family-alternatives | 2698 | @defopt face-font-family-alternatives |
| 2697 | If a given family is specified but does not exist, this variable | 2699 | If a given family is specified but does not exist, this variable |