*** empty log message ***
[wmaker-crm.git] / FAQ
blob03963b560404954977ded2aac6edbdfd330a82a2
2 WindowMaker FAQ
3 ====================================================================
4 Last modified: Tue Apr 20 20:15:17 EST 1999
6 the latest info can be found at
7 http://www.dpo.uab.edu/~grapeape/wmfaq.html or
8 http://wm.current.nu/wmfaq/
9 --------------------------
11 Summary of Contents:
13 1 - Introduction 
14      1.1 What is Window Maker? 
15      1.2 Where can I get Window Maker? 
16      1.3 Where are the mailing list archives? 
17      1.4 Where is more documentation on configuring Window Maker? 
18      1.5 What is an App Icon? 
19      1.6 How can I get a question added to the FAQ? 
20      1.7 How do I report bugs? 
21      1.8 Is there an anomymous cvs server? 
23 2 - Installation 
24      2.1 Where can I get proplist.h? 
25      2.2 Why do no icons show up after installing Window Maker 0.15.0
26          when I've followed all the directions? 
27      2.3 How do I get libtiff to work? 
28      2.4 How do I get libjpeg to work? 
29      2.5 How do I get libpng to work? 
30      2.6 How do I get libgif (or libungif) to work? 
31      2.7 Does wmsound work with 0.1x.x? 
32      2.8 Can I use WindowMaker with KDE or GNOME or CDE? 
33      2.9 How do I get Window Maker working with xdm in Redhat 5.[01]? 
34      2.10 Do I need to rerun wmaker.inst with every new version of
35           Window Maker? 
36      2.11 When I install Window Maker, I've used wmaker.inst correctly
37           and I only get aroot menu with xterm and exit. How do I fix this? 
38      2.12 How do I get Window Maker to use more than 16 colors on my
39           SGI Indy Workstation? 
40      2.13 Using WindowMaker with Solaris 2.6 CDE 
41      2.14 How do I switch CDE's windowmanager to use Window Maker?
42      2.15 When I run wmaker it quits complaing about something
43           "__register_frame_info".
44      2.16 When I run wmaker it complains about something like library is
45           62, caller expects 61
47 3 - Usage 
48      3.1 How do I get new apps on the dock (The line of pixmaps on the
49          right side of the screen by default) 
50      3.2 What is the difference between the Exit and Exit Session Option?
51      3.3 How do I "dock" AppIcons on the Clip? 
52      3.4 Why do none of my Key Bindings work in Window Maker 0.1x.x 
53      3.5 How do I rename workspaces? 
54      3.6 How can I resize a window if the window is larger than my currect
55          desktop? 
56      3.7 How do I "undock" AppIcons? 
57      3.8 I docked an application but when I run it the button is permanently
58          shaded and I can't run new instances.
59      3.9 When I run wmaker it complains about not being able to load any
60          fonts.
61      3.10 When I set the root background with wmsetbg by hand it works,
62          but when I do that from the configuration files it doesnt!
64 4 - Configuration 
65      4.1 What are those files inside my ~/GNUstep directory? 
66      4.2 How do I enable the normal X sloppy focus mode? 
67      4.3 How do I get my auto-arrange icons to work? 
68      4.4 How do I get my Meta-Tab to cycle through windows correctly? 
69      4.5 How can I define my own Icon for a program? (instead of the Icon
70          the Application Supplies?) 
71      4.6 How do I get a pixmap background for my appicons (those things
72          in the dock)? 
73      4.7 How do you dock <insert program here> that doesn't have an
74          appicon in the new version of Window Maker? 
75      4.8 How do I get x11amp to not have a title bar? (or any other
76          program for that matter?) 
77      4.9 How do I set a pixmap background? 
78      4.10 Can I put pixmaps in my root menu and title bars? 
79      4.11 How do I get my Minimize Icon to look like the triangle I see in
80           screenshots? 
81      4.12 How do I get superfluous bells and whistles working? 
82      4.13 How do I get my oldstyle back? 
83      4.14 How do I get the window menu with only a two button mouse? 
84      4.15 How do I edit my root menu? 
85      4.16 How can I set dock/clip to use single click to launch applications,
86           instead of double click?
88 5 - Other Applications 
89      5.1 How do I assign gimp an appicon? 
90      5.2 How do I get an appicon for XEmacs 20.3+? 
91      5.3 Where do you get that clock program I always see on people's
92          desktops? 
93      5.4 How do you dock asclock? 
94      5.5 How do you dock wmload? 
95      5.6 What other apps exist for the dock? 
96      5.7 How do I get an appicon for rxvt so I can dock it? 
97      5.8 How do I get different icons for rxvt's (or xterms) running different
98          programs?
99      5.9 How do I launch multiple instances of XTerm from one appicon? 
100      5.10 How do I allow Alt+# to work in an rxvt session? (with irc for
101           example) 
102      5.11 Window Maker breaks scilab
103      5.12 Netscape icons show up in black and white
104      5.13 Snow flakes from xsnow don't acumulate on titlebars!
105      5.14 I'm using RedHat 6.0 and Netscape dies without reason.
107 6 - Programming 
108      6.1 How do I get a normal X application to produce an appicon? 
109      6.2 How do I get my tcl/tk application to produce an appicon? 
110      6.3 What is WINGs? 
111      6.4 Where can I get more information about WINGs?
113 7 - Miscellaneous Questions 
114      7.1 Is there a pager for Window Maker? 
115      7.2 Can I have folders like in AfterStep? 
116      7.3 How do I use getstyle and setstyle? 
117      7.4 Why don't you distribute {normal diff, xdelta} patches?
118      7.5 Will you add GNOME support?
120 8 - Themes 
121      8.1 What exactly are Themes? 
122      8.2 How do I install a Theme? 
123      8.3 How do I make a Theme? 
126 ========================================================================
130 -=-=-=-=-=-=-
131 Introduction:
132 -=-=-=-=-=-=-
134 1.1 What is Window Maker? 
135 ----------------------------------
136 Window Maker is an elegant X11 window manger that emulates the
137 OpenStep desktop with some noticeable enhancements. Look at
138 http://wm.current.nu/themes/my-themes.html and
139 http://wm.current.nu/themes/screenshots.html
140 here for example screenshots. 
143 1.2 Where can I get Window Maker? 
144 ----------------------------------
145 The official site to get new developmental versions from is
146 ftp://ftp.windowmaker.org/pub/beta/srcs/. 
148 NOTE: Also see http://wm.current.nu/downloads.html for the latest 
149 Stable and Development versions. 
151 The development versions are usually very stable themselves, so if you
152 want to have all the newest features, you can rather safetly go with the
153 development versions. Just remember to save any unsaved data before
154 you go playing around with the config files. Also, remember they are
155 developmental versions, so your mileage may vary, don't get angry if they
156 crash. 
159 1.3 Where are the mailing list archives? 
160 ----------------------------------------
161 Phillip Smith from Netplex, our wonderful provider of windowmaker.org, has set
162 up some new lists from the domain.  Please read the information on the web
163 pages at http://www.windowmaker.org/lists.html for information on how to
164 subscribe, the posting guidelines, and how to access the web archives.
166 Many thanks to Ed Orcutt who hosted the original lists from his own machine
167 for many years and Caldera who graciously allowed Ed to continue hosting
168 from them when he moved to his new position with them.  Ed provided a very
169 valuable service for many years and we are sad to see him go.
172 1.4 Where is more documentation on configuring Window Maker? 
173 ----------------------------------
174 Besides the mailing list archives, there are nice documents in
175 ftp://ftp.windowmaker.org/pub/docs/, at
176 http://wm.current.nu/downloads.html on my download page and at 
177 http://wm.current.nu/user-guide/index.htm in the online user-guide. 
180 1.5 What is an appicon? 
181 ----------------------------------
182 An appicon is the icon (without the tiny titlebar a minimized application icon
183 has) produced by most applications that initially is in the bottom left corner
184 of the screen while an application is running. For an example, run xterm and
185 notice the icon in the corner. (Make sure that you use xterm and not a
186 default older rxvt because older versions of rxvt do not properly set their
187 window attributes.) 
190 1.6. How can I get a question added to the FAQ? 
191 ----------------------------------
192 Right now, the only method is to mail Chris Green <sprout@dok.org> or
193 myself <largo@current.nu> the question or post it on the Window Maker
194 Mailing list, and see if enough people have the same problem. 
196 If you are a developer and would like to be able to edit the official FAQ on
197 Chris's site, let him know at <sprout@dok.org>
199 He is currently pondering writing a front end that allows everyone to add
200 entries and only require a moderator approval before being posted. 
203 1.7. How do I report bugs? 
204 ----------------------------------
205 You can look at the BUGFORM file in your tarball of Window Maker.
206 Alternatively, you can use the Window Maker Bugtracker at
207 http://windowmaker.org/cgi-bin/bugs. 
210 1.8. Is there an anomymous cvs server? 
211 ----------------------------------
212 Yes there is. To check out from cvs, first 
214             export CVSROOT=":pserver:anoncvs@cvs.net-community.com:/gnustep"
215             cvs login
216           
217 'anoncvs' is the password. 
219 Then issue the command. "wm" is the name of the module. 
221             cvs -z3 checkout -d WindowMaker wm
222           
224 To update your source tree, cd to the WindowMaker directory and type 
226             cvs -z3 update 
227           
228 inside the WindowMaker directory. 
233 -=-=-=-=-=-=-
234 Installation:
235 -=-=-=-=-=-=-
237 2.1 Where can I get proplist.h? 
238 -------------------------------
239 You didn't read the INSTALL file, did you?  Please read that now.
240 libPropList is downloaded seperately and you need to install it _before_
241 attempting to configure Window Maker.
243 You can find a gzipped tar archive of libPropList at
244 ftp://ftp.windowmaker.org/pub/libs/
247 2.2 Why do no icons show up after installing Window Maker >= 0.15.x 
248     when I've followed all the directions? 
249 -------------------------------------------------------------------
250 Under normal circumstances, this should not happen because Window Maker
251 should detect if libtiff is going to be compiled in and then it will make the
252 default theme use .tiff or .xpm icons, depending if TIFF support is compiled
253 in or not.
255 As of Window Maker version 0.15.0, the default setup includes .tiff icons
256 which require you to have compiled Window Maker with libtiff support, if you
257 want them to be used. If you are happy with the .xpm icons, then you don't
258 need libtiff. Window Maker will detect that TIFF support is not available and
259 use .xpm icons instead. For some help on compiling with libtiff, look at the
260 libtiff section of this FAQ. 
263 2.3 How do I get libtiff to work? 
264 ----------------------------------
265 The whole key to getting libtiff working for me was to upgrade to >=
266 tiff-v3.4beta037-tar.gz availible at ftp.sgi.com. 
268 Rerun ./configure and make and it should work. I had previously been using
269 tiff-v3.4-tar.gz instead so the library was there just not working. A note to
270 keep in mind, is that the tiff libs are versioned rather oddly, version
271 tiff-v3.4beta037 is actually newer than tiff-v3.4. 
273 Make sure to rm config.cache and rerun ./configure before attempting to
274 compile again. 
276 Also, make sure to use gnu-make for the Window Maker compile. 
279 2.4 How do I get libjpeg to work? 
280 ----------------------------------
281 The newest jpeg libs are availible at ftp://ftp.uu.net/graphics/jpeg/. 
283 How many of you have seen that darned "lib reports 62 caller expects 61" type of
284 error?
285 Well, I have more than once, and here are some answers to possibly help
286 you out. 
288 First things first. As always, make sure there are not older copies of libjpeg
289 floating around on your system. By default my Slackware distribution came
290 with an old libjpeg.so.1 in the /usr/X11R6/lib/ directory. This can simply be
291 deleted. Or if something complains after you delete it, recompile it if you
292 can to look for the new lib in the right place, or if that fails, as a last resort,
293 you might add a symlink to the new lib like so:
294 ln -s /usr/local/lib/libjpeg.so.6.0.2 libjpeg.so.1 
296 Now on to the error.
297 This is basically caused by your application having been compiled to
298 dynamically use the libjpeg.so shared library. When you install a new lib and
299 then try to run your program again, it expects the lib it was compiled
300 against, in this case the older libjpeg.so.6.0.1 and instead finds libjpeg.so.6.0.2
301 and reports the error. 
303 The fix is actually rather simple. Along with adding a libjpeg.so.6 symlink
304 like so (just in case):
305 ln -s libjpeg.so.6.0.2 libjpeg.so.6
306 where you installed your new lib, you simply need to recompile your app to
307 link it against the new library. :) 
309 Make sure to rm config.cache and rerun ./configure before attempting to
310 compile again. 
312 Also, make sure to use gnu-make for the Window Maker compile. 
315 2.5 How do I get libpng to work? 
316 ----------------------------------
317 The newest png libs are availible at
318 http://www.cdrom.com/pub/png/pngcode.html. 
320 You should also get the newest zlib libs from
321 http://www.cdrom.com/pub/infozip/zlib/. 
323 I had a few problems with this lib as well, basically I had an old libz.so in my
324 /usr/X11R6/lib/ directory which configure was finding first, and which failed the
325 test, being an older lib. 
327 Generally the same applies here as with libjpeg, make sure there are no
328 older versions of the necessary libs floating around on your system, then try
329 and configure and make again. 
331 Make sure to rm config.cache and rerun ./configure before attempting to
332 compile again. 
334 Also, make sure to use gnu-make for the Window Maker compile. 
337 2.6 How do I get libgif (or libungif) to work? 
338 ----------------------------------
339 The newest libgif is availible at
340 ftp://sunsite.unc.edu/pub/Linux/libs/giflib/. 
342 The newest libungif is availible at
343 ftp://sunsite.unc.edu/pub/Linux/libs/graphics/. 
345 I had a few problems with libgif... it seems that the install process didn't
346 install the header file libgif.h, so although the Window Maker configure found
347 the lib (libgif.so.x), when you actually try to compile, it fails when it looks for
348 the header to include the make. I simply copied it from the libgif source
349 directory to the system include directory. (/usr/local/include/ on my system). 
351 Make sure to rm config.cache and rerun ./configure before attempting to
352 compile again. 
354 Also, make sure to use gnu-make for the Window Maker compile. 
357 2.7 Does wmsound work with 0.1x.x? 
358 ----------------------------------
359 As of Window Maker 0.15.x, sound is now included by default but requires
360 the authors sound server. For more information, read the NEWS file in the
361 Window Maker distribution. 
363 The author Anthony Quinn <southgat@frontiernet.net> has released a 
364 version that works with Window Maker >= 0.15.x. It is available from 
365 it's home page at http://www.frontiernet.net/~southgat/wmsound/ 
366 or on Largo's site at http://wm.current.nu/files.html#wmsound 
367 for your convenience. 
370 2.8 Can I use WindowMaker with KDE or GNOME or CDE? 
371 ----------------------------------
372 Contrary to a lot of people thinks, KDE is NOT a window manager. KDE is
373 a suite of various applications that includes a custom window manager (kwm).
374 The same is true for CDE. 
376 Now, answering the question: Yes, you can use WindowMaker in these
377 environments. To use Window Maker with GNOME, you don't need to do
378 anything special. To use it with CDE, read the answer for "How do I switch
379 CDE's windowmanager to use Window Maker?" 
381 To use it with KDE, read it's documentation to get rid of kwm (and possibly
382 kpanel) and replace it with wmaker. Then, start WPrefs.app, go to "Mouse
383 Preferences" and set the "Disable mouse actions" check box. You will
384 need to restart Window Maker to make this change take effect. The
385 "Disable mouse actions" change is needed to allow you to use krootwm,
386 wich enables you to use kfm's desktop icons, but will prevent you from
387 accessing Window Maker's Applications and Window List menus with the
388 mouse. 
391 2.9 How do I get Window Maker working with xdm in Redhat 5.[01]? 
392 ----------------------------------
393 After running wmaker.inst and letting it write to .xinitrc,
394 cp .xinitrc .xsession
395 and make sure that /usr/local/bin is in your $PATH for the Xserver. You can
396 make sure of this by including a statement like 
398             export PATH=$PATH:/usr/local/bin 
399           
401 in your .xsession file. 
403 Make sure to chmod +x .xsession so that the Xsession script of xdm can
404 execute it. 
406 This is how the Xsession script is designed: 
408             startup=$HOME/.xsession
410             if [ -x "$startup" ]; then
411                     exec "$startup"
412             elif [ -x "$HOME/.Xclients" ]; then
413                     exec "$HOME/.Xclients"
414             elif [ -x /etc/X11/xinit/Xclients ]; then
415                     exec /etc/X11/xinit/Xclients
416             else
417                     if [ -f "$resources" ]; then
418                             xrdb -load "$resources"
419                     fi
420                     exec xsm
421             fi
422           
424 You could also have a .Xclients file as was mentioned in previous revisions
425 of this question. 
428 2.10 Do I need to rerun wmaker.inst with every new version of
429      Window Maker? 
430 ----------------------------------
431 There is no need to do this. You can do it, but keep in mind, that all your
432 preferences will be lost, overwritten by the defaults. You can update the
433 files and add the changes yourself if you need to, but else in most cases is
434 sufficient to rely on WPrefs and it will update for you the new missing
435 options if they differ from the default ones.
437 The way domain files are read beginning from 0.15.0 makes the need for update
438 almost redundant. The user config files are merged with the global ones in
439 /usr/local/share/WindowMaker/Defaults.
440 So even if new options are added, they will be reflected in the user
441 configuration. 
442 Only if user wishes to change the default behavior, he needs to add that
443 option to the config file.
445 If there ever happens to be a need for all users to rerun wmaker.inst in a
446 future version, this will be noted in the NEWS file.
449 2.11 When I install Window Maker, I've used wmaker.inst correctly
450      and I only get aroot menu with xterm and exit. How do I fix this? 
451 ----------------------------------
452 Most likely, the problem is that Window Maker can not find a copy of the C
453 pre processor in a directory such as /lib. The file /lib/cpp should be a
454 symbolic link to whatever c compiler's cpp you are using. Mine reads as: 
456             cpp -> ../usr/lib/gcc-lib/i586-pc-linux-gnu/pgcc-2.90.29/cpp*
457           
459 There seems to be another common problem that exhibits this same
460 behavior. If you find another solution that matches this question please
461 email <sprout@dok.org> or <largo@current.nu>. 
464 2.12 How do I get Window Maker to use more than 16 colors on my
465      SGI Indy Workstation? 
466 ----------------------------------
467 Thanks to Peter H. Chou <pchou@leland.Stanford.EDU> for this answer: 
469 By default, the SGI X Server uses 8-bit Pseudocolor mode.
470 To change it, edit (as root) the file /usr/lib/X11/xdm/Xservers.
471 Change it to read: 
473             :0 secure /usr/bin/X11/X -bs -c -class TrueColor -depth 24
474           
479 2.13 Using WindowMaker with Solaris 2.6 CDE 
480 ----------------------------------
481 (thanks to Rob Funk, Unix God of osu.edu) 
483 Assuming you installed Window Maker according to the README's that
484 come with the source, all you need to run Window Maker on a Solaris box
485 is an entry in the .xinitrc. Only 0.17 - 0.19 versions have been tested, but
486 when you run the configure script, let it make changes to the .xinitrc file. It
487 should look something like this: 
489             #!/bin/sh
490             # Window Maker Default .xinitrc
491             exec /usr/local/bin/wmaker
492           
494 Believe it or not, that's all that it takes. This, in fact, runs WindowMaker
495 instead of OpenWindows. In order to choose WindowMaker, you simply
496 choose "OpenWindows Desktop" in the "Options - Session" Menus.
497 Choose "CDE Desktop" if you want CDE. 
499 The Color schemes and settings for Window Maker are seperate from
500 CDE. Tested on a SPARC 10, Solaris x86 should work also. (better,
501 hopefully) 
504 2.14 How do I switch CDE's window-manager to use Window Maker? 
505 ----------------------------------
506 Method 1: 
508 Peter Ilberg <peter.ilberg@natinst.com> gives us this answer: 
510 Install WM wherever you want it, mine is in /opt/WindowMaker-0.16.0
511 (eg. use ./configure --prefix=/opt/WindowMaker-0.16.0).
512 Run the install script wmaker.inst in your home directory. 
514 Add the following two lines to .dtprofile in your home directory: 
516 SESSIONTYPE=xdm; export SESSIONTYPE
517 PATH=:/usr/contrib/bin/X11:$PATH:.; export PATH 
519 This tells CDE to go looking for an .xinitrc/.xsession instead of using the
520 default environment. 
522 Make your .xsession/.xinitrc executable (VERY IMPORTANT, wmaker.inst did
523 NOT do this automatically for me) using eg. 
525 chmod ugo+x .xsession 
527 Your .xsession/.xinitrc should look something like this: 
529 #!/bin/sh
530 <some other init stuff that you want/need>
531 exec wmaker 
533 Things to try if it doesn't work: (somewhat fuzzy and random) 
535 This should do it although I did have problems sometimes initially which I
536 fixed by randomly trying absolute pathes for wmaker in .xsession/.xinitrc and/or
537 making the dtprofile/.xinitrc/etc executable. It helps logging in on the console
538 (select from CDE login screen) and start X manually using 'X'.
539 If it works that way it should work when logging into the CDE environment.
540 Remember to Check your paths! 
542 If it doesn't work, you can also substitute some other window manager for
543 wmaker in the .xinitrc and see if that works. If it does you know at least that
544 .xinitrc is getting called/executed, so your WM path is wrong or not set. 
547 Method 2: 
549 Thomas Hanselman gave this alternative answer (via Peter Ilberg): 
551 Build and install WM wherever you want, as described in Method 1. You
552 can install and run WM just fine from your home directory. That's what I'm
553 doing, since I don't have root access at work :(. Then, in your .Xdefaults file in
554 your home directory, add the following line: 
556 Dtsession*wmStartupCommand: <path to Window Maker executable> 
558 Then, log out, and log back in, and, unless I've forgotten a step (or this is a
559 custom Nortel thing), you should be in Window Maker heaven ;). 
561 Difference between the methods: (according to Thomas) 
563 I've been told that the difference between setting the resource and Peter's
564 method is that if you override the window manager with the resouce, you
565 still get the CDE resources read into the resource database (so you still
566 have your color settings & such from CDE), whereas with Peter's, the CDE
567 resource don't get read into the database. I don't know if this is true or not,
568 however. Also, another thing to note with Window Maker and HP-UX 10.20
569 -- if you select "Exit Session" from the WM root menu, Window Maker and
570 all of your applications are killed, but you may not be logged out. Again, this
571 might be an artifact from my work environment, or the way I start Window
572 Maker. 
574 Owen Stenseth <iplenergy.com> adds: 
576 When using this method it is possible to exit Window Maker cleanly by
577 using the dtaction command. I use the following in my Window Maker menu: 
579 "Exit Session"      EXEC dtaction ExitSession 
581 The only problem I have at the moment is I seem to get multiple copies of
582 asclock running when I log in again. 
584 You can also use the normal "Exit Session" command from the WM root
585 menu and place additional commands required to shutdown CDE in
586 ~/GNUstep/Library/WindowMaker/exitscript 
588 So, if you add "dtaction ExitSession" in that file, the command to shutdown
589 CDE will be automatically executed when you exit WindowMaker. 
592 2.15 When I run wmaker it quits complaing about something
593      __register_frame_info. 
594 ----------------------------------
595 This is due to using gcc >= 2.8.0 or egcs to compile Window Maker or a
596 library it uses, then running these precompiled binaries on a system using
597 libraries compiled with gcc 2.7.2.x
599 You will have to compile Window Maker yourself on this system.  Please read
600 the INSTALL file for the instructions on how to do so.
603 2.16 When I run wmaker it complains about something like expected
604      libjpeg 61 got 62.
605 ----------------------------------
606 Upgrade your libjpeg library and/or recompile Window Maker.
609 2.17 How do I fix an error such as "libwraster.so.1: cannot open shared
610          object file" ?
611 ----------------------------------
612 Like most software using GNU autoconf, Window Maker by default will install
613 under the /usr/local prefix.  This has the repercussion on many systems that
614 the libraries that are part of Window Maker will be installed in
615 /usr/local/lib, which is usually not in the default system LD_LIBRARY_PATH.
616 This is why the library cannot be found.
618 Under Linux, you will need to list this directory in /etc/ld.so.conf and
619 run /sbin/ldconfig.  Both these operations will need to be performed as the
620 superuser.
622 Under BSD, as the superuser you will need to run
624     ldconfig -m /usr/local/lib
626 which will merge this directory into the system library path.
628 If the problem persists, you may be able to use "ldd" to track down why the
629 library cannot be loaded (it will print a list of dynamic objects used by
630 the executable or library listed on the command line, and where it is
631 expecting to find it).
634 -=-=-=-
635 Usage:
636 -=-=-=-
638 3.1 How do I get new apps on the dock (The icon or line of icons on
639     the right side of the screen by default) 
640 ----------------------------------
641 Launch an application. If there is a little icon that pops up in the bottom
642 corner of the screen, drag it over to the dock icon(s). You should see a
643 whiteish square indicating when it is close enough to dock, and where it will
644 be placed. To make sure this application will be there next time you start up
645 windowmaker, exit windowmaker with the "exit session" option. 
648 3.2 What is the difference between the 'Exit' and 'Exit Session' Options? 
649 ----------------------------------
650 'Exit' exits wmaker, but leaves the other apps running, and if wmaker was
651 not the last app launched in the .xinitrc the X server is not closed, until
652 the last app started by .xinitrc is closed.
653 'Exit session' will exit wmaker, but also will close all running apps, thus
654 the X server will be closed, and your session will end.
657 3.3 How do I "dock" AppIcons on the Clip? 
658 -----------------------------------------
659 Just drag icons near it like you would for the dock.  Note that if you place
660 the clip near the dock, you may have problems docking appicons in either.
661 Move the clip away first.
664 3.4 Why do none of my Key Bindings (ie: Alt+#) work in Window Maker 0.1x.x 
665 ----------------------------------
666 If you are using XFree86, make sure scroll lock and numlock are off or no
667 bindings will work (XFree bug). You can try using the XFree86 Numlock
668 Hack by editing the line #undef NUMLOCK_HACK in $WindowMakerdir/src/wconfig.h
669 and changing it to #define NUMLOCK_HACK. 
670 As of 0.18.0, this hack functions properly.
673 3.5 How do I rename workspaces? 
674 ----------------------------------
675 Right click on the "desktop" (root window) to show the menu (don't hold the
676 button down). Go to the workspaces menu and hold the Control key down
677 and click on the workspace you would like to rename and type the name. 
679 If you use the clip, use the "Rename Workspace" command in the clip
680 menu. 
683 3.6 How can I resize a window if the window is larger than my
684     currect desktop? 
685 ----------------------------------
686 David Reviejo <dreviejo@arrakis.es> best summed up this answer: 
688      "Maybe you know:
689      Alt+Left click and drag
690      to move the window. 
692      Try this:
693      Alt+Right click and drag
694      to resize (by moving the nearest window corner) 
696      Another move/resize tip: while you are moving or resizing a window,
697      you
698      can change the move/resize mode by pressing the SHIFT key." 
703 3.7 How do I "undock" AppIcons? 
704 ----------------------------------
705 If the program is not running, just drag the icon to the middle of your
706 desktop (away from the dock and clip) and watch it disappear. 
708 If the program is running, hold down Meta (usually CTRL) and drag the icon
709 off the dock. You can also right click on it and choose 'Kill', then undock as
710 usual. 
713 3.8 I docked an application but when I run it the button is permanently
714     shaded and I can't run new instances.
715 ----------------------------------
716 You probably docked the application with dockit. To fix it
717 remove the icon and use the "Emulate Application Icon" checkbox in
718 the Advanced Options section of the Attributes panel for the window.
719 Then restart the application to get the application icon you
720 must use to dock the application. 
721 It can also mean that you did something you shouldn't, which is
722 changing the program that is ran from the docked icon. For example,
723 if you docked rxvt you must NOT change it to xterm, for example.
724 You also can't do any changes that might alter the contents of
725 the WM_CLASS hint for the window, like the -name parameter for
726 xterm, rxvt and other programs.
730 3.9 When I run wmaker it complains about not being able to load any fonts.
731 ----------------------------------
732 Check if the locale settings are correct. If you're not sure what to
733 do, unset the LANG environment variable before running wmaker.
735 TODO: give complete explanation
739 3.10 When I set the root background with wmsetbg by hand it works,
740      but when I do that from the configuration files it doesnt!
741 ----------------------------------
743 DOH! If you set the root background with wmsetbg by hand, it will obviously
744 find the image, since you have explicitly specified it by hand. But if you
745 simply put it in ~/GNUstep/Defaults/WindowMaker in some option like
746 WorkspaceBack, it will not find the image because Window Maker can't read
747 your mind to figure where you put the image. So, to fix it, you have to
748 either place the full path for the image in the texture specification or put
749 the path for the directory you put your background images in the PixmapPath
750 option. You can also put all your background images in places like
751 ~/GNUstep/Library/WindowMaker/Backgrounds or
752 /usr/local/share/WindowMaker/Backgrounds
753 These directories will be listed under the "Search Path" section of WPrefs.
757 -=-=-=-=-=-=-=-
758 Configuration:
759 -=-=-=-=-=-=-=-
761 4.1 What are those files inside my ~/GNUstep directory? 
762 ----------------------------------
763 ~/GNUstep/WindowMaker/WindowMaker 
765      The main config file. This file controls options such as keybindings,
766      fonts, pixmaps, and focus modes. 
769 ~/GNUstep/WindowMaker/WMWindowAttributes 
771      The Controls "attributes" for individual applications and appicons.
772      Options such as what icon to use are set here. For the most part, this
773      is now best accessed via a right click on a title bar of an application
774      and selecting "Attributes" 
777 ~/GNUstep/Defaults/WMState 
779      This is the file that is automatically generated and contains the current
780      dock settings. It is not recommended to edit this file by hand. 
783 ~/GNUstep/Defaults/WMRootMenu 
785      This file specifies what file to use as the root menu.  In Window Maker
786          0.19.0 and higher, you can replace this file with the one called plmenu
787          in ~/GNUstep/Defaults/WindowMaker, and you can then use WPrefs to edit
788          the menu.
791 ~/GNUstep/Library/WindowMaker/menu 
793      This is the file to edit to change your root menu. 
795 ~/GNUstep/Library/WindowMaker/plmenu
797          This is the same menu file, in property list format - WPrefs needs a
798          menu in this format if you wish to edit it using WPrefs.
803 4.2 How do I enable the normal X sloppy focus mode? 
804 ----------------------------------
805 In the ~/GNUstep/Defaults/WindowMaker, change the following: 
807 FocusMode = sloppy; 
810 4.3 How do I get my auto-arrange icons to work? 
811 ----------------------------------
812 In ~/GNUstep/Defaults/WindowMaker set AutoArrangeIcons=Yes; and the icons
813 should now auto-arrange. 
816 4.4 How do I get my Meta-Tab to cycle through windows correctly? 
817 ----------------------------------
818 Make sure that these settings are true in your ~/GNUstep/Defaults/WindowMaker
819 file: 
821 CirculateRaise = Yes;
822 RaiseDelay = 1; 
824 This will not give you MS Windows(tm) style application switching where
825 alt-tab is changes context. 
827 Paul Warren <<pdw@ferret.lmh.ox.ac.uk>> has released a patch that will
828 give this style of Context Switching to Window Maker. 
830 It is availible from http://ferret.lmh.ox.ac.uk/~pdw/patches/
833 4.5 How can I define my own Icon for a program? (instead of the
834     Icon the Application Supplies?) 
835 ----------------------------------
836 You can right click on the titlebar of the running app and choose the
837 "Attributes..." option, then click on the "Ignore client supplied icon"
838 checkbox. Click "Apply", "Save" and close the Attributes Editor. 
840 Another method is to edit ~/GNUstep/Defaults/WMWindowAttributes by hand and
841 use the AlwaysUserIcon=YES; option for the app. For example: 
843 xmcd = { Icon = "Radio.xpm";
844 AlwaysUserIcon=Yes;
845 }; 
848 4.6 How do I get a Tile background for my AppIcons (those things in
849     the dock)? 
850 ----------------------------------
851 You need to change 1 line to your ~/GNUstep/Defaults/WindowMaker file. 
853 IconBack = (spixmap, tile.black.xpm, white);
855 IconBack = (tpixmap, tile.black.xpm, white);
857 spixmap will scale the pixmap to fit the tile, tpixmap will tile it as is. 
859 As Random@efnet says, The last parameter is the color that fills in any
860 Transparent parts of your icon. 
862 IconBack takes other options too, search the NEWS file.
865 4.7 How do you dock <insert program here> that doesn't have an
866     appicon in the new version of Window Maker? 
867 ----------------------------------
868 There is now an option available to emulate appicons so that Window
869 Maker can dock just about anything now. 
871 To dock a misbehaving application, right click on the title bar and select the
872 attributes menu. Next, select the pull down menu's "Advanced Options"
873 item. Under the ``Advanced Options'' menu, select the ``Emulate
874 Application Icon'' Option then Save, Apply and close the dialog. 
876 This should allow you do dock the program normally. 
878 Emulate Appicon does exactly the same thing as dockit, a small app
879 distributed with ancient versions of Window Maker before the Attribute
880 Editor existed (now depricated for the obvious reason).  If Emulate Appicon
881 does not work, dockit will not work either.  Such applications violate the
882 ICCCM (Inter-Client Communication Conventions Manual) and are considered
883 badly coded for not setting the instance.class hints.
886 4.8 How do I get x11amp to not have a title bar? (or any other
887     program for that matter?) 
888 ----------------------------------
889 Right Click on the title bar and choose "Attributes". Click on Panel 2 and
890 click the the "Disable titlebar" and "Disable resizebar" options. Click
891 "Save", "Apply" and then close the Attributes panel. 
893 By Default, to get back to the attributes menu once you've removed the
894 titlebar, hit the key F10 while the window is focused. 
896 Here is an example entry in ~/GNUstep/WMWindowAttributes for x11amp. 
898 x11amp={
899 Icon="x11amp.xpm";
900 NoTitlebar=Yes;
901 NoResizebar=Yes;
902 NoAppIcon=Yes;
903 }; 
906 4.9 How do I set a pixmap background? 
907 ----------------------------------
908 Here is the in depth explanation straight from the NEWS file: 
910 wmsetbg now accepts the following options: 
911 usage: wmsetbg [-options] image 
912 options: 
913 -d 
914               dither image
915 -m 
916               match colors
917 -t 
918               tile image
919 -s 
920               scale image (default)
921 -u 
922               update Window Maker domain database
923 -D <domain> 
924               update <domain> database
925 -c <cpc> 
926               colors per channel to use
930 By default, it will try to guess if dithering is needed or not and proceed
931 accordingly.
932 Using -d or -m will force it to dither or match colors. 
934 Dithering for more than 15bpp is generally not needed, and will only result
935 in a slower processing.
936 Don't use dithering except when needed, because it is slower. Else rely on
937 wmsetbg which will detect if dithering is needed and use it. 
939 -u 
940    will update the WorkspaceBack in the default database
941    domain file in ~/GNUstep/Defaults/WindowMaker, and let Window
942    Maker refresh the screen. Please note that this option only
943    works under Window Maker, and will have no effect under
944    other window managers, since it rely on Window Maker to
945    update the image after it reads the updated defaults
946    database.
948 -D 
949    <domain> is same as above, but will update the domain
950    <domain> instead of the default Window Maker domain.
952 -c 
953    <cpc> will set the color per channel to use. Only needed for
954    PseudoColor visuals. Window Maker will automatically pass
955    the value read from the Window Maker domain database.
959 The following line is straight from your WindowMaker-0.15.x
960 ~/GNUstep/Library/WindowMaker/menu file and should all be on one line. 
962 "Images" OPEN_MENU BACKGROUNDS_DIR
963 ~/GNUstep/Library/WindowMaker/Backgrounds WITH wmsetbg -u -t 
965 This should give you an idea on how to add other entries for different image
966 directories. See the help info at the top of the
967 ~/GNUstep/Library/WindowMaker/menu file for more information. 
969 If you for some reason would like to set your background image with XV, for
970 instance to use an image format not yet supported by wmsetbg or to use one
971 of XV's special modes, edit the file ~/GNUstep/Library/WindowMaker/autostart
972 and insert the line 
974 xv -root -quit -maxpect ~/background.jpg
976 xv -root -quit -max ~/background.jpg 
978 you can also try variations of this to get different tiling and other effects
979 (where X is a number 1-9 I believe):
980 'xv -root -quit -rmodeX ~/background.jpg' 
982 If you would like xv functionality in your menu, heres a nice little tip from
983 Alfredo: 
985 Add the following line to your ~/GNUstep/Library/WindowMaker/menu file. (all on
986 one line) 
988 "More Backgrounds" OPEN_MENU /home/whoever/backgrounds xv -root -maxpect -quit 
991 4.10 Can I put pixmaps in my root menu and title bars? 
992 ----------------------------------
993 With the release of WindowMaker-0.14.1, you can now put pixmaps
994 anywhere you would have either a gradient or a color. This means now that 
996 MenuTextBack=(tpixmap, foo.xpm, acolor); 
998 in ~/GNUstep/Defaults/WindowMaker will put the correct pixmap tiled in your
999 menu. 
1001 FTitleBack = (spixmap, foo.xpm, black); 
1003 Would have the effect of streching a pixmap to fit the titlebar of the active
1004 window.
1005 You can use png, gif, ppm, tiff, jpeg and xpm images interchangeably in
1006 Window Maker if you have compiled in support for those formats. 
1009 4.11 How do I get my Minimize Icon to look like the triangle I see in
1010      screenshots? 
1011 ----------------------------------
1012 This involves a minor source tweak. Instructions are available at
1013 http://wm.current.nu/tips.html#titlebar_icons
1015 Example screenshot at 
1016 http://wm.current.nu/themes/images/screenshots/Midnight3.jpg
1019 4.12 How do I get superfluous bells and whistles working? 
1020 ----------------------------------
1021 Add Superfluous=YES; to your ~/GNUstep/Defaults/Windowmaker file. 
1023 This option was added as a runtime option in Window Maker >= 0.16.1. 
1026 4.13 How do I get the classic NeXT(tm)-like style back? 
1027 ----------------------------------
1028 Add NewStyle=NO; to your ~/GNUstep/Defaults/Windowmaker file. 
1030 This option was added as a runtime option in Window Maker >= 0.16.1 
1033 4.14 How do I get the window menu with only a two button mouse? 
1034 ----------------------------------
1035 Jim Noble <jmknoble@ntrnet.net> writes: 
1037 If you've got a two-button mouse under some versions of Solaris x86,
1038 there's no way (that i'm aware of) to emulate a 3-button mouse. The right
1039 button can be either MB2 or MB3, but chording doesn't work. 
1041             ApplicationMenuMouseButton = Left;
1043 and 
1045             WindowListMouseButton = Right; 
1046           
1048 in ~/GNUstep/Defaults/WindowMaker ought to allow the left button to
1049 activate the root menu, and the right button (as MB2) to activate the
1050 windows menu. 
1053 4.15 How do I edit my root menu? 
1054 ----------------------------------
1055 You can now use WPrefs.app 
1056 (see http://wm.current.nu/features/configuration.html for more info) 
1057 if you have the new PropList style menu, or you can manually edit the 
1058 oldstyle menu file 
1060             ~/GNUstep/Library/WindowMaker/menu
1062 (or you can also manually edit the newstyle menu file) 
1064             ~/GNUstep/Defaults/WMRootMenu
1066 and save your changes. Window Maker should detect the change and
1067 automatically update. If you are having a problem getting it to reload the
1068 menu, try 
1070             touch ~/GNUstep/Library/WindowMaker/menu
1072             (or 'touch ~/GNUstep/Defaults/WMRootMenu' for the newstyle menu)
1074 to force the modification time into the future. 
1077 4.16 How can I set dock/clip to use single click to launch
1078      applications, instead of double click?
1079 ----------------------------------
1080 You cannot do this. This is because single click is used to select app-icons,
1081 or to raise/lower the app-icon or the dock/clip.
1082 If this is impelmented then you will be unable to select or raise/lower
1083 dock/clip or app-icons, without also launching the application it represents.
1085 So don't ask for this to be implemented, because it will not be. Double
1086 click is used for a reason, is not just some weird idea we got in a morning
1087 when we wake up too early.
1092 4.18 How do I restore the configuration app to the dock?
1093 ----------------------------------]
1094 You should start it from a terminal using its full path name, which is
1095 /usr/local/GNUstep/Apps/WPrefs.app/WPrefs
1096 by default.
1099 4.19 How do I define my own icon for a program?  I don't like the one it
1100          supplies.
1101 ----------------------------------
1102 Right-click the titlebar of the running application and start the Attributes
1103 Editor.  Check the "Ignore client supplied icon" box.  "Apply" and "Save",
1104 and close the Attributes Editor.
1106 Another method is to edit ~/GNUstep/Defaults/WMWindowAttributes by hand and
1107 use the AlwaysUserIcon=YES; option for the app. For example: 
1109 xmcd = { Icon = "Radio.xpm"; AlwaysUserIcon=Yes; }; 
1112 -=-=-=-=-=-=-=-=-=-
1113 Other Applications:
1114 -=-=-=-=-=-=-=-=-=-
1116 5.1 How do I assign gimp an appicon? 
1117 ----------------------------------
1118 Window Maker now can assign Icons from within the windowmanager, to
1119 do so, right click on the title bar of an app or hit F10 while the desired app
1120 is focused, choose "Attributes...", click on the "4" Button, enter the icon file
1121 name (make sure this is in your pixmap path, or you can type in the full path
1122 without using ~/ type path names), click "Update", "Apply", "Save" and then
1123 close the Attributes Editor. 
1125 You can also enter the following line in
1126 ~/GNUstep/Library/WindowMaker/WMWindowAttributes: 
1128 gimp={Icon="gimp.xpm";}; 
1131 5.2 How do I get an appicon for XEmacs 20.3+? 
1132 ----------------------------------
1133 Thanks to Michael Hafner <hayfi@rz.fh-augsburg.de> for this answer. 
1135 You don't need to patch the XEmacs code, just run 
1137 ./configure --with-session=yes (in addition to any other options you use) 
1139 in your XEmacs 20.3+ sourcedir and rebuild it. Then XEmacs shows an
1140 appicon when running and you can easily dock it. 
1143 5.3 Where do you get that clock program I always see on people's
1144     desktops? 
1145 ----------------------------------
1146 Its called asclock. It was included with each version of Window
1147 Maker until version 0.17.5, and was no longer included in
1148 0.18.0 and above.
1149 You could find it in ./WindowMaker-0.xx.x/misc/asclock.tgz and it was
1150 prepatched to be able to dock. Some other (older) versions you might find
1151 on the net don't dock. 
1153 Since it was pulled from the distribution (probably to save space), I've
1154 included it at http://wm.current.nu/files.html#asclock for your convenience. 
1157 5.4 How do you dock asclock? 
1158 ----------------------------------
1159 asclock -shape -iconic -12 & 
1161 Drag it from the top right corner of the clock to the dock. Right click on the
1162 icon and select autolaunch.
1163 You have to drag the appicon by clicking on the edge of the icon, because
1164 the actual pixmap belongs to the app itself, and any clicks on the pixmap
1165 are interpreted by the app rather than X or the window manager. Therefor,
1166 you need to click somewhere on the appicon where the background tile
1167 shows through (usually the edges), and drag it that way. 
1170 5.5 How do you dock wmload? 
1171 ----------------------------------
1172 wmload -withdrawn -shape & 
1174 Then dock it similar to asclock. 
1177 5.6 What other apps exist for the dock? 
1178 ----------------------------------
1179 Several Nice applications are available: 
1181      wmmixer and wmcd and wmmount
1182      http://www.geocities.com/SiliconValley/Vista/2471/linux.htm#xapps 
1184      ascd,WMRack,asmixer,asmodem, and others
1185      ftp://ftp.windowmaker.org/pub/wmaker/contrib/srcs/apps/ 
1187      wmavgload, wmmount, and wmload
1188      ftp://ftp.windowmaker.org/pub/wmaker/contrib/srcs/utils/ 
1190      wmppp-wmifs, wmtime, wmmon and other nifty apps
1191      http://windowmaker.mezaway.org/ 
1193 A huge index of most available dockapps is available at:
1195          http://www.bensinclair.com/dockapp/
1198 5.7 How do I get an appicon for rxvt so I can dock it? 
1199 ----------------------------------
1200 The default rxvt that comes with most distribtions is an outdated version of
1201 rxvt. The newest development version of rxvt is availible from
1202 ftp://ftp.math.fu-berlin.de/pub/rxvt/devel/. As of the time of this writing, the
1203 version is 2.4.7 and it natively produces an appicon without a patch. 
1205 John Eikenberry has also created an rpm which is available from
1206 ftp://ftp.coe.uga.edu/users/jae/windowmaker/ 
1208 For your convenience, I have rxvt-2.4.7.tar.gz at
1209 http://wm.current.nu/files/rxvt-2.4.7.tar.gz for download. As of
1210 version 2.4.7, rxvt includes Window Maker support as well as John
1211 Eikenberry's NeXT scrollbar hack. 
1214 5.8 How do I get different icons for rxvt's (or xterms) running
1215     different programs? 
1216 ----------------------------------
1217 The simplest way is to run each rxvt with a different -name parameter. 
1219 For example, I want to run an rxvt for irc and one for mail. This is an
1220 example of what I'd do: 
1222 for the irc rxvt:
1223 rxvt -name "irc" -e "irc" 
1225 for the mail rxvt:
1226 rxvt -name "mail" -e "pine" 
1228 This would result in each rxvt now having the instance and class of irc.Xterm
1229 and mail.Xterm respectively, so that Window Maker can now set Attributes
1230 for them individually. 
1233 5.9 How do I launch multiple instances of XTerm from one appicon?
1234 ----------------------------------
1235 The easiest way to accomplish this is to dock XTerm as normal. Then Go
1236 to the 'Attributes menu' -> 'Application Specific' and select 'no application
1237 icon' for XTerm. 
1239 You can also right-click on the docked appicon and select settings. Change
1240 the 'Application Path with arguments' section to 
1242             foo.sh
1244 where foo.sh is the following script 
1246             #!/bin/sh
1247             exec xterm
1249 This should allow unlimited XTerms without appicon clutter. 
1252 5.10 How do I allow Alt+# to work in an rxvt session? (with irc for
1253      example) 
1254 ----------------------------------
1255 First, Launch a unique instance of rxvt or xterm.
1256 This can be done using the -name option of rxvt.
1257 For example: 
1259 rxvt -name foo -e irc 
1261 Then, go to the Attributes menu (right click on titlebar (or hit F10) and
1262 choose 'Attributes...')
1263 Then choose 'Advanced Options' from the listbox and enable 'Don't Bind
1264 Keyboard shortcuts'.
1265 Click 'Save' and 'Apply' and you should be able to run your session without
1266 the shortcuts. 
1269 5.11 Window Maker breaks scilab
1270 ----------------------------------
1272 If you refer to the problem of the "graphics" window of scilab not showing
1273 up in Window Maker, this is caused by a bug in scilab. You can see the
1274 cause of the problem by yourself, by running xprop on the graphic window:
1275 WM_NORMAL_HINTS(WM_SIZE_HINTS):
1276                 user specified location: 136679205, 1074468360
1277                 user specified size: 400 by 300
1278                 program specified minimum size: 400 by 300
1280 Now, when scilab opens it's window, Window Maker nicely does exactly what it
1281 is told, that is, map the window at position 136679205, 1074468360 which
1282 obviously falls outside the screen no matter how big is your monitor ;) 
1284 Meanwhile, the workaround for this is to open the window list menu
1285 (click on the root window with the middle mouse button) and click 
1286 on the ScilabGraphic entry. The window should be brought to your
1287 reach. Then, open the window commands menu (right click on window's
1288 titlebar) and open the Attributes panel. Go to the "Advanced Options"
1289 section, check the "Keep inside screen" option and save.
1291 If you can recompile Scilab, this came from a Scilab developer:
1293 replace 
1294  size_hints.flags = USPosition | USSize | PMinSize;
1295 with
1296  size_hints.flags = /** USPosition |**/ USSize | PMinSize;
1298 in routines/xsci/jpc_SGraph.c
1301 5.12 Netscape shows black and white icons
1302 ----------------------------------
1304 This is because Netscape uses monochrome icons when running under olwm
1305 and you are using the OPEN LOOK emulation option. If you do not use any XView
1306 apps anyway, recompile Window Maker without the --enable-openlook option.
1307 If you need OPEN LOOK emulation, you will have to get used to the monochrome
1308 icons or change then manually in the Attributes panel for each window.
1309 I have also seen this happen on some systems if you run Netscape in a high
1310 colour depth (32bpp) regardless of whether you're using openlook or not.
1311 That is a Netscape bug.  Therefore, bug Netscape.
1314 5.13 Snow flakes from xsnow don't acumulate on titlebars!
1315 ----------------------------------
1317 Because of the way xsnow is coded, it seems that it can't "see"
1318 windows with the SaveUnder attribute turned on. So, if snow
1319 accumulation on windows is vital for you, disable SaveUnders in
1320 WPrefs, in the advanced options section.
1323 5.14 I'm using RedHat 6.0 and Netscape dies without reason.
1324 ----------------------------------
1326 Er... well, I don't know why you're looking in this Window Maker FAQ 
1327 for a RedHat/Netscape problem, but anyway, the answer is in:
1329 http://www.redhat.com/cgi-bin/support?solution&11-990511-0082&100-926468988&14-0&15-0&25-&3-&30-
1332 -=-=-=-=-=-=-
1333 Programming:
1334 -=-=-=-=-=-=-
1336 6.1 How do I get a normal X application to produce an appicon? 
1337 ----------------------------------
1338  You must define the WM_CLASS (XSetClassHint()) and the
1339 CLIENT_LEADER or XWMHints.window_group properties, which are
1340 automatically set by most applications that use Xt (Motif, Athena ...),
1341 but if you use plain Xlib you must set them by hand. 
1343 Also you must make a call to XSetCommand(dpy, leader, argv, argc); 
1345 Take a look at Window Maker-0.1x.x/test/test.c that is an example for
1346 writing such an app (which also have an app menu).
1349 6.2 How do I get my tcl/tk application to produce an appicon? 
1350 ----------------------------------
1351 Oliver Graf <ograf@fga.de> writes: 
1353 The main window (normally this is called '.' [dot] in tk) should use the
1354 following lines: 
1356 wm command . [concat $argv0 $argv] 
1357 wm group . . 
1359 All child windows attached to the same app-icon should use: 
1361 toplevel .child
1362 wm group .child . 
1364 where .child should be replaced by the actual window path. 
1366 Replace '.' with the actual main-window path and 'wm group .child .' should
1367 be added for each 'toplevel .child' call. 
1370 6.3 What is WINGs? 
1371 ----------------------------------
1372 WINGs Is Not GNUstep. ;) 
1374 It is the Widget Library written for the widgets in Window Maker. 
1376 It is currently under heavy development but several people have started
1377 writing applications in it. Its goal is to emulate the NeXT(tm)-style widgets. 
1379 http://www.ozemail.com.au/~crn/wm/wings.html is the closest thing to an
1380 information center about WINGs by <crn@ozemail.com.au>. 
1383 6.4 Where can I get more information about WINGs? 
1384 ----------------------------------
1385 Nic Berstein <nic@postilion.org> has created a WINGs Developement list. 
1387 The purpose of this list is to provide a forum for support, ideas,
1388 suggestions, bug reports etc. for the WINGs widget set library. 
1390 To subscribe to this list, send a message with the word ``subscribe'' in the
1391 _BODY_ of the message to: <wings-request@postilion.org>. 
1395 -=-=-=-=-=-=-=-=-=-=-=-=-
1396 Miscellaneous Questions:
1397 -=-=-=-=-=-=-=-=-=-=-=-=-
1399 7.1 Is there a pager for Window Maker? 
1400 ----------------------------------
1401 Not at the moment because there is not a pressing need for a pager. The
1402 concept of multiple desktops does exist and there are currently 3 ways to
1403 switch between them. 
1405 First, the Alt+Number combination will switch between desktops. The
1406 Workspaces menu will also let you switch workspaces. Lastly, the Clip will
1407 also scroll one through workspaces. 
1409 For those that would like to send an application to a specific workspace,
1410 either drag it to an edge of the desktop onto the next workspace or you can
1411 right click on the titlebar, choose "Move to..." and choose the appropriate
1412 workspace. 
1414 BUT, Window Maker does support KDE and GNOME protocols, including the
1415 workspace management stuff, so you can use Window Maker in these
1416 environments and use their pagers.
1420 7.2 Can I have folders like in AfterStep? 
1421 ----------------------------------
1422 No. Window Maker does however support the collapsable Clip per desktop
1423 for a similar functionality. 
1426 7.3 How do I use getstyle and setstyle? 
1427 ----------------------------------
1428 To capture the current Window Maker style, use the command 
1430             getstyle > current.style 
1431           
1433 To replace the current style, use the command 
1435             setstyle filename.style
1438 7.4 Why don't you distribute {normal diff, xdelta} patches? 
1439 ----------------------------------
1440 Whenever possible plain diff patches are distributed. If the new version has
1441 new binary files, normal diff won't be able to handle them, so a patch
1442 package is distributed, instead. We don't use xdelta because: - most
1443 systems do not have xdelta installed; - xdelta is picky and require the file to
1444 be patched to be exactly the same as the one used to make the patch. The
1445 patch package scheme used is much more flexible. 
1447 We do not distribute a simple diff with the binary files separately (and
1448 variations, like uuencoding the binary files) because: - it is more
1449 complicated and error prone to require the user to manually move the files
1450 to the correct places; - the current patch package scheme *does* distribute
1451 the binary files and diff files separately. If the user wants to install everything
1452 by hand, nobody will object to that; - sooner or later someone will certainly
1453 ask for a script to automate the file moving stuff. 
1455 So we hacked a script (mkpatch) that automatically creates a patch
1456 package with the normal text diff file, a list of removed files and the binary
1457 files that have changed or been added, plus a script that does the patching
1458 automatically. If you don't like the script, you can apply the patch and move
1459 the files manually. Or download the whole distribution. 
1462 7.5 Will you add GNOME or KDE support?
1463 ----------------------------------
1465 Support for GNOME (and KDE) hints is included since 0.50.0.  You have to
1466 enable them at compile-time using the appropriate arguments to ./configure.
1467 Please read the INSTALL file for more details.
1469 -=-=-=-=-
1470 Themes:
1471 -=-=-=-=-
1473 8.1 What exactly are themes? 
1474 ----------------------------------
1475 Themes are a great aspect of Window Maker allowing a user to simply
1476 save the entire 'look' of their desktop in a Archive to distribute freely among
1477 friends, fellow users and/or the whole net in general. :) 
1479 See the theme-HOWTO at http://wm.current.nu/themes/theme-HOWTO.html 
1480 for an in-depth walk-through on making a Theme archive. 
1483 8.2 How do I install a Theme? 
1484 ----------------------------------
1485 This should be as simple as untarring the Theme.tar.gz into one of two
1486 places. You can untar it to the global /usr/local/share/WindowMaker/* directory,
1487 and have it be accessable to all users, or you can untar it to your own
1488 ~/GNUstep/Library/WindowMaker/ directory for your own personal use. 
1490 Use your favorite variation of the following: 
1492 gzip -dc "Theme.tar.gz" | tar xvf - 
1494 *(directory may differ on some systems) 
1497 8.3 How do I make a Theme? 
1498 ----------------------------------
1499 There is a neat little file called README.themes distributed with Window
1500 Maker that explains everything in intricate detail.  You can also read
1501 http://wm.current.nu/themes/themepacks.html
1504 ====================================================================
1505 and they lived happily ever after.
1506 ====================================================================
1507 (The End.)