Avoid icon change to default on winspector save
[wmaker-crm.git] / FAQ
blob4cca2aaaa3d4e3cdd99dac086b1a8a21f23f9d17
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 http://windowmaker.org/pub/source/beta/
148 The mercurial repository is available at https://hg.windowmaker.org/wmaker
150 The development versions are usually very stable themselves, so if you
151 want to have all the newest features, you can rather safetly go with the
152 development versions. Just remember to save any unsaved data before
153 you go playing around with the config files. Also, remember they are
154 developmental versions, so your mileage may vary, don't get angry if they
155 crash. 
158 1.3 Where are the mailing list archives? 
159 ----------------------------------------
160 Please read the information on the web pages at http://lists.windowmaker.org/
161 for information on how to subscribe, the posting guidelines, and how to access
162 the web archives.
165 1.4 Where is more documentation on configuring Window Maker? 
166 ----------------------------------
167 Besides the mailing list archives, there are nice documents in
168 http://windowmaker.org/documentation.php
171 1.5 What is an appicon? 
172 ----------------------------------
173 An appicon is the icon (without the tiny titlebar a minimized application icon
174 has) produced by most applications that initially is in the bottom left corner
175 of the screen while an application is running. For an example, run xterm and
176 notice the icon in the corner.
179 1.6. How can I get a question added to the FAQ? 
180 ----------------------------------
181 Ask on the mailing list, or send your request to faqs@windowmaker.org
183 Other avenues are the Window Maker wiki
184   http://bugs.windowmaker.org/projects/wmaker/wiki
185 and the forums
186   http://bugs.windowmaker.org/projects/wmaker/boards
189 1.7. How do I report bugs? 
190 ----------------------------------
191 You can look at the BUGFORM file in your tarball of Window Maker.
192 Alternatively, you can use the Window Maker Bugtracker at
193 http://bugs.windowmaker.org/projects/wmaker/issues
196 1.8. Is there a public source code repository?
197 ----------------------------------
198 Yes there is. To check out from mercurial use:
199   hg clone http://hg.windowmaker.org/wmaker wmaker
201 To update your source tree, cd to the wmaker directory and type
202   hg pull
203           
206 -=-=-=-=-=-=-
207 Installation:
208 -=-=-=-=-=-=-
210 2.1 Where can I get libPropList/proplist.h?
211 -------------------------------------------
212 starting with Window Maker 0.70.0, libPropList is no longer needed.
213 It was obsoleted by adding property list handling code to the WINGs library.
217 2.2 Why do no icons show up after installing Window Maker >= 0.15.x 
218     when I've followed all the directions? 
219 -------------------------------------------------------------------
220 Under normal circumstances, this should not happen because Window Maker
221 should detect if libtiff is going to be compiled in and then it will make the
222 default theme use .tiff or .xpm icons, depending if TIFF support is compiled
223 in or not.
225 As of Window Maker version 0.15.0, the default setup includes .tiff icons
226 which require you to have compiled Window Maker with libtiff support, if you
227 want them to be used. If you are happy with the .xpm icons, then you don't
228 need libtiff. Window Maker will detect that TIFF support is not available and
229 use .xpm icons instead. For some help on compiling with libtiff, look at the
230 libtiff section of this FAQ. 
233 2.3 How do I get libtiff to work? 
234 ----------------------------------
235 The whole key to getting libtiff working for me was to upgrade to >=
236 tiff-v3.4beta037-tar.gz availible at ftp.sgi.com. 
238 Rerun ./configure and make and it should work. I had previously been using
239 tiff-v3.4-tar.gz instead so the library was there just not working. A note to
240 keep in mind, is that the tiff libs are versioned rather oddly, version
241 tiff-v3.4beta037 is actually newer than tiff-v3.4. 
243 Make sure to rm config.cache and rerun ./configure before attempting to
244 compile again. 
246 Also, make sure to use gnu-make for the Window Maker compile. 
249 2.4 How do I get libjpeg to work? 
250 ----------------------------------
251 The newest jpeg libs are availible at ftp://ftp.uu.net/graphics/jpeg/. 
253 How many of you have seen that darned "lib reports 62 caller expects 61" type of
254 error?
255 Well, I have more than once, and here are some answers to possibly help
256 you out. 
258 First things first. As always, make sure there are not older copies of libjpeg
259 floating around on your system. By default my Slackware distribution came
260 with an old libjpeg.so.1 in the /usr/X11R6/lib/ directory. This can simply be
261 deleted. Or if something complains after you delete it, recompile it if you
262 can to look for the new lib in the right place, or if that fails, as a last resort,
263 you might add a symlink to the new lib like so:
264 ln -s /usr/local/lib/libjpeg.so.6.0.2 libjpeg.so.1 
266 Now on to the error.
267 This is basically caused by your application having been compiled to
268 dynamically use the libjpeg.so shared library. When you install a new lib and
269 then try to run your program again, it expects the lib it was compiled
270 against, in this case the older libjpeg.so.6.0.1 and instead finds libjpeg.so.6.0.2
271 and reports the error. 
273 The fix is actually rather simple. Along with adding a libjpeg.so.6 symlink
274 like so (just in case):
275 ln -s libjpeg.so.6.0.2 libjpeg.so.6
276 where you installed your new lib, you simply need to recompile your app to
277 link it against the new library. :) 
279 Make sure to rm config.cache and rerun ./configure before attempting to
280 compile again. 
282 Also, make sure to use gnu-make for the Window Maker compile. 
285 2.5 How do I get libpng to work? 
286 ----------------------------------
287 The newest png libs are availible at
288 http://www.cdrom.com/pub/png/pngcode.html. 
290 You should also get the newest zlib libs from
291 http://www.cdrom.com/pub/infozip/zlib/. 
293 I had a few problems with this lib as well, basically I had an old libz.so in my
294 /usr/X11R6/lib/ directory which configure was finding first, and which failed the
295 test, being an older lib. 
297 Generally the same applies here as with libjpeg, make sure there are no
298 older versions of the necessary libs floating around on your system, then try
299 and configure and make again. 
301 Make sure to rm config.cache and rerun ./configure before attempting to
302 compile again. 
304 Also, make sure to use gnu-make for the Window Maker compile. 
307 2.6 How do I get libgif (or libungif) to work? 
308 ----------------------------------
309 The newest libgif is availible at
310 ftp://sunsite.unc.edu/pub/Linux/libs/giflib/. 
312 The newest libungif is availible at
313 ftp://sunsite.unc.edu/pub/Linux/libs/graphics/. 
315 I had a few problems with libgif... it seems that the install process didn't
316 install the header file libgif.h, so although the Window Maker configure found
317 the lib (libgif.so.x), when you actually try to compile, it fails when it looks for
318 the header to include the make. I simply copied it from the libgif source
319 directory to the system include directory. (/usr/local/include/ on my system). 
321 Make sure to rm config.cache and rerun ./configure before attempting to
322 compile again. 
324 Also, make sure to use gnu-make for the Window Maker compile. 
327 2.7 Does wmsound work with 0.1x.x? 
328 ----------------------------------
329 As of Window Maker 0.15.x, sound is now included by default but requires
330 the authors sound server. For more information, read the NEWS file in the
331 Window Maker distribution. 
333 The author Anthony Quinn <southgat@frontiernet.net> has released a 
334 version that works with Window Maker >= 0.15.x. It is available from 
335 it's home page at http://www.frontiernet.net/~southgat/wmsound/ 
336 or on Largo's site at http://wm.current.nu/files.html#wmsound 
337 for your convenience. 
340 2.8 Can I use WindowMaker with KDE or GNOME or CDE? 
341 ---------------------------------------------------
342 Contrary to what a lot of people think, KDE is NOT a window manager. KDE is
343 a suite of various applications that includes a custom window manager (kwm).
344 The same is true for CDE. 
346 Now, answering the question: Yes, you can use WindowMaker in these
347 environments. To use Window Maker with GNOME, you don't need to do
348 anything special. To use it with CDE, read the answer for "How do I switch
349 CDE's windowmanager to use Window Maker?" 
351 To use it with KDE, read it's documentation to get rid of kwm (and possibly
352 kpanel) and replace it with wmaker. Then, start WPrefs.app, go to "Mouse
353 Preferences" and set the "Disable mouse actions" check box. You will
354 need to restart Window Maker to make this change take effect. The
355 "Disable mouse actions" change is needed to allow you to use krootwm,
356 wich enables you to use kfm's desktop icons, but will prevent you from
357 accessing Window Maker's Applications and Window List menus with the
358 mouse. 
361 2.9 How do I get Window Maker working with xdm in Redhat 5.[01]? 
362 ----------------------------------------------------------------
363 After running wmaker.inst and letting it write to .xinitrc,
364 cp .xinitrc .xsession
365 and make sure that /usr/local/bin is in your $PATH for the Xserver. You can
366 make sure of this by including a statement like 
368             export PATH=$PATH:/usr/local/bin 
369           
371 in your .xsession file. 
373 Make sure to chmod +x .xsession so that the Xsession script of xdm can
374 execute it. 
376 This is how the Xsession script is designed: 
378             startup=$HOME/.xsession
380             if [ -x "$startup" ]; then
381                     exec "$startup"
382             elif [ -x "$HOME/.Xclients" ]; then
383                     exec "$HOME/.Xclients"
384             elif [ -x /etc/X11/xinit/Xclients ]; then
385                     exec /etc/X11/xinit/Xclients
386             else
387                     if [ -f "$resources" ]; then
388                             xrdb -load "$resources"
389                     fi
390                     exec xsm
391             fi
392           
394 You could also have a .Xclients file as was mentioned in previous revisions
395 of this question. 
398 2.10 Do I need to rerun wmaker.inst with every new version of
399      Window Maker? 
400 ----------------------------------
401 There is no need to do this. You can do it, but keep in mind, that all your
402 preferences will be lost, overwritten by the defaults. You can update the
403 files and add the changes yourself if you need to, but else in most cases is
404 sufficient to rely on WPrefs and it will update for you the new missing
405 options if they differ from the default ones.
407 The way domain files are read beginning from 0.15.0 makes the need for update
408 almost redundant. The user config files are merged with the global ones in
409 /usr/local/share/WindowMaker/Defaults.
410 So even if new options are added, they will be reflected in the user
411 configuration. 
412 Only if user wishes to change the default behavior, he needs to add that
413 option to the config file.
415 If there ever happens to be a need for all users to rerun wmaker.inst in a
416 future version, this will be noted in the NEWS file.
419 2.11 When I install Window Maker, I've used wmaker.inst correctly
420      and I only get aroot menu with xterm and exit. How do I fix this? 
421 ----------------------------------
422 Most likely, the problem is that Window Maker can not find a copy of the C
423 pre processor in a directory such as /lib. The file /lib/cpp should be a
424 symbolic link to whatever c compiler's cpp you are using. Mine reads as: 
426             cpp -> ../usr/lib/gcc-lib/i586-pc-linux-gnu/pgcc-2.90.29/cpp*
427           
429 There seems to be another common problem that exhibits this same
430 behavior. If you find another solution that matches this question please
431 email <sprout@dok.org> or <largo@current.nu>. 
434 2.12 How do I get Window Maker to use more than 16 colors on my
435      SGI Indy Workstation? 
436 ----------------------------------
437 Thanks to Peter H. Chou <pchou@leland.Stanford.EDU> for this answer: 
439 By default, the SGI X Server uses 8-bit Pseudocolor mode.
440 To change it, edit (as root) the file /usr/lib/X11/xdm/Xservers.
441 Change it to read: 
443             :0 secure /usr/bin/X11/X -bs -c -class TrueColor -depth 24
444           
449 2.13 Using WindowMaker with Solaris 2.6 CDE 
450 ----------------------------------
451 (thanks to Rob Funk, Unix God of osu.edu) 
453 Assuming you installed Window Maker according to the README's that
454 come with the source, all you need to run Window Maker on a Solaris box
455 is an entry in the .xinitrc. Only 0.17 - 0.19 versions have been tested, but
456 when you run the configure script, let it make changes to the .xinitrc file. It
457 should look something like this: 
459             #!/bin/sh
460             # Window Maker Default .xinitrc
461             exec /usr/local/bin/wmaker
462           
464 Believe it or not, that's all that it takes. This, in fact, runs WindowMaker
465 instead of OpenWindows. In order to choose WindowMaker, you simply
466 choose "OpenWindows Desktop" in the "Options - Session" Menus.
467 Choose "CDE Desktop" if you want CDE. 
469 The Color schemes and settings for Window Maker are seperate from
470 CDE. Tested on a SPARC 10, Solaris x86 should work also. (better,
471 hopefully) 
474 2.14 How do I switch CDE's window-manager to use Window Maker? 
475 ----------------------------------
476 Method 1: 
478 Peter Ilberg <peter.ilberg@natinst.com> gives us this answer: 
480 Install WM wherever you want it, mine is in /opt/WindowMaker-0.16.0
481 (eg. use ./configure --prefix=/opt/WindowMaker-0.16.0).
482 Run the install script wmaker.inst in your home directory. 
484 Add the following two lines to .dtprofile in your home directory: 
486 SESSIONTYPE=xdm; export SESSIONTYPE
487 PATH=:/usr/contrib/bin/X11:$PATH:.; export PATH 
489 This tells CDE to go looking for an .xinitrc/.xsession instead of using the
490 default environment. 
492 Make your .xsession/.xinitrc executable (VERY IMPORTANT, wmaker.inst did
493 NOT do this automatically for me) using eg. 
495 chmod ugo+x .xsession 
497 Your .xsession/.xinitrc should look something like this: 
499 #!/bin/sh
500 <some other init stuff that you want/need>
501 exec wmaker 
503 Things to try if it doesn't work: (somewhat fuzzy and random) 
505 This should do it although I did have problems sometimes initially which I
506 fixed by randomly trying absolute pathes for wmaker in .xsession/.xinitrc and/or
507 making the dtprofile/.xinitrc/etc executable. It helps logging in on the console
508 (select from CDE login screen) and start X manually using 'X'.
509 If it works that way it should work when logging into the CDE environment.
510 Remember to Check your paths! 
512 If it doesn't work, you can also substitute some other window manager for
513 wmaker in the .xinitrc and see if that works. If it does you know at least that
514 .xinitrc is getting called/executed, so your WM path is wrong or not set. 
517 Method 2: 
519 Thomas Hanselman gave this alternative answer (via Peter Ilberg): 
521 Build and install WM wherever you want, as described in Method 1. You
522 can install and run WM just fine from your home directory. That's what I'm
523 doing, since I don't have root access at work :(. Then, in your .Xdefaults file in
524 your home directory, add the following line: 
526 Dtsession*wmStartupCommand: <path to Window Maker executable> 
528 Then, log out, and log back in, and, unless I've forgotten a step (or this is a
529 custom Nortel thing), you should be in Window Maker heaven ;). 
531 Difference between the methods: (according to Thomas) 
533 I've been told that the difference between setting the resource and Peter's
534 method is that if you override the window manager with the resouce, you
535 still get the CDE resources read into the resource database (so you still
536 have your color settings & such from CDE), whereas with Peter's, the CDE
537 resource don't get read into the database. I don't know if this is true or not,
538 however. Also, another thing to note with Window Maker and HP-UX 10.20
539 -- if you select "Exit Session" from the WM root menu, Window Maker and
540 all of your applications are killed, but you may not be logged out. Again, this
541 might be an artifact from my work environment, or the way I start Window
542 Maker. 
544 Owen Stenseth <iplenergy.com> adds: 
546 When using this method it is possible to exit Window Maker cleanly by
547 using the dtaction command. I use the following in my Window Maker menu: 
549 "Exit Session"      EXEC dtaction ExitSession 
551 The only problem I have at the moment is I seem to get multiple copies of
552 asclock running when I log in again. 
554 You can also use the normal "Exit Session" command from the WM root
555 menu and place additional commands required to shutdown CDE in
556 ~/GNUstep/Library/WindowMaker/exitscript 
558 So, if you add "dtaction ExitSession" in that file, the command to shutdown
559 CDE will be automatically executed when you exit WindowMaker. 
562 2.15 When I run wmaker it quits complaing about something
563      __register_frame_info. 
564 ----------------------------------
565 This is due to using gcc >= 2.8.0 or egcs to compile Window Maker or a
566 library it uses, then running these precompiled binaries on a system using
567 libraries compiled with gcc 2.7.2.x
569 You will have to compile Window Maker yourself on this system.  Please read
570 the INSTALL file for the instructions on how to do so.
573 2.16 When I run wmaker it complains about something like expected
574      libjpeg 61 got 62.
575 ----------------------------------
576 Upgrade your libjpeg library and/or recompile Window Maker.
579 2.17 How do I fix an error such as "libwraster.so.1: cannot open shared
580          object file" ?
581 ----------------------------------
582 Like most software using GNU autoconf, Window Maker by default will install
583 under the /usr/local prefix.  This has the repercussion on many systems that
584 the libraries that are part of Window Maker will be installed in
585 /usr/local/lib, which is usually not in the default system LD_LIBRARY_PATH.
586 This is why the library cannot be found.
588 Under Linux, you will need to list this directory in /etc/ld.so.conf and
589 run /sbin/ldconfig.  Both these operations will need to be performed as the
590 superuser.
592 Under BSD, as the superuser you will need to run
594     ldconfig -m /usr/local/lib
596 which will merge this directory into the system library path.
598 If the problem persists, you may be able to use "ldd" to track down why the
599 library cannot be loaded (it will print a list of dynamic objects used by
600 the executable or library listed on the command line, and where it is
601 expecting to find it).
604 -=-=-=-
605 Usage:
606 -=-=-=-
608 3.1 How do I get new apps on the dock (The icon or line of icons on
609     the right side of the screen by default) 
610 ----------------------------------
611 Launch an application. If there is a little icon that pops up in the bottom
612 corner of the screen, drag it over to the dock icon(s). You should see a
613 whiteish square indicating when it is close enough to dock, and where it will
614 be placed. To make sure this application will be there next time you start up
615 windowmaker, exit windowmaker with the "exit session" option. 
618 3.2 What is the difference between the 'Exit' and 'Exit Session' Options? 
619 ----------------------------------
620 'Exit' exits wmaker, but leaves the other apps running, and if wmaker was
621 not the last app launched in the .xinitrc the X server is not closed, until
622 the last app started by .xinitrc is closed.
623 'Exit session' will exit wmaker, but also will close all running apps, thus
624 the X server will be closed, and your session will end.
627 3.3 How do I "dock" AppIcons on the Clip? 
628 -----------------------------------------
629 Just drag icons near it like you would for the dock.  Note that if you place
630 the clip near the dock, you may have problems docking appicons in either.
631 Move the clip away first.
634 3.4 Why do none of my Key Bindings (ie: Alt+#) work in Window Maker 0.1x.x 
635 ----------------------------------
636 If you are using XFree86, make sure scroll lock and numlock are off or no
637 bindings will work (XFree bug). You can try using the XFree86 Numlock
638 Hack by editing the line #undef NUMLOCK_HACK in $WindowMakerdir/src/wconfig.h
639 and changing it to #define NUMLOCK_HACK. 
640 As of 0.18.0, this hack functions properly.
643 3.5 How do I rename workspaces? 
644 ----------------------------------
645 Right click on the "desktop" (root window) to show the menu (don't hold the
646 button down). Go to the workspaces menu and hold the Control key down
647 and click on the workspace you would like to rename and type the name. 
649 If you use the clip, use the "Rename Workspace" command in the clip
650 menu. 
653 3.6 How can I resize a window if the window is larger than my
654     currect desktop? 
655 ----------------------------------
656 David Reviejo <dreviejo@arrakis.es> best summed up this answer: 
658      "Maybe you know:
659      Alt+Left click and drag
660      to move the window. 
662      Try this:
663      Alt+Right click and drag
664      to resize (by moving the nearest window corner) 
666      Another move/resize tip: while you are moving or resizing a window,
667      you
668      can change the move/resize mode by pressing the SHIFT key." 
673 3.7 How do I "undock" AppIcons? 
674 ----------------------------------
675 If the program is not running, just drag the icon to the middle of your
676 desktop (away from the dock and clip) and watch it disappear. 
678 If the program is running, hold down Meta (usually CTRL) and drag the icon
679 off the dock. You can also right click on it and choose 'Kill', then undock as
680 usual. 
683 3.8 I docked an application but when I run it the button is permanently
684     shaded and I can't run new instances.
685 ----------------------------------
686 You probably docked the application with dockit. To fix it
687 remove the icon and use the "Emulate Application Icon" checkbox in
688 the Advanced Options section of the Attributes panel for the window.
689 Then restart the application to get the application icon you
690 must use to dock the application. 
691 It can also mean that you did something you shouldn't, which is
692 changing the program that is ran from the docked icon. For example,
693 if you docked rxvt you must NOT change it to xterm, for example.
694 You also can't do any changes that might alter the contents of
695 the WM_CLASS hint for the window, like the -name parameter for
696 xterm, rxvt and other programs.
700 3.9 When I run wmaker it complains about not being able to load any fonts.
701 ----------------------------------
702 Check if the locale settings are correct. If you're not sure what to
703 do, unset the LANG environment variable before running wmaker.
705 TODO: give complete explanation
709 3.10 When I set the root background with wmsetbg by hand it works,
710      but when I do that from the configuration files it doesnt!
711 ----------------------------------
713 DOH! If you set the root background with wmsetbg by hand, it will obviously
714 find the image, since you have explicitly specified it by hand. But if you
715 simply put it in ~/GNUstep/Defaults/WindowMaker in some option like
716 WorkspaceBack, it will not find the image because Window Maker can't read
717 your mind to figure where you put the image. So, to fix it, you have to
718 either place the full path for the image in the texture specification or put
719 the path for the directory you put your background images in the PixmapPath
720 option. You can also put all your background images in places like
721 ~/GNUstep/Library/WindowMaker/Backgrounds or
722 /usr/local/share/WindowMaker/Backgrounds
723 These directories will be listed under the "Search Path" section of WPrefs.
727 -=-=-=-=-=-=-=-
728 Configuration:
729 -=-=-=-=-=-=-=-
731 4.1 What are those files inside my ~/GNUstep directory? 
732 ----------------------------------
733 ~/GNUstep/WindowMaker/WindowMaker 
735      The main config file. This file controls options such as keybindings,
736      fonts, pixmaps, and focus modes. 
739 ~/GNUstep/WindowMaker/WMWindowAttributes 
741      The Controls "attributes" for individual applications and appicons.
742      Options such as what icon to use are set here. For the most part, this
743      is now best accessed via a right click on a title bar of an application
744      and selecting "Attributes" 
747 ~/GNUstep/Defaults/WMState 
749      This is the file that is automatically generated and contains the current
750      dock settings. It is not recommended to edit this file by hand. 
753 ~/GNUstep/Defaults/WMRootMenu 
755      This file specifies what file to use as the root menu.  In Window Maker
756          0.19.0 and higher, you can replace this file with the one called plmenu
757          in ~/GNUstep/Defaults/WindowMaker, and you can then use WPrefs to edit
758          the menu.
761 ~/GNUstep/Library/WindowMaker/menu 
763      This is the file to edit to change your root menu. 
765 ~/GNUstep/Library/WindowMaker/plmenu
767          This is the same menu file, in property list format - WPrefs needs a
768          menu in this format if you wish to edit it using WPrefs.
773 4.2 How do I enable the normal X sloppy focus mode? 
774 ----------------------------------
775 In the ~/GNUstep/Defaults/WindowMaker, change the following: 
777 FocusMode = sloppy; 
780 4.3 How do I get my auto-arrange icons to work? 
781 ----------------------------------
782 In ~/GNUstep/Defaults/WindowMaker set AutoArrangeIcons=Yes; and the icons
783 should now auto-arrange. 
786 4.4 How do I get my Meta-Tab to cycle through windows correctly? 
787 ----------------------------------
788 Make sure that these settings are true in your ~/GNUstep/Defaults/WindowMaker
789 file: 
791 CirculateRaise = Yes;
792 RaiseDelay = 1; 
794 This will not give you MS Windows(tm) style application switching where
795 alt-tab is changes context. 
797 Paul Warren <<pdw@ferret.lmh.ox.ac.uk>> has released a patch that will
798 give this style of Context Switching to Window Maker. 
800 It is availible from http://ferret.lmh.ox.ac.uk/~pdw/patches/
803 4.5 How can I define my own Icon for a program? (instead of the
804     Icon the Application Supplies?) 
805 ----------------------------------
806 You can right click on the titlebar of the running app and choose the
807 "Attributes..." option, then click on the "Ignore client supplied icon"
808 checkbox. Click "Apply", "Save" and close the Attributes Editor. 
810 Another method is to edit ~/GNUstep/Defaults/WMWindowAttributes by hand and
811 use the AlwaysUserIcon=YES; option for the app. For example: 
813 xmcd = { Icon = "Radio.xpm";
814 AlwaysUserIcon=Yes;
815 }; 
818 4.6 How do I get a Tile background for my AppIcons (those things in
819     the dock)? 
820 ----------------------------------
821 You need to change 1 line to your ~/GNUstep/Defaults/WindowMaker file. 
823 IconBack = (spixmap, tile.black.xpm, white);
825 IconBack = (tpixmap, tile.black.xpm, white);
827 spixmap will scale the pixmap to fit the tile, tpixmap will tile it as is. 
829 As Random@efnet says, The last parameter is the color that fills in any
830 Transparent parts of your icon. 
832 IconBack takes other options too, search the NEWS file.
835 4.7 How do you dock <insert program here> that doesn't have an
836     appicon in the new version of Window Maker? 
837 ----------------------------------
838 There is now an option available to emulate appicons so that Window
839 Maker can dock just about anything now. 
841 To dock a misbehaving application, right click on the title bar and select the
842 attributes menu. Next, select the pull down menu's "Advanced Options"
843 item. Under the ``Advanced Options'' menu, select the ``Emulate
844 Application Icon'' Option then Save, Apply and close the dialog. 
846 This should allow you do dock the program normally. 
848 Emulate Appicon does exactly the same thing as dockit, a small app
849 distributed with ancient versions of Window Maker before the Attribute
850 Editor existed (now depricated for the obvious reason).  If Emulate Appicon
851 does not work, dockit will not work either.  Such applications violate the
852 ICCCM (Inter-Client Communication Conventions Manual) and are considered
853 badly coded for not setting the instance.class hints.
856 4.8 How do I get x11amp to not have a title bar? (or any other
857     program for that matter?) 
858 ----------------------------------
859 Right Click on the title bar and choose "Attributes". Click on Panel 2 and
860 click the "Disable titlebar" and "Disable resizebar" options. Click
861 "Save", "Apply" and then close the Attributes panel. 
863 By Default, to get back to the attributes menu once you've removed the
864 titlebar, hit the key F10 while the window is focused. 
866 Here is an example entry in ~/GNUstep/WMWindowAttributes for x11amp. 
868 x11amp={
869 Icon="x11amp.xpm";
870 NoTitlebar=Yes;
871 NoResizebar=Yes;
872 NoAppIcon=Yes;
873 }; 
876 4.9 How do I set a pixmap background? 
877 ----------------------------------
878 Here is the in depth explanation straight from the NEWS file: 
880 wmsetbg now accepts the following options: 
881 usage: wmsetbg [-options] image 
882 options: 
883 -d 
884               dither image
885 -m 
886               match colors
887 -t 
888               tile image
889 -s 
890               scale image (default)
891 -u 
892               update Window Maker domain database
893 -D <domain> 
894               update <domain> database
895 -c <cpc> 
896               colors per channel to use
900 By default, it will try to guess if dithering is needed or not and proceed
901 accordingly.
902 Using -d or -m will force it to dither or match colors. 
904 Dithering for more than 15bpp is generally not needed, and will only result
905 in a slower processing.
906 Don't use dithering except when needed, because it is slower. Else rely on
907 wmsetbg which will detect if dithering is needed and use it. 
909 -u 
910    will update the WorkspaceBack in the default database
911    domain file in ~/GNUstep/Defaults/WindowMaker, and let Window
912    Maker refresh the screen. Please note that this option only
913    works under Window Maker, and will have no effect under
914    other window managers, since it rely on Window Maker to
915    update the image after it reads the updated defaults
916    database.
918 -D 
919    <domain> is same as above, but will update the domain
920    <domain> instead of the default Window Maker domain.
922 -c 
923    <cpc> will set the color per channel to use. Only needed for
924    PseudoColor visuals. Window Maker will automatically pass
925    the value read from the Window Maker domain database.
929 The following line is straight from your WindowMaker-0.15.x
930 ~/GNUstep/Library/WindowMaker/menu file and should all be on one line. 
932 "Images" OPEN_MENU BACKGROUNDS_DIR
933 ~/GNUstep/Library/WindowMaker/Backgrounds WITH wmsetbg -u -t 
935 This should give you an idea on how to add other entries for different image
936 directories. See the help info at the top of the
937 ~/GNUstep/Library/WindowMaker/menu file for more information. 
939 If you for some reason would like to set your background image with XV, for
940 instance to use an image format not yet supported by wmsetbg or to use one
941 of XV's special modes, edit the file ~/GNUstep/Library/WindowMaker/autostart
942 and insert the line 
944 xv -root -quit -maxpect ~/background.jpg
946 xv -root -quit -max ~/background.jpg 
948 you can also try variations of this to get different tiling and other effects
949 (where X is a number 1-9 I believe):
950 'xv -root -quit -rmodeX ~/background.jpg' 
952 If you would like xv functionality in your menu, heres a nice little tip from
953 Alfredo: 
955 Add the following line to your ~/GNUstep/Library/WindowMaker/menu file. (all on
956 one line) 
958 "More Backgrounds" OPEN_MENU /home/whoever/backgrounds xv -root -maxpect -quit 
961 4.10 Can I put pixmaps in my root menu and title bars? 
962 ----------------------------------
963 With the release of WindowMaker-0.14.1, you can now put pixmaps
964 anywhere you would have either a gradient or a color. This means now that 
966 MenuTextBack=(tpixmap, foo.xpm, acolor); 
968 in ~/GNUstep/Defaults/WindowMaker will put the correct pixmap tiled in your
969 menu. 
971 FTitleBack = (spixmap, foo.xpm, black); 
973 Would have the effect of streching a pixmap to fit the titlebar of the active
974 window.
975 You can use png, gif, ppm, tiff, jpeg and xpm images interchangeably in
976 Window Maker if you have compiled in support for those formats. 
979 4.11 How do I get my Minimize Icon to look like the triangle I see in
980      screenshots? 
981 ----------------------------------
982 This involves a minor source tweak. Instructions are available at
983 http://wm.current.nu/tips.html#titlebar_icons
985 Example screenshot at 
986 http://wm.current.nu/themes/images/screenshots/Midnight3.jpg
989 4.12 How do I get superfluous bells and whistles working? 
990 ----------------------------------
991 Add Superfluous=YES; to your ~/GNUstep/Defaults/Windowmaker file. 
993 This option was added as a runtime option in Window Maker >= 0.16.1. 
996 4.13 How do I get the classic NeXT(tm)-like style back? 
997 ----------------------------------
998 Add NewStyle=NO; to your ~/GNUstep/Defaults/Windowmaker file. 
1000 This option was added as a runtime option in Window Maker >= 0.16.1 
1003 4.14 How do I get the window menu with only a two button mouse? 
1004 ----------------------------------
1005 Jim Noble <jmknoble@ntrnet.net> writes: 
1007 If you've got a two-button mouse under some versions of Solaris x86,
1008 there's no way (that i'm aware of) to emulate a 3-button mouse. The right
1009 button can be either MB2 or MB3, but chording doesn't work. 
1011             ApplicationMenuMouseButton = Left;
1013 and 
1015             WindowListMouseButton = Right; 
1016           
1018 in ~/GNUstep/Defaults/WindowMaker ought to allow the left button to
1019 activate the root menu, and the right button (as MB2) to activate the
1020 windows menu. 
1023 4.15 How do I edit my root menu? 
1024 ----------------------------------
1025 You can now use WPrefs.app 
1026 (see http://wm.current.nu/features/configuration.html for more info) 
1027 if you have the new PropList style menu, or you can manually edit the 
1028 oldstyle menu file 
1030             ~/GNUstep/Library/WindowMaker/menu
1032 (or you can also manually edit the newstyle menu file) 
1034             ~/GNUstep/Defaults/WMRootMenu
1036 and save your changes. Window Maker should detect the change and
1037 automatically update. If you are having a problem getting it to reload the
1038 menu, try 
1040             touch ~/GNUstep/Library/WindowMaker/menu
1042             (or 'touch ~/GNUstep/Defaults/WMRootMenu' for the newstyle menu)
1044 to force the modification time into the future. 
1047 4.16 How can I set dock/clip to use single click to launch
1048      applications, instead of double click?
1049 ----------------------------------
1050 This question was officially answered as follows:
1052     You cannot do this. This is because single click is used to select
1053     app-icons, or to raise/lower the app-icon or the dock/clip.  If
1054     this is impelmented then you will be unable to select or
1055     raise/lower dock/clip or app-icons, without also launching the
1056     application it represents.
1058     So don't ask for this to be implemented, because it will not
1059     be. Double click is used for a reason, is not just some weird idea
1060     we got in a morning when we wake up too early.
1062 Regardless of that, there is now an option in WPrefs, under "Expert
1063 User Preferences," which allows you to set "Launch applications and
1064 restore windows with a single click."  (See the files contrib/README
1065 and contrib/single_click.diff in the source package for details.)
1067 If you set that option, a left button single click will launch or
1068 restore, rather than select, the app-icon.  You can use other methods
1069 (or temporarily turn the option off again) to select app-icons or
1070 raise/lower the dock/clip.  You can toggle the selected state of any
1071 app-icon via its right button menu, and there are auto-raise and
1072 keep-on-top options for the dock and clip.
1075 4.18 How do I restore the configuration app to the dock?
1076 ----------------------------------]
1077 You should start it from a terminal using its full path name, which is
1078 /usr/local/GNUstep/Applications/WPrefs.app/WPrefs
1079 by default.
1082 4.19 How do I define my own icon for a program?  I don't like the one it
1083      supplies.
1084 ----------------------------------
1085 Right-click the titlebar of the running application and start the Attributes
1086 Editor.  Check the "Ignore client supplied icon" box.  "Apply" and "Save",
1087 and close the Attributes Editor.
1089 Another method is to edit ~/GNUstep/Defaults/WMWindowAttributes by hand and
1090 use the AlwaysUserIcon=YES; option for the app. For example: 
1092 xmcd = { Icon = "Radio.xpm"; AlwaysUserIcon=Yes; }; 
1095 -=-=-=-=-=-=-=-=-=-
1096 Other Applications:
1097 -=-=-=-=-=-=-=-=-=-
1099 5.1 How do I assign gimp an appicon? 
1100 ----------------------------------
1101 Window Maker now can assign Icons from within the windowmanager, to
1102 do so, right click on the title bar of an app or hit F10 while the desired app
1103 is focused, choose "Attributes...", click on the "4" Button, enter the icon file
1104 name (make sure this is in your pixmap path, or you can type in the full path
1105 without using ~/ type path names), click "Update", "Apply", "Save" and then
1106 close the Attributes Editor. 
1108 You can also enter the following line in
1109 ~/GNUstep/Library/WindowMaker/WMWindowAttributes: 
1111 gimp={Icon="gimp.xpm";}; 
1114 5.2 How do I get an appicon for XEmacs 20.3+? 
1115 ----------------------------------
1116 Thanks to Michael Hafner <hayfi@rz.fh-augsburg.de> for this answer. 
1118 You don't need to patch the XEmacs code, just run 
1120 ./configure --with-session=yes (in addition to any other options you use) 
1122 in your XEmacs 20.3+ sourcedir and rebuild it. Then XEmacs shows an
1123 appicon when running and you can easily dock it. 
1126 5.3 Where do you get that clock program I always see on people's
1127     desktops? 
1128 ----------------------------------
1129 Its called asclock. It was included with each version of Window
1130 Maker until version 0.17.5, and was no longer included in
1131 0.18.0 and above.
1132 You could find it in ./WindowMaker-0.xx.x/misc/asclock.tgz and it was
1133 prepatched to be able to dock. Some other (older) versions you might find
1134 on the net don't dock. 
1136 Since it was pulled from the distribution (probably to save space), I've
1137 included it at http://wm.current.nu/files.html#asclock for your convenience. 
1140 5.4 How do you dock asclock? 
1141 ----------------------------------
1142 asclock -shape -iconic -12 & 
1144 Drag it from the top right corner of the clock to the dock. Right click on the
1145 icon and select autolaunch.
1146 You have to drag the appicon by clicking on the edge of the icon, because
1147 the actual pixmap belongs to the app itself, and any clicks on the pixmap
1148 are interpreted by the app rather than X or the window manager. Therefor,
1149 you need to click somewhere on the appicon where the background tile
1150 shows through (usually the edges), and drag it that way. 
1153 5.5 How do you dock wmload? 
1154 ----------------------------------
1155 wmload -withdrawn -shape & 
1157 Then dock it similar to asclock. 
1160 5.6 What other apps exist for the dock? 
1161 ----------------------------------
1162 Several Nice applications are available: 
1164      wmmixer and wmcd and wmmount
1165      http://www.geocities.com/SiliconValley/Vista/2471/linux.htm#xapps 
1167      ascd,WMRack,asmixer,asmodem, and others
1168      ftp://ftp.windowmaker.info/pub/wmaker/contrib/srcs/apps/ 
1170      wmavgload, wmmount, and wmload
1171      ftp://ftp.windowmaker.info/pub/wmaker/contrib/srcs/utils/ 
1173      wmppp-wmifs, wmtime, wmmon and other nifty apps
1174      http://windowmaker.mezaway.org/ 
1176 A huge index of most available dockapps is available at:
1178          http://www.bensinclair.com/dockapp/
1181 5.7 How do I get an appicon for rxvt so I can dock it? 
1182 ----------------------------------
1183 The default rxvt that comes with most distribtions is an outdated version of
1184 rxvt. The newest development version of rxvt is availible from
1185 ftp://ftp.math.fu-berlin.de/pub/rxvt/devel/. As of the time of this writing, the
1186 version is 2.4.7 and it natively produces an appicon without a patch. 
1188 John Eikenberry has also created an rpm which is available from
1189 ftp://ftp.coe.uga.edu/users/jae/windowmaker/ 
1191 For your convenience, I have rxvt-2.4.7.tar.gz at
1192 http://wm.current.nu/files/rxvt-2.4.7.tar.gz for download. As of
1193 version 2.4.7, rxvt includes Window Maker support as well as John
1194 Eikenberry's NeXT scrollbar hack. 
1197 5.8 How do I get different icons for rxvt's (or xterms) running
1198     different programs? 
1199 ----------------------------------
1200 The simplest way is to run each rxvt with a different -name parameter. 
1202 For example, I want to run an rxvt for irc and one for mail. This is an
1203 example of what I'd do: 
1205 for the irc rxvt:
1206 rxvt -name "irc" -e "irc" 
1208 for the mail rxvt:
1209 rxvt -name "mail" -e "pine" 
1211 This would result in each rxvt now having the instance and class of irc.Xterm
1212 and mail.Xterm respectively, so that Window Maker can now set Attributes
1213 for them individually. 
1216 5.9 How do I launch multiple instances of XTerm from one appicon?
1217 ----------------------------------
1218 The easiest way to accomplish this is to dock XTerm as normal. Then Go
1219 to the 'Attributes menu' -> 'Application Specific' and select 'no application
1220 icon' for XTerm. 
1222 You can also right-click on the docked appicon and select settings. Change
1223 the 'Application Path with arguments' section to 
1225             foo.sh
1227 where foo.sh is the following script 
1229             #!/bin/sh
1230             exec xterm
1232 This should allow unlimited XTerms without appicon clutter. 
1235 5.10 How do I allow Alt+# to work in an rxvt session? (with irc for
1236      example) 
1237 ----------------------------------
1238 First, Launch a unique instance of rxvt or xterm.
1239 This can be done using the -name option of rxvt.
1240 For example: 
1242 rxvt -name foo -e irc 
1244 Then, go to the Attributes menu (right click on titlebar (or hit F10) and
1245 choose 'Attributes...')
1246 Then choose 'Advanced Options' from the listbox and enable 'Don't Bind
1247 Keyboard shortcuts'.
1248 Click 'Save' and 'Apply' and you should be able to run your session without
1249 the shortcuts. 
1252 5.11 Window Maker breaks scilab
1253 ----------------------------------
1255 If you refer to the problem of the "graphics" window of scilab not showing
1256 up in Window Maker, this is caused by a bug in scilab. You can see the
1257 cause of the problem by yourself, by running xprop on the graphic window:
1258 WM_NORMAL_HINTS(WM_SIZE_HINTS):
1259                 user specified location: 136679205, 1074468360
1260                 user specified size: 400 by 300
1261                 program specified minimum size: 400 by 300
1263 Now, when scilab opens it's window, Window Maker nicely does exactly what it
1264 is told, that is, map the window at position 136679205, 1074468360 which
1265 obviously falls outside the screen no matter how big is your monitor ;) 
1267 Meanwhile, the workaround for this is to open the window list menu
1268 (click on the root window with the middle mouse button) and click 
1269 on the ScilabGraphic entry. The window should be brought to your
1270 reach. Then, open the window commands menu (right click on window's
1271 titlebar) and open the Attributes panel. Go to the "Advanced Options"
1272 section, check the "Keep inside screen" option and save.
1274 If you can recompile Scilab, this came from a Scilab developer:
1276 replace 
1277  size_hints.flags = USPosition | USSize | PMinSize;
1278 with
1279  size_hints.flags = /** USPosition |**/ USSize | PMinSize;
1281 in routines/xsci/jpc_SGraph.c
1284 5.12 Netscape shows black and white icons
1285 ----------------------------------
1287 I have seen this happen on some systems if you run Netscape in a high
1288 colour depth (32bpp). That is a Netscape bug. Therefore, bug Netscape.
1291 5.13 Snow flakes from xsnow don't acumulate on titlebars!
1292 ----------------------------------
1294 Because of the way xsnow is coded, it seems that it can't "see"
1295 windows with the SaveUnder attribute turned on. So, if snow
1296 accumulation on windows is vital for you, disable SaveUnders in
1297 WPrefs, in the advanced options section.
1300 5.14 I'm using RedHat 6.0 and Netscape dies without reason.
1301 ----------------------------------
1303 Er... well, I don't know why you're looking in this Window Maker FAQ 
1304 for a RedHat/Netscape problem, but anyway, the answer is in:
1306 http://www.redhat.com/cgi-bin/support?solution&11-990511-0082&100-926468988&14-0&15-0&25-&3-&30-
1309 -=-=-=-=-=-=-
1310 Programming:
1311 -=-=-=-=-=-=-
1313 6.1 How do I get a normal X application to produce an appicon? 
1314 ----------------------------------
1315  You must define the WM_CLASS (XSetClassHint()) and the
1316 CLIENT_LEADER or XWMHints.window_group properties, which are
1317 automatically set by most applications that use Xt (Motif, Athena ...),
1318 but if you use plain Xlib you must set them by hand. 
1320 Also you must make a call to XSetCommand(dpy, leader, argv, argc); 
1322 Take a look at Window Maker-0.1x.x/test/test.c that is an example for
1323 writing such an app (which also have an app menu).
1326 6.2 How do I get my tcl/tk application to produce an appicon? 
1327 ----------------------------------
1328 Oliver Graf <ograf@fga.de> writes: 
1330 The main window (normally this is called '.' [dot] in tk) should use the
1331 following lines: 
1333 wm command . [concat $argv0 $argv] 
1334 wm group . . 
1336 All child windows attached to the same app-icon should use: 
1338 toplevel .child
1339 wm group .child . 
1341 where .child should be replaced by the actual window path. 
1343 Replace '.' with the actual main-window path and 'wm group .child .' should
1344 be added for each 'toplevel .child' call. 
1347 6.3 What is WINGs? 
1348 ----------------------------------
1349 WINGs Is Not GNUstep. ;) 
1351 It is the Widget Library written for the widgets in Window Maker. 
1353 It is currently under heavy development but several people have started
1354 writing applications in it. Its goal is to emulate the NeXT(tm)-style widgets. 
1356 http://www.ozemail.com.au/~crn/wm/wings.html is the closest thing to an
1357 information center about WINGs by <crn@ozemail.com.au>. 
1360 6.4 Where can I get more information about WINGs? 
1361 ----------------------------------
1362 Nic Berstein <nic@postilion.org> has created a WINGs Developement list. 
1364 The purpose of this list is to provide a forum for support, ideas,
1365 suggestions, bug reports etc. for the WINGs widget set library. 
1367 To subscribe to this list, send a message with the word ``subscribe'' in the
1368 _BODY_ of the message to: <wings-request@postilion.org>. 
1372 -=-=-=-=-=-=-=-=-=-=-=-=-
1373 Miscellaneous Questions:
1374 -=-=-=-=-=-=-=-=-=-=-=-=-
1376 7.1 Is there a pager for Window Maker? 
1377 ----------------------------------
1378 Not at the moment because there is not a pressing need for a pager. The
1379 concept of multiple desktops does exist and there are currently 3 ways to
1380 switch between them. 
1382 First, the Alt+Number combination will switch between desktops. The
1383 Workspaces menu will also let you switch workspaces. Lastly, the Clip will
1384 also scroll one through workspaces. 
1386 For those that would like to send an application to a specific workspace,
1387 either drag it to an edge of the desktop onto the next workspace or you can
1388 right click on the titlebar, choose "Move to..." and choose the appropriate
1389 workspace. 
1391 BUT, Window Maker does support KDE and GNOME protocols, including the
1392 workspace management stuff, so you can use Window Maker in these
1393 environments and use their pagers.
1397 7.2 Can I have folders like in AfterStep? 
1398 ----------------------------------
1399 No. Window Maker does however support the collapsable Clip per desktop
1400 for a similar functionality. 
1403 7.3 How do I use getstyle and setstyle? 
1404 ----------------------------------
1405 To capture the current Window Maker style, use the command 
1407             getstyle > current.style 
1408           
1410 To replace the current style, use the command 
1412             setstyle filename.style
1415 7.4 Why don't you distribute {normal diff, xdelta} patches? 
1416 ----------------------------------
1417 Whenever possible plain diff patches are distributed. If the new version has
1418 new binary files, normal diff won't be able to handle them, so a patch
1419 package is distributed, instead. We don't use xdelta because: - most
1420 systems do not have xdelta installed; - xdelta is picky and require the file to
1421 be patched to be exactly the same as the one used to make the patch. The
1422 patch package scheme used is much more flexible. 
1424 We do not distribute a simple diff with the binary files separately (and
1425 variations, like uuencoding the binary files) because: - it is more
1426 complicated and error prone to require the user to manually move the files
1427 to the correct places; - the current patch package scheme *does* distribute
1428 the binary files and diff files separately. If the user wants to install everything
1429 by hand, nobody will object to that; - sooner or later someone will certainly
1430 ask for a script to automate the file moving stuff. 
1432 So we hacked a script (mkpatch) that automatically creates a patch
1433 package with the normal text diff file, a list of removed files and the binary
1434 files that have changed or been added, plus a script that does the patching
1435 automatically. If you don't like the script, you can apply the patch and move
1436 the files manually. Or download the whole distribution. 
1439 7.5 Will you add GNOME or KDE support?
1440 --------------------------------------
1442 Support for GNOME (and KDE) hints is included since 0.50.0.  You have to
1443 enable them at compile-time using the appropriate arguments to ./configure.
1444 Please read the INSTALL file for more details.
1445 Note: starting with version 0.90.0, support for legacy Gnome-1.x and KDE-2.x
1446 was dropped in favor of NETWM support (used by both Gnome-2.x and KDE-3.x)
1449 -=-=-=-=-
1450 Themes:
1451 -=-=-=-=-
1453 8.1 What exactly are themes? 
1454 ----------------------------------
1455 Themes are a great aspect of Window Maker allowing a user to simply
1456 save the entire 'look' of their desktop in a Archive to distribute freely among
1457 friends, fellow users and/or the whole net in general. :) 
1459 See the theme-HOWTO at http://wm.current.nu/themes/theme-HOWTO.html 
1460 for an in-depth walk-through on making a Theme archive. 
1463 8.2 How do I install a Theme? 
1464 ----------------------------------
1465 This should be as simple as untarring the Theme.tar.gz into one of two
1466 places. You can untar it to the global /usr/local/share/WindowMaker/* directory,
1467 and have it be accessable to all users, or you can untar it to your own
1468 ~/GNUstep/Library/WindowMaker/ directory for your own personal use. 
1470 Use your favorite variation of the following: 
1472 gzip -dc "Theme.tar.gz" | tar xvf - 
1474 *(directory may differ on some systems) 
1477 8.3 How do I make a Theme? 
1478 ----------------------------------
1479 There is a neat little file called README.themes distributed with Window
1480 Maker that explains everything in intricate detail.  You can also read
1481 http://wm.current.nu/themes/themepacks.html
1484 ====================================================================
1485 and they lived happily ever after.
1486 ====================================================================
1487 (The End.)