added missing macro for bag
[wmaker-crm.git] / NEWS
blob900debffc7486b8a04901ff1975f86b0baef1665
2 NEWS for veteran Window Maker users
3 -----------------------------------
5 --- 0.62.0
8 Optimizations!!
9 ---------------
11 Code for converting wrlib images into X Pixmaps was optimized in many ways,
12 both in the original C code and in assembly for Pentium(tm) processors (with
13 and without MMX(tm)). Depending on the bit depth/color mode and CPU model,
14 performance increases can go up to 150%
17 NoBorder Window Attribute
18 --------------------------
20 The NoBorder window attribute (to be put in
21 ~/GNUstep/Defaults/WindowAttributes) was added and will remove the
22 1 pixel border around windows.
25 Removed "Keep Attracted Icons" option from Clip's menu
26 ------------------------------------------------------
28 Since this option brought more confusion than usefulness among users, and
29 since it was usable only in a very limited context, being able to fill up
30 the Clip very easily, it was removed.
31 An alternative way of gaining the same functionality is to use the "Keep icon"
32 entry in the Clip's main menu. Or select multiple icons before calling that
33 entry, to make it apply to more than one icon.
35 Note: "Keep icon", as the obsoleted "Keep Attracted Icons" had nothing to do
36       with holding icons in Clip, while the application is running. Once they
37       are attracted, they are kept until the application close. Using
38       "Keep icon", will only assure that the icon will be kept, even after the
39       application is closed.
41 Please don't ask for this option back. It's error prone, and very unintuitive.
42 Considering it's very restrictive usability, and it's very ambiguous topic, it
43 does not need a special entry in the Clip's menu, taking in count that there
44 are already better alternative ways of gaining the same functionality.
47 Removed DisplayFont Option
48 ---------------------------
50 The font for the geometry size will be controlled by the default
51 WINGs font (SystemFont in WMGLOBAL) now.
54 Others
55 ------
57 - added DONT_SCALE_ICONS compile time option
60 --- 0.61.1
62 New libPropList
63 ---------------
65 new libPropList-0.9.1 is REQUIRED to build Window Maker 0.61.1.
66 go grab it and install it first.
69 --- 0.60.1
72 Window Edge Attraction
73 ----------------------
75 Window edge attraction was now added.
77 Attraction = YES/NO;
79 will enable/disable gravity to edge's boder.
80 The strength of gravity can be controled by modify `EdgeResistance' value
81 in WindowMaker configuration file.
84 Titlebar Draw String Plugin
85 ---------------------------
87 FTitleColor, UTitleColor, PTitleColor, MenuTitleColor can be assigend with
88 drawstring plugin instead of plain color. For example:
90     FTitleColor = (
91         function,
92         libwmfun.so,
93         drawPlainString,
94         gold,
95         black,
96         gray49
97     );
99 will invoke function drawplainstring from libwmfun.so and pass 3 colors for
100 arguments. To code new plugin, please see plugin.h for more informations.
103 --- 0.60.0
106 User Menu
107 ---------
109 The user menu is now a compile time option disabled by default. 
110 Supply --enable-usermenu to configure to enable it.
113 root menu INCOMPATIBLE changes
114 ------------------------------
116 EXEC <program> will execute the named program
118 SHEXEC <command> will execute the shell command.
120 If you want to execute something like blabla > /dev/null, then use SHEXEC
122 Dont forget to update your menus.
125 New Option For setstyle
126 -----------------------
128 The --ignore flag will tell setstyle to not change the option that is
129 specified, when modifying the Window Maker configurations. For example:
131 setstyle --ignore MenuStyle sometheme.themed will cause the MenuStyle
132 option to not be changed.
134 setstyle --ignore FTitleBack --ignore UTitleBack --ignore PTitleBack bla.themed
135 will load the theme, but keep the titlebar background related options as
136 before.
139 MultiByte Text Support Changes
140 ------------------------------
142 The --enable-kanji configure option is not needed anymore and was removed.
143 To enable support for multibyte text, you must:
144 - set the LANG environment variable to the appropriate value
145 - change the font configurations to contain font sets in the appropriate
146   encodings in both ~/G/D/WindowMaker and ~/G/D/WMGLOBAL (for WPrefs)
147 - set the MultiByteText option to YES in both of the above files
150 New Options
151 -----------
153 WorkspaceNameDisplayPosition =
154 none/center/top/bottom/topleft/topright/bottomleft/bottomright
157 SmoothWorkspaceBack = YES/NO
159 will enable smoothing of scaled workspace background images.
163 Application User Menu Path Changes
164 ----------------------------------
166 Default configuration for user specific menus installed in
167 /usr/local/share/WindowMaker/UserMenus or $(datadir)/WindowMaker/UserMenus
168 and ~/GNUstep/Library/WindowMaker/UserMenus.
171 Omnipresent icons in Clip
172 -------------------------
174 Added ability to set icons docked in Clip to be omnipresent on all workspaces.
175 To set/reset this flag use the clip menu.
176 The Clip menu changed in the following way:
177  - if you bring up the menu from the Clip's main icon, it will contain as
178    before the "Rename Workspace" entry in the second position.
179  - however, if you bring up the menu from any other icon in clip, the
180    "Rename Workspace" menu entry is replaced by "Omnipresent" or
181    "Toggle Omnipresent" depending on the context.
183 This entry will work in the following way, depending on the context:
185 1. If there is no icon selected in the clip, then the menu will contain the
186    entry named "Omnipresent" which will be checked accordingly to the current
187    state of the icon (omnipresent or not), and will let you change the
188    omnipresent state of the icon you brought the menu from.
189 2. If one or more icons are already selected when the Clip menu is called, the
190    entry will be named "Toggle Omnipresent" and will apply to all selected
191    icons trying to toggle their omnipresent state. The icons which will be
192    succesfully changed to their new state as requested, will be unselected,
193    while the ones that will fail for some reason to gain their new state,
194    will remain selected.
196 In both cases if there is no success in setting what user requested a panel
197 will inform user of the failure.
198 (Note: trying to set an icon to not-omnipresent will never fail. Failures can
199        be met only when trying to set omnipresent for an icon).
201 The icons set to omnipresent will be marked with a triangle in the upper left
202 corner, having the color of the IconTitleColor.
204 An icon can be set to omnipresent, only if its position is free in all the
205 workspaces, else you will be informed of the problem and asked to fix it first.
206 Also when dragging an omnipresent icon around in Clip, all the icons docked in
207 all the workspaces are shown while the dragging is done, to let one easily see
208 where are free slots in all workspaces.
210 For advanced users, there is also a shortcut to set/reset the omnipresent
211 state of an icon: just use "Shift+MiddleButton" (button2) on the icon you want
212 to change.
213 In this case only the mark in the upper left corner will appear in case of
214 success, or nothing will happen if icon cannot be made omnipresent (advanced
215 users are expected to know why the icon failed to be made omnipresent, so they
216 don't need a panel to explain them why ;) ).
218 Now before you load your gun to start a flame war because this is against your
219 principles you love so much, please sit down and think that this is a feature,
220 which, if you don't use, the old behaviour of the Clip is totally preserved.
221 It just adds some extra capabilities to the Clip for people who think that this
222 is useful.
225 XDND drop on dock support
226 -------------------------
228 Support for XDE on dock is now replaced by XDND.
229 To enable, edit src/wconfig.h
233 --- 0.53.0
235 New Options
236 -----------
238 ** MenuStyle
240 MenuStyle=<style>; will change the menu texture style.
242 <style> can be:
243 normal (default): for the traditional one texture per item, with bevels in 
244 each
246 singleTexture: for a single texture that spans the whole menu, with bevels
247 in each item
249 flat: singleTexture without the bevels
252 ** ResizebarBack
254 ResizebarBack=<texture>;
256 where <texture> is any of the textures you normally use in titlebars and
257 other places.
259 If the style file/theme does not contain a ResizebarBack option, setstyle
260 will automatically hack it so that wmaker will make the theme work like 
261 before.
264 New crash dialog panel
265 ----------------------
267 From now on, whenever a fatal situation appears, Window Maker will display a
268 dialog panel to the user and let him choose what to do.
269 The options are:
270 - Abort and leave a core file (usefull for debugging and getting backtraces)
271 - Restart Window Maker (default behaviour)
272 - Start alternate window manager (the one defined as fallback, or if not
273   possible fvwm or twm in this order).
275 If it will not be able to restart or start the alternate window manager, it
276 will abort and leave the core file.
279 Application User Menu
280 ---------------------
282 Applications with an appicon can have a user defined menu.
284 This menu will emulate keyboard events, and will be sent to the applications'
285 window(s), thus the application must accept key combinations (CTRL+N for
286 instance).
288 To enable this feature, #define USER_MENU in src/wconfig.h and place menu
289 files in ~/GNUstep/Defaults/UserMenus (/usr/local/etc/WindowMaker/UserMenus
290 globally).
292 The user menu is in PropList format and the filename is in:
293 <instance name>.<class name>.menu or application's main window.
294 (Example: the menu for xcalc would be - xcalc.XCalc.menu)
296 Example user menu syntax:
299   "Calculator",
300   ("Put 1", SHORTCUT, "2"),
301   ("Functions",
302     ("Put 2", SHORTCUT, "2"),
303     ("Put 3,4 and 5", SHORTCUT, (3,4,5))
304   ),
305   ("Exit", SHORTCUT, "Control+q")
310 --- 0.52.0
313 Appearance Editing in WPrefs
314 ----------------------------
316 Added Appearance/Texture editing capability in WPrefs. Workspace background
317 selection is not yet finished.
320 Themes
321 ------
323 Removed all themes from the source tree, and moved them in a separate package.
324 You can download the new package from the same place as this package:
325 ftp://ftp.windowmaker.org/pub/beta/srcs/
326 Look after WindowMaker-extra-<version-number>.tar.gz
327 Also WindowMaker-extra pack include the old WindowMaker-data.tar.gz which only
328 contained icons.
329 Look for the greatest version number when you download this package.
332 get-wraster-flags script change
333 -------------------------------
335 The name of the options passed to get-wraster-flags changed, to allow a better
336 name compatibility with the naming conventions used by other software.
337 The name change was as follows:
338 --lflags was changed in --ldflags
339 To allow backward compatibility, with already written software, the old
340 --lflags option is still recognized, but you are encouraged to move the the
341 new --ldflags.
345 --- 0.51.2
348 New Themes
349 ----------
351 Added 2 new cool themes (actually I added in 0.51.1, but forgot
352 to put it here...) from largo (LeetWM) and BadlandZ (STEP2000).
355 Full Screen Maximization
356 ------------------------
358 The FullMaximize window attribute will allow the window to
359 be maximized to the full size of the screen (ignoring anything
360 like titlebar, resizebar, dock, panels etc). It should be usefull
361 for programs that must use the whole screen, like games or things 
362 like presentation programs.
365 --- 0.51.1
367 KDE Application Menu script
368 ---------------------------
370 wkdemenu.pl is a converter from KDE application menu structures to wmaker 
371 menu that can be used as a piped menu. Look wkdemenu.sh for how to use it.
374 Window Edge Resistance
375 ----------------------
377 Window edge resistance was now added. No, feature freeze hasn't been
378 removed. Its just part of the edge resistance rewrite ;)
381 New Theme
382 ---------
384 Added SteelBlueSilk theme
386 Installation Path Changes
387 -------------------------
389 Default configuration data installed in /usr/local/etc/WindowMaker
390 or $(sysconfdir)/WindowMaker
393 --- 0.51.0
395 Window Maker has become a GNU program (part of the GNU Project).
397 Title text drop shadow
398 ----------------------
400 drop shadow option added for titlebar text. This is a compile time 
401 option which needs to be defined in src/wconfig.h after you run
402 configure and before you run make.
404 New options and syntax for your WindowMaker domain file are:
406   Shadow = yes/no;
407   FShadowColor = <color>;  
408   PShadowColor = <color>;
409   UShadowColor = <color>;
410   MShadowColor = <color>;
412 The shadow option is dynamic (no need for a restart).
413 MShadowColor is for the menu title text.
415 libPropList
416 -----------
418 WARNING!!! libPropList was removed from the Window Maker distribution
419 and is being distributed separately. If you dont have it installed yet,
420 get it from ftp.windowmaker.org/pub/libs and install before building
421 Window Maker.
424 signal handling change
425 ----------------------
426 SIGHUP will exit wmaker instead of restarting it!!! This is because
427 GNOME expects the window manager to exit instead of restarting...
428 Complaints should go to gnome people. SIGUSR1 will restart wmaker now.
431 script change
432 -------------
433 WINGs-flags was removed, and replaced by get-wraster-flags.
434 Please remove WINGs-flags from your system, since it was obsoloted by
435 get-wraster-flags.
436 Continuing to use WINGs-flags can lead to hazardous effects, since is no
437 longer updated.
440 docklib
441 -------
443 docklib is a little library for making dock applets. It's in the
444 docklib-0.0.tar.gz file. Unpack it and read the README file there.
447 Option Changes
448 --------------
450 Removed OnTopTransients option
452 Added OpenTransientOnOwnerWorkspace
455 Olwm Hint Support
456 -----------------
458 OPEN LOOK(tm)/olwm hints support was added.
460 Read the appropriate section in the README file.
464 --- 0.50.1
466 New option for WorkspaceBack. mpixmap is the same as spixmap, but
467 it will scale the pixmap by keeping the aspect ratio (maximize or maxpect).
468 The option only works for workspace backgrounds.
470 Also added IGNORE_PPOSITION compile time flag, which is equivalent
471 to NoPPosition from fvwm. 
476 --- 0.50.0
479 KDE and GNOME
480 -------------
482 Added full support for GNOME and KWM hints. 
483 Read the INSTALL file to see how enable them.
485 Everything in the so called GNOME window manager bla bla bla pseudo-spec is
486 implemented.
488 As for KDE stuff, it implements 90% of everything kwm does, adds some
489 Window Maker specific extensions to it and still uses half of the memory
490 kwm does, which should be enough to let you dump kwm ;) For details on what
491 exactly is implemented, see comments in src/kwm.c Read the README.KDE file 
492 for more information.
495 WARNING: Some KDE hints are badly designed, so doing things like using
496 kpanel's desktop switcher/pager and Window Maker's internal workspace
497 management functions to create, destroy and rename workspaces at the same 
498 time might cause unknown effects. To be on the safe side, only
499 use either of them to manage workspaces. Switching workspaces is hopefully,
500 safe, so you can switch workspaces from wherever you want.
504 Workspace Specific Background Images
505 ------------------------------------
507 Use the WorkspaceSpecificBack to set background images for specific
508 workspaces. The WorkspaceBack is used as the default background image.
510 Example:
512 WorkspaceSpecificBack = ((solid, red), (cpixmap, ship.jpg, gray), (), 
513                                 (dgradient, red, blue))
515 This will set the background image of workspace 1 to (solid, 0),
516 2 to ship.jpg and 4 to a gradient. Workspace 3 and other workspaces
517 will have the image defined by WorkspaceBack.
519 Note that this uses quite some memory...
522 setstyle/getstyle
523 -----------------
525 setstyle now accepts the -nofonts flag, which will load the style
526 file ignoring all font related options.
528 Example:
530 setstyle -nofonts Blabla.style
533 getstyle can be used to create theme packs. See the usage in the
534 WindowMaker/README.themes file.
538 New Texture Type
539 ----------------
541 Textured gradients will tile a texture pixmap and combine it with a gradient, 
542 using an arbitrary opaqueness. 
544 Syntax is (thgradient, <file>, <opaqueness>, <color1>, <color2>)
545           (tvgradient, <file>, <opaqueness>, <color1>, <color2>)
546           (tdgradient, <file>, <opaqueness>, <color1>, <color2>)
547 where:
548 <color1> and <color2> are the colors for the gradient,
549 <file> is the texture file and
550 <opaqueness> is the opaqueness to merge the texture witht the gradient,
551 ranging from 0 to 255.
553 Example:
555 (thgradient, "BlueImage.jpeg", 120, white, black)
557 The BlackTexture style and Checker theme are examples.
559 Hints:
561 You can use any type of pixmap file for this, but small (like 64x32)
562 grayscale pixmap files should get the best results (fast and low memory
563 usage). You can use color pixmaps, but it is harder to get the desired effect
564 with them.
566 Be warned that this texture type is the slowest.
570 New Options
571 -----------
573 IconTitleBack and IconTitleColor control the color of the
574 miniwindow title. Both of them are colors.
576 Example:
577 IconTitleColor=white;
578 IconTitleBack=black;
581 Since this introduces an incompatibility in themes and getting flamed by the
582 themes ppl isn't the most pleasant thing ("Whaddafuk you're thinking!? You
583 just broke 500 themes!!!" ;) the setstyle command was hacked so that it will
584 make old themes work as before, by trying to automatically set the above
585 options. Note that in some cases it will not have exactly the same results as
586 before.
589 StartMaximized window attribute. Will maximize the window when it
590 is mapped.
593 AutoRaiseLower option for the Clip. This allows automatic Raise/Lower of the
594 Clip icons when the mouse pointer enter/leave the Clip. To avoid unwanted
595 raising/lowering there is a time threshold before raising/lowering.
596 The thresholds can be changed in wconfig.h by changing one or both of
597 AUTO_LOWER_DELAY and AUTO_RAISE_DELAY (expressed in miliseconds).
598 For example if you set AUTO_RAISE_DELAY to 0, then the Clip will be raised as
599 soon as the mouse pointer enters it's area. Setting AUTO_RAISE_DELAY to a very
600 big value, will make the Clip to practically do not auto raise unless clicked,
601 but to be automatically lowered after AUTO_LOWER_DELAY (ms) when leaved.
604 New ThemePack Format
605 --------------------
607 Starting with this version, a new format of themes is being supported.
608 Before you open pine and start composing your flame, rest assured that
609 the old format is still supported. The new format is documented
610 in the WindowMaker/README.themes file.
613 Root Menu 
614 ---------
616 The -noext option for OPEN_MENU will strip whatever is after the last .
617 in file names that appear on the opened directory. So,
619 OPEN_MENU ~/bg WITH xv -root -quit
621 will create a menu with all the images in ~/bg without the extension.
625 --- 0.20.3
628 Icon (miniwindow) stacking
629 --------------------------
631 If you want miniwindows to reside under normal windows, edit
632 wconfig.h and change WNormalLevel (just grep for it) to
633 WDesktopLevel
636 5 Button Mouse
637 --------------
639 If you have a 5 button mouse and want to give some utility for
640 the extra 2 buttons, edit the appropriate line in src/wconfig.h
641 Clicking Button4 in the root window will switch you to the previous 
642 workspace and Button5 will do that for the next.
645 Option Changes
646 --------------
648 put NoWindowOverDock back
650 KeepOnBottom window attribute
653 -static command line option
654 ---------------------------
656 wmaker -static will start Window Maker in static mode. This will
657 prevent wmaker from checking or making any configuration changes.
658 That makes it possible to run wmaker before running wmaker.inst
661 Hysteresis for menu item selection
662 ----------------------------------
664 Hopefully it's intelligent enough, so you won't notice it.
666 In case you want to know what's it, it's equivalent to that
667 (insanely long) 2 second delay present in that Windoze95 menu, 
668 but more usefull than annoying (I hope :). To see it, do the following
669 with your current wmaker version and later with 0.20.3:
671 - open the apps menu and stick it
672 - click in the item for the "Workspaces" submenu and hold
673 - drag the mouse to the 4th or bigger entry (like "Workspace 4") in a
674 straight line, trying to select the target item before the submenu
675 is unmapped when you dragged over other items in the main menu
679 Window Shortcuts
680 ----------------
682 Window shortcuts are shortcuts to arbitrary windows. You can make up to 4
683 shortcuts. To assign a previously bound shortcut to a window use the "Select
684 Shortcut" submenu in the window commands menu. If the shortcut is not yet
685 assigned for any window, you can hit the shortcut to assign it to the active
686 window. The shortcut will do the same as clicking in an entry in the window
687 list menu. The keys for the shortcuts are defined in the ~/G/D/WindowMaker
688 file or in WPrefs.app
690 Option names are:
692 WindowShortcut1Key through WindowShortcut4Key
695 --- 0.20.2
698 The name of WindowMaker was changed to Window Maker.
700 Window creation animation disabled by default.
702 xdaliclock -shape
703 -----------------
705 If you use it edit src/wconfig.h and #define OPTIMIZE_SHAPE or disable the
706 titlebar and resizebar for the window. OPTIMIZE_SHAPE will remove the
707 flickering for xdaliclock and other programs that change their shapes often,
708 but will increase network traffic considerably. So, if you use xdaliclock
709 from a remote machine it can get slow.
712 Applications Menu
713 -----------------
715 The applications menu will now use the shell in the SHELL environment
716 variable to execute EXEC menu commands. If it is unset (I think it's always
717 automatically set by the shell program) it will use /bin/sh
720 Extra fancy icon kaboom :)
721 --------------------------
723 Edit src/wconfig.h and #define ICON_KABOOM_EXTRA to get
724 more effects for the icon undocking animation.
726 Options for superfluous stuff are even more superfluous, so this
727 will not become runtime.
730 XDE drag and drop support
731 -------------------------
733 Support for XDE drag and drop was added (by "]d" <id@maliwan.org>).
734 To enable, edit src/wconfig.h
735 The support works with gtk 1.1.2
738 libPropList
739 -----------
741 libPropList will now be built automatically by wmaker. Wich means
742 the (simplified) building process is now:
744 ./configure
745 make
746 make install
748 instead of:
750 tar xzf libPropList.tar.gz
751 (cd libPropList; make)
752 make
753 make install
755 You also don't need to worry about GNOME libPropList incompatibilities
756 anymore. 
759 Bug with focus lost in sloppy focus fixed
760 -----------------------------------------
762 The bug only occurs in sloppy or auto focus modes, with AutoFocus disabled
763 and Superfluous enabled. There is no easy/clean way to fix this, so Window
764 Maker will disable the animation of window creation if the focus mode is
765 either sloppy or auto AND AutoFocus=NO.
767 If you want the animation, enable AutoFocus or use manual focus mode
768 (prefered). 
771 The NoWindowUnderDock option was removed
772 ----------------------------------------
773 To obtain the same result, use the "Keep Dock On Top" option in the dock menu.
776 Persistent Program Suplied Icons
777 --------------------------------
779 Application supplied icons are now stored, so that the dock will keep
780 showing them after the app is exited. The icons are stored at
781 ~/GNUstep/.AppInfo/WindowMaker/
784 Sound support
785 -------------
787 Sound support is now on by default. Even if you don't use sound the overhead
788 is very small, and has no impact on performance. If you still want to
789 optimize it and remove a few hundred of bytes, then use --disable-sound or
790 --enable-sound=no options when you configure Window Maker.
793 --- 0.20.0
795   
796 Multihead support. wmaker will now manage all screens that are attached to the
797 display. 
798 ------------------------------------------------------------------------------
799   
801 It does so from a single process (instead of spawning a new process for each
802 screen, like fvwm does). This keeps memory usage a lot lower than fvwm.
804 State files have a suffix .n, where n is the number of the screen.
806 Since I don't have a real multiheaded machine, it probably has bugs.
808 Superfluous
809 -----------
811 Yet another useless superfluous animation. Find out what exactly it is
812 by yourself :)
815 exitscript
816 ----------
818 ~/G/L/W/exitscript will be called automatically when wmaker is exited.
821 New runtime options
822 -------------------
824 1. Miniaturization animation is now selectable by a runtime option
825 Add a line with
827 IconificationStyle = <style>;
829 to your WindowMaker configuration file.
830 <style> can be one of: Zoom, Twist, Flip or None
831 Case doesn't matter, and default is Zoom.
834 2. Edge resistance.
835 This can be controlled by setting:
837 EdgeResistance = xxx;
839 in your WindowMaker configuration file.
840 xxx is an integer greater than 0 and represents the number of pixels of edge
841 resistance. Setting it to 0 (default) will disable this feature.
843 New theme
844 ---------
846 A new theme named Night, is available in this distribution.
850 --- 0.19.3
852 GIF support was added. You will need libgif 2.2 to use it.
854 cpixmap added. Syntax is the same as tpixmap or spixmap
857 --- 0.19.2
859 getstyle will include IconBack info in Style files.
861 --- 0.19.0
863 libPropList was updated. If you have it installed, you must upgrade or
864 WPrefs will crash because of bugs in libPropList.
866 New options
867 -----------
869 Balloons!
870 ---------
872 WindowTitleBalloons = YES;
873 will enable balloons for window titles that are not fully visible.
875 MiniwindowTitleBalloons = YES;
876 will enable balloons for miniwindow titles.
878 AppIconBalloons = YES;
879 for application icons (docked or not)
882 IconPosition
883 ------------
885 IconPosition (the position of the icons) is specified as:
887 IconPosition = c1c2c3;
889 where:
891 c1 can be t or b (meaning top or bottom)
892 c2 can be l or r (meaning left or right)
893 c3 can be v or h (meaning vertical or horizontal)
895 case is insensitive.
897 For example, 
898 IconPosition = blh;
900 is the old iconPosition position.
902 IconPosition = trv;
904 will place the icons over the Dock.
906 New window attribute
907 --------------------
909 EmulateAppIcon = YES; will make the window have an application icon.
910 Only use this option for fully specified windows (like rxvt.Rxvt).
911 NEVER use in generic window specifications (like * or rxvt).
912 You must restart the application for the attribute to take effect.
915 WPrefs.app
916 ----------
918 Read WPrefs/README
921 --- 0.18.1
923 Boolean balues have changed!!! YES, Y and any non-zero integer will
924 mean TRUE and anything else (including True) will mean FALSE. This
925 is to conform to the OpenStep values used for booleans and
926 not cause headaches later, when GNUstep apps also starts using
927 defaults and users will try using True wich won't get recognized.
930 --- 0.18.0
932 Clip
933 ----
935 Clip button layout was changed. IT IS TEMPORARY AND THE DEFINITIVE LOOK
936 WILL BE DIFFERENT!!!
939 libPropList
940 -----------
942 More bugs were fixed in it. Upgrade the library if you have an older version
943 installed, with the one included.
946 Property list menus
947 -------------------
949 Format for property list menus has changed! The redundant array for
950 submenus was removed, so a menu that looked like:
952 ( Applications,
953   ("Xterm", EXEC, "xterm"),
954   ( 
955     (Paint,
956         ("Gimp", EXEC, "gimp"),
957         ("XV", EXEC, "xv")
958     )
959   )
962 must be changed to:
964 ( Applications,
965   ("Xterm", EXEC, "xterm"),
966   (Paint,
967         ("Gimp", EXEC, "gimp"),
968         ("XV", EXEC, "xv")
969   )
974 Misc
975 ----
977 NUMLOCK_HACK is back. This time it works and is enabled by default.
978 If you think you don't need it and promise me that you won't send 
979 "bug" reports saying that shortcuts stop working after a while, you can
980 disable it ;) It will save some memory and CPU.
983 Configuration
984 -------------
986 Removed the SwapMenuButton option and added 3 finer grained options:
988 SelectWindowsMouseButton
989 WindowListMouseButton
990 ApplicationMenuMouseButton
992 Values that can be used are Left, Middle, Right and Button1 through Button5
993 Left is equivalent to Button1, Middle to Button2 and Right to Button3
996 Removed the WorkspaceChangeDelay option and corresponding action.
997 Removed AClipColor and IClipColor
1000 Added the SelectKey back
1003 Changed default binding of Window commands menu from F10 to Control+Escape
1005 --- 0.17.4
1007 Misc
1008 -----
1010 libPropList has changed! Upgrade it before compiling wmaker.
1012 Hopefully the bugs that caused wmaker to crash if an error is found
1013 in the config files is fixed. If you do crash wmaker with a bad
1014 file, please try to find out the smallest possible portion of the file
1015 that still crashes wmaker and send it to me.
1018 New Options
1019 -----------
1021 PixmapPath was split to PixmapPath and IconPath. PixmapPath is the path
1022 for the pixmaps used as textures and IconPath is for the icons. 
1023 Don't forget to add IconPath to your current configuration file.
1025 There's also a new library in ~/GNUstep/Library/Icons. You should place
1026 your icons there, since icons are not a WindowMaker specific resource.
1029 DontConfirmKill=YES; will disable the confirmation panel for Kill
1032 --- 0.17.3
1034 Interface Changes
1035 -----------------
1037 Unhide Here in the appicon menu was changed to be the first entry.
1038 This way you can unhide the appicon with a single click without
1039 even moving the pointer.
1042 Clip Commands
1043 -------------
1045 The collect icons commands was renamed to attract icons and
1046 the attract icons options was renamed to Auto attract icons.
1048 The Remove Selected Icons was renamed to Remove Icon(s). It will
1049 act as before if some icon is selected and will remove the clicked
1050 icon (without confirmation) if it is not.
1052 Added a Keep Icon(s) command that will keep the selected icons if
1053 any is selected and the current one if none.
1055 The Move To command was renamed to Move Icon(s) To.
1058 --- 0.17.0
1060 If you have libPropList installed, you might want to reinstall it,
1061 replacing with the included libPropList. It has a small bug fix.
1063 Misc. Changes
1064 -------------
1066 Removed --with-gnome and made MWM_HINTS defined by default.
1067 This means that "GNOME support" will work with no additional
1068 flags passed to configure. 
1070 Added support for KDE, by adding a DisableWorkspaceMouseActions option.
1071 Set it to YES and run krootwm to be able to use everything in kfm.
1074 Shortcuts for Root Menu
1075 -----------------------
1077 There is now a new SHORTCUT optional keyword for the menus.
1078 For example, you can bind Control-F1 to xterm with:
1080 "XTerm" SHORTCUT Control+F1 EXEC xterm
1082 or F2 to ARRANGE_ICONS with:
1084 "Arrange Icons" SHORTCUT F2 ARRANGE_ICONS
1087 All commands allowed in the menu file accept the keyword, except for
1088 MENU and OPEN_MENU
1091 Interface Changes
1092 -----------------
1094 ** Configuration of docked applications is now done in a panel instead of
1095 in the menu. 
1097 ** Added a command menu for application icons
1099 ** Shift double-click on the application icon will unhide the app
1100 in the current workspace.
1103 Option Changes
1104 --------------
1106 NotMiniaturizable option changed to NoMiniaturizeButton
1107 NotClosable option changed to NoCloseButton
1110 Speed options values are now UltraFast, Fast, Medium, Slow or UltraSlow
1111                                               ^^^^^^
1113 Removed the Select keyboard binding. You can access it in the window
1114 commands menu.
1116 Removed the ClipMaxIcons option and made it a compile time option.
1118 Removed the ConstrainWindowSize option
1120 Renamed NoSound to DisableSound
1122 Renamed NoAutowrap to DontLinkWorkspaces
1124 Renamed NoDithering to DisableDithering
1126 Renamed NoAnimations to DisableAnimations
1128 Removed the LeftHanded option and added a SwapMenuButton option.
1129 SwapMenuButton will make the rubberband selection in the root window
1130 be bound to the right button and the root menu to the left button.
1133 New way to display temporary icons
1134 ----------------------------------
1136 The icons that are attracted by Clip, but will not be kept after the
1137 application close, are now using a different color for shading, unlike previous
1138 version that always used white. This will improve look for very different color
1139 combinations, and allow the user to control the look of the shaded icon.
1140 The color used for shading the icons is computed as follows:
1142 First a color is computed depending on the IconBack type:
1143  - for solid the color is the solid color itself.
1144  - for simple gradients the color is (from_color + to_color)/2.
1145  - for multiple gradients, the color is the first color in list.
1146  - for pixmaps, the color is the solid color specified for that pixmap.
1148 Then the color is made lighter by multiplying each red/green/blue filed with
1149 1.7 and limiting each field to 0xff in case they exceed this value.
1150 Then this new color will be used by superposing it with the icon we want to
1151 shade, using a proper alpha value.
1153 To control the color for shading is simple:
1155 - In case of multi gradients you just need to put the first color, as the color
1156 you like. WindowMaker do not use the first color in the list to directly build
1157 the gradient, but only when it needs a solid color for something (like in this
1158 case).
1160 - For pixmaps, put the needed color as the solid color the syntax for pixmaps
1161 require. This color is also not used when displaying normal icons, just when
1162 solid colors are needed (like this case).
1164 - For solid color, or simple gradients, in case the color it uses after
1165 computing is not good enough, you can always convert the solid or simple
1166 gradient to a multi gradient with the same look, and use that one. In this
1167 case is simple, just put the needed color as first color in list.
1169 Please note that this will not slow down WindowMaker, because the IconBack is
1170 read only once at startup, and then only if it is changed. After reading it WM
1171 will construct the image of the tile, and use the image instead of recomputing
1172 the gradient every time.
1174 Here are 2 examples of converting solid or simple gradient to a same looking
1175 multi gradient:
1177 IconBack = (solid, Blue);
1178 will become
1179 IconBack = (mhgradient , LightBlue, Blue, Blue);
1180 using LightBlue as color for shading.
1182 IconBack = (dgradient, "#284569", "#082420");
1183 will become
1184 IconBack = (mdgradient, "#183454", "#284569", "#082420");
1185 looking the same, but using #183454 for shading.
1188 New Sound Server Location
1189 -------------------------
1191 The sound server new URL is http://www.frontiernet.net/~southgat/wmsound
1192 Also it seems to be running on FreeBSD too (with little changes maybe).
1195 --- 0.16.1
1197 WINGs
1198 -----
1200 The path for the WINGs resource files was changed. If you don't
1201 do make install, you must move /usr/local/share/WindowMaker/Resources to
1202 /usr/local/share/WINGs
1205 New Options
1206 -----------
1208 The following new options are available:
1209 NewStyle = Yes/No; (static) Replaces --enable-newstyle
1210 DisableDock = Yes/No; (static) Same as -nodock command line option.
1211 DisableClip = Yes/No; (static) Same as -noclip.
1212 Superfluous = Yes/No; (dynamic) Replaces --enable-superfluous.
1214 NOTES.
1215 - The static options are only read at startup. Changing them, needs to restart,
1216   so they will be accounted.
1217 - DisableDock and DisableClip have lower precedence than -nodock -noclip
1218   command line options. If both option/command line option are given, then the
1219   command line option will be accounted.
1222 Start Hidden option
1223 -------------------
1225 The start hidden option was fixed, and made to be an application wide option.
1226 It will apply to every window the application owns. Also its place in the
1227 Attribute Inspector panel, changed accordingly, to reflect this.
1228 The start miniaturized is however still applying to particular windows of an
1229 application, unless the option is set for the class.
1230 Start miniaturized, will override start hidden if both set.
1232 IMPORTANT NOTE.
1233 Because of the way Netscape Communicator is implemented, it is NOT possible
1234 to set the start hidden or miniatirized flags for it. This is because Netscape
1235 chooses to send a second map event to the window it maps. This makes the
1236 window to receive a second map request and to be unhidden or maximized back,
1237 immediately after it was hidden or miniaturized by WindowMaker at startup.
1241 --- 0.16.0
1243 Misc. Changes
1244 -------------
1246 The NextMenuBehaviour option was renamed to WrapMenus
1247 The WorkspaceTiedMiniwindows option was renamed to StickyIcons
1249 The .tif files were renamed to .tiff
1252 Selecting Mini Windows
1253 ----------------------
1255 Now miniaturized windows can be selected as well as normal windows.
1256 You can do this by Shift-Click-ing them. They will be marked, and will follow
1257 you through workspaces like normal selected windows do.
1258 Miniaturizing a window will no longer deselect the window, but will place the
1259 icon and mark it as selected.
1260 The only difference between miniaturized and normal window selection is that
1261 for the moment the rubber-band selecting method works only for normal windows.
1264 Icon Selection Panel in Attributes Editor
1265 -----------------------------------------
1267 Now, selecting icons is as easy as clicking in the file name in a list.
1270 Simplified Options
1271 ------------------
1273 IconSlideStep, IconSlideSlowDown and IconSlideDelay were merged to 
1274 IconSlideSpeed
1276 MenuScrollStep and MenuScrollDelay were merged to MenuScrollSpeed
1278 ShadeStep and ShadeDelay were merged to ShadeSpeed
1281 Valid values for them are: Fast, Normal, Slow or UltraSlow
1283 If you want to fine tune the values, they can be changed in wconfig.h
1284 Send me your set of values with an indication of how fast is your hardware,
1285 so that I can make the default values more adequate.
1288 New Window Attributes
1289 ---------------------
1291 Added StartMiniaturized and StartHidden as window attributes and
1292 removed the previous implementation. Also removed the dock menu entries.
1293 They are now settable in the Attributes Panel.
1295 Also added DontSaveSession attribute. This way, you won't end up with multiple
1296 unwanted copies of the same app after the previous session is restored.
1297 I start X with a xterm in .xinitrc instead of wmaker, wich will cause the
1298 xterm restored by wmaker be duplicate. Just add -name something to the
1299 xterm started form .xinitrc and mark DontSaveSession=YES for that window.
1303 User Specifiable Visual IDs
1304 ---------------------------
1306 wmaker now supports different visuals than the default one. It isn't of much
1307 use for most people, but can be usefull for lucky SGI users who want it
1308 to use TrueColor instead of the default PseudoColor.
1310 wmaker -visualid VISUAL_ID
1312 where VISUAL_ID is the hex code for the visual you want.
1314 Note: I don't have an SGI box and haven't tested it...
1318 Starting Workspace
1319 ------------------
1321 The starting workspace is identified in the following order:
1322 1. If the app is omnipresent will be mapped on the current workspace.
1323 2. Else if the application have a StartWorkspace option set as attribute
1324    then this one will be used.
1325 3. Else, if the application was started from Clip, the workspace on which
1326    the Clip from where it was started is used.
1327 4. Else the current workspace is used.
1329 Restoring saved sessions will always use the saved workspace, no matter
1330 what other options are, except onmipresent.
1334 --- 0.15.1
1336 Workspace specific mini windows
1337 -------------------------------
1339 The minimized windows can be workspace specific, being more consistent with
1340 the rest. This is because minimized window represents just another state of a
1341 window (like normal or shaded), which all are workspace specific.
1342 This (or the old "present anywhere") behavior can be set using an option in
1343 the WindowMaker database: WorkspaceTiedMiniWindows = Yes/No;
1345 New way to animate the blowing icons
1346 ------------------------------------
1348 There is now a compile time option that allows one to set how the icons are
1349 animated when detaching from dock/clip in superfluous mode.
1350 By default the classic "Falling pieces" animation is used.
1351 If SPREAD_ICON is #define-ed in wconfig.h, then a "Spread in four directions"
1352 animation is used instead. Take a look at the section where this is described
1353 in src/wconfig.h
1354 By default there is #undef SPREAD_ICON to select "Falling pieces" animation.
1356 Auto Colapse for Clip
1357 ---------------------
1359 The clip now supports an option named "Auto Collapse" which can be set from
1360 the clip main menu. When set, clip will stay collapsed, and will show itself
1361 when the mouse moves over it. While the mouse is over it, or over any of the
1362 icons attached to the clip, the clip will stay uncollapsed, letting you to
1363 access the attached icons. This is not true for applications like asclock, or
1364 applets of that kind, because the icon window do not belongs to WindowMaker,
1365 but to the application itself. For such icons you must keep the mouse over the
1366 icon groundplate, else it will collapse back. But usually these type of icons
1367 will not stay in a collapsed clip, since one needs to see what they show.
1368 When the clip is leaved it will collapse back after a delay of 1 second, unless
1369 the mouse is moved back to the clip area. The delay can be set modifying
1370 AUTO_COLLAPSE_DELAY in wconfig.h. Default is 1000 (ms) which means 1 second.
1375 --- 0.15.0
1377 Changed name from Fiend to Clip
1378 -----------------------------------
1380 All occurrences of word Fiend with or without capital F were replaced with
1381 the corresponding Clip (same capital).
1382 This affects all configuration files under ~/GNUstep that contain this word.
1383 It can be refered as "Workspace Dock" too.
1386 New option in Clip menu, and extended Clip behavior
1387 ---------------------------------------------------
1389 The following new items are available in the dock menu:
1391 1. Attract Icons
1392 2. Keep Attracted Icons
1393 3. Collect Icons
1394 4. (Un)select All Icons
1395 5. Remove Selected Icons
1396 6. Move To
1397 7. Start miniaturized    (also available for regular dock)
1398 8. Start hidden          (also available for regular dock)
1399 9. Selected
1400 10. Set icon...          (also available for regular dock)
1403 Here is what they do:
1405 1. "Attract Icons" will let the Clip to attract and attach any new appicon that
1406    is created when an application starts. It will not do this if the Clip is
1407    full. If the Clip is Collapsed then the appicon will be hidden after it is
1408    attached.
1409 2. "Keep Attracted Icons" will tell the Clip to keep the attracted appicons,
1410    after the application is closed. Without this the appicons will vanish,
1411    leaving the Clip in the original state. If you move an appicon that was
1412    attracted from Clip to regular Dock, it will be kept when closed, no matter
1413    what "Keep Attracted Icons" is set to in Clip.
1414 3. "Collect Icons" will collect all appicons that are not yet attached to Dock
1415    or Clip, and attach them to the current workspace Clip. The value of
1416    "Keep Attracted Icons" will apply when applications close. If Clip is
1417    collapsed, the appicons will be hidden.
1418 4. "(Un)select All Icons" will select all icons in the clip if none is
1419    selected, or it will deselect all selected ones. The selected icons are
1420    marked using a small triangle in the bottom right corner of the appicon.
1421    The color of the mark is set using SClipColor in WindowMaker domain
1422    database.
1423 5. "Remove Selected Icons" will remove from Clip all selected icons. The ones
1424    that still run, will be detached, all the others will vanish.
1425 6. "Move To" will transfer all selected icons to another workspace and attach
1426    them to the Clip in that workspace. If none is selected, only the one the
1427    mouse was pressed on will be moved.
1428 7. "Start miniaturized" will launch (or autolaunch if set) the application in
1429    a miniaturized state.
1430 8. "Start hidden" will launch (or autolaunch if set) the application in a
1431    hidden state. Note that only one of the two can be set at a time.
1432 9. "Selected" can be used to toggle the selected state of the appicon
1433    individually. The same can be achieved using Shift-LeftClick on the appicon.
1434    In fact the intended way of toggling the selected state is by using
1435    the Shift-LeftClick on icon. The menu entry is just another way to do the
1436    same.
1437 10. "Set icon..." will allow one to set the image for the appicon. The image
1438    will be updated without restart, and also all appicons in the same
1439    instance.class as the one we set for, will be updated.
1441 So a simple way of avoiding the screen to be filled up with appicons is to set
1442 the "Attract Icons" in the Clip. Also the "Keep Attracted Icons" can be set to
1443 No, so the attracted icons will be deleted when application exits, thus leaving
1444 the Clip clean. If also one to not want to see the appicons that keep filling
1445 the Clip, he can set the Clip to be Collapsed.
1447 Getting rid of unneeded icons in Clip is as simple as selecting them
1448 individually using Shift-LeftClick, and then using the "Remove selected Icons"
1449 entry in menu.
1452 Support for different visuals.
1453 ------------------------------
1455 WindowMaker is now able to support any visual, except DirectColor, in any
1456 depth from 1bpp to 32bpp.
1458 One can start the X server with different visuals, by passing the X server the
1459 right option. For XFree 3.3.x is -cc <id>.
1460 WindowMaker is not yet able to choose a different visual from the Default one
1461 on a given screen, but can use any default visual it finds, except the direct
1462 color visual.
1463 For example starting X like (for XFree 3.3.x, and if the driver for the
1464 card supports this. Read the man page for your X server):
1465 startx -- -bpp 8 -cc 0 will give you the StaticGray visual.
1466 startx -- -bpp 8 -cc 1 will give the GrayScale visual
1467 and so on.
1469 Wrlib code is now generic, and will support any visual except DirectColor in
1470 any depth. Programs written with wrlib can work on different visuals from
1471 the default visual for a given screen.
1472 Behavior in different visuals can be tested using the testgrad program in
1473 wrlib subdirectory in distribution.
1474 testgrad -h will show the usage.
1476 Multidiagonal gradients are also implemented now in wrlib, and a new algorithm
1477 is used to speed up the generation of diagonal gradients.
1480 New arrangement of the directory structure under ~/GNUstep/
1481 ---------------------------------------------------------------
1483 To better adapt to theme support the directory structure changed under
1484 ~/GNUstep/Library/WindowMaker
1486 1. Style directory moved to Styles.
1487 2. Added the following directories: Backgrounds, IconSets, Pixmaps, Sounds and
1488    Themes.
1489 3. The .style files no longer get copied in the user's Styles directory.
1490    Instead they are read from the global /usr/local/share/WindowMaker/Styles
1491    directory.
1493 Under ~/GNUstep/Defaults the following changes occurred:
1495 1. A default WMState is installed by wmaker.inst.
1496    It contains the dockit program assigned to the top icon of the dock, and
1497    the wmsetbg program assigned for the drop command on both dock's and clip's
1498    main icon.
1499    Double clicking the dock's main icon will bring up dockit that will let you
1500    dock any application that do not have an application icon.
1501    Dropping an image on dock's or clip's main icon, from an Offix DND aware
1502    application, will put the image on the background tiled, and will update
1503    WindowMaker domain database file.
1504 2. Syntax of WMState changed a little. The old position will not be restored
1505    when you will first start the new version, but after that it will be
1506    normally remembered. This is because now the main clip icons is only saved
1507    once, not for every workspace.
1508    You should replace Fiend with Clip in any place where it appears, if you
1509    want to keep the old WMState file, else it will not work.
1510 3. At compile time, it will detect if you have support for tif, and will
1511    install a WMWindowAttributes with corresponding image name extension
1512    (.tif or .xpm). This is true only for pixmaps that come with the source
1513    distribution and get installed under /usr/local/share/WindowMaker/Pixmaps
1515 The menu file changed a lot. Old menu file will *not* work with new theme
1516 support, so please upgrade.
1519 New behavior of OPEN_MENU command
1520 ---------------------------------
1522 The OPEN_MENU command now supports the following syntax:
1523 1. File menu handling.
1524    // opens file.menu which must contain a valid menu file and inserts
1525    // it in current position
1526    OPEN_MENU file.menu
1527 2. Pipe menu handling.
1528    // opens command and uses it's stdout to construct menu.
1529    // Command's output must be a valid menu description.
1530    OPEN_MENU | command
1531 3. Directory handling.
1532    // Opens one or more directories and construct a menu with all
1533    // the subdirectories and executable files in them sorted alphabetically.
1534    OPEN_MENU /some/dir [/some/other/dir ...]
1535 4. Directory handling with command.
1536    // Opens one or more directories and construct menu with all
1537    // subdirectories and readable files in them sorted alphabetically,
1538    // preceding each of them with command.
1539    // WITH is a required keyword!!!
1540    OPEN_MENU /some/dir [/some/other/dir ...] WITH command -options
1542 Please note that because of the 'WITH' keyword old menu files no longer work
1543 for the OPEN_MENU with a command.
1546 Theme support
1547 -------------
1549 Theme support is now as easy as untar-ing a tarball in the right place.
1550 Because of the way OPEN_MENU works, they can be installed on a global
1551 shareable basis, or for personal user use.
1552 Themes installed under ~/GNUstep will be available only for a user, but
1553 if if they are installed under /usr/local/share/WindowMaker they will be seen
1554 by all users. This is also true for style files, background images, pixmaps,
1555 etc that get installed under /usr/local/share/WindowMaker.
1556 Themes can be saved or loaded using the Appereance menu.
1558 Also support for different IconSets is available. You can save or load a new
1559 IconSet using the Appereance menu.
1561 Setting background images is now as simple as putting the images in the right
1562 place (~/GNUstep/Library/WindowMaker/Backgrounds or
1563 /usr/local/share/WindowMaker/Backgrounds, or any other place in your
1564 PixmapPath). Then use the Appereance menu. They will be instantly available
1565 since they are opened by a OPEN_MENU command. Also the image do not need to
1566 have a .jpg or any other extension. It will be recognized anyhow.
1567 As an example please see the OpenStep theme supplied with WindowMaker.
1568 The OpenStep image is a jpeg file without extension.
1570 Please keep in mind that anything under /usr/local/share/WindowMaker will be
1571 available for all users.
1574 New options for wmsetbg and getstyle
1575 ------------------------------------
1577 wmsetbg now accepts the following options:
1578 usage: wmsetbg [-options] image
1579 options:
1580  -d             dither image
1581  -m             match  colors
1582  -t             tile   image
1583  -s             scale  image (default)
1584  -u             update WindowMaker domain database
1585  -D <domain>    update <domain> database
1586  -c <cpc>       colors per channel to use
1588 By default, it will try to guess if dithering is needed or not and proceed
1589 accordingly.
1590 Using -d or -m will force it to dither or match colors.
1592 Dithering for more than 15bpp is generally not needed, and will only result
1593 in a slower processing.
1594 Don't use dithering except when needed, because it is slower. Else rely on
1595 wmsetbg which will detect if dithering is needed and use it.
1597 -u will update the WorkspaceBack in the default database domain file in
1598    ~/GNUstep/Defaults/WindowMaker, and let WindowMaker refresh the screen.
1599    Please note that this option only works under WindowMaker, and will have no
1600    effect under other window managers, since it rely on WindowMaker to update
1601    the image after it reads the updated defaults database.
1603 -D <domain> is same as above, but will update the domain <domain> instead of
1604    the default WindowMaker domain.
1606 -c <cpc> will set the color per channel to use. Only needed for PseudoColor
1607    visuals. WindowMaker will automatically pass the value read from the
1608    WindowMaker domain database.
1611 getstyle now have the -t option, that instructs it to read all options
1612 related to theme. Without -t getstyle will read only style options that
1613 means it will not read WorkspaceBack and IconBack.
1614 Use -t when you want to make a theme and need all theme options to be saved.
1615 Else it will extract just a style file.
1618 Session management support
1619 --------------------------
1621 Two new commands are available for use in menus:
1623 SAVE_SESSION and CLEAR_SESSION.
1625 SAVE_SESSION:
1626 will take a snapshot of all running applications, and their current hints
1627 (shaded, hidden, minimized, geometry and workspace they are on),
1628 and save it inside the WMState file. Also the current workspace we are on is
1629 saved. The applications that are running and were started from dock or clip are
1630 marked, so they will be attached to the corresponding dock/clip when restored.
1631 This state is restored every next session, until a new one is saved or
1632 CLEAR_SESSION is used.
1634 CLEAR_SESSION:
1635 will clear any previous saved session.
1637 There is also a run time option named SaveSessionOnExit = Yes/No; that allows
1638 one to automatically save the state of desktop when leaving WindowMaker.
1639 This way next session, the state of the desktop before last exit is restored.
1641 Please note that if this option is set to Yes, than any manual saving of the
1642 state, or any clearing of the state will be overridden when exiting
1643 WindowMaker.
1645 These options are available under the "Workspace" menu.
1648 User WindowMaker configuration files are now merged with global ones
1649 --------------------------------------------------------------------
1651 When starts WindowMaker will look for database domain files under
1652 $GNUSTEP_USER_ROOT/Defaults or ~/GNUstep/Deafults to be read. (In this order).
1654 If they are not available then it will scan for them in
1655 $GNUSTEP_LOCAL_ROOT/Defaults, $GNUSTEP_SYSTEM_ROOT/Defaults or
1656 /usr/local/GNUstep/Defaults (in this order).
1658 Even if the file was found or not, it will always load the corresponding domain
1659 file under /usr/local/share/WindowMaker/Defaults.
1661 Then if the user file was found it will merge it over the global file, else
1662 the global file will be used.
1664 This way any settings that are set by the system administrator in the shared
1665 file will be available for users that do not have them in their config files.
1666 Any option the user have in his config file will override the one in the
1667 shared domain file.
1669 So any new runtime options that appear in WindowMaker domain, do not need to
1670 be set in all user files, except the ones the user wants a different behavior
1671 from the default set for all users in the shared file.
1673 Also it is possible for the user to not have any personal domain databases, and
1674 the global shared ones will be used, but it still needs to have the directory
1675 structure, so WMState gets written on session exit.
1676 So all it needs to have is ~/GNUstep/Defaults directory available.
1679 New behavior of the Slide Icons
1680 -------------------------------
1682 Animation constants are now runtime.
1683 They are:
1684 IconSlideDelay = 0;
1685 IconSlideStep = 5;
1686 IconSlideSlowDown = 50;
1688 To better adapt both slow and fast machines the behavior of sliding icons
1689 changed in the following manner:
1691 Old one was to keep moving the icon with a constant step (default 5 pixels)
1692 until it reached the destination.
1694 Now it will use a new parameter named IconSlideSlowDown to speed up or slow
1695 down the moving.
1697 Instead of moving it with a constant step it will use IconSlideSlowDown to
1698 divide the distance to the destination, and use this value as the first step.
1699 Then is will compute the remaining distance and will again use
1700 IconSlideSlowDown to divide it and get the new step. And so on.
1701 When the step to move becomes smaller than IconSlideStep, IconSlideStep will
1702 be used further until the destination is reached.
1704 This way a nice deceleration effect is achieved, since while the icon
1705 approaches destination, it will use smaller steps, gibing the illusion that
1706 the icons is moving slower.
1708 IconSlideDelay will give the pause between steps, and is expressed in ms.
1710 Giving large values to IconSlideSlowDown (>1024 for 1024x768 screen) will
1711 result in the old "constant step advance" behavior, since the computed step
1712 will always be smaller than IconSlideStep, and the last will be used instead.
1714 Making IconSlideSlowDown = 0 or 1, will result in an instant jump to the
1715 destination without any animation.
1718 Attribute editor
1719 ----------------
1721 Because the icon images on screen automatically update after any change in
1722 WMWindowAttributes domain file, the use of both Save and Apply buttons is no
1723 longer needed. If one wants to just apply the setting to the current window
1724 only, he will only use the Apply button.
1725 If he wants them saved for all applications in the same instance and/or class
1726 the using the Save button will write them to disk, and automatically
1727 WindowMaker will update all the icons that need to be updated on screen.
1730 Sound support
1731 -------------
1733 Some basic sound support is now part of WindowMaker. The sound server is not
1734 yet part of WindowMaker distribution, so you need to download it separately.
1735 This is because is linux specific, and need some changes before it can be
1736 included.
1737 Until them if you have a linux system and want to use sound, use the
1738 wmsound-0.5 available at http://www.geocities.com/SiliconValley/Bay/7874
1739 Download that package, and only build the sound server there.
1740 DO NO APPLY ANY PATCHES FROM THERE!, because they are already applied.
1741 Just build the sound and copy the executable in /usr/local/bin
1742 Follow the rest of the install steps described there, except the patch-ing
1743 procedure.
1745 To enable sound for WindowMaker pass --enable-sound to configure.
1747 Also use NoSound = Yes/No; to enable/disable sound at runtime without killing
1748 the sound server.
1750 If you cannot set the sound to work yet, then is not for you.
1751 Wait until the sound server will be fixed and will be part of WindowMaker.
1754 New entries in WindowMaker domain database
1755 ------------------------------------------
1757 The following entries have been added to the runtime options:
1759   SaveSessionOnExit = No;
1761 will autosave (or not) the session state on exit.
1763   WindowPlaceOrigin = "64, 64";
1765 will offset all windows in auto or cascade placement mode with the value
1766 (in pixels) before placing them on screen. First is horizontal direction and
1767 second is vertical.
1768 This do not apply to windows that request a specific position on screen.
1769 This is useful if you want your Clip on the top left corner to not be
1770 overlapped by mapping windows.
1771 It will let it to have a row and a column of docked appicons near the screen
1772 edge, that will not be overlapped by windows.
1773 If you set it to "128, 128" it will have 2 rows and 2 columns not overlapped.
1776   NoSound = No;
1778 Enable/disable sound at runtime without the need of killing the sound server.
1781   MenuScrollDelay = 10;
1782   MenuScrollStep = 5;
1784 Constants for the menu scrolling animation.
1786   IconSlideDelay = 0;
1787   IconSlideStep = 5;
1788   IconSlideSlowDown = 50;
1790 Constants for the icons sliding on screen. Explained above.
1792   ShadeDelay = 0;
1793   ShadeSteps = 15;
1795 Animation parameters for shading a window. How many steps it will take, and the
1796 delay between steps in ms.
1798   DoubleClickTime = 250;
1800 The time for the double click to be considered so. Expressed in ms.
1802   SClipColor = "#6f8ae2";
1804 Color for selected icons in Clip.
1806 All delays are expressed in ms.
1810 --- 0.14.1
1813 *** Enhanced fiend clone.
1815 Here are the new fiend features:
1816 1. Keys for raising/lowering the fiend, and their default values:
1817    FiendLowerKey = None;
1818    FiendRaiseKey = None;
1819    FiendRaiseLowerKey = None;
1821    All reside in WindowMaker configuration file.
1823 2. Added posibility to launch the workspace menu with button1 click on the
1824    idle indicator of fiend, or with button3 click on workspace name on the
1825    fiend.
1827 3. Added Control-button1-click on fiend's idle indicator, to create a new
1828    workspace and move to it. Same action as New item in Workspace menu.
1830 4. Fiend's idle indicator do have a color that reflects its normal/collapsed
1831    state.
1833 5. The delay between changing workspaces from fiend is now a runtime option:
1835    WorkspaceChangeDelay = 700;
1837    in WindowMaker configuration file.
1839 6. Application icons can be moved between dock and fiend now.
1841 7. The way workspaces are changed is controlled now by two runtime options:
1843    AdvanceToNewWorkspace=Yes/No;
1844    CycleWorkspaces=Yes/No;
1846    Both apply to either fiend navigating buttons or to next/prev worksapace
1847    keybindings. Both default to No, and are in WindowMaker configuration file.
1849 8. Also added posibility to advance to new workspace, no matter what value
1850    AdvanceToNewWorkspace have, with Control-button1-click on "next workspace"
1851    fiend button.
1854 *** Theme support ***
1856 Spixmap and tpixmap now work. Their syntax is:
1858 SomeStyleOption = (spixmap, file, color);
1859 SomeStyleOption = (tpixmap, file, color);
1861 - spixmap means scaled pixmap, so the image in the file will be scaled to
1862 adapt to the destination's size.
1863 - tpixmap means tiled pixmap, and the image from file will be tiled in the
1864 destination.
1866 file is searched in the PixmapPath, but can be a full path name.
1868 Color is used depending on which Style option is applied.
1869 For example in case of titlebars, color is used for miniwindows titles color.
1870 You are not restricted in selecting that color, but is better to put one
1871 that matches the overall color of the image.
1873 Currently they apply to all the options that accept (solid, color), or any
1874 type of gradient.
1875 This means they also apply to WorkspaceBack and IconBack, which allows theme
1876 support with the simple use of the setstyle and getstyle utilities.
1877 There is no need for an extra theme manager, just to include the needed
1878 options in the style files.
1880 In case of WorkspaceBack, color is used to be set in the background until
1881 the image gets loaded and displayed. This is to avoid the stippled screen
1882 the X server shows, in case the image is big and loads slow.
1883 There is a small utility in the util directory, named wmsetbg which is
1884 used to set the background image. This is needed for windowmaker not to
1885 freeze while loading and scaling the image.
1886 Currently it is hardcoded in windowmaker to use wmsetbg to set the background
1887 image, and is better to use it since is smaller that other image manipulation
1888 programs, and it is compiled with support for same image types as windowmaker.
1889 Since it comes and is installed with WindowMaker, there will be no need to
1890 download and use an external app, which also may not have support for the same
1891 image types as windowmaker.
1895 --- 0.14.0
1897 *** Fiend clone.
1899 The fiend clone is a dock extender, that lets you dock more than the default
1900 10-12 icons in the dock. It actually lets you dock how many icons you like,
1901 with a current default of 25 per workspace. The fiend have different docked
1902 icons on every workspace. Also the fiend main icon shows you the workspace
1903 you're on and lets you navigate through the workspaces with the small green
1904 buttons on the low right corner.
1905 To save screen space the fiend can be collapsed to the main icon either
1906 from the fiend menu (available with right click on the fiend icons), or
1907 with a double left click on the main fiend icon, which is a toggle for
1908 the collapsed/uncollapsed state.
1909 Collapsed state is marked by a different title color.
1910 Pressing on the small buttons on the low right corner, the workspaces are
1911 changed in increments of 1 to the left or right, but keeping the button
1912 pressed over them will continuously advance through workspaces until the
1913 mouse is moved away from the buttons or the button is released.
1914 The delay between workspace changes is set by FIEND_WKS_CHANGE_DELAY in
1915 src/wconfig.h, and defaults to 700 ms.
1916 Unlike the dock, fiend can hold icons in any directions, and can be placed
1917 in any position on screen.
1919 When an icons is to be docked, but the position can be either in the dock
1920 or in the fiend, the dock will be used first, and the icon will be docked
1921 there.
1923 Here are the new runtime options introduced by the fiend:
1924 Files are located in ~/GNUstep/Defaults/
1926 In WMWindowAttributes:
1927        "Logo.WMFiend" = {Icon = "Cone.xpm";};  - icon for the fiend
1929 In Windowmaker:
1930         FiendMaxIcons = 25;           - the max number of icons in fiend per
1931                                         workspace
1932         FiendTitleFont = "-*-helvetica-bold-r-normal-*-10-*-*-*-*-*-*-*";
1933                                       - the font used to show the current
1934                                         workspace
1935         FiendTitleColor = black;      - color for the uncollapsed fiend title
1936         CFiendTitleColor = "#616161"; - color for the collapsed fiend title
1937         AFiendColor = "#00ba70";      - color for the workspace changing
1938                                         buttons, when active
1939         IFiendColor = "#008000";      - color for the workspace changing
1940                                         buttons, when idle
1942 For the ones who don't want to use fiend, there is a option to wmaker named
1943 -nofiend that can be feed to the command line when starting wmaker.
1944 (This is the equivalent for -nodock, but removes fiend clone).
1946 The syntax of WMState file have changed, but you don't have to worry because
1947 WindowMaker will know to read the old format and will save it and further
1948 will use the new one. You do not need to change your file, for the new version
1949 to work.
1952 --- 0.13.1
1954 *** Enhanced Attribute editor.
1956 Now you can save defaults for all windows.
1957 Please note that only Icon, KeepInsideScree, and sometimes NoAppIcon
1958 can be useful in a normal environment. But others may have other opinion ;)
1959 If you set AlwaysUserIcon default for all windows, note that apps like
1960 asclock, wmload, wmmail, wmrack, will show that icon instead of their
1961 window.
1963 Now Attribute editor also counts for defaults saved for all windows,
1964 (not only the default "No" for all options hardcoded in WindowMaker),
1965 when saving options for some instance.class specification. This is to
1966 save disk space by saving only the options that differs from global defaults
1967 (either defaults for all windows or the hardcoded valued in WindowMaker).
1969 Attribute Editor now updates on the fly the appicon image or creates/deletes
1970 the appicon if you set that options in the Inspector panel and Apply them.
1971 Modifying Icon file, NoAppIcon or AlwaysUserIcon and Applying them will
1972 result in the image update for the app-icon.
1974 Note that if you apply but not save these options, the miniwindow image will
1975 not be updated. This is because app-icon is always on screen so it can be
1976 updated, but miniwindow image is read from the defaults database and from disk
1977 every time you minimize the window and is destroyed when you restore.
1980 --- 0.13.0
1982 *** Atribute editor is working ;).
1984 How it works is quite obvious.
1985 Anyway, here is a short description.
1987 Save   - only save the configuration in defaults database and updates
1988          WMWindowAttributes
1989 Apply  - only applies the values to the current window
1990 Revert - reverts the values from the defaults database
1992 Note that Save and Revert count for the window specification
1993 (instance & class), that are selected, and save/use the values for/from
1994 that.
1996  The Update button will show the icon who's name was typed in the textfield
1997 If the textfield is empty, will try to use the default icon.
1998 Also saving with and empty textfield for icon, uses the default icon.
2000  The Default button will use the icon in the textfield as default icon
2001 and save that value in WMWindowAttributes (Note that in this case is no
2002 need to press the Save button!). Also if the textfield is empty it will
2003 try to use the old default icon, if available.
2005 *** Now menus are saved between sessions, or over a restart.
2007  Just stick them to the desktop, and you will find them over sessions
2008 until you close them.
2009  Please note that only the root_menu, the window switch_menu and the
2010 workspaces_menu can be saved this way.
2012 *** Changed the lousy Windoze menu behaviour.
2014 This applies to 'NextMenuBehaviour = NO;'
2016  Now the items are no more automatically selected if you launch the menu
2017 and the mouse is over some item, if you use a short click to launch the
2018 menu (shorter than the default DBL click time).
2019  If you use a longer click or keep the mouse pressed, the item under mouse
2020 will be selected after that delay, and launched when you will release the
2021 mouse button.
2022  If the click was short, a second one is needed to launch the item.
2024 *** Autoarrange icons is now a runtime option
2027 AutoArrangeIcons = YES/NO;
2028 in 'WindowMaker'.
2030 *** Added configurable horizontal resize threshold
2033   HorizontalResizeThreshold = <n>;
2035 This will make the n pixels at the exterior side of the corner handle
2036 of the resize bar to restrict to horizontal only resize.
2037 Also you can use Shift-click&drag anywhere on the corner handle to
2038 restrict the resize only to horizontal.
2039 Note that the Shift-click&drag does not depend of the configured threshold
2040 and works completely independent.
2042 *** New option for OPEN_MENU (pipe from command)
2044 OPEN_MENU | /foo/bar/script
2046 will make a menu that is dinamically constructed by /foo/bar/script
2049 --- 0.12.0
2051 *** New option for OPEN_MENU
2053 OPEN_MENU /foo/bar/pics xv -root -quit
2055 will make a menu with all files in /foo/bar/pics and precede them
2056 with EXEC xv -root -quit
2058 thus, making a menu with entries like:
2061 "marble.gif" EXEC xv -root -quit marble.gif
2062 "water.jpg" EXEC xv -root -quit water.jpg
2066 *** Multicolor gradients
2068 (mhgradient, colorX, color1, color2, color3, ..., colorn)
2069 (mvgradient, colorX, color1, color2, color3, ..., colorn)
2071 You can put any number of colors >= 2. 
2073 colorX is a special color that is used as the solid color of the
2074 texture when wmaker needs a solid color (like in miniwindow title and
2075 resizebar)
2077 *** PixmapPath format changed
2079 What used to be
2081 PixmapPath = "/usr/local/share/pixmaps:~/foobar";
2083 must now be
2085 PixmapPath = ("/usr/local/share/pixmaps", "~/foobar");
2088 *** Added OffiX DND in dock
2090 Use the "Set drop arguments..." command in the menu and put a %d
2091 where the dropped object string should be substituted, like:
2093 xedit %d
2095 *** Escape thingies for menu and dock commands:
2097 %w - substitute with current selected X window ID
2098 %s - substitute with current selection
2099 %d - substitute with last dropped object
2100 %a(some text) - opens a input box with "some text" as a title. Then,
2101 the text typed will be substituted there
2103 \r, \n - substitute with corresponding characters
2106 *** The WMState file format has changed a little.
2107 The Command field for the dock application list is now a normal string,
2108 instead of a list. So, remove the parentheses and the commas for the command
2109 and join all the parts. Example:
2111 if it used to be
2113 Command = ( xterm," -geometry", "+10+10" );
2115 then make it
2117 Command = "xterm -geometry +10+10";
2120 --- 0.10.2
2122 AutoFocus = NO; disables automatic focusing of windows
2123 when they are first mapped
2126 --- 0.10.1
2128 titlebar gradients are in a single piece now
2130 the WMDock file was merged into the WMState file. You can insert this
2131 file in WMState and set it's key to Dock. For example, if your WMDock
2132 contains:
2135         Applications = { {Command = (); }};
2136         Position = "-64,0";
2137         Lowered = NO;
2140 and WMState contains:
2143         Workspaces = ( "Workspace 1" );
2146 then you can merge both and have:
2149         Workspaces = ( "Workspace 1" );
2150         Dock = {
2151                 Applications = { {Command = (); }};
2152                 Position = "-64,0";
2153                 Lowered = NO;
2154         };
2159 The configuration format has changed!! Forget everything about the old
2160 format.
2162 dockapp was removed and the old version will not work anymore. 
2164 the dialogs require tcl/tk. they will be rewritten in plain C
2167 These are some tips for people upgrading from older versions and don't want
2168 too many unused files around. There is no problem if you decide to keep 
2169 them for a while.
2171         you can  rm -r ~/gnustep if you don't want anything from there
2173         remove the files in /usr/local/share/WindowMaker before installation
2175         the /usr/local/share/pixmaps directory can be removed