0.51.1 pre snapshot. Be careful, it may be buggy. It fixes some bugs though.
[wmaker-crm.git] / README.KDE
blob8bfaffdeac62c633c17c54e44ca36c875fee22bd
3 Information on Using Window Maker with KDE
4 ------------------------------------------
7 Window Maker supports almost all KDE/KWM specific client
8 communication protocols, so you can simply replace kwm with 
9 Window Maker, if you think these advantages are worthy:
11                 Window Maker                    KWM
12 =============================================================================
13 Looks           NEXTSTEP(tm)/NEXTSTEP(tm)       Original, but reminds
14                                 enhanced        Windows(tm)
16 Decoration      solid, gradient, multi-color    solid, vertical and
17 Textures        gradient, pixmaps, textured     horizontal gradient,
18                 gradient - all gradients are    pixmap
19                 supported in horizontal,
20                 vertical and diagonal 
21                 directions
23 Configurable    No                              Yes, but not totally
24 Titlebar Buttons
26 Mini CLI        Yes, but limited                Yes
28 Window Specific Yes                             In KDE 1.1, yes.
29 Configuration                                   In KDE 1.0, no.
31 Quick Keyboard  Yes                             In KDE 1.1, yes
32 Navigation                                      In KDE 1.0, no.
34 Pager           KDE pagers will work as         Yes
35                 well as GNOME pagers
37 Session         Not yet supported, but          Yes, old (pre-X11R6) style
38 Management      X11R6 style SM is being worked.
40 Dock            kpanel, GNOME panel and Dock    kpanel
42 GNOME support   Yes                             No
44 Memory Usage(1) 1.85Mb  Lite: 1.79Mb            In KDE 1.0, 3.13Mb
45                                                 In KDE 1.1, probably more
48 (1) Memory usage was tested by running wmaker and kwm at the same machine
49 with the same windows, on the same screen and similar window texture
50 configurations (at different times, of course). I looked in the output of
51 ps -m, in the SIZE field, right after starting the window managers. The Lite
52 value for wmaker, is for when it was compiled with --enable-lite.
55 Enabling KDE Support
56 --------------------
58 To enable KDE support in Window Maker, you must compile it after
59 configuring it as follows:
60 ./configure --enable-kde --enable-lite
62 The --enable-lite flag is *optional*, but will reduce some memory
63 usage by removing things that are duplicated in Window Maker and KDE.
64 Do not enable it if you don't care about a few dozen kbytes of memory
65 savings (see table above). It won't make KDE or Window Maker any 
66 slower/faster.
68 Then, open WPrefs and turn on the "Disable mouse actions"
69 option in the Mouse related options panel. Or enable the 
70 DisableWSMouseActions option by hand.
72 Then, just replace kwm with wmaker in your startkde script.
73 If you are going to use Window Makers sound server, comment out
74 kwmsound in startkde.  Also if wmaker sets your root window
75 background, comment out kbgndwm, kde's wallpaper setter.
77 Make sure to disable workspace background setting in KDE. If you
78 wont be using Window Maker themes anyway, you can set
79 WorkspaceBack = (none);
81 in ~/GNUstep/Defaults/WindowMaker
84 Enhancing Integration
85 ---------------------
87 Window Maker adds some extensions to KDE's messaging stuff, so you can run
88 Window Maker specific commands from places like kpanel, krootwm or even
89 kwmcom. Recently KDE developers have kindly added support for these extensions
90 in the more recent KDE versions from CVS. The added stuff are the following 
91 kwm like commands:
93 wm:wmaker - select Window Maker support mode
94 wmaker:info - show info panel
95 wmaker:legal - show legal panel
96 wmaker:arrangeIcons - arrange icons
97 wmaker:showAll - show all windows
98 wmaker:hideOthers - hide others
99 wmaker:restart - restart wmaker
100 wmaker:exit - exit wmaker
102 You can test them with kwmcom, like:
103 kwmcom wmaker:info
106 Problems
107 --------
109 * kpanel will not be kept always on top. That's because kpanel is an
110 OverrideRedirect window, so Window Maker can't do anything about that.
112 Before requesting for a hack to work around that in Window Maker, please
113 request the kpanel author to fix it.
115 * because the KDE protocol for letting the window manager know the usable
116 window region is broken, you might find some problems with the window
117 positioning/maximization code and kpanel's position.
119 * It seems kpanel (and maybe KDE in general) doesn't like dynamically
120 changing the number of workspaces. So, don't create or destroy workspaces
121 while running on KDE, unless you really need.
123 * If kpanel, kwmpager or kpager becomes confused about the number of
124 windows present, restart them.
126 * Wmaker opens windows by default under/over the panel, when the panel is
127 at top or left of screen.  Use the GUI configuration tool WPrefs to change
128 this.
130 * Some commands, such as cascade windows and rearrange windows are not
131 yet implemented.