Support for opening X frames from a tty session.
[bpt/emacs.git] / lisp / cus-face.el
dissimilarity index 61%
index 4137161..b5716da 100644 (file)
-;;; cus-face.el -- customization support for faces.
-;;
-;; Copyright (C) 1996, 1997 Free Software Foundation, Inc.
-;;
-;; Author: Per Abrahamsen <abraham@dina.kvl.dk>
-;; Keywords: help, faces
-;; Version: Emacs
-;; X-URL: http://www.dina.kvl.dk/~abraham/custom/
-
-;; This file is part of GNU Emacs.
-
-;; GNU Emacs is free software; you can redistribute it and/or modify
-;; it under the terms of the GNU General Public License as published by
-;; the Free Software Foundation; either version 2, or (at your option)
-;; any later version.
-
-;; GNU Emacs is distributed in the hope that it will be useful,
-;; but WITHOUT ANY WARRANTY; without even the implied warranty of
-;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-;; GNU General Public License for more details.
-
-;; You should have received a copy of the GNU General Public License
-;; along with GNU Emacs; see the file COPYING.  If not, write to the
-;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-;; Boston, MA 02111-1307, USA.
-
-;;; Commentary:
-;;
-;; See `custom.el'.
-
-;;; Code:
-
-(defalias 'custom-facep 'facep)
-
-;;; Declaring a face.
-
-;;;###autoload
-(defun custom-declare-face (face spec doc &rest args)
-  "Like `defface', but FACE is evaluated as a normal argument."
-  (unless (get face 'face-defface-spec)
-    (put face 'face-defface-spec spec)
-    (when (fboundp 'facep)
-      (unless (facep face)
-       ;; If the user has already created the face, respect that.
-       (let ((value (or (get face 'saved-face) spec))
-             (frames (frame-list))
-             frame)
-         ;; Create global face.
-         (make-empty-face face)
-         ;; Create frame local faces
-         (while frames
-           (setq frame (car frames)
-                 frames (cdr frames))
-           (face-spec-set face value frame)))
-       ;; When making a face after frames already exist
-       (if (memq window-system '(x w32))
-           (make-face-x-resource-internal face))))
-    (when (and doc (null (face-documentation face)))
-      (set-face-documentation face doc))
-    (custom-handle-all-keywords face args 'custom-face)
-    (run-hooks 'custom-define-hook))
-  face)
-
-;;; Face attributes.
-
-;; Below, nil is used in widget specifications for `unspecified' face
-;; attributes and `off' is used instead of nil attribute values.  The
-;; reason for this is that nil corresponds to the result you get when
-;; looking up an attribute in a defface spec that isn't contained in
-;; the spec.
-
-(defconst custom-face-attributes
-  '((:family
-     (choice :tag "Font family"
-            :help-echo "Font family or fontset alias name."
-            (const :tag "*" nil)
-            (string :tag "Family"))
-     (lambda (face value &optional frame)
-       (set-face-attribute face frame :family (or value 'unspecified)))
-     (lambda (face &optional frame)
-       (let ((family (face-attribute face :family frame)))
-        (if (eq family 'unspecified) nil family))))
-    
-    (:width
-     (choice :tag "Width"
-            :help-echo "Font width."
-            (const :tag "*" nil)
-            (const :tag "compressed" condensed)
-            (const :tag "condensed" condensed)
-            (const :tag "demiexpanded" semi-expanded)
-            (const :tag "expanded" expanded)
-            (const :tag "extracondensed" extra-condensed)
-            (const :tag "extraexpanded" extra-expanded)
-            (const :tag "medium" normal)
-            (const :tag "narrow" condensed)
-            (const :tag "normal" normal)
-            (const :tag "regular" normal)
-            (const :tag "semicondensed" semi-condensed)
-            (const :tag "semiexpanded" semi-expanded)
-            (const :tag "ultracondensed" ultra-condensed)
-            (const :tag "ultraexpanded" ultra-expanded)
-            (const :tag "wide" extra-expanded))
-     (lambda (face value &optional frame)
-       (set-face-attribute face frame :width (or value 'unspecified)))
-     (lambda (face &optional frame)
-       (let ((width (face-attribute face :width frame)))
-        (if (eq width 'unspecified) nil width))))
-    
-    (:height
-     (choice :tag "Height"
-            :help-echo "Face's font height."
-            (const :tag "*" nil)
-            (integer :tag "Height in 1/10 pt"))
-     (lambda (face value &optional frame)
-       (set-face-attribute face frame :height (or value 'unspecified)))
-     (lambda (face &optional frame)
-       (let ((height (face-attribute face :height frame)))
-        (if (eq height 'unspecified) nil height))))
-    
-    (:weight
-     (choice :tag "Weight"
-            :help-echo "Font weight."
-            (const :tag "*" nil)
-            (const :tag "black" ultra_bold)
-            (const :tag "bold" bold)
-            (const :tag "book" semi-light)
-            (const :tag "demibold" semi-bold)
-            (const :tag "extralight" extra-light)
-            (const :tag "extrabold" extra-bold)
-            (const :tag "heavy" extra-bold)
-            (const :tag "light" light)
-            (const :tag "medium" normal)
-            (const :tag "normal" normal)
-            (const :tag "regular" normal)
-            (const :tag "semibold" semi-bold)
-            (const :tag "semilight" semi-light)
-            (const :tag "ultralight" ultra-light)
-            (const :tag "ultrabold" ultra-bold))
-     (lambda (face value &optional frame)
-       (set-face-attribute face frame :weight (or value 'unspecified)))
-     (lambda (face &optional frame)
-       (let ((weight (face-attribute face :weight frame)))
-        (if (eq weight 'unspecified) nil weight))))
-    
-    (:slant
-     (choice :tag "Slant"
-            :help-echo "Font slant."
-            (const :tag "*" nil)
-            (const :tag "italic" italic)
-            (const :tag "oblique" oblique)
-            (const :tag "normal" normal))
-     (lambda (face value &optional frame)
-       (set-face-attribute face frame :slant (or value 'unspecified)))
-     (lambda (face &optional frame)
-       (let ((slant (face-attribute face :slant frame)))
-        (if (eq slant 'unspecified) nil slant))))
-    
-    (:underline
-     (choice :tag "Underline"
-            :help-echo "Control text underlining."
-            (const :tag "*" nil)
-            (const :tag "On" t)
-            (const :tag "Off" off)
-            (color :tag "Colored"))
-     (lambda (face value &optional frame)
-       (cond ((eq value 'off) (setq value nil))
-            ((null value) (setq value 'unspecified)))
-       (set-face-attribute face frame :underline value))
-     (lambda (face &optional frame)
-       (let ((underline (face-attribute face :underline frame)))
-        (cond ((eq underline 'unspecified) (setq underline nil))
-              ((null underline) (setq underline 'off)))
-        underline)))
-    
-    (:overline
-     (choice :tag "Overline"
-            :help-echo "Control text overlining."
-            (const :tag "*" nil)
-            (const :tag "On" t)
-            (const :tag "Off" off)
-            (color :tag "Colored"))
-     (lambda (face value &optional frame)
-       (cond ((eq value 'off) (setq value nil))
-            ((null value) (setq value 'unspecified)))
-       (set-face-attribute face frame :overline value))
-     (lambda (face &optional frame)
-       (let ((overline (face-attribute face :overline frame)))
-        (cond ((eq overline 'unspecified) (setq overline nil))
-              ((null overline) (setq overline 'off)))
-        overline)))
-    
-    (:strike-through
-     (choice :tag "Strike-through"
-            :help-echo "Control text strike-through."
-            (const :tag "*" nil)
-            (const :tag "On" t)
-            (const :tag "Off" off)
-            (color :tag "Colored"))
-     (lambda (face value &optional frame)
-       (cond ((eq value 'off) (setq value nil))
-            ((null value) (setq value 'unspecified)))
-       (set-face-attribute face frame :strike-through value))
-     (lambda (face &optional frame)
-       (let ((value (face-attribute face :strike-through frame)))
-        (cond ((eq value 'unspecified) (setq value nil))
-              ((null value) (setq value 'off)))
-        value)))
-    
-    (:box
-     (choice :tag "Box around text"
-            :help-echo "Control box around text."
-            (const :tag "*" nil)
-            (const :tag "Off" off)
-            (list :tag "Box"
-                  :value (1 "black" nil)
-                  (integer :tag "Width")
-                  (color :tag "Color")
-                  (choice :tag "Shadows"
-                          (const :tag "None" nil)
-                          (const :tag "Raised" raised)
-                          (const :tag "Sunken" sunken))))
-     (lambda (face value &optional frame)
-       (cond ((consp value)
-             (let ((width (nth 0 value))
-                   (color (nth 1 value))
-                   (shadow (nth 2 value)))
-               (setq value (list :width width :color color :shadow shadow))))
-            ((eq value 'off)
-             (setq value nil))
-            ((null value)
-             (setq value 'unspecified)))
-       (set-face-attribute face frame :box value))
-     (lambda (face &optional frame)
-       (let ((value (face-attribute face :box frame)))
-        (cond ((consp value)
-               (let ((width (plist-get value :width))
-                     (color (plist-get value :color))
-                     (shadow (plist-get value :shadow)))
-                 (setq value (list width color shadow))))
-              ((eq value 'unspecified)
-               (setq value nil))
-              ((null value)
-               (setq value 'off)))
-        value)))
-    
-    (:inverse-video
-     (choice :tag "Inverse-video"
-            :help-echo "Control whether text should be in inverse-video."
-            (const :tag "*" nil)
-            (const :tag "On" t)
-            (const :tag "Off" off))
-     (lambda (face value &optional frame)
-       (cond ((eq value 'off) (setq value nil))
-            ((null value) (setq value 'unspecified)))
-       (set-face-attribute face frame :inverse-video value))
-     (lambda (face &optional frame)
-       (let ((value (face-attribute face :inverse-video frame)))
-        (cond ((eq value 'unspecified) (setq value nil))
-              ((null value) (setq value 'off)))
-        value)))
-    
-    (:foreground
-     (choice :tag "Foreground"
-            :help-echo "Set foreground color."
-            (const :tag "*" nil)
-            (color :tag "Color"))
-     (lambda (face value &optional frame)
-       (set-face-attribute face frame :foreground (or value 'unspecified)))
-     (lambda (face &optional frame)
-       (let ((value (face-attribute face :foreground frame)))
-        (if (eq value 'unspecified) nil value))))
-    
-    (:background
-     (choice :tag "Background"
-            :help-echo "Set background color."
-            (const :tag "*" nil)
-            (color :tag "Color"))
-     (lambda (face value &optional frame)
-       (set-face-attribute face frame :background (or value 'unspecified)))
-     (lambda (face &optional frame)
-       (let ((value (face-attribute face :background frame)))
-        (if (eq value 'unspecified) nil value))))
-    
-    (:stipple
-     (choice :tag "Stipple"
-            :help-echo "Name of background bitmap file."
-            (const :tag "*" nil)
-            (file :tag "File" :must-match t))
-     (lambda (face value &optional frame)
-       (set-face-attribute face frame :stipple (or value 'unspecified)))
-     (lambda (face &optional frame)
-       (let ((value (face-attribute face :stipple frame)))
-        (if (eq value 'unspecified) nil value)))))
-       
-  "Alist of face attributes.
-
-The elements are of the form (KEY TYPE SET GET), where KEY is the name
-of the attribute, TYPE is a widget type for editing the attibute, SET
-is a function for setting the attribute value, and GET is a function
-for getiing the attribute value.
-
-The SET function should take three arguments, the face to modify, the
-value of the attribute, and optionally the frame where the face should
-be changed.
-
-The GET function should take two arguments, the face to examine, and
-optionally the frame where the face should be examined.")
-
-
-(defun custom-face-attributes-get (face frame)
-  "For FACE on FRAME, return an alternating list describing its attributes.
-The list has the form (KEYWORD VALUE KEYWORD VALUE...).
-Each keyword should be listed in `custom-face-attributes'.
-
-If FRAME is nil, use the global defaults for FACE."
-  (let ((attrs custom-face-attributes)
-       plist)
-    (while attrs
-      (let* ((attribute (car (car attrs)))
-            (value (face-attribute face attribute frame)))
-       (setq attrs (cdr attrs))
-       (unless (eq value 'unspecified)
-         (setq plist (cons attribute (cons value plist))))))
-    plist))
-
-;;; Initializing.
-
-;;;###autoload
-(defun custom-set-faces (&rest args)
-  "Initialize faces according to user preferences.
-The arguments should be a list where each entry has the form:
-
-  (FACE SPEC [NOW])
-
-SPEC is stored as the saved value for FACE.
-If NOW is present and non-nil, FACE is created now, according to SPEC.
-
-See `defface' for the format of SPEC."
-  (while args
-    (let ((entry (car args)))
-      (if (listp entry)
-         (let ((face (nth 0 entry))
-               (spec (nth 1 entry))
-               (now (nth 2 entry)))
-           (put face 'saved-face spec)
-           (when now
-             (put face 'force-face t))
-           (when (or now (facep face))
-             (make-empty-face face)
-             (face-spec-set face spec))
-           (setq args (cdr args)))
-       ;; Old format, a plist of FACE SPEC pairs.
-       (let ((face (nth 0 args))
-             (spec (nth 1 args)))
-         (put face 'saved-face spec))
-       (setq args (cdr (cdr args)))))))
-
-;;; The End.
-
-(provide 'cus-face)
-
-;; cus-face.el ends here
+;;; cus-face.el --- customization support for faces
+;;
+;; Copyright (C) 1996, 1997, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
+;;
+;; Author: Per Abrahamsen <abraham@dina.kvl.dk>
+;; Keywords: help, faces
+
+;; This file is part of GNU Emacs.
+
+;; GNU Emacs is free software; you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation; either version 2, or (at your option)
+;; any later version.
+
+;; GNU Emacs is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with GNU Emacs; see the file COPYING.  If not, write to the
+;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+;; Boston, MA 02111-1307, USA.
+
+;;; Commentary:
+;;
+;; See `custom.el'.
+
+;;; Code:
+
+(defalias 'custom-facep 'facep)
+
+;;; Declaring a face.
+
+;;;###autoload
+(defun custom-declare-face (face spec doc &rest args)
+  "Like `defface', but FACE is evaluated as a normal argument."
+  (unless (get face 'face-defface-spec)
+    (when (fboundp 'facep)
+      (unless (facep face)
+       ;; If the user has already created the face, respect that.
+       (let ((value (or (get face 'saved-face) spec))
+             (frames (frame-list))
+             (have-window-system (memq initial-window-system '(x w32)))
+             frame)
+         ;; Create global face.
+         (make-empty-face face)
+         ;; Create frame-local faces
+         (while frames
+           (setq frame (car frames)
+                 frames (cdr frames))
+           (face-spec-set face value frame)
+           (when (memq (window-system frame) '(x w32))
+             (setq have-window-system t)))
+         ;; When making a face after frames already exist
+         (if have-window-system
+             (make-face-x-resource-internal face)))))
+    ;; Don't record SPEC until we see it causes no errors.
+    (put face 'face-defface-spec spec)
+    (when (and doc (null (face-documentation face)))
+      (set-face-documentation face (purecopy doc)))
+    (custom-handle-all-keywords face args 'custom-face)
+    (run-hooks 'custom-define-hook))
+  face)
+
+;;; Face attributes.
+
+(defconst custom-face-attributes
+  '((:family
+     (string :tag "Font Family"
+            :help-echo "Font family or fontset alias name."))
+
+    (:width
+     (choice :tag "Width"
+            :help-echo "Font width."
+            :value normal              ; default
+            (const :tag "compressed" condensed)
+            (const :tag "condensed" condensed)
+            (const :tag "demiexpanded" semi-expanded)
+            (const :tag "expanded" expanded)
+            (const :tag "extracondensed" extra-condensed)
+            (const :tag "extraexpanded" extra-expanded)
+            (const :tag "medium" normal)
+            (const :tag "narrow" condensed)
+            (const :tag "normal" normal)
+            (const :tag "regular" normal)
+            (const :tag "semicondensed" semi-condensed)
+            (const :tag "semiexpanded" semi-expanded)
+            (const :tag "ultracondensed" ultra-condensed)
+            (const :tag "ultraexpanded" ultra-expanded)
+            (const :tag "wide" extra-expanded)))
+
+    (:height
+     (choice :tag "Height"
+            :help-echo "Face's font height."
+            :value 1.0                 ; default
+            (integer :tag "Height in 1/10 pt")
+            (number :tag "Scale" 1.0)))
+
+    (:weight
+     (choice :tag "Weight"
+            :help-echo "Font weight."
+            :value normal              ; default
+            (const :tag "black" ultra-bold)
+            (const :tag "bold" bold)
+            (const :tag "book" semi-light)
+            (const :tag "demibold" semi-bold)
+            (const :tag "extralight" extra-light)
+            (const :tag "extrabold" extra-bold)
+            (const :tag "heavy" extra-bold)
+            (const :tag "light" light)
+            (const :tag "medium" normal)
+            (const :tag "normal" normal)
+            (const :tag "regular" normal)
+            (const :tag "semibold" semi-bold)
+            (const :tag "semilight" semi-light)
+            (const :tag "ultralight" ultra-light)
+            (const :tag "ultrabold" ultra-bold)))
+
+    (:slant
+     (choice :tag "Slant"
+            :help-echo "Font slant."
+            :value normal              ; default
+            (const :tag "italic" italic)
+            (const :tag "oblique" oblique)
+            (const :tag "normal" normal)))
+
+    (:underline
+     (choice :tag "Underline"
+            :help-echo "Control text underlining."
+            (const :tag "Off" nil)
+            (const :tag "On" t)
+            (color :tag "Colored")))
+
+    (:overline
+     (choice :tag "Overline"
+            :help-echo "Control text overlining."
+            (const :tag "Off" nil)
+            (const :tag "On" t)
+            (color :tag "Colored")))
+
+    (:strike-through
+     (choice :tag "Strike-through"
+            :help-echo "Control text strike-through."
+            (const :tag "Off" nil)
+            (const :tag "On" t)
+            (color :tag "Colored")))
+
+    (:box
+     ;; Fixme: this can probably be done better.
+     (choice :tag "Box around text"
+            :help-echo "Control box around text."
+            (const :tag "Off" nil)
+            (list :tag "Box"
+                  :value (:line-width 2 :color "grey75" :style released-button)
+                  (const :format "" :value :line-width)
+                  (integer :tag "Width")
+                  (const :format "" :value :color)
+                  (choice :tag "Color" (const :tag "*" nil) color)
+                  (const :format "" :value :style)
+                  (choice :tag "Style"
+                          (const :tag "Raised" released-button)
+                          (const :tag "Sunken" pressed-button)
+                          (const :tag "None" nil))))
+     ;; filter to make value suitable for customize
+     (lambda (real-value)
+       (and real-value
+           (let ((lwidth
+                  (or (and (consp real-value)
+                           (plist-get real-value :line-width))
+                      (and (integerp real-value) real-value)
+                      1))
+                 (color
+                  (or (and (consp real-value) (plist-get real-value :color))
+                      (and (stringp real-value) real-value)
+                      nil))
+                 (style
+                  (and (consp real-value) (plist-get real-value :style))))
+             (list :line-width lwidth :color color :style style))))
+     ;; filter to make customized-value suitable for storing
+     (lambda (cus-value)
+       (and cus-value
+           (let ((lwidth (plist-get cus-value :line-width))
+                 (color (plist-get cus-value :color))
+                 (style (plist-get cus-value :style)))
+             (cond ((and (null color) (null style))
+                    lwidth)
+                   ((and (null lwidth) (null style))
+                    ;; actually can't happen, because LWIDTH is always an int
+                    color)
+                   (t
+                    ;; Keep as a plist, but remove null entries
+                    (nconc (and lwidth `(:line-width ,lwidth))
+                           (and color  `(:color ,color))
+                           (and style  `(:style ,style)))))))))
+
+    (:inverse-video
+     (choice :tag "Inverse-video"
+            :help-echo "Control whether text should be in inverse-video."
+            (const :tag "Off" nil)
+            (const :tag "On" t)))
+
+    (:foreground
+     (color :tag "Foreground"
+           :help-echo "Set foreground color."))
+
+    (:background
+     (color :tag "Background"
+           :help-echo "Set background color."))
+
+    (:stipple
+     (choice :tag "Stipple"
+            :help-echo "Background bit-mask"
+            (const :tag "None" nil)
+            (file :tag "File"
+                  :help-echo "Name of bitmap file."
+                  :must-match t)))
+
+    (:inherit
+     (repeat :tag "Inherit"
+            :help-echo "List of faces to inherit attributes from."
+            (face :Tag "Face" default))
+     ;; filter to make value suitable for customize
+     (lambda (real-value)
+       (cond ((or (null real-value) (eq real-value 'unspecified))
+             nil)
+            ((symbolp real-value)
+             (list real-value))
+            (t
+             real-value)))
+     ;; filter to make customized-value suitable for storing
+     (lambda (cus-value)
+       (if (and (consp cus-value) (null (cdr cus-value)))
+          (car cus-value)
+        cus-value))))
+
+  "Alist of face attributes.
+
+The elements are of the form (KEY TYPE PRE-FILTER POST-FILTER),
+where KEY is the name of the attribute, TYPE is a widget type for
+editing the attribute, PRE-FILTER is a function to make the attribute's
+value suitable for the customization widget, and POST-FILTER is a
+function to make the customized value suitable for storing.  PRE-FILTER
+and POST-FILTER are optional.
+
+The PRE-FILTER should take a single argument, the attribute value as
+stored, and should return a value for customization (using the
+customization type TYPE).
+
+The POST-FILTER should also take a single argument, the value after
+being customized, and should return a value suitable for setting the
+given face attribute.")
+
+(defun custom-face-attributes-get (face frame)
+  "For FACE on FRAME, return an alternating list describing its attributes.
+The list has the form (KEYWORD VALUE KEYWORD VALUE...).
+Each keyword should be listed in `custom-face-attributes'.
+
+If FRAME is nil, use the global defaults for FACE."
+  (let ((attrs custom-face-attributes)
+       plist)
+    (while attrs
+      (let* ((attribute (car (car attrs)))
+            (value (face-attribute face attribute frame)))
+       (setq attrs (cdr attrs))
+       (unless (or (eq value 'unspecified)
+                   (and (null value) (memq attribute '(:inherit))))
+         (setq plist (cons attribute (cons value plist))))))
+    plist))
+
+;;; Initializing.
+
+;;;###autoload
+(defun custom-set-faces (&rest args)
+  "Initialize faces according to user preferences.
+This associates the settings with the `user' theme.
+The arguments should be a list where each entry has the form:
+
+  (FACE SPEC [NOW [COMMENT]])
+
+SPEC is stored as the saved value for FACE, as well as the value for the
+`user' theme.  The `user' theme is one of the default themes known to Emacs.
+See `custom-known-themes' for more information on the known themes.
+See `custom-theme-set-faces' for more information on the interplay
+between themes and faces.
+See `defface' for the format of SPEC.
+
+If NOW is present and non-nil, FACE is created now, according to SPEC.
+COMMENT is a string comment about FACE."
+  (apply 'custom-theme-set-faces 'user args))
+
+(defun custom-theme-set-faces (theme &rest args)
+  "Initialize faces for theme THEME.
+The arguments should be a list where each entry has the form:
+
+  (FACE SPEC [NOW [COMMENT]])
+
+SPEC is stored as the saved value for FACE, as well as the value for the
+`user' theme.  The `user' theme is one of the default themes known to Emacs.
+See `custom-known-themes' for more information on the known themes.
+See `custom-theme-set-faces' for more information on the interplay
+between themes and faces.
+See `defface' for the format of SPEC.
+
+If NOW is present and non-nil, FACE is created now, according to SPEC.
+COMMENT is a string comment about FACE.
+
+Several properties of THEME and FACE are used in the process:
+
+If THEME property `theme-immediate' is non-nil, this is equivalent of
+providing the NOW argument to all faces in the argument list: FACE is
+created now.  The only difference is FACE property `force-face': if NOW
+is non-nil, FACE property `force-face' is set to the symbol `rogue', else
+if THEME property `theme-immediate' is non-nil, FACE property `force-face'
+is set to the symbol `immediate'.
+
+SPEC itself is saved in FACE property `saved-face' and it is stored in
+FACE's list property `theme-face' \(using `custom-push-theme')."
+  (custom-check-theme theme)
+  (let ((immediate (get theme 'theme-immediate)))
+    (while args
+      (let ((entry (car args)))
+       (if (listp entry)
+           (let ((face (nth 0 entry))
+                 (spec (nth 1 entry))
+                 (now (nth 2 entry))
+                 (comment (nth 3 entry)))
+             (put face 'saved-face spec)
+             (put face 'saved-face-comment comment)
+             (custom-push-theme 'theme-face face theme 'set spec)
+             (when (or now immediate)
+               (put face 'force-face (if now 'rogue 'immediate)))
+             (when (or now immediate (facep face))
+               (unless (facep face)
+                 (make-empty-face face))
+               (put face 'face-comment comment)
+               (face-spec-set face spec))
+           (setq args (cdr args)))
+       ;; Old format, a plist of FACE SPEC pairs.
+       (let ((face (nth 0 args))
+             (spec (nth 1 args)))
+         (put face 'saved-face spec)
+         (custom-push-theme 'theme-face face theme 'set spec))
+       (setq args (cdr (cdr args))))))))
+
+;;;###autoload
+(defun custom-theme-face-value (face theme)
+  "Return spec of FACE in THEME if THEME modifies FACE.
+Value is nil otherwise.  The association between theme and spec for FACE
+is stored in FACE's property `theme-face'.  The appropriate face
+is retrieved using `custom-theme-value'."
+  ;; Returns car because the value is stored inside a one element list
+  (car-safe (custom-theme-value theme (get face 'theme-face))))
+
+(defun custom-theme-reset-internal-face (face to-theme)
+  "Reset FACE to the value defined by TO-THEME.
+If FACE is not defined in TO-THEME, reset FACE to the standard
+value.  See `custom-theme-face-value'.  The standard value is
+stored in SYMBOL's property `face-defface-spec' by `defface'."
+  (let ((spec (custom-theme-face-value face to-theme))
+       was-in-theme)
+    (setq was-in-theme spec)
+    (setq spec (or spec (get face 'face-defface-spec)))
+    (when spec
+      (put face 'save-face was-in-theme)
+      (when (or (get face 'force-face) (facep face))
+             (unless (facep face)
+               (make-empty-face face))
+             (face-spec-set face spec)))
+    spec))
+
+;;;###autoload
+(defun custom-theme-reset-faces (theme &rest args)
+  "Reset the value of the face to values previously defined.
+Associate this setting with THEME.
+
+ARGS is a list of lists of the form
+
+    (FACE TO-THEME)
+
+This means reset FACE to its value in TO-THEME."
+  (custom-check-theme theme)
+  (mapcar '(lambda (arg)
+            (apply 'custom-theme-reset-internal-face arg)
+            (custom-push-theme 'theme-face (car arg) theme 'reset (cadr arg)))
+         args))
+
+;;;###autoload
+(defun custom-reset-faces (&rest args)
+  "Reset the value of the face to values previously saved.
+This is the setting assosiated the `user' theme.
+
+ARGS is defined as for `custom-theme-reset-faces'"
+  (apply 'custom-theme-reset-faces 'user args))
+
+;;; The End.
+
+(provide 'cus-face)
+
+;;; arch-tag: 9a5c4b63-0d27-4c92-a5af-f2c7ed764c2b
+;;; cus-face.el ends here