Update for 0.52.0. This is a test version, which brings the Appearance
[wmaker-crm.git] / NEWS
blob910147ef2005b9e699771df29eb805037dc74eb1
2 NEWS for veteran Window Maker users
3 -----------------------------------
5 --- 0.51.2
7 New Themes
8 ----------
10 Added 2 new cool themes (actually I added in 0.51.1, but forgot
11 to put it here...) from largo (LeetWM) and BadlandZ (STEP2000).
14 Full Screen Maximization
15 ------------------------
17 The FullMaximize window attribute will allow the window to
18 be maximized to the full size of the screen (ignoring anything
19 like titlebar, resizebar, dock, panels etc). It should be usefull
20 for programs that must use the whole screen, like games or things 
21 like presentation programs.
24 --- 0.51.1
26 KDE Application Menu script
27 ---------------------------
29 wkdemenu.sh is a converter from KDE application menu structures to wmaker 
30 menu that can be used as a piped menu. Look wkdemenu.sh for how to use it.
33 Window Edge Resistance
34 ----------------------
36 Window edge resistance was now added. No, feature freeze hasn't been
37 removed. Its just part of the edge resistance rewrite ;)
40 New Theme
41 ---------
43 Added SteelBlueSilk theme
45 Installation Path Changes
46 -------------------------
48 Default configuration data installed in /usr/local/etc/WindowMaker
49 or $(sysconfdir)/WindowMaker
52 --- 0.51.0
54 Window Maker has become a GNU program (part of the GNU Project).
56 libPropList
57 -----------
59 WARNING!!! libPropList was removed from the Window Maker distribution
60 and is being distributed separately. If you dont have it installed yet,
61 get it from ftp.windowmaker.org/pub/libs and install before building
62 Window Maker.
65 signal handling change
66 ----------------------
67 SIGHUP will exit wmaker instead of restarting it!!! This is because
68 GNOME expects the window manager to exit instead of restarting...
69 Complaints should go to gnome people. SIGUSR1 will restart wmaker now.
72 script change
73 -------------
74 WINGs-flags was removed, and replaced by get-wraster-flags.
75 Please remove WINGs-flags from your system, since it was obsoloted by
76 get-wraster-flags.
77 Continuing to use WINGs-flags can lead to hazardous effects, since is no
78 longer updated.
81 docklib
82 -------
84 docklib is a little library for making dock applets. It's in the
85 docklib-0.0.tar.gz file. Unpack it and read the README file there.
88 Option Changes
89 --------------
91 Removed OnTopTransients option
93 Added OpenTransientOnOwnerWorkspace
96 Olwm Hint Support
97 -----------------
99 OPEN LOOK(tm)/olwm hints support was added.
101 Read the appropriate section in the README file.
105 --- 0.50.1
107 New option for WorkspaceBack. mpixmap is the same as spixmap, but
108 it will scale the pixmap by keeping the aspect ratio (maximize or maxpect).
109 The option only works for workspace backgrounds.
111 Also added IGNORE_PPOSITION compile time flag, which is equivalent
112 to NoPPosition from fvwm. 
117 --- 0.50.0
120 KDE and GNOME
121 -------------
123 Added full support for GNOME and KWM hints. 
124 Read the INSTALL file to see how enable them.
126 Everything in the so called GNOME window manager bla bla bla pseudo-spec is
127 implemented.
129 As for KDE stuff, it implements 90% of everything kwm does, adds some
130 Window Maker specific extensions to it and still uses half of the memory
131 kwm does, which should be enough to let you dump kwm ;) For details on what
132 exactly is implemented, see comments in src/kwm.c Read the README.KDE file 
133 for more information.
136 WARNING: Some KDE hints are badly designed, so doing things like using
137 kpanel's desktop switcher/pager and Window Maker's internal workspace
138 management functions to create, destroy and rename workspaces at the same 
139 time might cause unknown effects. To be on the safe side, only
140 use either of them to manage workspaces. Switching workspaces is hopefully,
141 safe, so you can switch workspaces from wherever you want.
145 Workspace Specific Background Images
146 ------------------------------------
148 Use the WorkspaceSpecificBack to set background images for specific
149 workspaces. The WorkspaceBack is used as the default background image.
151 Example:
153 WorkspaceSpecificBack = ((solid, red), (cpixmap, ship.jpg, gray), (), 
154                                 (dgradient, red, blue))
156 This will set the background image of workspace 1 to (solid, 0),
157 2 to ship.jpg and 4 to a gradient. Workspace 3 and other workspaces
158 will have the image defined by WorkspaceBack.
160 Note that this uses quite some memory...
163 setstyle/getstyle
164 -----------------
166 setstyle now accepts the -nofonts flag, which will load the style
167 file ignoring all font related options.
169 Example:
171 setstyle -nofonts Blabla.style
174 getstyle can be used to create theme packs. See the usage in the
175 WindowMaker/README.themes file.
179 New Texture Type
180 ----------------
182 Textured gradients will tile a texture pixmap and combine it with a gradient, 
183 using an arbitrary opaqueness. 
185 Syntax is (thgradient, <file>, <opaqueness>, <color1>, <color2>)
186           (tvgradient, <file>, <opaqueness>, <color1>, <color2>)
187           (tdgradient, <file>, <opaqueness>, <color1>, <color2>)
188 where:
189 <color1> and <color2> are the colors for the gradient,
190 <file> is the texture file and
191 <opaqueness> is the opaqueness to merge the texture witht the gradient,
192 ranging from 0 to 255.
194 Example:
196 (thgradient, "BlueImage.jpeg", 120, white, black)
198 The BlackTexture style and Checker theme are examples.
200 Hints:
202 You can use any type of pixmap file for this, but small (like 64x32)
203 grayscale pixmap files should get the best results (fast and low memory
204 usage). You can use color pixmaps, but it is harder to get the desired effect
205 with them.
207 Be warned that this texture type is the slowest.
211 New Options
212 -----------
214 IconTitleBack and IconTitleColor control the color of the
215 miniwindow title. Both of them are colors.
217 Example:
218 IconTitleColor=white;
219 IconTitleBack=black;
222 Since this introduces an incompatibility in themes and getting flamed by the
223 themes ppl isn't the most pleasant thing ("Whaddafuk you're thinking!? You
224 just broke 500 themes!!!" ;) the setstyle command was hacked so that it will
225 make old themes work as before, by trying to automatically set the above
226 options. Note that in some cases it will not have exactly the same results as
227 before.
230 StartMaximized window attribute. Will maximize the window when it
231 is mapped.
234 AutoRaiseLower option for the Clip. This allows automatic Raise/Lower of the
235 Clip icons when the mouse pointer enter/leave the Clip. To avoid unwanted
236 raising/lowering there is a time threshold before raising/lowering.
237 The thresholds can be changed in wconfig.h by changing one or both of
238 AUTO_LOWER_DELAY and AUTO_RAISE_DELAY (expressed in miliseconds).
239 For example if you set AUTO_RAISE_DELAY to 0, then the Clip will be raised as
240 soon as the mouse pointer enters it's area. Setting AUTO_RAISE_DELAY to a very
241 big value, will make the Clip to practically do not auto raise unless clicked,
242 but to be automatically lowered after AUTO_LOWER_DELAY (ms) when leaved.
245 New ThemePack Format
246 --------------------
248 Starting with this version, a new format of themes is being supported.
249 Before you open pine and start composing your flame, rest assured that
250 the old format is still supported. The new format is documented
251 in the WindowMaker/README.themes file.
254 Root Menu 
255 ---------
257 The -noext option for OPEN_MENU will strip whatever is after the last .
258 in file names that appear on the opened directory. So,
260 OPEN_MENU ~/bg WITH xv -root -quit
262 will create a menu with all the images in ~/bg without the extension.
266 --- 0.20.3
269 Icon (miniwindow) stacking
270 --------------------------
272 If you want miniwindows to reside under normal windows, edit
273 wconfig.h and change WNormalLevel (just grep for it) to
274 WDesktopLevel
277 5 Button Mouse
278 --------------
280 If you have a 5 button mouse and want to give some utility for
281 the extra 2 buttons, edit the appropriate line in src/wconfig.h
282 Clicking Button4 in the root window will switch you to the previous 
283 workspace and Button5 will do that for the next.
286 Option Changes
287 --------------
289 put NoWindowOverDock back
291 KeepOnBottom window attribute
294 -static command line option
295 ---------------------------
297 wmaker -static will start Window Maker in static mode. This will
298 prevent wmaker from checking or making any configuration changes.
299 That makes it possible to run wmaker before running wmaker.inst
302 Hysteresis for menu item selection
303 ----------------------------------
305 Hopefully it's intelligent enough, so you won't notice it.
307 In case you want to know what's it, it's equivalent to that
308 (insanely long) 2 second delay present in that Windoze95 menu, 
309 but more usefull than annoying (I hope :). To see it, do the following
310 with your current wmaker version and later with 0.20.3:
312 - open the apps menu and stick it
313 - click in the item for the "Workspaces" submenu and hold
314 - drag the mouse to the 4th or bigger entry (like "Workspace 4") in a
315 straight line, trying to select the target item before the submenu
316 is unmapped when you dragged over other items in the main menu
320 Window Shortcuts
321 ----------------
323 Window shortcuts are shortcuts to arbitrary windows. You can make up to 4
324 shortcuts. To assign a previously bound shortcut to a window use the "Select
325 Shortcut" submenu in the window commands menu. If the shortcut is not yet
326 assigned for any window, you can hit the shortcut to assign it to the active
327 window. The shortcut will do the same as clicking in an entry in the window
328 list menu. The keys for the shortcuts are defined in the ~/G/D/WindowMaker
329 file or in WPrefs.app
331 Option names are:
333 WindowShortcut1Key through WindowShortcut4Key
336 --- 0.20.2
339 The name of WindowMaker was changed to Window Maker.
341 Window creation animation disabled by default.
343 xdaliclock -shape
344 -----------------
346 If you use it edit src/wconfig.h and #define OPTIMIZE_SHAPE or disable the
347 titlebar and resizebar for the window. OPTIMIZE_SHAPE will remove the
348 flickering for xdaliclock and other programs that change their shapes often,
349 but will increase network traffic considerably. So, if you use xdaliclock
350 from a remote machine it can get slow.
353 Applications Menu
354 -----------------
356 The applications menu will now use the shell in the SHELL environment
357 variable to execute EXEC menu commands. If it is unset (I think it's always
358 automatically set by the shell program) it will use /bin/sh
361 Extra fancy icon kaboom :)
362 --------------------------
364 Edit src/wconfig.h and #define ICON_KABOOM_EXTRA to get
365 more effects for the icon undocking animation.
367 Options for superfluous stuff are even more superfluous, so this
368 will not become runtime.
371 XDE drag and drop support
372 -------------------------
374 Support for XDE drag and drop was added (by "]d" <id@maliwan.org>).
375 To enable, edit src/wconfig.h
376 The support works with gtk 1.1.2
379 libPropList
380 -----------
382 libPropList will now be built automatically by wmaker. Wich means
383 the (simplified) building process is now:
385 ./configure
386 make
387 make install
389 instead of:
391 tar xzf libPropList.tar.gz
392 (cd libPropList; make)
393 make
394 make install
396 You also don't need to worry about GNOME libPropList incompatibilities
397 anymore. 
400 Bug with focus lost in sloppy focus fixed
401 -----------------------------------------
403 The bug only occurs in sloppy or auto focus modes, with AutoFocus disabled
404 and Superfluous enabled. There is no easy/clean way to fix this, so Window
405 Maker will disable the animation of window creation if the focus mode is
406 either sloppy or auto AND AutoFocus=NO.
408 If you want the animation, enable AutoFocus or use manual focus mode
409 (prefered). 
412 The NoWindowUnderDock option was removed
413 ----------------------------------------
414 To obtain the same result, use the "Keep Dock On Top" option in the dock menu.
417 Persistent Program Suplied Icons
418 --------------------------------
420 Application supplied icons are now stored, so that the dock will keep
421 showing them after the app is exited. The icons are stored at
422 ~/GNUstep/.AppInfo/WindowMaker/
425 Sound support
426 -------------
428 Sound support is now on by default. Even if you don't use sound the overhead
429 is very small, and has no impact on performance. If you still want to
430 optimize it and remove a few hundred of bytes, then use --disable-sound or
431 --enable-sound=no options when you configure Window Maker.
434 --- 0.20.0
436   
437 Multihead support. wmaker will now manage all screens that are attached to the
438 display. 
439 ------------------------------------------------------------------------------
440   
442 It does so from a single process (instead of spawning a new process for each
443 screen, like fvwm does). This keeps memory usage a lot lower than fvwm.
445 State files have a suffix .n, where n is the number of the screen.
447 Since I don't have a real multiheaded machine, it probably has bugs.
449 Superfluous
450 -----------
452 Yet another useless superfluous animation. Find out what exactly it is
453 by yourself :)
456 exitscript
457 ----------
459 ~/G/L/W/exitscript will be called automatically when wmaker is exited.
462 New runtime options
463 -------------------
465 1. Miniaturization animation is now selectable by a runtime option
466 Add a line with
468 IconificationStyle = <style>;
470 to your WindowMaker configuration file.
471 <style> can be one of: Zoom, Twist, Flip or None
472 Case doesn't matter, and default is Zoom.
475 2. Edge resistance.
476 This can be controlled by setting:
478 EdgeResistance = xxx;
480 in your WindowMaker configuration file.
481 xxx is an integer greater than 0 and represents the number of pixels of edge
482 resistance. Setting it to 0 (default) will disable this feature.
484 New theme
485 ---------
487 A new theme named Night, is available in this distribution.
491 --- 0.19.3
493 GIF support was added. You will need libgif 2.2 to use it.
495 cpixmap added. Syntax is the same as tpixmap or spixmap
498 --- 0.19.2
500 getstyle will include IconBack info in Style files.
502 --- 0.19.0
504 libPropList was updated. If you have it installed, you must upgrade or
505 WPrefs will crash because of bugs in libPropList.
507 New options
508 -----------
510 Balloons!
511 ---------
513 WindowTitleBalloons = YES;
514 will enable balloons for window titles that are not fully visible.
516 MiniwindowTitleBalloons = YES;
517 will enable balloons for miniwindow titles.
519 AppIconBalloons = YES;
520 for application icons (docked or not)
523 IconPosition
524 ------------
526 IconPosition (the position of the icons) is specified as:
528 IconPosition = c1c2c3;
530 where:
532 c1 can be t or b (meaning top or bottom)
533 c2 can be l or r (meaning left or right)
534 c3 can be v or h (meaning vertical or horizontal)
536 case is insensitive.
538 For example, 
539 IconPosition = blh;
541 is the old iconPosition position.
543 IconPosition = trv;
545 will place the icons over the Dock.
547 New window attribute
548 --------------------
550 EmulateAppIcon = YES; will make the window have an application icon.
551 Only use this option for fully specified windows (like rxvt.Rxvt).
552 NEVER use in generic window specifications (like * or rxvt).
553 You must restart the application for the attribute to take effect.
556 WPrefs.app
557 ----------
559 Read WPrefs/README
562 --- 0.18.1
564 Boolean balues have changed!!! YES, Y and any non-zero integer will
565 mean TRUE and anything else (including True) will mean FALSE. This
566 is to conform to the OpenStep values used for booleans and
567 not cause headaches later, when GNUstep apps also starts using
568 defaults and users will try using True wich won't get recognized.
571 --- 0.18.0
573 Clip
574 ----
576 Clip button layout was changed. IT IS TEMPORARY AND THE DEFINITIVE LOOK
577 WILL BE DIFFERENT!!!
580 libPropList
581 -----------
583 More bugs were fixed in it. Upgrade the library if you have an older version
584 installed, with the one included.
587 Property list menus
588 -------------------
590 Format for property list menus has changed! The redundant array for
591 submenus was removed, so a menu that looked like:
593 ( Applications,
594   ("Xterm", EXEC, "xterm"),
595   ( 
596     (Paint,
597         ("Gimp", EXEC, "gimp"),
598         ("XV", EXEC, "xv")
599     )
600   )
603 must be changed to:
605 ( Applications,
606   ("Xterm", EXEC, "xterm"),
607   (Paint,
608         ("Gimp", EXEC, "gimp"),
609         ("XV", EXEC, "xv")
610   )
615 Misc
616 ----
618 NUMLOCK_HACK is back. This time it works and is enabled by default.
619 If you think you don't need it and promise me that you won't send 
620 "bug" reports saying that shortcuts stop working after a while, you can
621 disable it ;) It will save some memory and CPU.
624 Configuration
625 -------------
627 Removed the SwapMenuButton option and added 3 finer grained options:
629 SelectWindowsMouseButton
630 WindowListMouseButton
631 ApplicationMenuMouseButton
633 Values that can be used are Left, Middle, Right and Button1 through Button5
634 Left is equivalent to Button1, Middle to Button2 and Right to Button3
637 Removed the WorkspaceChangeDelay option and corresponding action.
638 Removed AClipColor and IClipColor
641 Added the SelectKey back
644 Changed default binding of Window commands menu from F10 to Control+Escape
646 --- 0.17.4
648 Misc
649 -----
651 libPropList has changed! Upgrade it before compiling wmaker.
653 Hopefully the bugs that caused wmaker to crash if an error is found
654 in the config files is fixed. If you do crash wmaker with a bad
655 file, please try to find out the smallest possible portion of the file
656 that still crashes wmaker and send it to me.
659 New Options
660 -----------
662 PixmapPath was split to PixmapPath and IconPath. PixmapPath is the path
663 for the pixmaps used as textures and IconPath is for the icons. 
664 Don't forget to add IconPath to your current configuration file.
666 There's also a new library in ~/GNUstep/Library/Icons. You should place
667 your icons there, since icons are not a WindowMaker specific resource.
670 DontConfirmKill=YES; will disable the confirmation panel for Kill
673 --- 0.17.3
675 Interface Changes
676 -----------------
678 Unhide Here in the appicon menu was changed to be the first entry.
679 This way you can unhide the appicon with a single click without
680 even moving the pointer.
683 Clip Commands
684 -------------
686 The collect icons commands was renamed to attract icons and
687 the attract icons options was renamed to Auto attract icons.
689 The Remove Selected Icons was renamed to Remove Icon(s). It will
690 act as before if some icon is selected and will remove the clicked
691 icon (without confirmation) if it is not.
693 Added a Keep Icon(s) command that will keep the selected icons if
694 any is selected and the current one if none.
696 The Move To command was renamed to Move Icon(s) To.
699 --- 0.17.0
701 If you have libPropList installed, you might want to reinstall it,
702 replacing with the included libPropList. It has a small bug fix.
704 Misc. Changes
705 -------------
707 Removed --with-gnome and made MWM_HINTS defined by default.
708 This means that "GNOME support" will work with no additional
709 flags passed to configure. 
711 Added support for KDE, by adding a DisableWorkspaceMouseActions option.
712 Set it to YES and run krootwm to be able to use everything in kfm.
715 Shortcuts for Root Menu
716 -----------------------
718 There is now a new SHORTCUT optional keyword for the menus.
719 For example, you can bind Control-F1 to xterm with:
721 "XTerm" SHORTCUT Control+F1 EXEC xterm
723 or F2 to ARRANGE_ICONS with:
725 "Arrange Icons" SHORTCUT F2 ARRANGE_ICONS
728 All commands allowed in the menu file accept the keyword, except for
729 MENU and OPEN_MENU
732 Interface Changes
733 -----------------
735 ** Configuration of docked applications is now done in a panel instead of
736 in the menu. 
738 ** Added a command menu for application icons
740 ** Shift double-click on the application icon will unhide the app
741 in the current workspace.
744 Option Changes
745 --------------
747 NotMiniaturizable option changed to NoMiniaturizeButton
748 NotClosable option changed to NoCloseButton
751 Speed options values are now UltraFast, Fast, Medium, Slow or UltraSlow
752                                               ^^^^^^
754 Removed the Select keyboard binding. You can access it in the window
755 commands menu.
757 Removed the ClipMaxIcons option and made it a compile time option.
759 Removed the ConstrainWindowSize option
761 Renamed NoSound to DisableSound
763 Renamed NoAutowrap to DontLinkWorkspaces
765 Renamed NoDithering to DisableDithering
767 Renamed NoAnimations to DisableAnimations
769 Removed the LeftHanded option and added a SwapMenuButton option.
770 SwapMenuButton will make the rubberband selection in the root window
771 be bound to the right button and the root menu to the left button.
774 New way to display temporary icons
775 ----------------------------------
777 The icons that are attracted by Clip, but will not be kept after the
778 application close, are now using a different color for shading, unlike previous
779 version that always used white. This will improve look for very different color
780 combinations, and allow the user to control the look of the shaded icon.
781 The color used for shading the icons is computed as follows:
783 First a color is computed depending on the IconBack type:
784  - for solid the color is the solid color itself.
785  - for simple gradients the color is (from_color + to_color)/2.
786  - for multiple gradients, the color is the first color in list.
787  - for pixmaps, the color is the solid color specified for that pixmap.
789 Then the color is made lighter by multiplying each red/green/blue filed with
790 1.7 and limiting each field to 0xff in case they exceed this value.
791 Then this new color will be used by superposing it with the icon we want to
792 shade, using a proper alpha value.
794 To control the color for shading is simple:
796 - In case of multi gradients you just need to put the first color, as the color
797 you like. WindowMaker do not use the first color in the list to directly build
798 the gradient, but only when it needs a solid color for something (like in this
799 case).
801 - For pixmaps, put the needed color as the solid color the syntax for pixmaps
802 require. This color is also not used when displaying normal icons, just when
803 solid colors are needed (like this case).
805 - For solid color, or simple gradients, in case the color it uses after
806 computing is not good enough, you can always convert the solid or simple
807 gradient to a multi gradient with the same look, and use that one. In this
808 case is simple, just put the needed color as first color in list.
810 Please note that this will not slow down WindowMaker, because the IconBack is
811 read only once at startup, and then only if it is changed. After reading it WM
812 will construct the image of the tile, and use the image instead of recomputing
813 the gradient every time.
815 Here are 2 examples of converting solid or simple gradient to a same looking
816 multi gradient:
818 IconBack = (solid, Blue);
819 will become
820 IconBack = (mhgradient , LightBlue, Blue, Blue);
821 using LightBlue as color for shading.
823 IconBack = (dgradient, "#284569", "#082420");
824 will become
825 IconBack = (mdgradient, "#183454", "#284569", "#082420");
826 looking the same, but using #183454 for shading.
829 New Sound Server Location
830 -------------------------
832 The sound server new URL is http://www.frontiernet.net/~southgat/wmsound
833 Also it seems to be running on FreeBSD too (with little changes maybe).
836 --- 0.16.1
838 WINGs
839 -----
841 The path for the WINGs resource files was changed. If you don't
842 do make install, you must move /usr/local/share/WindowMaker/Resources to
843 /usr/local/share/WINGs
846 New Options
847 -----------
849 The following new options are available:
850 NewStyle = Yes/No; (static) Replaces --enable-newstyle
851 DisableDock = Yes/No; (static) Same as -nodock command line option.
852 DisableClip = Yes/No; (static) Same as -noclip.
853 Superfluous = Yes/No; (dynamic) Replaces --enable-superfluous.
855 NOTES.
856 - The static options are only read at startup. Changing them, needs to restart,
857   so they will be accounted.
858 - DisableDock and DisableClip have lower precedence than -nodock -noclip
859   command line options. If both option/command line option are given, then the
860   command line option will be accounted.
863 Start Hidden option
864 -------------------
866 The start hidden option was fixed, and made to be an application wide option.
867 It will apply to every window the application owns. Also its place in the
868 Attribute Inspector panel, changed accordingly, to reflect this.
869 The start miniaturized is however still applying to particular windows of an
870 application, unless the option is set for the class.
871 Start miniaturized, will override start hidden if both set.
873 IMPORTANT NOTE.
874 Because of the way Netscape Communicator is implemented, it is NOT possible
875 to set the start hidden or miniatirized flags for it. This is because Netscape
876 chooses to send a second map event to the window it maps. This makes the
877 window to receive a second map request and to be unhidden or maximized back,
878 immediately after it was hidden or miniaturized by WindowMaker at startup.
882 --- 0.16.0
884 Misc. Changes
885 -------------
887 The NextMenuBehaviour option was renamed to WrapMenus
888 The WorkspaceTiedMiniwindows option was renamed to StickyIcons
890 The .tif files were renamed to .tiff
893 Selecting Mini Windows
894 ----------------------
896 Now miniaturized windows can be selected as well as normal windows.
897 You can do this by Shift-Click-ing them. They will be marked, and will follow
898 you through workspaces like normal selected windows do.
899 Miniaturizing a window will no longer deselect the window, but will place the
900 icon and mark it as selected.
901 The only difference between miniaturized and normal window selection is that
902 for the moment the rubber-band selecting method works only for normal windows.
905 Icon Selection Panel in Attributes Editor
906 -----------------------------------------
908 Now, selecting icons is as easy as clicking in the file name in a list.
911 Simplified Options
912 ------------------
914 IconSlideStep, IconSlideSlowDown and IconSlideDelay were merged to 
915 IconSlideSpeed
917 MenuScrollStep and MenuScrollDelay were merged to MenuScrollSpeed
919 ShadeStep and ShadeDelay were merged to ShadeSpeed
922 Valid values for them are: Fast, Normal, Slow or UltraSlow
924 If you want to fine tune the values, they can be changed in wconfig.h
925 Send me your set of values with an indication of how fast is your hardware,
926 so that I can make the default values more adequate.
929 New Window Attributes
930 ---------------------
932 Added StartMiniaturized and StartHidden as window attributes and
933 removed the previous implementation. Also removed the dock menu entries.
934 They are now settable in the Attributes Panel.
936 Also added DontSaveSession attribute. This way, you won't end up with multiple
937 unwanted copies of the same app after the previous session is restored.
938 I start X with a xterm in .xinitrc instead of wmaker, wich will cause the
939 xterm restored by wmaker be duplicate. Just add -name something to the
940 xterm started form .xinitrc and mark DontSaveSession=YES for that window.
944 User Specifiable Visual IDs
945 ---------------------------
947 wmaker now supports different visuals than the default one. It isn't of much
948 use for most people, but can be usefull for lucky SGI users who want it
949 to use TrueColor instead of the default PseudoColor.
951 wmaker -visualid VISUAL_ID
953 where VISUAL_ID is the hex code for the visual you want.
955 Note: I don't have an SGI box and haven't tested it...
959 Starting Workspace
960 ------------------
962 The starting workspace is identified in the following order:
963 1. If the app is omnipresent will be mapped on the current workspace.
964 2. Else if the application have a StartWorkspace option set as attribute
965    then this one will be used.
966 3. Else, if the application was started from Clip, the workspace on which
967    the Clip from where it was started is used.
968 4. Else the current workspace is used.
970 Restoring saved sessions will always use the saved workspace, no matter
971 what other options are, except onmipresent.
975 --- 0.15.1
977 Workspace specific mini windows
978 -------------------------------
980 The minimized windows can be workspace specific, being more consistent with
981 the rest. This is because minimized window represents just another state of a
982 window (like normal or shaded), which all are workspace specific.
983 This (or the old "present anywhere") behavior can be set using an option in
984 the WindowMaker database: WorkspaceTiedMiniWindows = Yes/No;
986 New way to animate the blowing icons
987 ------------------------------------
989 There is now a compile time option that allows one to set how the icons are
990 animated when detaching from dock/clip in superfluous mode.
991 By default the classic "Falling pieces" animation is used.
992 If SPREAD_ICON is #define-ed in wconfig.h, then a "Spread in four directions"
993 animation is used instead. Take a look at the section where this is described
994 in src/wconfig.h
995 By default there is #undef SPREAD_ICON to select "Falling pieces" animation.
997 Auto Colapse for Clip
998 ---------------------
1000 The clip now supports an option named "Auto Collapse" which can be set from
1001 the clip main menu. When set, clip will stay collapsed, and will show itself
1002 when the mouse moves over it. While the mouse is over it, or over any of the
1003 icons attached to the clip, the clip will stay uncollapsed, letting you to
1004 access the attached icons. This is not true for applications like asclock, or
1005 applets of that kind, because the icon window do not belongs to WindowMaker,
1006 but to the application itself. For such icons you must keep the mouse over the
1007 icon groundplate, else it will collapse back. But usually these type of icons
1008 will not stay in a collapsed clip, since one needs to see what they show.
1009 When the clip is leaved it will collapse back after a delay of 1 second, unless
1010 the mouse is moved back to the clip area. The delay can be set modifying
1011 AUTO_COLLAPSE_DELAY in wconfig.h. Default is 1000 (ms) which means 1 second.
1016 --- 0.15.0
1018 Changed name from Fiend to Clip
1019 -----------------------------------
1021 All occurrences of word Fiend with or without capital F were replaced with
1022 the corresponding Clip (same capital).
1023 This affects all configuration files under ~/GNUstep that contain this word.
1024 It can be refered as "Workspace Dock" too.
1027 New option in Clip menu, and extended Clip behavior
1028 ---------------------------------------------------
1030 The following new items are available in the dock menu:
1032 1. Attract Icons
1033 2. Keep Attracted Icons
1034 3. Collect Icons
1035 4. (Un)select All Icons
1036 5. Remove Selected Icons
1037 6. Move To
1038 7. Start miniaturized    (also available for regular dock)
1039 8. Start hidden          (also available for regular dock)
1040 9. Selected
1041 10. Set icon...          (also available for regular dock)
1044 Here is what they do:
1046 1. "Attract Icons" will let the Clip to attract and attach any new appicon that
1047    is created when an application starts. It will not do this if the Clip is
1048    full. If the Clip is Collapsed then the appicon will be hidden after it is
1049    attached.
1050 2. "Keep Attracted Icons" will tell the Clip to keep the attracted appicons,
1051    after the application is closed. Without this the appicons will vanish,
1052    leaving the Clip in the original state. If you move an appicon that was
1053    attracted from Clip to regular Dock, it will be kept when closed, no matter
1054    what "Keep Attracted Icons" is set to in Clip.
1055 3. "Collect Icons" will collect all appicons that are not yet attached to Dock
1056    or Clip, and attach them to the current workspace Clip. The value of
1057    "Keep Attracted Icons" will apply when applications close. If Clip is
1058    collapsed, the appicons will be hidden.
1059 4. "(Un)select All Icons" will select all icons in the clip if none is
1060    selected, or it will deselect all selected ones. The selected icons are
1061    marked using a small triangle in the bottom right corner of the appicon.
1062    The color of the mark is set using SClipColor in WindowMaker domain
1063    database.
1064 5. "Remove Selected Icons" will remove from Clip all selected icons. The ones
1065    that still run, will be detached, all the others will vanish.
1066 6. "Move To" will transfer all selected icons to another workspace and attach
1067    them to the Clip in that workspace. If none is selected, only the one the
1068    mouse was pressed on will be moved.
1069 7. "Start miniaturized" will launch (or autolaunch if set) the application in
1070    a miniaturized state.
1071 8. "Start hidden" will launch (or autolaunch if set) the application in a
1072    hidden state. Note that only one of the two can be set at a time.
1073 9. "Selected" can be used to toggle the selected state of the appicon
1074    individually. The same can be achieved using Shift-LeftClick on the appicon.
1075    In fact the intended way of toggling the selected state is by using
1076    the Shift-LeftClick on icon. The menu entry is just another way to do the
1077    same.
1078 10. "Set icon..." will allow one to set the image for the appicon. The image
1079    will be updated without restart, and also all appicons in the same
1080    instance.class as the one we set for, will be updated.
1082 So a simple way of avoiding the screen to be filled up with appicons is to set
1083 the "Attract Icons" in the Clip. Also the "Keep Attracted Icons" can be set to
1084 No, so the attracted icons will be deleted when application exits, thus leaving
1085 the Clip clean. If also one to not want to see the appicons that keep filling
1086 the Clip, he can set the Clip to be Collapsed.
1088 Getting rid of unneeded icons in Clip is as simple as selecting them
1089 individually using Shift-LeftClick, and then using the "Remove selected Icons"
1090 entry in menu.
1093 Support for different visuals.
1094 ------------------------------
1096 WindowMaker is now able to support any visual, except DirectColor, in any
1097 depth from 1bpp to 32bpp.
1099 One can start the X server with different visuals, by passing the X server the
1100 right option. For XFree 3.3.x is -cc <id>.
1101 WindowMaker is not yet able to choose a different visual from the Default one
1102 on a given screen, but can use any default visual it finds, except the direct
1103 color visual.
1104 For example starting X like (for XFree 3.3.x, and if the driver for the
1105 card supports this. Read the man page for your X server):
1106 startx -- -bpp 8 -cc 0 will give you the StaticGray visual.
1107 startx -- -bpp 8 -cc 1 will give the GrayScale visual
1108 and so on.
1110 Wrlib code is now generic, and will support any visual except DirectColor in
1111 any depth. Programs written with wrlib can work on different visuals from
1112 the default visual for a given screen.
1113 Behavior in different visuals can be tested using the testgrad program in
1114 wrlib subdirectory in distribution.
1115 testgrad -h will show the usage.
1117 Multidiagonal gradients are also implemented now in wrlib, and a new algorithm
1118 is used to speed up the generation of diagonal gradients.
1121 New arrangement of the directory structure under ~/GNUstep/
1122 ---------------------------------------------------------------
1124 To better adapt to theme support the directory structure changed under
1125 ~/GNUstep/Library/WindowMaker
1127 1. Style directory moved to Styles.
1128 2. Added the following directories: Backgrounds, IconSets, Pixmaps, Sounds and
1129    Themes.
1130 3. The .style files no longer get copied in the user's Styles directory.
1131    Instead they are read from the global /usr/local/share/WindowMaker/Styles
1132    directory.
1134 Under ~/GNUstep/Defaults the following changes occurred:
1136 1. A default WMState is installed by wmaker.inst.
1137    It contains the dockit program assigned to the top icon of the dock, and
1138    the wmsetbg program assigned for the drop command on both dock's and clip's
1139    main icon.
1140    Double clicking the dock's main icon will bring up dockit that will let you
1141    dock any application that do not have an application icon.
1142    Dropping an image on dock's or clip's main icon, from an Offix DND aware
1143    application, will put the image on the background tiled, and will update
1144    WindowMaker domain database file.
1145 2. Syntax of WMState changed a little. The old position will not be restored
1146    when you will first start the new version, but after that it will be
1147    normally remembered. This is because now the main clip icons is only saved
1148    once, not for every workspace.
1149    You should replace Fiend with Clip in any place where it appears, if you
1150    want to keep the old WMState file, else it will not work.
1151 3. At compile time, it will detect if you have support for tif, and will
1152    install a WMWindowAttributes with corresponding image name extension
1153    (.tif or .xpm). This is true only for pixmaps that come with the source
1154    distribution and get installed under /usr/local/share/WindowMaker/Pixmaps
1156 The menu file changed a lot. Old menu file will *not* work with new theme
1157 support, so please upgrade.
1160 New behavior of OPEN_MENU command
1161 ---------------------------------
1163 The OPEN_MENU command now supports the following syntax:
1164 1. File menu handling.
1165    // opens file.menu which must contain a valid menu file and inserts
1166    // it in current position
1167    OPEN_MENU file.menu
1168 2. Pipe menu handling.
1169    // opens command and uses it's stdout to construct menu.
1170    // Command's output must be a valid menu description.
1171    OPEN_MENU | command
1172 3. Directory handling.
1173    // Opens one or more directories and construct a menu with all
1174    // the subdirectories and executable files in them sorted alphabetically.
1175    OPEN_MENU /some/dir [/some/other/dir ...]
1176 4. Directory handling with command.
1177    // Opens one or more directories and construct menu with all
1178    // subdirectories and readable files in them sorted alphabetically,
1179    // preceding each of them with command.
1180    // WITH is a required keyword!!!
1181    OPEN_MENU /some/dir [/some/other/dir ...] WITH command -options
1183 Please note that because of the 'WITH' keyword old menu files no longer work
1184 for the OPEN_MENU with a command.
1187 Theme support
1188 -------------
1190 Theme support is now as easy as untar-ing a tarball in the right place.
1191 Because of the way OPEN_MENU works, they can be installed on a global
1192 shareable basis, or for personal user use.
1193 Themes installed under ~/GNUstep will be available only for a user, but
1194 if if they are installed under /usr/local/share/WindowMaker they will be seen
1195 by all users. This is also true for style files, background images, pixmaps,
1196 etc that get installed under /usr/local/share/WindowMaker.
1197 Themes can be saved or loaded using the Appereance menu.
1199 Also support for different IconSets is available. You can save or load a new
1200 IconSet using the Appereance menu.
1202 Setting background images is now as simple as putting the images in the right
1203 place (~/GNUstep/Library/WindowMaker/Backgrounds or
1204 /usr/local/share/WindowMaker/Backgrounds, or any other place in your
1205 PixmapPath). Then use the Appereance menu. They will be instantly available
1206 since they are opened by a OPEN_MENU command. Also the image do not need to
1207 have a .jpg or any other extension. It will be recognized anyhow.
1208 As an example please see the OpenStep theme supplied with WindowMaker.
1209 The OpenStep image is a jpeg file without extension.
1211 Please keep in mind that anything under /usr/local/share/WindowMaker will be
1212 available for all users.
1215 New options for wmsetbg and getstyle
1216 ------------------------------------
1218 wmsetbg now accepts the following options:
1219 usage: wmsetbg [-options] image
1220 options:
1221  -d             dither image
1222  -m             match  colors
1223  -t             tile   image
1224  -s             scale  image (default)
1225  -u             update WindowMaker domain database
1226  -D <domain>    update <domain> database
1227  -c <cpc>       colors per channel to use
1229 By default, it will try to guess if dithering is needed or not and proceed
1230 accordingly.
1231 Using -d or -m will force it to dither or match colors.
1233 Dithering for more than 15bpp is generally not needed, and will only result
1234 in a slower processing.
1235 Don't use dithering except when needed, because it is slower. Else rely on
1236 wmsetbg which will detect if dithering is needed and use it.
1238 -u will update the WorkspaceBack in the default database domain file in
1239    ~/GNUstep/Defaults/WindowMaker, and let WindowMaker refresh the screen.
1240    Please note that this option only works under WindowMaker, and will have no
1241    effect under other window managers, since it rely on WindowMaker to update
1242    the image after it reads the updated defaults database.
1244 -D <domain> is same as above, but will update the domain <domain> instead of
1245    the default WindowMaker domain.
1247 -c <cpc> will set the color per channel to use. Only needed for PseudoColor
1248    visuals. WindowMaker will automatically pass the value read from the
1249    WindowMaker domain database.
1252 getstyle now have the -t option, that instructs it to read all options
1253 related to theme. Without -t getstyle will read only style options that
1254 means it will not read WorkspaceBack and IconBack.
1255 Use -t when you want to make a theme and need all theme options to be saved.
1256 Else it will extract just a style file.
1259 Session management support
1260 --------------------------
1262 Two new commands are available for use in menus:
1264 SAVE_SESSION and CLEAR_SESSION.
1266 SAVE_SESSION:
1267 will take a snapshot of all running applications, and their current hints
1268 (shaded, hidden, minimized, geometry and workspace they are on),
1269 and save it inside the WMState file. Also the current workspace we are on is
1270 saved. The applications that are running and were started from dock or clip are
1271 marked, so they will be attached to the corresponding dock/clip when restored.
1272 This state is restored every next session, until a new one is saved or
1273 CLEAR_SESSION is used.
1275 CLEAR_SESSION:
1276 will clear any previous saved session.
1278 There is also a run time option named SaveSessionOnExit = Yes/No; that allows
1279 one to automatically save the state of desktop when leaving WindowMaker.
1280 This way next session, the state of the desktop before last exit is restored.
1282 Please note that if this option is set to Yes, than any manual saving of the
1283 state, or any clearing of the state will be overridden when exiting
1284 WindowMaker.
1286 These options are available under the "Workspace" menu.
1289 User WindowMaker configuration files are now merged with global ones
1290 --------------------------------------------------------------------
1292 When starts WindowMaker will look for database domain files under
1293 $GNUSTEP_USER_ROOT/Defaults or ~/GNUstep/Deafults to be read. (In this order).
1295 If they are not available then it will scan for them in
1296 $GNUSTEP_LOCAL_ROOT/Defaults, $GNUSTEP_SYSTEM_ROOT/Defaults or
1297 /usr/local/GNUstep/Defaults (in this order).
1299 Even if the file was found or not, it will always load the corresponding domain
1300 file under /usr/local/share/WindowMaker/Defaults.
1302 Then if the user file was found it will merge it over the global file, else
1303 the global file will be used.
1305 This way any settings that are set by the system administrator in the shared
1306 file will be available for users that do not have them in their config files.
1307 Any option the user have in his config file will override the one in the
1308 shared domain file.
1310 So any new runtime options that appear in WindowMaker domain, do not need to
1311 be set in all user files, except the ones the user wants a different behavior
1312 from the default set for all users in the shared file.
1314 Also it is possible for the user to not have any personal domain databases, and
1315 the global shared ones will be used, but it still needs to have the directory
1316 structure, so WMState gets written on session exit.
1317 So all it needs to have is ~/GNUstep/Defaults directory available.
1320 New behavior of the Slide Icons
1321 -------------------------------
1323 Animation constants are now runtime.
1324 They are:
1325 IconSlideDelay = 0;
1326 IconSlideStep = 5;
1327 IconSlideSlowDown = 50;
1329 To better adapt both slow and fast machines the behavior of sliding icons
1330 changed in the following manner:
1332 Old one was to keep moving the icon with a constant step (default 5 pixels)
1333 until it reached the destination.
1335 Now it will use a new parameter named IconSlideSlowDown to speed up or slow
1336 down the moving.
1338 Instead of moving it with a constant step it will use IconSlideSlowDown to
1339 divide the distance to the destination, and use this value as the first step.
1340 Then is will compute the remaining distance and will again use
1341 IconSlideSlowDown to divide it and get the new step. And so on.
1342 When the step to move becomes smaller than IconSlideStep, IconSlideStep will
1343 be used further until the destination is reached.
1345 This way a nice deceleration effect is achieved, since while the icon
1346 approaches destination, it will use smaller steps, gibing the illusion that
1347 the icons is moving slower.
1349 IconSlideDelay will give the pause between steps, and is expressed in ms.
1351 Giving large values to IconSlideSlowDown (>1024 for 1024x768 screen) will
1352 result in the old "constant step advance" behavior, since the computed step
1353 will always be smaller than IconSlideStep, and the last will be used instead.
1355 Making IconSlideSlowDown = 0 or 1, will result in an instant jump to the
1356 destination without any animation.
1359 Attribute editor
1360 ----------------
1362 Because the icon images on screen automatically update after any change in
1363 WMWindowAttributes domain file, the use of both Save and Apply buttons is no
1364 longer needed. If one wants to just apply the setting to the current window
1365 only, he will only use the Apply button.
1366 If he wants them saved for all applications in the same instance and/or class
1367 the using the Save button will write them to disk, and automatically
1368 WindowMaker will update all the icons that need to be updated on screen.
1371 Sound support
1372 -------------
1374 Some basic sound support is now part of WindowMaker. The sound server is not
1375 yet part of WindowMaker distribution, so you need to download it separately.
1376 This is because is linux specific, and need some changes before it can be
1377 included.
1378 Until them if you have a linux system and want to use sound, use the
1379 wmsound-0.5 available at http://www.geocities.com/SiliconValley/Bay/7874
1380 Download that package, and only build the sound server there.
1381 DO NO APPLY ANY PATCHES FROM THERE!, because they are already applied.
1382 Just build the sound and copy the executable in /usr/local/bin
1383 Follow the rest of the install steps described there, except the patch-ing
1384 procedure.
1386 To enable sound for WindowMaker pass --enable-sound to configure.
1388 Also use NoSound = Yes/No; to enable/disable sound at runtime without killing
1389 the sound server.
1391 If you cannot set the sound to work yet, then is not for you.
1392 Wait until the sound server will be fixed and will be part of WindowMaker.
1395 New entries in WindowMaker domain database
1396 ------------------------------------------
1398 The following entries have been added to the runtime options:
1400   SaveSessionOnExit = No;
1402 will autosave (or not) the session state on exit.
1404   WindowPlaceOrigin = "64, 64";
1406 will offset all windows in auto or cascade placement mode with the value
1407 (in pixels) before placing them on screen. First is horizontal direction and
1408 second is vertical.
1409 This do not apply to windows that request a specific position on screen.
1410 This is useful if you want your Clip on the top left corner to not be
1411 overlapped by mapping windows.
1412 It will let it to have a row and a column of docked appicons near the screen
1413 edge, that will not be overlapped by windows.
1414 If you set it to "128, 128" it will have 2 rows and 2 columns not overlapped.
1417   NoSound = No;
1419 Enable/disable sound at runtime without the need of killing the sound server.
1422   MenuScrollDelay = 10;
1423   MenuScrollStep = 5;
1425 Constants for the menu scrolling animation.
1427   IconSlideDelay = 0;
1428   IconSlideStep = 5;
1429   IconSlideSlowDown = 50;
1431 Constants for the icons sliding on screen. Explained above.
1433   ShadeDelay = 0;
1434   ShadeSteps = 15;
1436 Animation parameters for shading a window. How many steps it will take, and the
1437 delay between steps in ms.
1439   DoubleClickTime = 250;
1441 The time for the double click to be considered so. Expressed in ms.
1443   SClipColor = "#6f8ae2";
1445 Color for selected icons in Clip.
1447 All delays are expressed in ms.
1451 --- 0.14.1
1454 *** Enhanced fiend clone.
1456 Here are the new fiend features:
1457 1. Keys for raising/lowering the fiend, and their default values:
1458    FiendLowerKey = None;
1459    FiendRaiseKey = None;
1460    FiendRaiseLowerKey = None;
1462    All reside in WindowMaker configuration file.
1464 2. Added posibility to launch the workspace menu with button1 click on the
1465    idle indicator of fiend, or with button3 click on workspace name on the
1466    fiend.
1468 3. Added Control-button1-click on fiend's idle indicator, to create a new
1469    workspace and move to it. Same action as New item in Workspace menu.
1471 4. Fiend's idle indicator do have a color that reflects its normal/collapsed
1472    state.
1474 5. The delay between changing workspaces from fiend is now a runtime option:
1476    WorkspaceChangeDelay = 700;
1478    in WindowMaker configuration file.
1480 6. Application icons can be moved between dock and fiend now.
1482 7. The way workspaces are changed is controlled now by two runtime options:
1484    AdvanceToNewWorkspace=Yes/No;
1485    CycleWorkspaces=Yes/No;
1487    Both apply to either fiend navigating buttons or to next/prev worksapace
1488    keybindings. Both default to No, and are in WindowMaker configuration file.
1490 8. Also added posibility to advance to new workspace, no matter what value
1491    AdvanceToNewWorkspace have, with Control-button1-click on "next workspace"
1492    fiend button.
1495 *** Theme support ***
1497 Spixmap and tpixmap now work. Their syntax is:
1499 SomeStyleOption = (spixmap, file, color);
1500 SomeStyleOption = (tpixmap, file, color);
1502 - spixmap means scaled pixmap, so the image in the file will be scaled to
1503 adapt to the destination's size.
1504 - tpixmap means tiled pixmap, and the image from file will be tiled in the
1505 destination.
1507 file is searched in the PixmapPath, but can be a full path name.
1509 Color is used depending on which Style option is applied.
1510 For example in case of titlebars, color is used for miniwindows titles color.
1511 You are not restricted in selecting that color, but is better to put one
1512 that matches the overall color of the image.
1514 Currently they apply to all the options that accept (solid, color), or any
1515 type of gradient.
1516 This means they also apply to WorkspaceBack and IconBack, which allows theme
1517 support with the simple use of the setstyle and getstyle utilities.
1518 There is no need for an extra theme manager, just to include the needed
1519 options in the style files.
1521 In case of WorkspaceBack, color is used to be set in the background until
1522 the image gets loaded and displayed. This is to avoid the stippled screen
1523 the X server shows, in case the image is big and loads slow.
1524 There is a small utility in the util directory, named wmsetbg which is
1525 used to set the background image. This is needed for windowmaker not to
1526 freeze while loading and scaling the image.
1527 Currently it is hardcoded in windowmaker to use wmsetbg to set the background
1528 image, and is better to use it since is smaller that other image manipulation
1529 programs, and it is compiled with support for same image types as windowmaker.
1530 Since it comes and is installed with WindowMaker, there will be no need to
1531 download and use an external app, which also may not have support for the same
1532 image types as windowmaker.
1536 --- 0.14.0
1538 *** Fiend clone.
1540 The fiend clone is a dock extender, that lets you dock more than the default
1541 10-12 icons in the dock. It actually lets you dock how many icons you like,
1542 with a current default of 25 per workspace. The fiend have different docked
1543 icons on every workspace. Also the fiend main icon shows you the workspace
1544 you're on and lets you navigate through the workspaces with the small green
1545 buttons on the low right corner.
1546 To save screen space the fiend can be collapsed to the main icon either
1547 from the fiend menu (available with right click on the fiend icons), or
1548 with a double left click on the main fiend icon, which is a toggle for
1549 the collapsed/uncollapsed state.
1550 Collapsed state is marked by a different title color.
1551 Pressing on the small buttons on the low right corner, the workspaces are
1552 changed in increments of 1 to the left or right, but keeping the button
1553 pressed over them will continuously advance through workspaces until the
1554 mouse is moved away from the buttons or the button is released.
1555 The delay between workspace changes is set by FIEND_WKS_CHANGE_DELAY in
1556 src/wconfig.h, and defaults to 700 ms.
1557 Unlike the dock, fiend can hold icons in any directions, and can be placed
1558 in any position on screen.
1560 When an icons is to be docked, but the position can be either in the dock
1561 or in the fiend, the dock will be used first, and the icon will be docked
1562 there.
1564 Here are the new runtime options introduced by the fiend:
1565 Files are located in ~/GNUstep/Defaults/
1567 In WMWindowAttributes:
1568        "Logo.WMFiend" = {Icon = "Cone.xpm";};  - icon for the fiend
1570 In Windowmaker:
1571         FiendMaxIcons = 25;           - the max number of icons in fiend per
1572                                         workspace
1573         FiendTitleFont = "-*-helvetica-bold-r-normal-*-10-*-*-*-*-*-*-*";
1574                                       - the font used to show the current
1575                                         workspace
1576         FiendTitleColor = black;      - color for the uncollapsed fiend title
1577         CFiendTitleColor = "#616161"; - color for the collapsed fiend title
1578         AFiendColor = "#00ba70";      - color for the workspace changing
1579                                         buttons, when active
1580         IFiendColor = "#008000";      - color for the workspace changing
1581                                         buttons, when idle
1583 For the ones who don't want to use fiend, there is a option to wmaker named
1584 -nofiend that can be feed to the command line when starting wmaker.
1585 (This is the equivalent for -nodock, but removes fiend clone).
1587 The syntax of WMState file have changed, but you don't have to worry because
1588 WindowMaker will know to read the old format and will save it and further
1589 will use the new one. You do not need to change your file, for the new version
1590 to work.
1593 --- 0.13.1
1595 *** Enhanced Attribute editor.
1597 Now you can save defaults for all windows.
1598 Please note that only Icon, KeepInsideScree, and sometimes NoAppIcon
1599 can be useful in a normal environment. But others may have other opinion ;)
1600 If you set AlwaysUserIcon default for all windows, note that apps like
1601 asclock, wmload, wmmail, wmrack, will show that icon instead of their
1602 window.
1604 Now Attribute editor also counts for defaults saved for all windows,
1605 (not only the default "No" for all options hardcoded in WindowMaker),
1606 when saving options for some instance.class specification. This is to
1607 save disk space by saving only the options that differs from global defaults
1608 (either defaults for all windows or the hardcoded valued in WindowMaker).
1610 Attribute Editor now updates on the fly the appicon image or creates/deletes
1611 the appicon if you set that options in the Inspector panel and Apply them.
1612 Modifying Icon file, NoAppIcon or AlwaysUserIcon and Applying them will
1613 result in the image update for the app-icon.
1615 Note that if you apply but not save these options, the miniwindow image will
1616 not be updated. This is because app-icon is always on screen so it can be
1617 updated, but miniwindow image is read from the defaults database and from disk
1618 every time you minimize the window and is destroyed when you restore.
1621 --- 0.13.0
1623 *** Atribute editor is working ;).
1625 How it works is quite obvious.
1626 Anyway, here is a short description.
1628 Save   - only save the configuration in defaults database and updates
1629          WMWindowAttributes
1630 Apply  - only applies the values to the current window
1631 Revert - reverts the values from the defaults database
1633 Note that Save and Revert count for the window specification
1634 (instance & class), that are selected, and save/use the values for/from
1635 that.
1637  The Update button will show the icon who's name was typed in the textfield
1638 If the textfield is empty, will try to use the default icon.
1639 Also saving with and empty textfield for icon, uses the default icon.
1641  The Default button will use the icon in the textfield as default icon
1642 and save that value in WMWindowAttributes (Note that in this case is no
1643 need to press the Save button!). Also if the textfield is empty it will
1644 try to use the old default icon, if available.
1646 *** Now menus are saved between sessions, or over a restart.
1648  Just stick them to the desktop, and you will find them over sessions
1649 until you close them.
1650  Please note that only the root_menu, the window switch_menu and the
1651 workspaces_menu can be saved this way.
1653 *** Changed the lousy Windoze menu behaviour.
1655 This applies to 'NextMenuBehaviour = NO;'
1657  Now the items are no more automatically selected if you launch the menu
1658 and the mouse is over some item, if you use a short click to launch the
1659 menu (shorter than the default DBL click time).
1660  If you use a longer click or keep the mouse pressed, the item under mouse
1661 will be selected after that delay, and launched when you will release the
1662 mouse button.
1663  If the click was short, a second one is needed to launch the item.
1665 *** Autoarrange icons is now a runtime option
1668 AutoArrangeIcons = YES/NO;
1669 in 'WindowMaker'.
1671 *** Added configurable horizontal resize threshold
1674   HorizontalResizeThreshold = <n>;
1676 This will make the n pixels at the exterior side of the corner handle
1677 of the resize bar to restrict to horizontal only resize.
1678 Also you can use Shift-click&drag anywhere on the corner handle to
1679 restrict the resize only to horizontal.
1680 Note that the Shift-click&drag does not depend of the configured threshold
1681 and works completely independent.
1683 *** New option for OPEN_MENU (pipe from command)
1685 OPEN_MENU | /foo/bar/script
1687 will make a menu that is dinamically constructed by /foo/bar/script
1690 --- 0.12.0
1692 *** New option for OPEN_MENU
1694 OPEN_MENU /foo/bar/pics xv -root -quit
1696 will make a menu with all files in /foo/bar/pics and precede them
1697 with EXEC xv -root -quit
1699 thus, making a menu with entries like:
1702 "marble.gif" EXEC xv -root -quit marble.gif
1703 "water.jpg" EXEC xv -root -quit water.jpg
1707 *** Multicolor gradients
1709 (mhgradient, colorX, color1, color2, color3, ..., colorn)
1710 (mvgradient, colorX, color1, color2, color3, ..., colorn)
1712 You can put any number of colors >= 2. 
1714 colorX is a special color that is used as the solid color of the
1715 texture when wmaker needs a solid color (like in miniwindow title and
1716 resizebar)
1718 *** PixmapPath format changed
1720 What used to be
1722 PixmapPath = "/usr/local/share/pixmaps:~/foobar";
1724 must now be
1726 PixmapPath = ("/usr/local/share/pixmaps", "~/foobar");
1729 *** Added OffiX DND in dock
1731 Use the "Set drop arguments..." command in the menu and put a %d
1732 where the dropped object string should be substituted, like:
1734 xedit %d
1736 *** Escape thingies for menu and dock commands:
1738 %w - substitute with current selected X window ID
1739 %s - substitute with current selection
1740 %d - substitute with last dropped object
1741 %a(some text) - opens a input box with "some text" as a title. Then,
1742 the text typed will be substituted there
1744 \r, \n - substitute with corresponding characters
1747 *** The WMState file format has changed a little.
1748 The Command field for the dock application list is now a normal string,
1749 instead of a list. So, remove the parentheses and the commas for the command
1750 and join all the parts. Example:
1752 if it used to be
1754 Command = ( xterm," -geometry", "+10+10" );
1756 then make it
1758 Command = "xterm -geometry +10+10";
1761 --- 0.10.2
1763 AutoFocus = NO; disables automatic focusing of windows
1764 when they are first mapped
1767 --- 0.10.1
1769 titlebar gradients are in a single piece now
1771 the WMDock file was merged into the WMState file. You can insert this
1772 file in WMState and set it's key to Dock. For example, if your WMDock
1773 contains:
1776         Applications = { {Command = (); }};
1777         Position = "-64,0";
1778         Lowered = NO;
1781 and WMState contains:
1784         Workspaces = ( "Workspace 1" );
1787 then you can merge both and have:
1790         Workspaces = ( "Workspace 1" );
1791         Dock = {
1792                 Applications = { {Command = (); }};
1793                 Position = "-64,0";
1794                 Lowered = NO;
1795         };
1800 The configuration format has changed!! Forget everything about the old
1801 format.
1803 dockapp was removed and the old version will not work anymore. 
1805 the dialogs require tcl/tk. they will be rewritten in plain C
1808 These are some tips for people upgrading from older versions and don't want
1809 too many unused files around. There is no problem if you decide to keep 
1810 them for a while.
1812         you can  rm -r ~/gnustep if you don't want anything from there
1814         remove the files in /usr/local/share/WindowMaker before installation
1816         the /usr/local/share/pixmaps directory can be removed