Add doc/website: our website source code.
[emacs-color-theme.git] / BUGS
blobe464a7cecc998be31b488ad70b05afb8d8ae64e7
1 This is the list of common problems.
3 Emacs 20.7: Some faces are created using copy-face; these faces are
4 not printed correctly using M-x color-theme-print.  They will have
5 (nil) in their spec.  M-x customize-face has the same problem.
7 Example:
9 (copy-face 'bold 'new-bold)
10 (color-theme-spec 'bold)
11   => (bold ((t (:bold t))))
12 (color-theme-spec 'new-bold)
13   => (new-bold ((t (nil))))
15 XEmacs 21.1: Some faces are defined using a certain font instead of
16 of the correct attribute.  They will have (nil) in their spec.
17 M-x customize-face has the same problem.
19 Example:
21 (color-theme-spec 'bold)
22   => (bold ((t (nil))))
24 XEmacs 21.2 and up, Emacs 21: Not compatible with the custom-theme
25 mode.  It should be easy to transform the color-theme source into
26 custom-theme source, however.
28 If you are running XEmacs, then only foreground and background color
29 of the default face and only the background color of the text-cursor
30 face will used.  This is due to the fact that these three pieces of
31 information are stored as frame parameters in Emacs.
33 If you are running XEmacs, variables cannot have a frame-local
34 binding.  Therefore, if color-theme-is-global is set to nil, the
35 variable settings in a color theme are ignored.
37 Using Emacs and a non-nil value for color-theme-is-global will
38 install a new color theme for all frames.  Using XEmacs and a non-nil
39 value for color-theme-is-global will install a new color theme only
40 on those frames that are not using a local color theme.
42 If your system does not define the color names used, you will get the
43 error "undefined color".  See the output of `list-colors-display' for
44 a list of colors defined on your display.
46 The :box, :height, and other new attributes will be honored in Emacs
47 21, but when you print such a color-theme on Emacs 20 or XEmacs 21,
48 the information will get lost.  So don't do that.  Furthermore,
49 customizing these faces may end up showing you a lisp expression
50 instead of the real widgets on Emacs 20 or XEmacs 21 because these
51 attributes are not understood.
53 :inverse-video handling differs in Emacs and XEmacs.  We therefore do
54 away with it.  When printing a color-theme, the inverse-video
55 attribute should be handled correctly without ever appearing in color
56 themes.  For maintenance, the following might be usefull for
57 query-replace-regexp.
58 :background "\([^"]*\)"\(.*\):foreground "\([^"]*\)"\(.*\) :inverse-video t
59 :background "\3"\2:foreground "\1"\4
61 In XEmacs 21.1, some of the face tests don't work.  Example:
62 (custom-face-bold 'bold) returns nil on my system.  A bug report was
63 submitted.
65 Emacs 20 users will loose with new color themes, because these will
66 set the colors of the default face only, leaving frame background
67 untouched.  In Emacs 20, the colors of the default face and of the
68 frame could be changed independently.  In Emacs 21, this is no longer
69 true.  New color themes will not be made backwards compatible.
71 This release was superficially tested with Emacs 21.x/22.x and XEmacs 21.4.