wmclockmon: update change-log
[dockapps.git] / wmthemech / README
blob754ea515b57cc7f47d33b4335a3780b664efdca4
1 wmThemeCh is a WindowMaker theme (and background) changer dockapp.
3 Left-click  selects another theme/background.
4 Right-click selects another category.
6 Themes are collected from the standard WindowMaker themes and background
7 directories.
9 You can define categories in ~/.wmThemeCh/categories ,
10 each line defining a category name.
11 The icon corresponding to that category will be ~/.wmThemeCh/<name>.xpm
12 Icons are 56 x 56 pixels.
14 A theme belongs to a category if either :
15 1) a valid "wmThemeCh.cat.db" file lies in theme's directory
16    (for .themed format only), and a line of that file is category's name.
17    Note that ".wmThemeCh.cat.db" also is supported.
18 2) a valid ".wmThemeCh.cat.db" file lies in a parent directory
19    and a line of that file is category's name.
21 Example
22 -------
24 File /usr/local/share/wmthemech/categories :
26 People
28 /usr/local/share/wmthemech/People.xpm
30 File ~/.wmThemeCh/categories :
32 Anime
33 Cartoons
35 ~/.wmThemeCh/Anime.xpm
36 ~/.wmThemeCh/People.xpm
38 ~/GNUstep/Library/WindowMaker/Themes/.wmThemeCh.cat.db :
40 # wmThemeCh categories database file version 1.0
41 Anime
42 Misc
44 ~/GNUstep/Library/WindowMaker/Themes/MyTheme.themed/wmThemeCh.cat.db :
46 # wmThemeCh categories database file version 1.0
47 People
48 Art
50 MyTheme belongs to Anime and People categories.
51 It would also belong to Art and Misc if those were defined.
52 People category icon would be the one in ~/.wmThemeCh , overriding
53 the default one.