Fix some bugs, DisableMiniwindows, _KWM_WIN_ICON_GEOMETRY..
[wmaker-crm.git] / NEWS
blob8b498cbc472f38d6a1642672a2ccdc36b0754e8c
2 NEWS for veteran Window Maker users
3 -----------------------------------
5 --- 0.51.2
8 Appearance Editing in WPrefs
9 ----------------------------
11 Added Appearance/Texture editing capability in WPrefs. Workspace background
12 selection is not yet finished.
15 New Themes
16 ----------
18 Added 2 new cool themes (actually I added in 0.51.1, but forgot
19 to put it here...) from largo (LeetWM) and BadlandZ (STEP2000).
22 Full Screen Maximization
23 ------------------------
25 The FullMaximize window attribute will allow the window to
26 be maximized to the full size of the screen (ignoring anything
27 like titlebar, resizebar, dock, panels etc). It should be usefull
28 for programs that must use the whole screen, like games or things 
29 like presentation programs.
32 --- 0.51.1
34 KDE Application Menu script
35 ---------------------------
37 wkdemenu.sh is a converter from KDE application menu structures to wmaker 
38 menu that can be used as a piped menu. Look wkdemenu.sh for how to use it.
41 Window Edge Resistance
42 ----------------------
44 Window edge resistance was now added. No, feature freeze hasn't been
45 removed. Its just part of the edge resistance rewrite ;)
48 New Theme
49 ---------
51 Added SteelBlueSilk theme
53 Installation Path Changes
54 -------------------------
56 Default configuration data installed in /usr/local/etc/WindowMaker
57 or $(sysconfdir)/WindowMaker
60 --- 0.51.0
62 Window Maker has become a GNU program (part of the GNU Project).
64 Title text drop shadow
65 ----------------------
67 drop shadow option added for titlebar text. The is a compile time 
68 option which needs to be defined in src/wconfig.h after you run
69 configure and before you run make.
71 New options and syntax for your WindowMaker domain file are:
73   Shadow = yes/no;
74   FShadowColor = <color>;  
75   PShadowColor = <color>;
76   UShadowColor = <color>;
77   MShadowColor = <color>;
79 The shadow option is dynamic (no need for a restart).
80 MShadowColor is for the menu title text.
82 libPropList
83 -----------
85 WARNING!!! libPropList was removed from the Window Maker distribution
86 and is being distributed separately. If you dont have it installed yet,
87 get it from ftp.windowmaker.org/pub/libs and install before building
88 Window Maker.
91 signal handling change
92 ----------------------
93 SIGHUP will exit wmaker instead of restarting it!!! This is because
94 GNOME expects the window manager to exit instead of restarting...
95 Complaints should go to gnome people. SIGUSR1 will restart wmaker now.
98 script change
99 -------------
100 WINGs-flags was removed, and replaced by get-wraster-flags.
101 Please remove WINGs-flags from your system, since it was obsoloted by
102 get-wraster-flags.
103 Continuing to use WINGs-flags can lead to hazardous effects, since is no
104 longer updated.
107 docklib
108 -------
110 docklib is a little library for making dock applets. It's in the
111 docklib-0.0.tar.gz file. Unpack it and read the README file there.
114 Option Changes
115 --------------
117 Removed OnTopTransients option
119 Added OpenTransientOnOwnerWorkspace
122 Olwm Hint Support
123 -----------------
125 OPEN LOOK(tm)/olwm hints support was added.
127 Read the appropriate section in the README file.
131 --- 0.50.1
133 New option for WorkspaceBack. mpixmap is the same as spixmap, but
134 it will scale the pixmap by keeping the aspect ratio (maximize or maxpect).
135 The option only works for workspace backgrounds.
137 Also added IGNORE_PPOSITION compile time flag, which is equivalent
138 to NoPPosition from fvwm. 
143 --- 0.50.0
146 KDE and GNOME
147 -------------
149 Added full support for GNOME and KWM hints. 
150 Read the INSTALL file to see how enable them.
152 Everything in the so called GNOME window manager bla bla bla pseudo-spec is
153 implemented.
155 As for KDE stuff, it implements 90% of everything kwm does, adds some
156 Window Maker specific extensions to it and still uses half of the memory
157 kwm does, which should be enough to let you dump kwm ;) For details on what
158 exactly is implemented, see comments in src/kwm.c Read the README.KDE file 
159 for more information.
162 WARNING: Some KDE hints are badly designed, so doing things like using
163 kpanel's desktop switcher/pager and Window Maker's internal workspace
164 management functions to create, destroy and rename workspaces at the same 
165 time might cause unknown effects. To be on the safe side, only
166 use either of them to manage workspaces. Switching workspaces is hopefully,
167 safe, so you can switch workspaces from wherever you want.
171 Workspace Specific Background Images
172 ------------------------------------
174 Use the WorkspaceSpecificBack to set background images for specific
175 workspaces. The WorkspaceBack is used as the default background image.
177 Example:
179 WorkspaceSpecificBack = ((solid, red), (cpixmap, ship.jpg, gray), (), 
180                                 (dgradient, red, blue))
182 This will set the background image of workspace 1 to (solid, 0),
183 2 to ship.jpg and 4 to a gradient. Workspace 3 and other workspaces
184 will have the image defined by WorkspaceBack.
186 Note that this uses quite some memory...
189 setstyle/getstyle
190 -----------------
192 setstyle now accepts the -nofonts flag, which will load the style
193 file ignoring all font related options.
195 Example:
197 setstyle -nofonts Blabla.style
200 getstyle can be used to create theme packs. See the usage in the
201 WindowMaker/README.themes file.
205 New Texture Type
206 ----------------
208 Textured gradients will tile a texture pixmap and combine it with a gradient, 
209 using an arbitrary opaqueness. 
211 Syntax is (thgradient, <file>, <opaqueness>, <color1>, <color2>)
212           (tvgradient, <file>, <opaqueness>, <color1>, <color2>)
213           (tdgradient, <file>, <opaqueness>, <color1>, <color2>)
214 where:
215 <color1> and <color2> are the colors for the gradient,
216 <file> is the texture file and
217 <opaqueness> is the opaqueness to merge the texture witht the gradient,
218 ranging from 0 to 255.
220 Example:
222 (thgradient, "BlueImage.jpeg", 120, white, black)
224 The BlackTexture style and Checker theme are examples.
226 Hints:
228 You can use any type of pixmap file for this, but small (like 64x32)
229 grayscale pixmap files should get the best results (fast and low memory
230 usage). You can use color pixmaps, but it is harder to get the desired effect
231 with them.
233 Be warned that this texture type is the slowest.
237 New Options
238 -----------
240 IconTitleBack and IconTitleColor control the color of the
241 miniwindow title. Both of them are colors.
243 Example:
244 IconTitleColor=white;
245 IconTitleBack=black;
248 Since this introduces an incompatibility in themes and getting flamed by the
249 themes ppl isn't the most pleasant thing ("Whaddafuk you're thinking!? You
250 just broke 500 themes!!!" ;) the setstyle command was hacked so that it will
251 make old themes work as before, by trying to automatically set the above
252 options. Note that in some cases it will not have exactly the same results as
253 before.
256 StartMaximized window attribute. Will maximize the window when it
257 is mapped.
260 AutoRaiseLower option for the Clip. This allows automatic Raise/Lower of the
261 Clip icons when the mouse pointer enter/leave the Clip. To avoid unwanted
262 raising/lowering there is a time threshold before raising/lowering.
263 The thresholds can be changed in wconfig.h by changing one or both of
264 AUTO_LOWER_DELAY and AUTO_RAISE_DELAY (expressed in miliseconds).
265 For example if you set AUTO_RAISE_DELAY to 0, then the Clip will be raised as
266 soon as the mouse pointer enters it's area. Setting AUTO_RAISE_DELAY to a very
267 big value, will make the Clip to practically do not auto raise unless clicked,
268 but to be automatically lowered after AUTO_LOWER_DELAY (ms) when leaved.
271 New ThemePack Format
272 --------------------
274 Starting with this version, a new format of themes is being supported.
275 Before you open pine and start composing your flame, rest assured that
276 the old format is still supported. The new format is documented
277 in the WindowMaker/README.themes file.
280 Root Menu 
281 ---------
283 The -noext option for OPEN_MENU will strip whatever is after the last .
284 in file names that appear on the opened directory. So,
286 OPEN_MENU ~/bg WITH xv -root -quit
288 will create a menu with all the images in ~/bg without the extension.
292 --- 0.20.3
295 Icon (miniwindow) stacking
296 --------------------------
298 If you want miniwindows to reside under normal windows, edit
299 wconfig.h and change WNormalLevel (just grep for it) to
300 WDesktopLevel
303 5 Button Mouse
304 --------------
306 If you have a 5 button mouse and want to give some utility for
307 the extra 2 buttons, edit the appropriate line in src/wconfig.h
308 Clicking Button4 in the root window will switch you to the previous 
309 workspace and Button5 will do that for the next.
312 Option Changes
313 --------------
315 put NoWindowOverDock back
317 KeepOnBottom window attribute
320 -static command line option
321 ---------------------------
323 wmaker -static will start Window Maker in static mode. This will
324 prevent wmaker from checking or making any configuration changes.
325 That makes it possible to run wmaker before running wmaker.inst
328 Hysteresis for menu item selection
329 ----------------------------------
331 Hopefully it's intelligent enough, so you won't notice it.
333 In case you want to know what's it, it's equivalent to that
334 (insanely long) 2 second delay present in that Windoze95 menu, 
335 but more usefull than annoying (I hope :). To see it, do the following
336 with your current wmaker version and later with 0.20.3:
338 - open the apps menu and stick it
339 - click in the item for the "Workspaces" submenu and hold
340 - drag the mouse to the 4th or bigger entry (like "Workspace 4") in a
341 straight line, trying to select the target item before the submenu
342 is unmapped when you dragged over other items in the main menu
346 Window Shortcuts
347 ----------------
349 Window shortcuts are shortcuts to arbitrary windows. You can make up to 4
350 shortcuts. To assign a previously bound shortcut to a window use the "Select
351 Shortcut" submenu in the window commands menu. If the shortcut is not yet
352 assigned for any window, you can hit the shortcut to assign it to the active
353 window. The shortcut will do the same as clicking in an entry in the window
354 list menu. The keys for the shortcuts are defined in the ~/G/D/WindowMaker
355 file or in WPrefs.app
357 Option names are:
359 WindowShortcut1Key through WindowShortcut4Key
362 --- 0.20.2
365 The name of WindowMaker was changed to Window Maker.
367 Window creation animation disabled by default.
369 xdaliclock -shape
370 -----------------
372 If you use it edit src/wconfig.h and #define OPTIMIZE_SHAPE or disable the
373 titlebar and resizebar for the window. OPTIMIZE_SHAPE will remove the
374 flickering for xdaliclock and other programs that change their shapes often,
375 but will increase network traffic considerably. So, if you use xdaliclock
376 from a remote machine it can get slow.
379 Applications Menu
380 -----------------
382 The applications menu will now use the shell in the SHELL environment
383 variable to execute EXEC menu commands. If it is unset (I think it's always
384 automatically set by the shell program) it will use /bin/sh
387 Extra fancy icon kaboom :)
388 --------------------------
390 Edit src/wconfig.h and #define ICON_KABOOM_EXTRA to get
391 more effects for the icon undocking animation.
393 Options for superfluous stuff are even more superfluous, so this
394 will not become runtime.
397 XDE drag and drop support
398 -------------------------
400 Support for XDE drag and drop was added (by "]d" <id@maliwan.org>).
401 To enable, edit src/wconfig.h
402 The support works with gtk 1.1.2
405 libPropList
406 -----------
408 libPropList will now be built automatically by wmaker. Wich means
409 the (simplified) building process is now:
411 ./configure
412 make
413 make install
415 instead of:
417 tar xzf libPropList.tar.gz
418 (cd libPropList; make)
419 make
420 make install
422 You also don't need to worry about GNOME libPropList incompatibilities
423 anymore. 
426 Bug with focus lost in sloppy focus fixed
427 -----------------------------------------
429 The bug only occurs in sloppy or auto focus modes, with AutoFocus disabled
430 and Superfluous enabled. There is no easy/clean way to fix this, so Window
431 Maker will disable the animation of window creation if the focus mode is
432 either sloppy or auto AND AutoFocus=NO.
434 If you want the animation, enable AutoFocus or use manual focus mode
435 (prefered). 
438 The NoWindowUnderDock option was removed
439 ----------------------------------------
440 To obtain the same result, use the "Keep Dock On Top" option in the dock menu.
443 Persistent Program Suplied Icons
444 --------------------------------
446 Application supplied icons are now stored, so that the dock will keep
447 showing them after the app is exited. The icons are stored at
448 ~/GNUstep/.AppInfo/WindowMaker/
451 Sound support
452 -------------
454 Sound support is now on by default. Even if you don't use sound the overhead
455 is very small, and has no impact on performance. If you still want to
456 optimize it and remove a few hundred of bytes, then use --disable-sound or
457 --enable-sound=no options when you configure Window Maker.
460 --- 0.20.0
462   
463 Multihead support. wmaker will now manage all screens that are attached to the
464 display. 
465 ------------------------------------------------------------------------------
466   
468 It does so from a single process (instead of spawning a new process for each
469 screen, like fvwm does). This keeps memory usage a lot lower than fvwm.
471 State files have a suffix .n, where n is the number of the screen.
473 Since I don't have a real multiheaded machine, it probably has bugs.
475 Superfluous
476 -----------
478 Yet another useless superfluous animation. Find out what exactly it is
479 by yourself :)
482 exitscript
483 ----------
485 ~/G/L/W/exitscript will be called automatically when wmaker is exited.
488 New runtime options
489 -------------------
491 1. Miniaturization animation is now selectable by a runtime option
492 Add a line with
494 IconificationStyle = <style>;
496 to your WindowMaker configuration file.
497 <style> can be one of: Zoom, Twist, Flip or None
498 Case doesn't matter, and default is Zoom.
501 2. Edge resistance.
502 This can be controlled by setting:
504 EdgeResistance = xxx;
506 in your WindowMaker configuration file.
507 xxx is an integer greater than 0 and represents the number of pixels of edge
508 resistance. Setting it to 0 (default) will disable this feature.
510 New theme
511 ---------
513 A new theme named Night, is available in this distribution.
517 --- 0.19.3
519 GIF support was added. You will need libgif 2.2 to use it.
521 cpixmap added. Syntax is the same as tpixmap or spixmap
524 --- 0.19.2
526 getstyle will include IconBack info in Style files.
528 --- 0.19.0
530 libPropList was updated. If you have it installed, you must upgrade or
531 WPrefs will crash because of bugs in libPropList.
533 New options
534 -----------
536 Balloons!
537 ---------
539 WindowTitleBalloons = YES;
540 will enable balloons for window titles that are not fully visible.
542 MiniwindowTitleBalloons = YES;
543 will enable balloons for miniwindow titles.
545 AppIconBalloons = YES;
546 for application icons (docked or not)
549 IconPosition
550 ------------
552 IconPosition (the position of the icons) is specified as:
554 IconPosition = c1c2c3;
556 where:
558 c1 can be t or b (meaning top or bottom)
559 c2 can be l or r (meaning left or right)
560 c3 can be v or h (meaning vertical or horizontal)
562 case is insensitive.
564 For example, 
565 IconPosition = blh;
567 is the old iconPosition position.
569 IconPosition = trv;
571 will place the icons over the Dock.
573 New window attribute
574 --------------------
576 EmulateAppIcon = YES; will make the window have an application icon.
577 Only use this option for fully specified windows (like rxvt.Rxvt).
578 NEVER use in generic window specifications (like * or rxvt).
579 You must restart the application for the attribute to take effect.
582 WPrefs.app
583 ----------
585 Read WPrefs/README
588 --- 0.18.1
590 Boolean balues have changed!!! YES, Y and any non-zero integer will
591 mean TRUE and anything else (including True) will mean FALSE. This
592 is to conform to the OpenStep values used for booleans and
593 not cause headaches later, when GNUstep apps also starts using
594 defaults and users will try using True wich won't get recognized.
597 --- 0.18.0
599 Clip
600 ----
602 Clip button layout was changed. IT IS TEMPORARY AND THE DEFINITIVE LOOK
603 WILL BE DIFFERENT!!!
606 libPropList
607 -----------
609 More bugs were fixed in it. Upgrade the library if you have an older version
610 installed, with the one included.
613 Property list menus
614 -------------------
616 Format for property list menus has changed! The redundant array for
617 submenus was removed, so a menu that looked like:
619 ( Applications,
620   ("Xterm", EXEC, "xterm"),
621   ( 
622     (Paint,
623         ("Gimp", EXEC, "gimp"),
624         ("XV", EXEC, "xv")
625     )
626   )
629 must be changed to:
631 ( Applications,
632   ("Xterm", EXEC, "xterm"),
633   (Paint,
634         ("Gimp", EXEC, "gimp"),
635         ("XV", EXEC, "xv")
636   )
641 Misc
642 ----
644 NUMLOCK_HACK is back. This time it works and is enabled by default.
645 If you think you don't need it and promise me that you won't send 
646 "bug" reports saying that shortcuts stop working after a while, you can
647 disable it ;) It will save some memory and CPU.
650 Configuration
651 -------------
653 Removed the SwapMenuButton option and added 3 finer grained options:
655 SelectWindowsMouseButton
656 WindowListMouseButton
657 ApplicationMenuMouseButton
659 Values that can be used are Left, Middle, Right and Button1 through Button5
660 Left is equivalent to Button1, Middle to Button2 and Right to Button3
663 Removed the WorkspaceChangeDelay option and corresponding action.
664 Removed AClipColor and IClipColor
667 Added the SelectKey back
670 Changed default binding of Window commands menu from F10 to Control+Escape
672 --- 0.17.4
674 Misc
675 -----
677 libPropList has changed! Upgrade it before compiling wmaker.
679 Hopefully the bugs that caused wmaker to crash if an error is found
680 in the config files is fixed. If you do crash wmaker with a bad
681 file, please try to find out the smallest possible portion of the file
682 that still crashes wmaker and send it to me.
685 New Options
686 -----------
688 PixmapPath was split to PixmapPath and IconPath. PixmapPath is the path
689 for the pixmaps used as textures and IconPath is for the icons. 
690 Don't forget to add IconPath to your current configuration file.
692 There's also a new library in ~/GNUstep/Library/Icons. You should place
693 your icons there, since icons are not a WindowMaker specific resource.
696 DontConfirmKill=YES; will disable the confirmation panel for Kill
699 --- 0.17.3
701 Interface Changes
702 -----------------
704 Unhide Here in the appicon menu was changed to be the first entry.
705 This way you can unhide the appicon with a single click without
706 even moving the pointer.
709 Clip Commands
710 -------------
712 The collect icons commands was renamed to attract icons and
713 the attract icons options was renamed to Auto attract icons.
715 The Remove Selected Icons was renamed to Remove Icon(s). It will
716 act as before if some icon is selected and will remove the clicked
717 icon (without confirmation) if it is not.
719 Added a Keep Icon(s) command that will keep the selected icons if
720 any is selected and the current one if none.
722 The Move To command was renamed to Move Icon(s) To.
725 --- 0.17.0
727 If you have libPropList installed, you might want to reinstall it,
728 replacing with the included libPropList. It has a small bug fix.
730 Misc. Changes
731 -------------
733 Removed --with-gnome and made MWM_HINTS defined by default.
734 This means that "GNOME support" will work with no additional
735 flags passed to configure. 
737 Added support for KDE, by adding a DisableWorkspaceMouseActions option.
738 Set it to YES and run krootwm to be able to use everything in kfm.
741 Shortcuts for Root Menu
742 -----------------------
744 There is now a new SHORTCUT optional keyword for the menus.
745 For example, you can bind Control-F1 to xterm with:
747 "XTerm" SHORTCUT Control+F1 EXEC xterm
749 or F2 to ARRANGE_ICONS with:
751 "Arrange Icons" SHORTCUT F2 ARRANGE_ICONS
754 All commands allowed in the menu file accept the keyword, except for
755 MENU and OPEN_MENU
758 Interface Changes
759 -----------------
761 ** Configuration of docked applications is now done in a panel instead of
762 in the menu. 
764 ** Added a command menu for application icons
766 ** Shift double-click on the application icon will unhide the app
767 in the current workspace.
770 Option Changes
771 --------------
773 NotMiniaturizable option changed to NoMiniaturizeButton
774 NotClosable option changed to NoCloseButton
777 Speed options values are now UltraFast, Fast, Medium, Slow or UltraSlow
778                                               ^^^^^^
780 Removed the Select keyboard binding. You can access it in the window
781 commands menu.
783 Removed the ClipMaxIcons option and made it a compile time option.
785 Removed the ConstrainWindowSize option
787 Renamed NoSound to DisableSound
789 Renamed NoAutowrap to DontLinkWorkspaces
791 Renamed NoDithering to DisableDithering
793 Renamed NoAnimations to DisableAnimations
795 Removed the LeftHanded option and added a SwapMenuButton option.
796 SwapMenuButton will make the rubberband selection in the root window
797 be bound to the right button and the root menu to the left button.
800 New way to display temporary icons
801 ----------------------------------
803 The icons that are attracted by Clip, but will not be kept after the
804 application close, are now using a different color for shading, unlike previous
805 version that always used white. This will improve look for very different color
806 combinations, and allow the user to control the look of the shaded icon.
807 The color used for shading the icons is computed as follows:
809 First a color is computed depending on the IconBack type:
810  - for solid the color is the solid color itself.
811  - for simple gradients the color is (from_color + to_color)/2.
812  - for multiple gradients, the color is the first color in list.
813  - for pixmaps, the color is the solid color specified for that pixmap.
815 Then the color is made lighter by multiplying each red/green/blue filed with
816 1.7 and limiting each field to 0xff in case they exceed this value.
817 Then this new color will be used by superposing it with the icon we want to
818 shade, using a proper alpha value.
820 To control the color for shading is simple:
822 - In case of multi gradients you just need to put the first color, as the color
823 you like. WindowMaker do not use the first color in the list to directly build
824 the gradient, but only when it needs a solid color for something (like in this
825 case).
827 - For pixmaps, put the needed color as the solid color the syntax for pixmaps
828 require. This color is also not used when displaying normal icons, just when
829 solid colors are needed (like this case).
831 - For solid color, or simple gradients, in case the color it uses after
832 computing is not good enough, you can always convert the solid or simple
833 gradient to a multi gradient with the same look, and use that one. In this
834 case is simple, just put the needed color as first color in list.
836 Please note that this will not slow down WindowMaker, because the IconBack is
837 read only once at startup, and then only if it is changed. After reading it WM
838 will construct the image of the tile, and use the image instead of recomputing
839 the gradient every time.
841 Here are 2 examples of converting solid or simple gradient to a same looking
842 multi gradient:
844 IconBack = (solid, Blue);
845 will become
846 IconBack = (mhgradient , LightBlue, Blue, Blue);
847 using LightBlue as color for shading.
849 IconBack = (dgradient, "#284569", "#082420");
850 will become
851 IconBack = (mdgradient, "#183454", "#284569", "#082420");
852 looking the same, but using #183454 for shading.
855 New Sound Server Location
856 -------------------------
858 The sound server new URL is http://www.frontiernet.net/~southgat/wmsound
859 Also it seems to be running on FreeBSD too (with little changes maybe).
862 --- 0.16.1
864 WINGs
865 -----
867 The path for the WINGs resource files was changed. If you don't
868 do make install, you must move /usr/local/share/WindowMaker/Resources to
869 /usr/local/share/WINGs
872 New Options
873 -----------
875 The following new options are available:
876 NewStyle = Yes/No; (static) Replaces --enable-newstyle
877 DisableDock = Yes/No; (static) Same as -nodock command line option.
878 DisableClip = Yes/No; (static) Same as -noclip.
879 Superfluous = Yes/No; (dynamic) Replaces --enable-superfluous.
881 NOTES.
882 - The static options are only read at startup. Changing them, needs to restart,
883   so they will be accounted.
884 - DisableDock and DisableClip have lower precedence than -nodock -noclip
885   command line options. If both option/command line option are given, then the
886   command line option will be accounted.
889 Start Hidden option
890 -------------------
892 The start hidden option was fixed, and made to be an application wide option.
893 It will apply to every window the application owns. Also its place in the
894 Attribute Inspector panel, changed accordingly, to reflect this.
895 The start miniaturized is however still applying to particular windows of an
896 application, unless the option is set for the class.
897 Start miniaturized, will override start hidden if both set.
899 IMPORTANT NOTE.
900 Because of the way Netscape Communicator is implemented, it is NOT possible
901 to set the start hidden or miniatirized flags for it. This is because Netscape
902 chooses to send a second map event to the window it maps. This makes the
903 window to receive a second map request and to be unhidden or maximized back,
904 immediately after it was hidden or miniaturized by WindowMaker at startup.
908 --- 0.16.0
910 Misc. Changes
911 -------------
913 The NextMenuBehaviour option was renamed to WrapMenus
914 The WorkspaceTiedMiniwindows option was renamed to StickyIcons
916 The .tif files were renamed to .tiff
919 Selecting Mini Windows
920 ----------------------
922 Now miniaturized windows can be selected as well as normal windows.
923 You can do this by Shift-Click-ing them. They will be marked, and will follow
924 you through workspaces like normal selected windows do.
925 Miniaturizing a window will no longer deselect the window, but will place the
926 icon and mark it as selected.
927 The only difference between miniaturized and normal window selection is that
928 for the moment the rubber-band selecting method works only for normal windows.
931 Icon Selection Panel in Attributes Editor
932 -----------------------------------------
934 Now, selecting icons is as easy as clicking in the file name in a list.
937 Simplified Options
938 ------------------
940 IconSlideStep, IconSlideSlowDown and IconSlideDelay were merged to 
941 IconSlideSpeed
943 MenuScrollStep and MenuScrollDelay were merged to MenuScrollSpeed
945 ShadeStep and ShadeDelay were merged to ShadeSpeed
948 Valid values for them are: Fast, Normal, Slow or UltraSlow
950 If you want to fine tune the values, they can be changed in wconfig.h
951 Send me your set of values with an indication of how fast is your hardware,
952 so that I can make the default values more adequate.
955 New Window Attributes
956 ---------------------
958 Added StartMiniaturized and StartHidden as window attributes and
959 removed the previous implementation. Also removed the dock menu entries.
960 They are now settable in the Attributes Panel.
962 Also added DontSaveSession attribute. This way, you won't end up with multiple
963 unwanted copies of the same app after the previous session is restored.
964 I start X with a xterm in .xinitrc instead of wmaker, wich will cause the
965 xterm restored by wmaker be duplicate. Just add -name something to the
966 xterm started form .xinitrc and mark DontSaveSession=YES for that window.
970 User Specifiable Visual IDs
971 ---------------------------
973 wmaker now supports different visuals than the default one. It isn't of much
974 use for most people, but can be usefull for lucky SGI users who want it
975 to use TrueColor instead of the default PseudoColor.
977 wmaker -visualid VISUAL_ID
979 where VISUAL_ID is the hex code for the visual you want.
981 Note: I don't have an SGI box and haven't tested it...
985 Starting Workspace
986 ------------------
988 The starting workspace is identified in the following order:
989 1. If the app is omnipresent will be mapped on the current workspace.
990 2. Else if the application have a StartWorkspace option set as attribute
991    then this one will be used.
992 3. Else, if the application was started from Clip, the workspace on which
993    the Clip from where it was started is used.
994 4. Else the current workspace is used.
996 Restoring saved sessions will always use the saved workspace, no matter
997 what other options are, except onmipresent.
1001 --- 0.15.1
1003 Workspace specific mini windows
1004 -------------------------------
1006 The minimized windows can be workspace specific, being more consistent with
1007 the rest. This is because minimized window represents just another state of a
1008 window (like normal or shaded), which all are workspace specific.
1009 This (or the old "present anywhere") behavior can be set using an option in
1010 the WindowMaker database: WorkspaceTiedMiniWindows = Yes/No;
1012 New way to animate the blowing icons
1013 ------------------------------------
1015 There is now a compile time option that allows one to set how the icons are
1016 animated when detaching from dock/clip in superfluous mode.
1017 By default the classic "Falling pieces" animation is used.
1018 If SPREAD_ICON is #define-ed in wconfig.h, then a "Spread in four directions"
1019 animation is used instead. Take a look at the section where this is described
1020 in src/wconfig.h
1021 By default there is #undef SPREAD_ICON to select "Falling pieces" animation.
1023 Auto Colapse for Clip
1024 ---------------------
1026 The clip now supports an option named "Auto Collapse" which can be set from
1027 the clip main menu. When set, clip will stay collapsed, and will show itself
1028 when the mouse moves over it. While the mouse is over it, or over any of the
1029 icons attached to the clip, the clip will stay uncollapsed, letting you to
1030 access the attached icons. This is not true for applications like asclock, or
1031 applets of that kind, because the icon window do not belongs to WindowMaker,
1032 but to the application itself. For such icons you must keep the mouse over the
1033 icon groundplate, else it will collapse back. But usually these type of icons
1034 will not stay in a collapsed clip, since one needs to see what they show.
1035 When the clip is leaved it will collapse back after a delay of 1 second, unless
1036 the mouse is moved back to the clip area. The delay can be set modifying
1037 AUTO_COLLAPSE_DELAY in wconfig.h. Default is 1000 (ms) which means 1 second.
1042 --- 0.15.0
1044 Changed name from Fiend to Clip
1045 -----------------------------------
1047 All occurrences of word Fiend with or without capital F were replaced with
1048 the corresponding Clip (same capital).
1049 This affects all configuration files under ~/GNUstep that contain this word.
1050 It can be refered as "Workspace Dock" too.
1053 New option in Clip menu, and extended Clip behavior
1054 ---------------------------------------------------
1056 The following new items are available in the dock menu:
1058 1. Attract Icons
1059 2. Keep Attracted Icons
1060 3. Collect Icons
1061 4. (Un)select All Icons
1062 5. Remove Selected Icons
1063 6. Move To
1064 7. Start miniaturized    (also available for regular dock)
1065 8. Start hidden          (also available for regular dock)
1066 9. Selected
1067 10. Set icon...          (also available for regular dock)
1070 Here is what they do:
1072 1. "Attract Icons" will let the Clip to attract and attach any new appicon that
1073    is created when an application starts. It will not do this if the Clip is
1074    full. If the Clip is Collapsed then the appicon will be hidden after it is
1075    attached.
1076 2. "Keep Attracted Icons" will tell the Clip to keep the attracted appicons,
1077    after the application is closed. Without this the appicons will vanish,
1078    leaving the Clip in the original state. If you move an appicon that was
1079    attracted from Clip to regular Dock, it will be kept when closed, no matter
1080    what "Keep Attracted Icons" is set to in Clip.
1081 3. "Collect Icons" will collect all appicons that are not yet attached to Dock
1082    or Clip, and attach them to the current workspace Clip. The value of
1083    "Keep Attracted Icons" will apply when applications close. If Clip is
1084    collapsed, the appicons will be hidden.
1085 4. "(Un)select All Icons" will select all icons in the clip if none is
1086    selected, or it will deselect all selected ones. The selected icons are
1087    marked using a small triangle in the bottom right corner of the appicon.
1088    The color of the mark is set using SClipColor in WindowMaker domain
1089    database.
1090 5. "Remove Selected Icons" will remove from Clip all selected icons. The ones
1091    that still run, will be detached, all the others will vanish.
1092 6. "Move To" will transfer all selected icons to another workspace and attach
1093    them to the Clip in that workspace. If none is selected, only the one the
1094    mouse was pressed on will be moved.
1095 7. "Start miniaturized" will launch (or autolaunch if set) the application in
1096    a miniaturized state.
1097 8. "Start hidden" will launch (or autolaunch if set) the application in a
1098    hidden state. Note that only one of the two can be set at a time.
1099 9. "Selected" can be used to toggle the selected state of the appicon
1100    individually. The same can be achieved using Shift-LeftClick on the appicon.
1101    In fact the intended way of toggling the selected state is by using
1102    the Shift-LeftClick on icon. The menu entry is just another way to do the
1103    same.
1104 10. "Set icon..." will allow one to set the image for the appicon. The image
1105    will be updated without restart, and also all appicons in the same
1106    instance.class as the one we set for, will be updated.
1108 So a simple way of avoiding the screen to be filled up with appicons is to set
1109 the "Attract Icons" in the Clip. Also the "Keep Attracted Icons" can be set to
1110 No, so the attracted icons will be deleted when application exits, thus leaving
1111 the Clip clean. If also one to not want to see the appicons that keep filling
1112 the Clip, he can set the Clip to be Collapsed.
1114 Getting rid of unneeded icons in Clip is as simple as selecting them
1115 individually using Shift-LeftClick, and then using the "Remove selected Icons"
1116 entry in menu.
1119 Support for different visuals.
1120 ------------------------------
1122 WindowMaker is now able to support any visual, except DirectColor, in any
1123 depth from 1bpp to 32bpp.
1125 One can start the X server with different visuals, by passing the X server the
1126 right option. For XFree 3.3.x is -cc <id>.
1127 WindowMaker is not yet able to choose a different visual from the Default one
1128 on a given screen, but can use any default visual it finds, except the direct
1129 color visual.
1130 For example starting X like (for XFree 3.3.x, and if the driver for the
1131 card supports this. Read the man page for your X server):
1132 startx -- -bpp 8 -cc 0 will give you the StaticGray visual.
1133 startx -- -bpp 8 -cc 1 will give the GrayScale visual
1134 and so on.
1136 Wrlib code is now generic, and will support any visual except DirectColor in
1137 any depth. Programs written with wrlib can work on different visuals from
1138 the default visual for a given screen.
1139 Behavior in different visuals can be tested using the testgrad program in
1140 wrlib subdirectory in distribution.
1141 testgrad -h will show the usage.
1143 Multidiagonal gradients are also implemented now in wrlib, and a new algorithm
1144 is used to speed up the generation of diagonal gradients.
1147 New arrangement of the directory structure under ~/GNUstep/
1148 ---------------------------------------------------------------
1150 To better adapt to theme support the directory structure changed under
1151 ~/GNUstep/Library/WindowMaker
1153 1. Style directory moved to Styles.
1154 2. Added the following directories: Backgrounds, IconSets, Pixmaps, Sounds and
1155    Themes.
1156 3. The .style files no longer get copied in the user's Styles directory.
1157    Instead they are read from the global /usr/local/share/WindowMaker/Styles
1158    directory.
1160 Under ~/GNUstep/Defaults the following changes occurred:
1162 1. A default WMState is installed by wmaker.inst.
1163    It contains the dockit program assigned to the top icon of the dock, and
1164    the wmsetbg program assigned for the drop command on both dock's and clip's
1165    main icon.
1166    Double clicking the dock's main icon will bring up dockit that will let you
1167    dock any application that do not have an application icon.
1168    Dropping an image on dock's or clip's main icon, from an Offix DND aware
1169    application, will put the image on the background tiled, and will update
1170    WindowMaker domain database file.
1171 2. Syntax of WMState changed a little. The old position will not be restored
1172    when you will first start the new version, but after that it will be
1173    normally remembered. This is because now the main clip icons is only saved
1174    once, not for every workspace.
1175    You should replace Fiend with Clip in any place where it appears, if you
1176    want to keep the old WMState file, else it will not work.
1177 3. At compile time, it will detect if you have support for tif, and will
1178    install a WMWindowAttributes with corresponding image name extension
1179    (.tif or .xpm). This is true only for pixmaps that come with the source
1180    distribution and get installed under /usr/local/share/WindowMaker/Pixmaps
1182 The menu file changed a lot. Old menu file will *not* work with new theme
1183 support, so please upgrade.
1186 New behavior of OPEN_MENU command
1187 ---------------------------------
1189 The OPEN_MENU command now supports the following syntax:
1190 1. File menu handling.
1191    // opens file.menu which must contain a valid menu file and inserts
1192    // it in current position
1193    OPEN_MENU file.menu
1194 2. Pipe menu handling.
1195    // opens command and uses it's stdout to construct menu.
1196    // Command's output must be a valid menu description.
1197    OPEN_MENU | command
1198 3. Directory handling.
1199    // Opens one or more directories and construct a menu with all
1200    // the subdirectories and executable files in them sorted alphabetically.
1201    OPEN_MENU /some/dir [/some/other/dir ...]
1202 4. Directory handling with command.
1203    // Opens one or more directories and construct menu with all
1204    // subdirectories and readable files in them sorted alphabetically,
1205    // preceding each of them with command.
1206    // WITH is a required keyword!!!
1207    OPEN_MENU /some/dir [/some/other/dir ...] WITH command -options
1209 Please note that because of the 'WITH' keyword old menu files no longer work
1210 for the OPEN_MENU with a command.
1213 Theme support
1214 -------------
1216 Theme support is now as easy as untar-ing a tarball in the right place.
1217 Because of the way OPEN_MENU works, they can be installed on a global
1218 shareable basis, or for personal user use.
1219 Themes installed under ~/GNUstep will be available only for a user, but
1220 if if they are installed under /usr/local/share/WindowMaker they will be seen
1221 by all users. This is also true for style files, background images, pixmaps,
1222 etc that get installed under /usr/local/share/WindowMaker.
1223 Themes can be saved or loaded using the Appereance menu.
1225 Also support for different IconSets is available. You can save or load a new
1226 IconSet using the Appereance menu.
1228 Setting background images is now as simple as putting the images in the right
1229 place (~/GNUstep/Library/WindowMaker/Backgrounds or
1230 /usr/local/share/WindowMaker/Backgrounds, or any other place in your
1231 PixmapPath). Then use the Appereance menu. They will be instantly available
1232 since they are opened by a OPEN_MENU command. Also the image do not need to
1233 have a .jpg or any other extension. It will be recognized anyhow.
1234 As an example please see the OpenStep theme supplied with WindowMaker.
1235 The OpenStep image is a jpeg file without extension.
1237 Please keep in mind that anything under /usr/local/share/WindowMaker will be
1238 available for all users.
1241 New options for wmsetbg and getstyle
1242 ------------------------------------
1244 wmsetbg now accepts the following options:
1245 usage: wmsetbg [-options] image
1246 options:
1247  -d             dither image
1248  -m             match  colors
1249  -t             tile   image
1250  -s             scale  image (default)
1251  -u             update WindowMaker domain database
1252  -D <domain>    update <domain> database
1253  -c <cpc>       colors per channel to use
1255 By default, it will try to guess if dithering is needed or not and proceed
1256 accordingly.
1257 Using -d or -m will force it to dither or match colors.
1259 Dithering for more than 15bpp is generally not needed, and will only result
1260 in a slower processing.
1261 Don't use dithering except when needed, because it is slower. Else rely on
1262 wmsetbg which will detect if dithering is needed and use it.
1264 -u will update the WorkspaceBack in the default database domain file in
1265    ~/GNUstep/Defaults/WindowMaker, and let WindowMaker refresh the screen.
1266    Please note that this option only works under WindowMaker, and will have no
1267    effect under other window managers, since it rely on WindowMaker to update
1268    the image after it reads the updated defaults database.
1270 -D <domain> is same as above, but will update the domain <domain> instead of
1271    the default WindowMaker domain.
1273 -c <cpc> will set the color per channel to use. Only needed for PseudoColor
1274    visuals. WindowMaker will automatically pass the value read from the
1275    WindowMaker domain database.
1278 getstyle now have the -t option, that instructs it to read all options
1279 related to theme. Without -t getstyle will read only style options that
1280 means it will not read WorkspaceBack and IconBack.
1281 Use -t when you want to make a theme and need all theme options to be saved.
1282 Else it will extract just a style file.
1285 Session management support
1286 --------------------------
1288 Two new commands are available for use in menus:
1290 SAVE_SESSION and CLEAR_SESSION.
1292 SAVE_SESSION:
1293 will take a snapshot of all running applications, and their current hints
1294 (shaded, hidden, minimized, geometry and workspace they are on),
1295 and save it inside the WMState file. Also the current workspace we are on is
1296 saved. The applications that are running and were started from dock or clip are
1297 marked, so they will be attached to the corresponding dock/clip when restored.
1298 This state is restored every next session, until a new one is saved or
1299 CLEAR_SESSION is used.
1301 CLEAR_SESSION:
1302 will clear any previous saved session.
1304 There is also a run time option named SaveSessionOnExit = Yes/No; that allows
1305 one to automatically save the state of desktop when leaving WindowMaker.
1306 This way next session, the state of the desktop before last exit is restored.
1308 Please note that if this option is set to Yes, than any manual saving of the
1309 state, or any clearing of the state will be overridden when exiting
1310 WindowMaker.
1312 These options are available under the "Workspace" menu.
1315 User WindowMaker configuration files are now merged with global ones
1316 --------------------------------------------------------------------
1318 When starts WindowMaker will look for database domain files under
1319 $GNUSTEP_USER_ROOT/Defaults or ~/GNUstep/Deafults to be read. (In this order).
1321 If they are not available then it will scan for them in
1322 $GNUSTEP_LOCAL_ROOT/Defaults, $GNUSTEP_SYSTEM_ROOT/Defaults or
1323 /usr/local/GNUstep/Defaults (in this order).
1325 Even if the file was found or not, it will always load the corresponding domain
1326 file under /usr/local/share/WindowMaker/Defaults.
1328 Then if the user file was found it will merge it over the global file, else
1329 the global file will be used.
1331 This way any settings that are set by the system administrator in the shared
1332 file will be available for users that do not have them in their config files.
1333 Any option the user have in his config file will override the one in the
1334 shared domain file.
1336 So any new runtime options that appear in WindowMaker domain, do not need to
1337 be set in all user files, except the ones the user wants a different behavior
1338 from the default set for all users in the shared file.
1340 Also it is possible for the user to not have any personal domain databases, and
1341 the global shared ones will be used, but it still needs to have the directory
1342 structure, so WMState gets written on session exit.
1343 So all it needs to have is ~/GNUstep/Defaults directory available.
1346 New behavior of the Slide Icons
1347 -------------------------------
1349 Animation constants are now runtime.
1350 They are:
1351 IconSlideDelay = 0;
1352 IconSlideStep = 5;
1353 IconSlideSlowDown = 50;
1355 To better adapt both slow and fast machines the behavior of sliding icons
1356 changed in the following manner:
1358 Old one was to keep moving the icon with a constant step (default 5 pixels)
1359 until it reached the destination.
1361 Now it will use a new parameter named IconSlideSlowDown to speed up or slow
1362 down the moving.
1364 Instead of moving it with a constant step it will use IconSlideSlowDown to
1365 divide the distance to the destination, and use this value as the first step.
1366 Then is will compute the remaining distance and will again use
1367 IconSlideSlowDown to divide it and get the new step. And so on.
1368 When the step to move becomes smaller than IconSlideStep, IconSlideStep will
1369 be used further until the destination is reached.
1371 This way a nice deceleration effect is achieved, since while the icon
1372 approaches destination, it will use smaller steps, gibing the illusion that
1373 the icons is moving slower.
1375 IconSlideDelay will give the pause between steps, and is expressed in ms.
1377 Giving large values to IconSlideSlowDown (>1024 for 1024x768 screen) will
1378 result in the old "constant step advance" behavior, since the computed step
1379 will always be smaller than IconSlideStep, and the last will be used instead.
1381 Making IconSlideSlowDown = 0 or 1, will result in an instant jump to the
1382 destination without any animation.
1385 Attribute editor
1386 ----------------
1388 Because the icon images on screen automatically update after any change in
1389 WMWindowAttributes domain file, the use of both Save and Apply buttons is no
1390 longer needed. If one wants to just apply the setting to the current window
1391 only, he will only use the Apply button.
1392 If he wants them saved for all applications in the same instance and/or class
1393 the using the Save button will write them to disk, and automatically
1394 WindowMaker will update all the icons that need to be updated on screen.
1397 Sound support
1398 -------------
1400 Some basic sound support is now part of WindowMaker. The sound server is not
1401 yet part of WindowMaker distribution, so you need to download it separately.
1402 This is because is linux specific, and need some changes before it can be
1403 included.
1404 Until them if you have a linux system and want to use sound, use the
1405 wmsound-0.5 available at http://www.geocities.com/SiliconValley/Bay/7874
1406 Download that package, and only build the sound server there.
1407 DO NO APPLY ANY PATCHES FROM THERE!, because they are already applied.
1408 Just build the sound and copy the executable in /usr/local/bin
1409 Follow the rest of the install steps described there, except the patch-ing
1410 procedure.
1412 To enable sound for WindowMaker pass --enable-sound to configure.
1414 Also use NoSound = Yes/No; to enable/disable sound at runtime without killing
1415 the sound server.
1417 If you cannot set the sound to work yet, then is not for you.
1418 Wait until the sound server will be fixed and will be part of WindowMaker.
1421 New entries in WindowMaker domain database
1422 ------------------------------------------
1424 The following entries have been added to the runtime options:
1426   SaveSessionOnExit = No;
1428 will autosave (or not) the session state on exit.
1430   WindowPlaceOrigin = "64, 64";
1432 will offset all windows in auto or cascade placement mode with the value
1433 (in pixels) before placing them on screen. First is horizontal direction and
1434 second is vertical.
1435 This do not apply to windows that request a specific position on screen.
1436 This is useful if you want your Clip on the top left corner to not be
1437 overlapped by mapping windows.
1438 It will let it to have a row and a column of docked appicons near the screen
1439 edge, that will not be overlapped by windows.
1440 If you set it to "128, 128" it will have 2 rows and 2 columns not overlapped.
1443   NoSound = No;
1445 Enable/disable sound at runtime without the need of killing the sound server.
1448   MenuScrollDelay = 10;
1449   MenuScrollStep = 5;
1451 Constants for the menu scrolling animation.
1453   IconSlideDelay = 0;
1454   IconSlideStep = 5;
1455   IconSlideSlowDown = 50;
1457 Constants for the icons sliding on screen. Explained above.
1459   ShadeDelay = 0;
1460   ShadeSteps = 15;
1462 Animation parameters for shading a window. How many steps it will take, and the
1463 delay between steps in ms.
1465   DoubleClickTime = 250;
1467 The time for the double click to be considered so. Expressed in ms.
1469   SClipColor = "#6f8ae2";
1471 Color for selected icons in Clip.
1473 All delays are expressed in ms.
1477 --- 0.14.1
1480 *** Enhanced fiend clone.
1482 Here are the new fiend features:
1483 1. Keys for raising/lowering the fiend, and their default values:
1484    FiendLowerKey = None;
1485    FiendRaiseKey = None;
1486    FiendRaiseLowerKey = None;
1488    All reside in WindowMaker configuration file.
1490 2. Added posibility to launch the workspace menu with button1 click on the
1491    idle indicator of fiend, or with button3 click on workspace name on the
1492    fiend.
1494 3. Added Control-button1-click on fiend's idle indicator, to create a new
1495    workspace and move to it. Same action as New item in Workspace menu.
1497 4. Fiend's idle indicator do have a color that reflects its normal/collapsed
1498    state.
1500 5. The delay between changing workspaces from fiend is now a runtime option:
1502    WorkspaceChangeDelay = 700;
1504    in WindowMaker configuration file.
1506 6. Application icons can be moved between dock and fiend now.
1508 7. The way workspaces are changed is controlled now by two runtime options:
1510    AdvanceToNewWorkspace=Yes/No;
1511    CycleWorkspaces=Yes/No;
1513    Both apply to either fiend navigating buttons or to next/prev worksapace
1514    keybindings. Both default to No, and are in WindowMaker configuration file.
1516 8. Also added posibility to advance to new workspace, no matter what value
1517    AdvanceToNewWorkspace have, with Control-button1-click on "next workspace"
1518    fiend button.
1521 *** Theme support ***
1523 Spixmap and tpixmap now work. Their syntax is:
1525 SomeStyleOption = (spixmap, file, color);
1526 SomeStyleOption = (tpixmap, file, color);
1528 - spixmap means scaled pixmap, so the image in the file will be scaled to
1529 adapt to the destination's size.
1530 - tpixmap means tiled pixmap, and the image from file will be tiled in the
1531 destination.
1533 file is searched in the PixmapPath, but can be a full path name.
1535 Color is used depending on which Style option is applied.
1536 For example in case of titlebars, color is used for miniwindows titles color.
1537 You are not restricted in selecting that color, but is better to put one
1538 that matches the overall color of the image.
1540 Currently they apply to all the options that accept (solid, color), or any
1541 type of gradient.
1542 This means they also apply to WorkspaceBack and IconBack, which allows theme
1543 support with the simple use of the setstyle and getstyle utilities.
1544 There is no need for an extra theme manager, just to include the needed
1545 options in the style files.
1547 In case of WorkspaceBack, color is used to be set in the background until
1548 the image gets loaded and displayed. This is to avoid the stippled screen
1549 the X server shows, in case the image is big and loads slow.
1550 There is a small utility in the util directory, named wmsetbg which is
1551 used to set the background image. This is needed for windowmaker not to
1552 freeze while loading and scaling the image.
1553 Currently it is hardcoded in windowmaker to use wmsetbg to set the background
1554 image, and is better to use it since is smaller that other image manipulation
1555 programs, and it is compiled with support for same image types as windowmaker.
1556 Since it comes and is installed with WindowMaker, there will be no need to
1557 download and use an external app, which also may not have support for the same
1558 image types as windowmaker.
1562 --- 0.14.0
1564 *** Fiend clone.
1566 The fiend clone is a dock extender, that lets you dock more than the default
1567 10-12 icons in the dock. It actually lets you dock how many icons you like,
1568 with a current default of 25 per workspace. The fiend have different docked
1569 icons on every workspace. Also the fiend main icon shows you the workspace
1570 you're on and lets you navigate through the workspaces with the small green
1571 buttons on the low right corner.
1572 To save screen space the fiend can be collapsed to the main icon either
1573 from the fiend menu (available with right click on the fiend icons), or
1574 with a double left click on the main fiend icon, which is a toggle for
1575 the collapsed/uncollapsed state.
1576 Collapsed state is marked by a different title color.
1577 Pressing on the small buttons on the low right corner, the workspaces are
1578 changed in increments of 1 to the left or right, but keeping the button
1579 pressed over them will continuously advance through workspaces until the
1580 mouse is moved away from the buttons or the button is released.
1581 The delay between workspace changes is set by FIEND_WKS_CHANGE_DELAY in
1582 src/wconfig.h, and defaults to 700 ms.
1583 Unlike the dock, fiend can hold icons in any directions, and can be placed
1584 in any position on screen.
1586 When an icons is to be docked, but the position can be either in the dock
1587 or in the fiend, the dock will be used first, and the icon will be docked
1588 there.
1590 Here are the new runtime options introduced by the fiend:
1591 Files are located in ~/GNUstep/Defaults/
1593 In WMWindowAttributes:
1594        "Logo.WMFiend" = {Icon = "Cone.xpm";};  - icon for the fiend
1596 In Windowmaker:
1597         FiendMaxIcons = 25;           - the max number of icons in fiend per
1598                                         workspace
1599         FiendTitleFont = "-*-helvetica-bold-r-normal-*-10-*-*-*-*-*-*-*";
1600                                       - the font used to show the current
1601                                         workspace
1602         FiendTitleColor = black;      - color for the uncollapsed fiend title
1603         CFiendTitleColor = "#616161"; - color for the collapsed fiend title
1604         AFiendColor = "#00ba70";      - color for the workspace changing
1605                                         buttons, when active
1606         IFiendColor = "#008000";      - color for the workspace changing
1607                                         buttons, when idle
1609 For the ones who don't want to use fiend, there is a option to wmaker named
1610 -nofiend that can be feed to the command line when starting wmaker.
1611 (This is the equivalent for -nodock, but removes fiend clone).
1613 The syntax of WMState file have changed, but you don't have to worry because
1614 WindowMaker will know to read the old format and will save it and further
1615 will use the new one. You do not need to change your file, for the new version
1616 to work.
1619 --- 0.13.1
1621 *** Enhanced Attribute editor.
1623 Now you can save defaults for all windows.
1624 Please note that only Icon, KeepInsideScree, and sometimes NoAppIcon
1625 can be useful in a normal environment. But others may have other opinion ;)
1626 If you set AlwaysUserIcon default for all windows, note that apps like
1627 asclock, wmload, wmmail, wmrack, will show that icon instead of their
1628 window.
1630 Now Attribute editor also counts for defaults saved for all windows,
1631 (not only the default "No" for all options hardcoded in WindowMaker),
1632 when saving options for some instance.class specification. This is to
1633 save disk space by saving only the options that differs from global defaults
1634 (either defaults for all windows or the hardcoded valued in WindowMaker).
1636 Attribute Editor now updates on the fly the appicon image or creates/deletes
1637 the appicon if you set that options in the Inspector panel and Apply them.
1638 Modifying Icon file, NoAppIcon or AlwaysUserIcon and Applying them will
1639 result in the image update for the app-icon.
1641 Note that if you apply but not save these options, the miniwindow image will
1642 not be updated. This is because app-icon is always on screen so it can be
1643 updated, but miniwindow image is read from the defaults database and from disk
1644 every time you minimize the window and is destroyed when you restore.
1647 --- 0.13.0
1649 *** Atribute editor is working ;).
1651 How it works is quite obvious.
1652 Anyway, here is a short description.
1654 Save   - only save the configuration in defaults database and updates
1655          WMWindowAttributes
1656 Apply  - only applies the values to the current window
1657 Revert - reverts the values from the defaults database
1659 Note that Save and Revert count for the window specification
1660 (instance & class), that are selected, and save/use the values for/from
1661 that.
1663  The Update button will show the icon who's name was typed in the textfield
1664 If the textfield is empty, will try to use the default icon.
1665 Also saving with and empty textfield for icon, uses the default icon.
1667  The Default button will use the icon in the textfield as default icon
1668 and save that value in WMWindowAttributes (Note that in this case is no
1669 need to press the Save button!). Also if the textfield is empty it will
1670 try to use the old default icon, if available.
1672 *** Now menus are saved between sessions, or over a restart.
1674  Just stick them to the desktop, and you will find them over sessions
1675 until you close them.
1676  Please note that only the root_menu, the window switch_menu and the
1677 workspaces_menu can be saved this way.
1679 *** Changed the lousy Windoze menu behaviour.
1681 This applies to 'NextMenuBehaviour = NO;'
1683  Now the items are no more automatically selected if you launch the menu
1684 and the mouse is over some item, if you use a short click to launch the
1685 menu (shorter than the default DBL click time).
1686  If you use a longer click or keep the mouse pressed, the item under mouse
1687 will be selected after that delay, and launched when you will release the
1688 mouse button.
1689  If the click was short, a second one is needed to launch the item.
1691 *** Autoarrange icons is now a runtime option
1694 AutoArrangeIcons = YES/NO;
1695 in 'WindowMaker'.
1697 *** Added configurable horizontal resize threshold
1700   HorizontalResizeThreshold = <n>;
1702 This will make the n pixels at the exterior side of the corner handle
1703 of the resize bar to restrict to horizontal only resize.
1704 Also you can use Shift-click&drag anywhere on the corner handle to
1705 restrict the resize only to horizontal.
1706 Note that the Shift-click&drag does not depend of the configured threshold
1707 and works completely independent.
1709 *** New option for OPEN_MENU (pipe from command)
1711 OPEN_MENU | /foo/bar/script
1713 will make a menu that is dinamically constructed by /foo/bar/script
1716 --- 0.12.0
1718 *** New option for OPEN_MENU
1720 OPEN_MENU /foo/bar/pics xv -root -quit
1722 will make a menu with all files in /foo/bar/pics and precede them
1723 with EXEC xv -root -quit
1725 thus, making a menu with entries like:
1728 "marble.gif" EXEC xv -root -quit marble.gif
1729 "water.jpg" EXEC xv -root -quit water.jpg
1733 *** Multicolor gradients
1735 (mhgradient, colorX, color1, color2, color3, ..., colorn)
1736 (mvgradient, colorX, color1, color2, color3, ..., colorn)
1738 You can put any number of colors >= 2. 
1740 colorX is a special color that is used as the solid color of the
1741 texture when wmaker needs a solid color (like in miniwindow title and
1742 resizebar)
1744 *** PixmapPath format changed
1746 What used to be
1748 PixmapPath = "/usr/local/share/pixmaps:~/foobar";
1750 must now be
1752 PixmapPath = ("/usr/local/share/pixmaps", "~/foobar");
1755 *** Added OffiX DND in dock
1757 Use the "Set drop arguments..." command in the menu and put a %d
1758 where the dropped object string should be substituted, like:
1760 xedit %d
1762 *** Escape thingies for menu and dock commands:
1764 %w - substitute with current selected X window ID
1765 %s - substitute with current selection
1766 %d - substitute with last dropped object
1767 %a(some text) - opens a input box with "some text" as a title. Then,
1768 the text typed will be substituted there
1770 \r, \n - substitute with corresponding characters
1773 *** The WMState file format has changed a little.
1774 The Command field for the dock application list is now a normal string,
1775 instead of a list. So, remove the parentheses and the commas for the command
1776 and join all the parts. Example:
1778 if it used to be
1780 Command = ( xterm," -geometry", "+10+10" );
1782 then make it
1784 Command = "xterm -geometry +10+10";
1787 --- 0.10.2
1789 AutoFocus = NO; disables automatic focusing of windows
1790 when they are first mapped
1793 --- 0.10.1
1795 titlebar gradients are in a single piece now
1797 the WMDock file was merged into the WMState file. You can insert this
1798 file in WMState and set it's key to Dock. For example, if your WMDock
1799 contains:
1802         Applications = { {Command = (); }};
1803         Position = "-64,0";
1804         Lowered = NO;
1807 and WMState contains:
1810         Workspaces = ( "Workspace 1" );
1813 then you can merge both and have:
1816         Workspaces = ( "Workspace 1" );
1817         Dock = {
1818                 Applications = { {Command = (); }};
1819                 Position = "-64,0";
1820                 Lowered = NO;
1821         };
1826 The configuration format has changed!! Forget everything about the old
1827 format.
1829 dockapp was removed and the old version will not work anymore. 
1831 the dialogs require tcl/tk. they will be rewritten in plain C
1834 These are some tips for people upgrading from older versions and don't want
1835 too many unused files around. There is no problem if you decide to keep 
1836 them for a while.
1838         you can  rm -r ~/gnustep if you don't want anything from there
1840         remove the files in /usr/local/share/WindowMaker before installation
1842         the /usr/local/share/pixmaps directory can be removed