diff options
| author | Chong Yidong | 2012-06-09 00:39:49 +0800 |
|---|---|---|
| committer | Chong Yidong | 2012-06-09 00:39:49 +0800 |
| commit | 4b56d0fe74527ddab5a976200b479376faa6b6f4 (patch) | |
| tree | 22ec2ff7bc6ab4ce3c8c95d16cd17a71b4c9285b /doc | |
| parent | d5c20fe8ca35d0a2b45bfad0a90553be04752d75 (diff) | |
| download | emacs-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/ChangeLog | 6 | ||||
| -rw-r--r-- | doc/lispref/display.texi | 41 |
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 @@ | |||
| 1 | 2012-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 | |||
| 1 | 2012-06-08 Dmitry Antipov <dmantipov@yandex.ru> | 7 | 2012-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 |
| 1928 | The @var{spec} argument is a @dfn{face specification}, which states | 1928 | The @var{spec} argument is a @dfn{face specification}, which states |
| 1929 | how the face should appear on different kinds of terminals. It should | 1929 | how the face should appear on different kinds of terminals. It should |
| 1930 | be an alist whose elements each have the form @code{(@var{display} | 1930 | be an alist whose elements each have the form |
| 1931 | @var{atts})}. @var{display} specifies a class of terminals (see | 1931 | |
| 1932 | below), while @var{atts} is a property list of face attributes and | 1932 | @example |
| 1933 | their values, specifying the appearance of the face on matching | 1933 | (@var{display} . @var{plist}) |
| 1934 | terminals | 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, | ||
| 1939 | specifying 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} |
| 1949 | This element of @var{spec} doesn't match any frames; instead, it | 1954 | This element of @var{spec} doesn't match any frames; instead, it |
| 1950 | specifies defaults that apply to all frames. This kind of element, if | 1955 | specifies defaults that apply to all frames. This element, if used, |
| 1951 | used, must be the first element of @var{spec}. Each of the following | 1956 | must be the first element of @var{spec}. Each of the following |
| 1952 | elements can override any or all of these defaults. | 1957 | elements 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 |
| 2068 | Font family or fontset (a string). @xref{Fonts,,, emacs, The GNU | 2073 | Font family or fontset (a string). @xref{Fonts,,, emacs, The GNU |
| 2069 | Emacs Manual}. If you specify a font family name, the wild-card | 2074 | Emacs Manual}, for more information about font families; the function |
| 2070 | characters @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 | 2076 | names. @xref{Fontsets}, for information about fontsets. |
| 2072 | family names. @xref{Fontsets}, for information about fontsets. | ||
| 2073 | 2077 | ||
| 2074 | @item :foundry | 2078 | @item :foundry |
| 2075 | The name of the @dfn{font foundry} for the font family specified by | 2079 | The name of the @dfn{font foundry} for the font family specified by |
| 2076 | the @code{:family} attribute (a string). The wild-card characters | 2080 | the @code{:family} attribute (a string). @xref{Fonts,,, emacs, The |
| 2077 | @samp{*} and @samp{?} are allowed. @xref{Fonts,,, emacs, The GNU | 2081 | GNU Emacs Manual}. |
| 2078 | Emacs Manual}. | ||
| 2079 | 2082 | ||
| 2080 | @item :width | 2083 | @item :width |
| 2081 | Relative proportionate character width, also known as the character | 2084 | Relative proportionate character width, also known as the character |
| @@ -2221,16 +2224,6 @@ attributes from faces earlier in the list override those from later | |||
| 2221 | faces. | 2224 | faces. |
| 2222 | @end table | 2225 | @end table |
| 2223 | 2226 | ||
| 2224 | For compatibility with Emacs 20, you can also specify values for two | ||
| 2225 | ``fake'' face attributes: @code{:bold} and @code{:italic}. Their | ||
| 2226 | values must be either @code{t} or @code{nil}; a value of | ||
| 2227 | @code{unspecified} is not allowed. Setting @code{:bold} to @code{t} | ||
| 2228 | is equivalent to setting the @code{:weight} attribute to @code{bold}, | ||
| 2229 | and setting it to @code{nil} is equivalent to setting @code{:weight} | ||
| 2230 | to @code{normal}. Setting @code{:italic} to @code{t} is equivalent to | ||
| 2231 | setting the @code{:slant} attribute to @code{italic}, and setting it | ||
| 2232 | to @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 |
| 2235 | This function returns a list of available font family names. The | 2228 | This function returns a list of available font family names. The |
| 2236 | optional argument @var{frame} specifies the frame on which the text is | 2229 | optional argument @var{frame} specifies the frame on which the text is |