aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorChong Yidong2012-06-09 00:39:49 +0800
committerChong Yidong2012-06-09 00:39:49 +0800
commit4b56d0fe74527ddab5a976200b479376faa6b6f4 (patch)
tree22ec2ff7bc6ab4ce3c8c95d16cd17a71b4c9285b /doc
parentd5c20fe8ca35d0a2b45bfad0a90553be04752d75 (diff)
downloademacs-4b56d0fe74527ddab5a976200b479376faa6b6f4.tar.gz
emacs-4b56d0fe74527ddab5a976200b479376faa6b6f4.zip
Face cleanups. Remove some uses of old-style face spec and :bold/:italic.
* faces.el (set-face-attribute): Doc fix. (modify-face): Don't use :bold and :italic. (error, warning, success): Tweak definitions. * cus-edit.el (custom-modified, custom-invalid, custom-rogue) (custom-modified, custom-set, custom-changed, custom-themed) (custom-saved, custom-button, custom-button-mouse) (custom-button-pressed, custom-state, custom-comment-tag) (custom-variable-tag, custom-group-tag-1, custom-group-tag) (custom-group-subtitle): Use new-style face specs. (custom-invalid-face, custom-rogue-face, custom-modified-face) (custom-set-face, custom-changed-face, custom-saved-face) (custom-button-face, custom-button-pressed-face) (custom-documentation-face, custom-state-face) (custom-comment-face, custom-comment-tag-face) (custom-variable-tag-face, custom-variable-button-face) (custom-face-tag-face, custom-group-tag-face-1) (custom-group-tag-face): Remove obsolete face alias. * epa.el (epa-validity-high, epa-validity-medium) (epa-validity-low, epa-mark, epa-field-name, epa-string) (epa-field-name, epa-field-body): * font-lock.el (font-lock-comment-face, font-lock-string-face) (font-lock-keyword-face, font-lock-builtin-face) (font-lock-function-name-face, font-lock-variable-name-face) (font-lock-type-face, font-lock-constant-face): * ido.el (ido-first-match, ido-only-match, ido-subdir) (ido-virtual, ido-indicator, ido-incomplete-regexp): * speedbar.el (speedbar-button-face, speedbar-file-face) (speedbar-directory-face, speedbar-tag-face) (speedbar-selected-face, speedbar-highlight-face) (speedbar-separator-face): * whitespace.el (whitespace-newline, whitespace-space) (whitespace-hspace, whitespace-tab, whitespace-trailing) (whitespace-line, whitespace-space-before-tab) (whitespace-space-after-tab, whitespace-indentation) (whitespace-empty): * emulation/cua-base.el (cua-global-mark): * eshell/em-prompt.el (eshell-prompt): * net/newst-plainview.el (newsticker-new-item-face) (newsticker-old-item-face, newsticker-immortal-item-face) (newsticker-obsolete-item-face, newsticker-date-face) (newsticker-statistics-face, newsticker-default-face): * net/newst-reader.el (newsticker-feed-face) (newsticker-extra-face, newsticker-enclosure-face): * net/newst-treeview.el (newsticker-treeview-face) (newsticker-treeview-new-face, newsticker-treeview-old-face) (newsticker-treeview-immortal-face) (newsticker-treeview-obsolete-face) (newsticker-treeview-selection-face): * net/rcirc.el (rcirc-my-nick, rcirc-other-nick) (rcirc-bright-nick, rcirc-server, rcirc-timestamp) (rcirc-nick-in-message, rcirc-nick-in-message-full-line) (rcirc-prompt, rcirc-track-keyword, rcirc-url, rcirc-keyword): * nxml/nxml-outln.el (nxml-heading, nxml-outline-indicator) (nxml-outline-active-indicator, nxml-outline-ellipsis): * play/mpuz.el (mpuz-unsolved, mpuz-solved, mpuz-trivial) (mpuz-text): * progmodes/vera-mode.el (vera-font-lock-number) (vera-font-lock-function, vera-font-lock-interface): * textmodes/table.el (table-cell): Use new-style face specs, and don't use the old :bold and :italic attributes. * erc-button.el (erc-button): * erc-goodies.el (erc-bold-face, erc-inverse-face) (erc-underline-face, fg:erc-color-*): * erc-match.el (erc-current-nick-face, erc-dangerous-host-face) (erc-pal-face, erc-fool-face, erc-keyword-face): * erc-stamp.el (erc-timestamp-face): Likewise. * erc.el (erc-direct-msg-face, erc-header-line, erc-input-face) (erc-command-indicator-face, erc-notice-face, erc-action-face) (erc-error-face, erc-my-nick-face, erc-nick-default-face) (erc-nick-msg-face): Use new-style face specs, and avoid :bold. * progmodes/ebrowse.el (ebrowse-tree-mark, ebrowse-root-class) (ebrowse-member-attribute, ebrowse-default, ebrowse-file-name) (ebrowse-member-class, ebrowse-progress): Likewise. (ebrowse-tree-mark-face, ebrowse-root-class-face) (ebrowse-file-name-face, ebrowse-default-face) (ebrowse-member-attribute-face, ebrowse-member-class-face) (ebrowse-progress-face): Remove obsolete faces. * progmodes/flymake.el (flymake-errline, flymake-warnline): Inherit from error and warning faces respectively. * textmodes/flyspell.el (flyspell-incorrect, flyspell-duplicate): Likewise. (flyspell-incorrect-face, flyspell-duplicate-face): Remove obsolete aliases. * display.texi (Face Attributes): Font family does not accept wildcards. De-document obsolete :bold and :italic attributes. (Defining Faces): Use new-style face spec format.
Diffstat (limited to 'doc')
-rw-r--r--doc/lispref/ChangeLog6
-rw-r--r--doc/lispref/display.texi41
2 files changed, 23 insertions, 24 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 1ef5595fa06..3c9f26d6a24 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,9 @@
12012-06-08 Chong Yidong <cyd@gnu.org>
2
3 * display.texi (Face Attributes): Font family does not accept
4 wildcards. De-document obsolete :bold and :italic attributes.
5 (Defining Faces): Use new-style face spec format.
6
12012-06-08 Dmitry Antipov <dmantipov@yandex.ru> 72012-06-08 Dmitry Antipov <dmantipov@yandex.ru>
2 8
3 * internals.text (Garbage Collection): Document new 9 * internals.text (Garbage Collection): Document new
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 4ecedd144e7..53e800bfbf0 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -1927,11 +1927,16 @@ exactly what the @code{defface} says.
1927@cindex face specification 1927@cindex face specification
1928The @var{spec} argument is a @dfn{face specification}, which states 1928The @var{spec} argument is a @dfn{face specification}, which states
1929how the face should appear on different kinds of terminals. It should 1929how the face should appear on different kinds of terminals. It should
1930be an alist whose elements each have the form @code{(@var{display} 1930be an alist whose elements each have the form
1931@var{atts})}. @var{display} specifies a class of terminals (see 1931
1932below), while @var{atts} is a property list of face attributes and 1932@example
1933their values, specifying the appearance of the face on matching 1933(@var{display} . @var{plist})
1934terminals 1934@end example
1935
1936@noindent
1937@var{display} specifies a class of terminals (see below), while
1938@var{plist} is a property list of face attributes and their values,
1939specifying how the face appears on such terminals
1935@iftex 1940@iftex
1936(see the next section for details about face attributes). 1941(see the next section for details about face attributes).
1937@end iftex 1942@end iftex
@@ -1947,8 +1952,8 @@ for that frame. There are three possibilities for @var{display}:
1947@table @asis 1952@table @asis
1948@item @code{default} 1953@item @code{default}
1949This element of @var{spec} doesn't match any frames; instead, it 1954This element of @var{spec} doesn't match any frames; instead, it
1950specifies defaults that apply to all frames. This kind of element, if 1955specifies defaults that apply to all frames. This element, if used,
1951used, must be the first element of @var{spec}. Each of the following 1956must be the first element of @var{spec}. Each of the following
1952elements can override any or all of these defaults. 1957elements can override any or all of these defaults.
1953 1958
1954@item @code{t} 1959@item @code{t}
@@ -2066,16 +2071,14 @@ attribute is ignored.
2066@table @code 2071@table @code
2067@item :family 2072@item :family
2068Font family or fontset (a string). @xref{Fonts,,, emacs, The GNU 2073Font family or fontset (a string). @xref{Fonts,,, emacs, The GNU
2069Emacs Manual}. If you specify a font family name, the wild-card 2074Emacs Manual}, for more information about font families; the function
2070characters @samp{*} and @samp{?} are allowed. The function 2075@code{font-family-list} (see below) returns a list of available family
2071@code{font-family-list}, described below, returns a list of available 2076names. @xref{Fontsets}, for information about fontsets.
2072family names. @xref{Fontsets}, for information about fontsets.
2073 2077
2074@item :foundry 2078@item :foundry
2075The name of the @dfn{font foundry} for the font family specified by 2079The name of the @dfn{font foundry} for the font family specified by
2076the @code{:family} attribute (a string). The wild-card characters 2080the @code{:family} attribute (a string). @xref{Fonts,,, emacs, The
2077@samp{*} and @samp{?} are allowed. @xref{Fonts,,, emacs, The GNU 2081GNU Emacs Manual}.
2078Emacs Manual}.
2079 2082
2080@item :width 2083@item :width
2081Relative proportionate character width, also known as the character 2084Relative proportionate character width, also known as the character
@@ -2221,16 +2224,6 @@ attributes from faces earlier in the list override those from later
2221faces. 2224faces.
2222@end table 2225@end table
2223 2226
2224For compatibility with Emacs 20, you can also specify values for two
2225``fake'' face attributes: @code{:bold} and @code{:italic}. Their
2226values must be either @code{t} or @code{nil}; a value of
2227@code{unspecified} is not allowed. Setting @code{:bold} to @code{t}
2228is equivalent to setting the @code{:weight} attribute to @code{bold},
2229and setting it to @code{nil} is equivalent to setting @code{:weight}
2230to @code{normal}. Setting @code{:italic} to @code{t} is equivalent to
2231setting the @code{:slant} attribute to @code{italic}, and setting it
2232to @code{nil} is equivalent to setting @code{:slant} to @code{normal}.
2233
2234@defun font-family-list &optional frame 2227@defun font-family-list &optional frame
2235This function returns a list of available font family names. The 2228This function returns a list of available font family names. The
2236optional argument @var{frame} specifies the frame on which the text is 2229optional argument @var{frame} specifies the frame on which the text is