Edge attraction.
[wmaker-crm.git] / NEWS
blob8c3398bbaf9f71e0172e82f88835d99d7b7fc6fa
2 NEWS for veteran Window Maker users
3 -----------------------------------
5 --- 0.60.1
8 Window Edge Attraction
9 ----------------------
11 Window edge attraction was now added.
13 Attraction = YES/NO;
15 will enable/disable gravity to edge's boder.
16 The strength of gravity can be controled by modify `EdgeResistance' value
17 in WindowMaker configuration file.
21 --- 0.60.0
24 User Menu
25 ---------
27 The user menu is now a compile time option disabled by default. 
28 Supply --enable-usermenu to configure to enable it.
31 root menu INCOMPATIBLE changes
32 ------------------------------
34 EXEC <program> will execute the named program
36 SHEXEC <command> will execute the shell command.
38 If you want to execute something like blabla > /dev/null, then use SHEXEC
40 Dont forget to update your menus.
43 New Option For setstyle
44 -----------------------
46 The --ignore flag will tell setstyle to not change the option that is
47 specified, when modifying the Window Maker configurations. For example:
49 setstyle --ignore MenuStyle sometheme.themed will cause the MenuStyle
50 option to not be changed.
52 setstyle --ignore FTitleBack --ignore UTitleBack --ignore PTitleBack bla.themed
53 will load the theme, but keep the titlebar background related options as
54 before.
57 MultiByte Text Support Changes
58 ------------------------------
60 The --enable-kanji configure option is not needed anymore and was removed.
61 To enable support for multibyte text, you must:
62 - set the LANG environment variable to the appropriate value
63 - change the font configurations to contain font sets in the appropriate
64   encodings in both ~/G/D/WindowMaker and ~/G/D/WMGLOBAL (for WPrefs)
65 - set the MultiByteText option to YES in both of the above files
68 New Options
69 -----------
71 WorkspaceNameDisplayPosition =
72 none/center/top/bottom/topleft/topright/bottomleft/bottomright
75 SmoothWorkspaceBack = YES/NO
77 will enable smoothing of scaled workspace background images.
81 Application User Menu Path Changes
82 ----------------------------------
84 Default configuration for user specific menus installed in
85 /usr/local/share/WindowMaker/UserMenus or $(datadir)/WindowMaker/UserMenus
86 and ~/GNUstep/Library/WindowMaker/UserMenus.
89 Omnipresent icons in Clip
90 -------------------------
92 Added ability to set icons docked in Clip to be omnipresent on all workspaces.
93 To set/reset this flag use the clip menu.
94 The Clip menu changed in the following way:
95  - if you bring up the menu from the Clip's main icon, it will contain as
96    before the "Rename Workspace" entry in the second position.
97  - however, if you bring up the menu from any other icon in clip, the
98    "Rename Workspace" menu entry is replaced by "Omnipresent" or
99    "Toggle Omnipresent" depending on the context.
101 This entry will work in the following way, depending on the context:
103 1. If there is no icon selected in the clip, then the menu will contain the
104    entry named "Omnipresent" which will be checked accordingly to the current
105    state of the icon (omnipresent or not), and will let you change the
106    omnipresent state of the icon you brought the menu from.
107 2. If one or more icons are already selected when the Clip menu is called, the
108    entry will be named "Toggle Omnipresent" and will apply to all selected
109    icons trying to toggle their omnipresent state. The icons which will be
110    succesfully changed to their new state as requested, will be unselected,
111    while the ones that will fail for some reason to gain their new state,
112    will remain selected.
114 In both cases if there is no success in setting what user requested a panel
115 will inform user of the failure.
116 (Note: trying to set an icon to not-omnipresent will never fail. Failures can
117        be met only when trying to set omnipresent for an icon).
119 The icons set to omnipresent will be marked with a triangle in the upper left
120 corner, having the color of the IconTitleColor.
122 An icon can be set to omnipresent, only if its position is free in all the
123 workspaces, else you will be informed of the problem and asked to fix it first.
124 Also when dragging an omnipresent icon around in Clip, all the icons docked in
125 all the workspaces are shown while the dragging is done, to let one easily see
126 where are free slots in all workspaces.
128 For advanced users, there is also a shortcut to set/reset the omnipresent
129 state of an icon: just use "Shift+MiddleButton" (button2) on the icon you want
130 to change.
131 In this case only the mark in the upper left corner will appear in case of
132 success, or nothing will happen if icon cannot be made omnipresent (advanced
133 users are expected to know why the icon failed to be made omnipresent, so they
134 don't need a panel to explain them why ;) ).
136 Now before you load your gun to start a flame war because this is against your
137 principles you love so much, please sit down and think that this is a feature,
138 which, if you don't use, the old behaviour of the Clip is totally preserved.
139 It just adds some extra capabilities to the Clip for people who think that this
140 is useful.
143 XDND drop on dock support
144 -------------------------
146 Support for XDE on dock is now replaced by XDND.
147 To enable, edit src/wconfig.h
151 --- 0.53.0
153 New Options
154 -----------
156 ** MenuStyle
158 MenuStyle=<style>; will change the menu texture style.
160 <style> can be:
161 normal (default): for the traditional one texture per item, with bevels in 
162 each
164 singleTexture: for a single texture that spans the whole menu, with bevels
165 in each item
167 flat: singleTexture without the bevels
170 ** ResizebarBack
172 ResizebarBack=<texture>;
174 where <texture> is any of the textures you normally use in titlebars and
175 other places.
177 If the style file/theme does not contain a ResizebarBack option, setstyle
178 will automatically hack it so that wmaker will make the theme work like 
179 before.
182 New crash dialog panel
183 ----------------------
185 From now on, whenever a fatal situation appears, Window Maker will display a
186 dialog panel to the user and let him choose what to do.
187 The options are:
188 - Abort and leave a core file (usefull for debugging and getting backtraces)
189 - Restart Window Maker (default behaviour)
190 - Start alternate window manager (the one defined as fallback, or if not
191   possible fvwm or twm in this order).
193 If it will not be able to restart or start the alternate window manager, it
194 will abort and leave the core file.
197 Application User Menu
198 ---------------------
200 Applications with an appicon can have a user defined menu.
202 This menu will emulate keyboard events, and will be sent to the applications'
203 window(s), thus the application must accept key combinations (CTRL+N for
204 instance).
206 To enable this feature, #define USER_MENU in src/wconfig.h and place menu
207 files in ~/GNUstep/Defaults/UserMenus (/usr/local/etc/WindowMaker/UserMenus
208 globally).
210 The user menu is in PropList format and the filename is in:
211 <instance name>.<class name>.menu or application's main window.
212 (Example: the menu for xcalc would be - xcalc.XCalc.menu)
214 Example user menu syntax:
217   "Calculator",
218   ("Put 1", SHORTCUT, "2"),
219   ("Functions",
220     ("Put 2", SHORTCUT, "2"),
221     ("Put 3,4 and 5", SHORTCUT, (3,4,5))
222   ),
223   ("Exit", SHORTCUT, "Control+q")
228 --- 0.52.0
231 Appearance Editing in WPrefs
232 ----------------------------
234 Added Appearance/Texture editing capability in WPrefs. Workspace background
235 selection is not yet finished.
238 Themes
239 ------
241 Removed all themes from the source tree, and moved them in a separate package.
242 You can download the new package from the same place as this package:
243 ftp://ftp.windowmaker.org/pub/beta/srcs/
244 Look after WindowMaker-extra-<version-number>.tar.gz
245 Also WindowMaker-extra pack include the old WindowMaker-data.tar.gz which only
246 contained icons.
247 Look for the greatest version number when you download this package.
250 get-wraster-flags script change
251 -------------------------------
253 The name of the options passed to get-wraster-flags changed, to allow a better
254 name compatibility with the naming conventions used by other software.
255 The name change was as follows:
256 --lflags was changed in --ldflags
257 To allow backward compatibility, with already written software, the old
258 --lflags option is still recognized, but you are encouraged to move the the
259 new --ldflags.
263 --- 0.51.2
266 New Themes
267 ----------
269 Added 2 new cool themes (actually I added in 0.51.1, but forgot
270 to put it here...) from largo (LeetWM) and BadlandZ (STEP2000).
273 Full Screen Maximization
274 ------------------------
276 The FullMaximize window attribute will allow the window to
277 be maximized to the full size of the screen (ignoring anything
278 like titlebar, resizebar, dock, panels etc). It should be usefull
279 for programs that must use the whole screen, like games or things 
280 like presentation programs.
283 --- 0.51.1
285 KDE Application Menu script
286 ---------------------------
288 wkdemenu.pl is a converter from KDE application menu structures to wmaker 
289 menu that can be used as a piped menu. Look wkdemenu.sh for how to use it.
292 Window Edge Resistance
293 ----------------------
295 Window edge resistance was now added. No, feature freeze hasn't been
296 removed. Its just part of the edge resistance rewrite ;)
299 New Theme
300 ---------
302 Added SteelBlueSilk theme
304 Installation Path Changes
305 -------------------------
307 Default configuration data installed in /usr/local/etc/WindowMaker
308 or $(sysconfdir)/WindowMaker
311 --- 0.51.0
313 Window Maker has become a GNU program (part of the GNU Project).
315 Title text drop shadow
316 ----------------------
318 drop shadow option added for titlebar text. This is a compile time 
319 option which needs to be defined in src/wconfig.h after you run
320 configure and before you run make.
322 New options and syntax for your WindowMaker domain file are:
324   Shadow = yes/no;
325   FShadowColor = <color>;  
326   PShadowColor = <color>;
327   UShadowColor = <color>;
328   MShadowColor = <color>;
330 The shadow option is dynamic (no need for a restart).
331 MShadowColor is for the menu title text.
333 libPropList
334 -----------
336 WARNING!!! libPropList was removed from the Window Maker distribution
337 and is being distributed separately. If you dont have it installed yet,
338 get it from ftp.windowmaker.org/pub/libs and install before building
339 Window Maker.
342 signal handling change
343 ----------------------
344 SIGHUP will exit wmaker instead of restarting it!!! This is because
345 GNOME expects the window manager to exit instead of restarting...
346 Complaints should go to gnome people. SIGUSR1 will restart wmaker now.
349 script change
350 -------------
351 WINGs-flags was removed, and replaced by get-wraster-flags.
352 Please remove WINGs-flags from your system, since it was obsoloted by
353 get-wraster-flags.
354 Continuing to use WINGs-flags can lead to hazardous effects, since is no
355 longer updated.
358 docklib
359 -------
361 docklib is a little library for making dock applets. It's in the
362 docklib-0.0.tar.gz file. Unpack it and read the README file there.
365 Option Changes
366 --------------
368 Removed OnTopTransients option
370 Added OpenTransientOnOwnerWorkspace
373 Olwm Hint Support
374 -----------------
376 OPEN LOOK(tm)/olwm hints support was added.
378 Read the appropriate section in the README file.
382 --- 0.50.1
384 New option for WorkspaceBack. mpixmap is the same as spixmap, but
385 it will scale the pixmap by keeping the aspect ratio (maximize or maxpect).
386 The option only works for workspace backgrounds.
388 Also added IGNORE_PPOSITION compile time flag, which is equivalent
389 to NoPPosition from fvwm. 
394 --- 0.50.0
397 KDE and GNOME
398 -------------
400 Added full support for GNOME and KWM hints. 
401 Read the INSTALL file to see how enable them.
403 Everything in the so called GNOME window manager bla bla bla pseudo-spec is
404 implemented.
406 As for KDE stuff, it implements 90% of everything kwm does, adds some
407 Window Maker specific extensions to it and still uses half of the memory
408 kwm does, which should be enough to let you dump kwm ;) For details on what
409 exactly is implemented, see comments in src/kwm.c Read the README.KDE file 
410 for more information.
413 WARNING: Some KDE hints are badly designed, so doing things like using
414 kpanel's desktop switcher/pager and Window Maker's internal workspace
415 management functions to create, destroy and rename workspaces at the same 
416 time might cause unknown effects. To be on the safe side, only
417 use either of them to manage workspaces. Switching workspaces is hopefully,
418 safe, so you can switch workspaces from wherever you want.
422 Workspace Specific Background Images
423 ------------------------------------
425 Use the WorkspaceSpecificBack to set background images for specific
426 workspaces. The WorkspaceBack is used as the default background image.
428 Example:
430 WorkspaceSpecificBack = ((solid, red), (cpixmap, ship.jpg, gray), (), 
431                                 (dgradient, red, blue))
433 This will set the background image of workspace 1 to (solid, 0),
434 2 to ship.jpg and 4 to a gradient. Workspace 3 and other workspaces
435 will have the image defined by WorkspaceBack.
437 Note that this uses quite some memory...
440 setstyle/getstyle
441 -----------------
443 setstyle now accepts the -nofonts flag, which will load the style
444 file ignoring all font related options.
446 Example:
448 setstyle -nofonts Blabla.style
451 getstyle can be used to create theme packs. See the usage in the
452 WindowMaker/README.themes file.
456 New Texture Type
457 ----------------
459 Textured gradients will tile a texture pixmap and combine it with a gradient, 
460 using an arbitrary opaqueness. 
462 Syntax is (thgradient, <file>, <opaqueness>, <color1>, <color2>)
463           (tvgradient, <file>, <opaqueness>, <color1>, <color2>)
464           (tdgradient, <file>, <opaqueness>, <color1>, <color2>)
465 where:
466 <color1> and <color2> are the colors for the gradient,
467 <file> is the texture file and
468 <opaqueness> is the opaqueness to merge the texture witht the gradient,
469 ranging from 0 to 255.
471 Example:
473 (thgradient, "BlueImage.jpeg", 120, white, black)
475 The BlackTexture style and Checker theme are examples.
477 Hints:
479 You can use any type of pixmap file for this, but small (like 64x32)
480 grayscale pixmap files should get the best results (fast and low memory
481 usage). You can use color pixmaps, but it is harder to get the desired effect
482 with them.
484 Be warned that this texture type is the slowest.
488 New Options
489 -----------
491 IconTitleBack and IconTitleColor control the color of the
492 miniwindow title. Both of them are colors.
494 Example:
495 IconTitleColor=white;
496 IconTitleBack=black;
499 Since this introduces an incompatibility in themes and getting flamed by the
500 themes ppl isn't the most pleasant thing ("Whaddafuk you're thinking!? You
501 just broke 500 themes!!!" ;) the setstyle command was hacked so that it will
502 make old themes work as before, by trying to automatically set the above
503 options. Note that in some cases it will not have exactly the same results as
504 before.
507 StartMaximized window attribute. Will maximize the window when it
508 is mapped.
511 AutoRaiseLower option for the Clip. This allows automatic Raise/Lower of the
512 Clip icons when the mouse pointer enter/leave the Clip. To avoid unwanted
513 raising/lowering there is a time threshold before raising/lowering.
514 The thresholds can be changed in wconfig.h by changing one or both of
515 AUTO_LOWER_DELAY and AUTO_RAISE_DELAY (expressed in miliseconds).
516 For example if you set AUTO_RAISE_DELAY to 0, then the Clip will be raised as
517 soon as the mouse pointer enters it's area. Setting AUTO_RAISE_DELAY to a very
518 big value, will make the Clip to practically do not auto raise unless clicked,
519 but to be automatically lowered after AUTO_LOWER_DELAY (ms) when leaved.
522 New ThemePack Format
523 --------------------
525 Starting with this version, a new format of themes is being supported.
526 Before you open pine and start composing your flame, rest assured that
527 the old format is still supported. The new format is documented
528 in the WindowMaker/README.themes file.
531 Root Menu 
532 ---------
534 The -noext option for OPEN_MENU will strip whatever is after the last .
535 in file names that appear on the opened directory. So,
537 OPEN_MENU ~/bg WITH xv -root -quit
539 will create a menu with all the images in ~/bg without the extension.
543 --- 0.20.3
546 Icon (miniwindow) stacking
547 --------------------------
549 If you want miniwindows to reside under normal windows, edit
550 wconfig.h and change WNormalLevel (just grep for it) to
551 WDesktopLevel
554 5 Button Mouse
555 --------------
557 If you have a 5 button mouse and want to give some utility for
558 the extra 2 buttons, edit the appropriate line in src/wconfig.h
559 Clicking Button4 in the root window will switch you to the previous 
560 workspace and Button5 will do that for the next.
563 Option Changes
564 --------------
566 put NoWindowOverDock back
568 KeepOnBottom window attribute
571 -static command line option
572 ---------------------------
574 wmaker -static will start Window Maker in static mode. This will
575 prevent wmaker from checking or making any configuration changes.
576 That makes it possible to run wmaker before running wmaker.inst
579 Hysteresis for menu item selection
580 ----------------------------------
582 Hopefully it's intelligent enough, so you won't notice it.
584 In case you want to know what's it, it's equivalent to that
585 (insanely long) 2 second delay present in that Windoze95 menu, 
586 but more usefull than annoying (I hope :). To see it, do the following
587 with your current wmaker version and later with 0.20.3:
589 - open the apps menu and stick it
590 - click in the item for the "Workspaces" submenu and hold
591 - drag the mouse to the 4th or bigger entry (like "Workspace 4") in a
592 straight line, trying to select the target item before the submenu
593 is unmapped when you dragged over other items in the main menu
597 Window Shortcuts
598 ----------------
600 Window shortcuts are shortcuts to arbitrary windows. You can make up to 4
601 shortcuts. To assign a previously bound shortcut to a window use the "Select
602 Shortcut" submenu in the window commands menu. If the shortcut is not yet
603 assigned for any window, you can hit the shortcut to assign it to the active
604 window. The shortcut will do the same as clicking in an entry in the window
605 list menu. The keys for the shortcuts are defined in the ~/G/D/WindowMaker
606 file or in WPrefs.app
608 Option names are:
610 WindowShortcut1Key through WindowShortcut4Key
613 --- 0.20.2
616 The name of WindowMaker was changed to Window Maker.
618 Window creation animation disabled by default.
620 xdaliclock -shape
621 -----------------
623 If you use it edit src/wconfig.h and #define OPTIMIZE_SHAPE or disable the
624 titlebar and resizebar for the window. OPTIMIZE_SHAPE will remove the
625 flickering for xdaliclock and other programs that change their shapes often,
626 but will increase network traffic considerably. So, if you use xdaliclock
627 from a remote machine it can get slow.
630 Applications Menu
631 -----------------
633 The applications menu will now use the shell in the SHELL environment
634 variable to execute EXEC menu commands. If it is unset (I think it's always
635 automatically set by the shell program) it will use /bin/sh
638 Extra fancy icon kaboom :)
639 --------------------------
641 Edit src/wconfig.h and #define ICON_KABOOM_EXTRA to get
642 more effects for the icon undocking animation.
644 Options for superfluous stuff are even more superfluous, so this
645 will not become runtime.
648 XDE drag and drop support
649 -------------------------
651 Support for XDE drag and drop was added (by "]d" <id@maliwan.org>).
652 To enable, edit src/wconfig.h
653 The support works with gtk 1.1.2
656 libPropList
657 -----------
659 libPropList will now be built automatically by wmaker. Wich means
660 the (simplified) building process is now:
662 ./configure
663 make
664 make install
666 instead of:
668 tar xzf libPropList.tar.gz
669 (cd libPropList; make)
670 make
671 make install
673 You also don't need to worry about GNOME libPropList incompatibilities
674 anymore. 
677 Bug with focus lost in sloppy focus fixed
678 -----------------------------------------
680 The bug only occurs in sloppy or auto focus modes, with AutoFocus disabled
681 and Superfluous enabled. There is no easy/clean way to fix this, so Window
682 Maker will disable the animation of window creation if the focus mode is
683 either sloppy or auto AND AutoFocus=NO.
685 If you want the animation, enable AutoFocus or use manual focus mode
686 (prefered). 
689 The NoWindowUnderDock option was removed
690 ----------------------------------------
691 To obtain the same result, use the "Keep Dock On Top" option in the dock menu.
694 Persistent Program Suplied Icons
695 --------------------------------
697 Application supplied icons are now stored, so that the dock will keep
698 showing them after the app is exited. The icons are stored at
699 ~/GNUstep/.AppInfo/WindowMaker/
702 Sound support
703 -------------
705 Sound support is now on by default. Even if you don't use sound the overhead
706 is very small, and has no impact on performance. If you still want to
707 optimize it and remove a few hundred of bytes, then use --disable-sound or
708 --enable-sound=no options when you configure Window Maker.
711 --- 0.20.0
713   
714 Multihead support. wmaker will now manage all screens that are attached to the
715 display. 
716 ------------------------------------------------------------------------------
717   
719 It does so from a single process (instead of spawning a new process for each
720 screen, like fvwm does). This keeps memory usage a lot lower than fvwm.
722 State files have a suffix .n, where n is the number of the screen.
724 Since I don't have a real multiheaded machine, it probably has bugs.
726 Superfluous
727 -----------
729 Yet another useless superfluous animation. Find out what exactly it is
730 by yourself :)
733 exitscript
734 ----------
736 ~/G/L/W/exitscript will be called automatically when wmaker is exited.
739 New runtime options
740 -------------------
742 1. Miniaturization animation is now selectable by a runtime option
743 Add a line with
745 IconificationStyle = <style>;
747 to your WindowMaker configuration file.
748 <style> can be one of: Zoom, Twist, Flip or None
749 Case doesn't matter, and default is Zoom.
752 2. Edge resistance.
753 This can be controlled by setting:
755 EdgeResistance = xxx;
757 in your WindowMaker configuration file.
758 xxx is an integer greater than 0 and represents the number of pixels of edge
759 resistance. Setting it to 0 (default) will disable this feature.
761 New theme
762 ---------
764 A new theme named Night, is available in this distribution.
768 --- 0.19.3
770 GIF support was added. You will need libgif 2.2 to use it.
772 cpixmap added. Syntax is the same as tpixmap or spixmap
775 --- 0.19.2
777 getstyle will include IconBack info in Style files.
779 --- 0.19.0
781 libPropList was updated. If you have it installed, you must upgrade or
782 WPrefs will crash because of bugs in libPropList.
784 New options
785 -----------
787 Balloons!
788 ---------
790 WindowTitleBalloons = YES;
791 will enable balloons for window titles that are not fully visible.
793 MiniwindowTitleBalloons = YES;
794 will enable balloons for miniwindow titles.
796 AppIconBalloons = YES;
797 for application icons (docked or not)
800 IconPosition
801 ------------
803 IconPosition (the position of the icons) is specified as:
805 IconPosition = c1c2c3;
807 where:
809 c1 can be t or b (meaning top or bottom)
810 c2 can be l or r (meaning left or right)
811 c3 can be v or h (meaning vertical or horizontal)
813 case is insensitive.
815 For example, 
816 IconPosition = blh;
818 is the old iconPosition position.
820 IconPosition = trv;
822 will place the icons over the Dock.
824 New window attribute
825 --------------------
827 EmulateAppIcon = YES; will make the window have an application icon.
828 Only use this option for fully specified windows (like rxvt.Rxvt).
829 NEVER use in generic window specifications (like * or rxvt).
830 You must restart the application for the attribute to take effect.
833 WPrefs.app
834 ----------
836 Read WPrefs/README
839 --- 0.18.1
841 Boolean balues have changed!!! YES, Y and any non-zero integer will
842 mean TRUE and anything else (including True) will mean FALSE. This
843 is to conform to the OpenStep values used for booleans and
844 not cause headaches later, when GNUstep apps also starts using
845 defaults and users will try using True wich won't get recognized.
848 --- 0.18.0
850 Clip
851 ----
853 Clip button layout was changed. IT IS TEMPORARY AND THE DEFINITIVE LOOK
854 WILL BE DIFFERENT!!!
857 libPropList
858 -----------
860 More bugs were fixed in it. Upgrade the library if you have an older version
861 installed, with the one included.
864 Property list menus
865 -------------------
867 Format for property list menus has changed! The redundant array for
868 submenus was removed, so a menu that looked like:
870 ( Applications,
871   ("Xterm", EXEC, "xterm"),
872   ( 
873     (Paint,
874         ("Gimp", EXEC, "gimp"),
875         ("XV", EXEC, "xv")
876     )
877   )
880 must be changed to:
882 ( Applications,
883   ("Xterm", EXEC, "xterm"),
884   (Paint,
885         ("Gimp", EXEC, "gimp"),
886         ("XV", EXEC, "xv")
887   )
892 Misc
893 ----
895 NUMLOCK_HACK is back. This time it works and is enabled by default.
896 If you think you don't need it and promise me that you won't send 
897 "bug" reports saying that shortcuts stop working after a while, you can
898 disable it ;) It will save some memory and CPU.
901 Configuration
902 -------------
904 Removed the SwapMenuButton option and added 3 finer grained options:
906 SelectWindowsMouseButton
907 WindowListMouseButton
908 ApplicationMenuMouseButton
910 Values that can be used are Left, Middle, Right and Button1 through Button5
911 Left is equivalent to Button1, Middle to Button2 and Right to Button3
914 Removed the WorkspaceChangeDelay option and corresponding action.
915 Removed AClipColor and IClipColor
918 Added the SelectKey back
921 Changed default binding of Window commands menu from F10 to Control+Escape
923 --- 0.17.4
925 Misc
926 -----
928 libPropList has changed! Upgrade it before compiling wmaker.
930 Hopefully the bugs that caused wmaker to crash if an error is found
931 in the config files is fixed. If you do crash wmaker with a bad
932 file, please try to find out the smallest possible portion of the file
933 that still crashes wmaker and send it to me.
936 New Options
937 -----------
939 PixmapPath was split to PixmapPath and IconPath. PixmapPath is the path
940 for the pixmaps used as textures and IconPath is for the icons. 
941 Don't forget to add IconPath to your current configuration file.
943 There's also a new library in ~/GNUstep/Library/Icons. You should place
944 your icons there, since icons are not a WindowMaker specific resource.
947 DontConfirmKill=YES; will disable the confirmation panel for Kill
950 --- 0.17.3
952 Interface Changes
953 -----------------
955 Unhide Here in the appicon menu was changed to be the first entry.
956 This way you can unhide the appicon with a single click without
957 even moving the pointer.
960 Clip Commands
961 -------------
963 The collect icons commands was renamed to attract icons and
964 the attract icons options was renamed to Auto attract icons.
966 The Remove Selected Icons was renamed to Remove Icon(s). It will
967 act as before if some icon is selected and will remove the clicked
968 icon (without confirmation) if it is not.
970 Added a Keep Icon(s) command that will keep the selected icons if
971 any is selected and the current one if none.
973 The Move To command was renamed to Move Icon(s) To.
976 --- 0.17.0
978 If you have libPropList installed, you might want to reinstall it,
979 replacing with the included libPropList. It has a small bug fix.
981 Misc. Changes
982 -------------
984 Removed --with-gnome and made MWM_HINTS defined by default.
985 This means that "GNOME support" will work with no additional
986 flags passed to configure. 
988 Added support for KDE, by adding a DisableWorkspaceMouseActions option.
989 Set it to YES and run krootwm to be able to use everything in kfm.
992 Shortcuts for Root Menu
993 -----------------------
995 There is now a new SHORTCUT optional keyword for the menus.
996 For example, you can bind Control-F1 to xterm with:
998 "XTerm" SHORTCUT Control+F1 EXEC xterm
1000 or F2 to ARRANGE_ICONS with:
1002 "Arrange Icons" SHORTCUT F2 ARRANGE_ICONS
1005 All commands allowed in the menu file accept the keyword, except for
1006 MENU and OPEN_MENU
1009 Interface Changes
1010 -----------------
1012 ** Configuration of docked applications is now done in a panel instead of
1013 in the menu. 
1015 ** Added a command menu for application icons
1017 ** Shift double-click on the application icon will unhide the app
1018 in the current workspace.
1021 Option Changes
1022 --------------
1024 NotMiniaturizable option changed to NoMiniaturizeButton
1025 NotClosable option changed to NoCloseButton
1028 Speed options values are now UltraFast, Fast, Medium, Slow or UltraSlow
1029                                               ^^^^^^
1031 Removed the Select keyboard binding. You can access it in the window
1032 commands menu.
1034 Removed the ClipMaxIcons option and made it a compile time option.
1036 Removed the ConstrainWindowSize option
1038 Renamed NoSound to DisableSound
1040 Renamed NoAutowrap to DontLinkWorkspaces
1042 Renamed NoDithering to DisableDithering
1044 Renamed NoAnimations to DisableAnimations
1046 Removed the LeftHanded option and added a SwapMenuButton option.
1047 SwapMenuButton will make the rubberband selection in the root window
1048 be bound to the right button and the root menu to the left button.
1051 New way to display temporary icons
1052 ----------------------------------
1054 The icons that are attracted by Clip, but will not be kept after the
1055 application close, are now using a different color for shading, unlike previous
1056 version that always used white. This will improve look for very different color
1057 combinations, and allow the user to control the look of the shaded icon.
1058 The color used for shading the icons is computed as follows:
1060 First a color is computed depending on the IconBack type:
1061  - for solid the color is the solid color itself.
1062  - for simple gradients the color is (from_color + to_color)/2.
1063  - for multiple gradients, the color is the first color in list.
1064  - for pixmaps, the color is the solid color specified for that pixmap.
1066 Then the color is made lighter by multiplying each red/green/blue filed with
1067 1.7 and limiting each field to 0xff in case they exceed this value.
1068 Then this new color will be used by superposing it with the icon we want to
1069 shade, using a proper alpha value.
1071 To control the color for shading is simple:
1073 - In case of multi gradients you just need to put the first color, as the color
1074 you like. WindowMaker do not use the first color in the list to directly build
1075 the gradient, but only when it needs a solid color for something (like in this
1076 case).
1078 - For pixmaps, put the needed color as the solid color the syntax for pixmaps
1079 require. This color is also not used when displaying normal icons, just when
1080 solid colors are needed (like this case).
1082 - For solid color, or simple gradients, in case the color it uses after
1083 computing is not good enough, you can always convert the solid or simple
1084 gradient to a multi gradient with the same look, and use that one. In this
1085 case is simple, just put the needed color as first color in list.
1087 Please note that this will not slow down WindowMaker, because the IconBack is
1088 read only once at startup, and then only if it is changed. After reading it WM
1089 will construct the image of the tile, and use the image instead of recomputing
1090 the gradient every time.
1092 Here are 2 examples of converting solid or simple gradient to a same looking
1093 multi gradient:
1095 IconBack = (solid, Blue);
1096 will become
1097 IconBack = (mhgradient , LightBlue, Blue, Blue);
1098 using LightBlue as color for shading.
1100 IconBack = (dgradient, "#284569", "#082420");
1101 will become
1102 IconBack = (mdgradient, "#183454", "#284569", "#082420");
1103 looking the same, but using #183454 for shading.
1106 New Sound Server Location
1107 -------------------------
1109 The sound server new URL is http://www.frontiernet.net/~southgat/wmsound
1110 Also it seems to be running on FreeBSD too (with little changes maybe).
1113 --- 0.16.1
1115 WINGs
1116 -----
1118 The path for the WINGs resource files was changed. If you don't
1119 do make install, you must move /usr/local/share/WindowMaker/Resources to
1120 /usr/local/share/WINGs
1123 New Options
1124 -----------
1126 The following new options are available:
1127 NewStyle = Yes/No; (static) Replaces --enable-newstyle
1128 DisableDock = Yes/No; (static) Same as -nodock command line option.
1129 DisableClip = Yes/No; (static) Same as -noclip.
1130 Superfluous = Yes/No; (dynamic) Replaces --enable-superfluous.
1132 NOTES.
1133 - The static options are only read at startup. Changing them, needs to restart,
1134   so they will be accounted.
1135 - DisableDock and DisableClip have lower precedence than -nodock -noclip
1136   command line options. If both option/command line option are given, then the
1137   command line option will be accounted.
1140 Start Hidden option
1141 -------------------
1143 The start hidden option was fixed, and made to be an application wide option.
1144 It will apply to every window the application owns. Also its place in the
1145 Attribute Inspector panel, changed accordingly, to reflect this.
1146 The start miniaturized is however still applying to particular windows of an
1147 application, unless the option is set for the class.
1148 Start miniaturized, will override start hidden if both set.
1150 IMPORTANT NOTE.
1151 Because of the way Netscape Communicator is implemented, it is NOT possible
1152 to set the start hidden or miniatirized flags for it. This is because Netscape
1153 chooses to send a second map event to the window it maps. This makes the
1154 window to receive a second map request and to be unhidden or maximized back,
1155 immediately after it was hidden or miniaturized by WindowMaker at startup.
1159 --- 0.16.0
1161 Misc. Changes
1162 -------------
1164 The NextMenuBehaviour option was renamed to WrapMenus
1165 The WorkspaceTiedMiniwindows option was renamed to StickyIcons
1167 The .tif files were renamed to .tiff
1170 Selecting Mini Windows
1171 ----------------------
1173 Now miniaturized windows can be selected as well as normal windows.
1174 You can do this by Shift-Click-ing them. They will be marked, and will follow
1175 you through workspaces like normal selected windows do.
1176 Miniaturizing a window will no longer deselect the window, but will place the
1177 icon and mark it as selected.
1178 The only difference between miniaturized and normal window selection is that
1179 for the moment the rubber-band selecting method works only for normal windows.
1182 Icon Selection Panel in Attributes Editor
1183 -----------------------------------------
1185 Now, selecting icons is as easy as clicking in the file name in a list.
1188 Simplified Options
1189 ------------------
1191 IconSlideStep, IconSlideSlowDown and IconSlideDelay were merged to 
1192 IconSlideSpeed
1194 MenuScrollStep and MenuScrollDelay were merged to MenuScrollSpeed
1196 ShadeStep and ShadeDelay were merged to ShadeSpeed
1199 Valid values for them are: Fast, Normal, Slow or UltraSlow
1201 If you want to fine tune the values, they can be changed in wconfig.h
1202 Send me your set of values with an indication of how fast is your hardware,
1203 so that I can make the default values more adequate.
1206 New Window Attributes
1207 ---------------------
1209 Added StartMiniaturized and StartHidden as window attributes and
1210 removed the previous implementation. Also removed the dock menu entries.
1211 They are now settable in the Attributes Panel.
1213 Also added DontSaveSession attribute. This way, you won't end up with multiple
1214 unwanted copies of the same app after the previous session is restored.
1215 I start X with a xterm in .xinitrc instead of wmaker, wich will cause the
1216 xterm restored by wmaker be duplicate. Just add -name something to the
1217 xterm started form .xinitrc and mark DontSaveSession=YES for that window.
1221 User Specifiable Visual IDs
1222 ---------------------------
1224 wmaker now supports different visuals than the default one. It isn't of much
1225 use for most people, but can be usefull for lucky SGI users who want it
1226 to use TrueColor instead of the default PseudoColor.
1228 wmaker -visualid VISUAL_ID
1230 where VISUAL_ID is the hex code for the visual you want.
1232 Note: I don't have an SGI box and haven't tested it...
1236 Starting Workspace
1237 ------------------
1239 The starting workspace is identified in the following order:
1240 1. If the app is omnipresent will be mapped on the current workspace.
1241 2. Else if the application have a StartWorkspace option set as attribute
1242    then this one will be used.
1243 3. Else, if the application was started from Clip, the workspace on which
1244    the Clip from where it was started is used.
1245 4. Else the current workspace is used.
1247 Restoring saved sessions will always use the saved workspace, no matter
1248 what other options are, except onmipresent.
1252 --- 0.15.1
1254 Workspace specific mini windows
1255 -------------------------------
1257 The minimized windows can be workspace specific, being more consistent with
1258 the rest. This is because minimized window represents just another state of a
1259 window (like normal or shaded), which all are workspace specific.
1260 This (or the old "present anywhere") behavior can be set using an option in
1261 the WindowMaker database: WorkspaceTiedMiniWindows = Yes/No;
1263 New way to animate the blowing icons
1264 ------------------------------------
1266 There is now a compile time option that allows one to set how the icons are
1267 animated when detaching from dock/clip in superfluous mode.
1268 By default the classic "Falling pieces" animation is used.
1269 If SPREAD_ICON is #define-ed in wconfig.h, then a "Spread in four directions"
1270 animation is used instead. Take a look at the section where this is described
1271 in src/wconfig.h
1272 By default there is #undef SPREAD_ICON to select "Falling pieces" animation.
1274 Auto Colapse for Clip
1275 ---------------------
1277 The clip now supports an option named "Auto Collapse" which can be set from
1278 the clip main menu. When set, clip will stay collapsed, and will show itself
1279 when the mouse moves over it. While the mouse is over it, or over any of the
1280 icons attached to the clip, the clip will stay uncollapsed, letting you to
1281 access the attached icons. This is not true for applications like asclock, or
1282 applets of that kind, because the icon window do not belongs to WindowMaker,
1283 but to the application itself. For such icons you must keep the mouse over the
1284 icon groundplate, else it will collapse back. But usually these type of icons
1285 will not stay in a collapsed clip, since one needs to see what they show.
1286 When the clip is leaved it will collapse back after a delay of 1 second, unless
1287 the mouse is moved back to the clip area. The delay can be set modifying
1288 AUTO_COLLAPSE_DELAY in wconfig.h. Default is 1000 (ms) which means 1 second.
1293 --- 0.15.0
1295 Changed name from Fiend to Clip
1296 -----------------------------------
1298 All occurrences of word Fiend with or without capital F were replaced with
1299 the corresponding Clip (same capital).
1300 This affects all configuration files under ~/GNUstep that contain this word.
1301 It can be refered as "Workspace Dock" too.
1304 New option in Clip menu, and extended Clip behavior
1305 ---------------------------------------------------
1307 The following new items are available in the dock menu:
1309 1. Attract Icons
1310 2. Keep Attracted Icons
1311 3. Collect Icons
1312 4. (Un)select All Icons
1313 5. Remove Selected Icons
1314 6. Move To
1315 7. Start miniaturized    (also available for regular dock)
1316 8. Start hidden          (also available for regular dock)
1317 9. Selected
1318 10. Set icon...          (also available for regular dock)
1321 Here is what they do:
1323 1. "Attract Icons" will let the Clip to attract and attach any new appicon that
1324    is created when an application starts. It will not do this if the Clip is
1325    full. If the Clip is Collapsed then the appicon will be hidden after it is
1326    attached.
1327 2. "Keep Attracted Icons" will tell the Clip to keep the attracted appicons,
1328    after the application is closed. Without this the appicons will vanish,
1329    leaving the Clip in the original state. If you move an appicon that was
1330    attracted from Clip to regular Dock, it will be kept when closed, no matter
1331    what "Keep Attracted Icons" is set to in Clip.
1332 3. "Collect Icons" will collect all appicons that are not yet attached to Dock
1333    or Clip, and attach them to the current workspace Clip. The value of
1334    "Keep Attracted Icons" will apply when applications close. If Clip is
1335    collapsed, the appicons will be hidden.
1336 4. "(Un)select All Icons" will select all icons in the clip if none is
1337    selected, or it will deselect all selected ones. The selected icons are
1338    marked using a small triangle in the bottom right corner of the appicon.
1339    The color of the mark is set using SClipColor in WindowMaker domain
1340    database.
1341 5. "Remove Selected Icons" will remove from Clip all selected icons. The ones
1342    that still run, will be detached, all the others will vanish.
1343 6. "Move To" will transfer all selected icons to another workspace and attach
1344    them to the Clip in that workspace. If none is selected, only the one the
1345    mouse was pressed on will be moved.
1346 7. "Start miniaturized" will launch (or autolaunch if set) the application in
1347    a miniaturized state.
1348 8. "Start hidden" will launch (or autolaunch if set) the application in a
1349    hidden state. Note that only one of the two can be set at a time.
1350 9. "Selected" can be used to toggle the selected state of the appicon
1351    individually. The same can be achieved using Shift-LeftClick on the appicon.
1352    In fact the intended way of toggling the selected state is by using
1353    the Shift-LeftClick on icon. The menu entry is just another way to do the
1354    same.
1355 10. "Set icon..." will allow one to set the image for the appicon. The image
1356    will be updated without restart, and also all appicons in the same
1357    instance.class as the one we set for, will be updated.
1359 So a simple way of avoiding the screen to be filled up with appicons is to set
1360 the "Attract Icons" in the Clip. Also the "Keep Attracted Icons" can be set to
1361 No, so the attracted icons will be deleted when application exits, thus leaving
1362 the Clip clean. If also one to not want to see the appicons that keep filling
1363 the Clip, he can set the Clip to be Collapsed.
1365 Getting rid of unneeded icons in Clip is as simple as selecting them
1366 individually using Shift-LeftClick, and then using the "Remove selected Icons"
1367 entry in menu.
1370 Support for different visuals.
1371 ------------------------------
1373 WindowMaker is now able to support any visual, except DirectColor, in any
1374 depth from 1bpp to 32bpp.
1376 One can start the X server with different visuals, by passing the X server the
1377 right option. For XFree 3.3.x is -cc <id>.
1378 WindowMaker is not yet able to choose a different visual from the Default one
1379 on a given screen, but can use any default visual it finds, except the direct
1380 color visual.
1381 For example starting X like (for XFree 3.3.x, and if the driver for the
1382 card supports this. Read the man page for your X server):
1383 startx -- -bpp 8 -cc 0 will give you the StaticGray visual.
1384 startx -- -bpp 8 -cc 1 will give the GrayScale visual
1385 and so on.
1387 Wrlib code is now generic, and will support any visual except DirectColor in
1388 any depth. Programs written with wrlib can work on different visuals from
1389 the default visual for a given screen.
1390 Behavior in different visuals can be tested using the testgrad program in
1391 wrlib subdirectory in distribution.
1392 testgrad -h will show the usage.
1394 Multidiagonal gradients are also implemented now in wrlib, and a new algorithm
1395 is used to speed up the generation of diagonal gradients.
1398 New arrangement of the directory structure under ~/GNUstep/
1399 ---------------------------------------------------------------
1401 To better adapt to theme support the directory structure changed under
1402 ~/GNUstep/Library/WindowMaker
1404 1. Style directory moved to Styles.
1405 2. Added the following directories: Backgrounds, IconSets, Pixmaps, Sounds and
1406    Themes.
1407 3. The .style files no longer get copied in the user's Styles directory.
1408    Instead they are read from the global /usr/local/share/WindowMaker/Styles
1409    directory.
1411 Under ~/GNUstep/Defaults the following changes occurred:
1413 1. A default WMState is installed by wmaker.inst.
1414    It contains the dockit program assigned to the top icon of the dock, and
1415    the wmsetbg program assigned for the drop command on both dock's and clip's
1416    main icon.
1417    Double clicking the dock's main icon will bring up dockit that will let you
1418    dock any application that do not have an application icon.
1419    Dropping an image on dock's or clip's main icon, from an Offix DND aware
1420    application, will put the image on the background tiled, and will update
1421    WindowMaker domain database file.
1422 2. Syntax of WMState changed a little. The old position will not be restored
1423    when you will first start the new version, but after that it will be
1424    normally remembered. This is because now the main clip icons is only saved
1425    once, not for every workspace.
1426    You should replace Fiend with Clip in any place where it appears, if you
1427    want to keep the old WMState file, else it will not work.
1428 3. At compile time, it will detect if you have support for tif, and will
1429    install a WMWindowAttributes with corresponding image name extension
1430    (.tif or .xpm). This is true only for pixmaps that come with the source
1431    distribution and get installed under /usr/local/share/WindowMaker/Pixmaps
1433 The menu file changed a lot. Old menu file will *not* work with new theme
1434 support, so please upgrade.
1437 New behavior of OPEN_MENU command
1438 ---------------------------------
1440 The OPEN_MENU command now supports the following syntax:
1441 1. File menu handling.
1442    // opens file.menu which must contain a valid menu file and inserts
1443    // it in current position
1444    OPEN_MENU file.menu
1445 2. Pipe menu handling.
1446    // opens command and uses it's stdout to construct menu.
1447    // Command's output must be a valid menu description.
1448    OPEN_MENU | command
1449 3. Directory handling.
1450    // Opens one or more directories and construct a menu with all
1451    // the subdirectories and executable files in them sorted alphabetically.
1452    OPEN_MENU /some/dir [/some/other/dir ...]
1453 4. Directory handling with command.
1454    // Opens one or more directories and construct menu with all
1455    // subdirectories and readable files in them sorted alphabetically,
1456    // preceding each of them with command.
1457    // WITH is a required keyword!!!
1458    OPEN_MENU /some/dir [/some/other/dir ...] WITH command -options
1460 Please note that because of the 'WITH' keyword old menu files no longer work
1461 for the OPEN_MENU with a command.
1464 Theme support
1465 -------------
1467 Theme support is now as easy as untar-ing a tarball in the right place.
1468 Because of the way OPEN_MENU works, they can be installed on a global
1469 shareable basis, or for personal user use.
1470 Themes installed under ~/GNUstep will be available only for a user, but
1471 if if they are installed under /usr/local/share/WindowMaker they will be seen
1472 by all users. This is also true for style files, background images, pixmaps,
1473 etc that get installed under /usr/local/share/WindowMaker.
1474 Themes can be saved or loaded using the Appereance menu.
1476 Also support for different IconSets is available. You can save or load a new
1477 IconSet using the Appereance menu.
1479 Setting background images is now as simple as putting the images in the right
1480 place (~/GNUstep/Library/WindowMaker/Backgrounds or
1481 /usr/local/share/WindowMaker/Backgrounds, or any other place in your
1482 PixmapPath). Then use the Appereance menu. They will be instantly available
1483 since they are opened by a OPEN_MENU command. Also the image do not need to
1484 have a .jpg or any other extension. It will be recognized anyhow.
1485 As an example please see the OpenStep theme supplied with WindowMaker.
1486 The OpenStep image is a jpeg file without extension.
1488 Please keep in mind that anything under /usr/local/share/WindowMaker will be
1489 available for all users.
1492 New options for wmsetbg and getstyle
1493 ------------------------------------
1495 wmsetbg now accepts the following options:
1496 usage: wmsetbg [-options] image
1497 options:
1498  -d             dither image
1499  -m             match  colors
1500  -t             tile   image
1501  -s             scale  image (default)
1502  -u             update WindowMaker domain database
1503  -D <domain>    update <domain> database
1504  -c <cpc>       colors per channel to use
1506 By default, it will try to guess if dithering is needed or not and proceed
1507 accordingly.
1508 Using -d or -m will force it to dither or match colors.
1510 Dithering for more than 15bpp is generally not needed, and will only result
1511 in a slower processing.
1512 Don't use dithering except when needed, because it is slower. Else rely on
1513 wmsetbg which will detect if dithering is needed and use it.
1515 -u will update the WorkspaceBack in the default database domain file in
1516    ~/GNUstep/Defaults/WindowMaker, and let WindowMaker refresh the screen.
1517    Please note that this option only works under WindowMaker, and will have no
1518    effect under other window managers, since it rely on WindowMaker to update
1519    the image after it reads the updated defaults database.
1521 -D <domain> is same as above, but will update the domain <domain> instead of
1522    the default WindowMaker domain.
1524 -c <cpc> will set the color per channel to use. Only needed for PseudoColor
1525    visuals. WindowMaker will automatically pass the value read from the
1526    WindowMaker domain database.
1529 getstyle now have the -t option, that instructs it to read all options
1530 related to theme. Without -t getstyle will read only style options that
1531 means it will not read WorkspaceBack and IconBack.
1532 Use -t when you want to make a theme and need all theme options to be saved.
1533 Else it will extract just a style file.
1536 Session management support
1537 --------------------------
1539 Two new commands are available for use in menus:
1541 SAVE_SESSION and CLEAR_SESSION.
1543 SAVE_SESSION:
1544 will take a snapshot of all running applications, and their current hints
1545 (shaded, hidden, minimized, geometry and workspace they are on),
1546 and save it inside the WMState file. Also the current workspace we are on is
1547 saved. The applications that are running and were started from dock or clip are
1548 marked, so they will be attached to the corresponding dock/clip when restored.
1549 This state is restored every next session, until a new one is saved or
1550 CLEAR_SESSION is used.
1552 CLEAR_SESSION:
1553 will clear any previous saved session.
1555 There is also a run time option named SaveSessionOnExit = Yes/No; that allows
1556 one to automatically save the state of desktop when leaving WindowMaker.
1557 This way next session, the state of the desktop before last exit is restored.
1559 Please note that if this option is set to Yes, than any manual saving of the
1560 state, or any clearing of the state will be overridden when exiting
1561 WindowMaker.
1563 These options are available under the "Workspace" menu.
1566 User WindowMaker configuration files are now merged with global ones
1567 --------------------------------------------------------------------
1569 When starts WindowMaker will look for database domain files under
1570 $GNUSTEP_USER_ROOT/Defaults or ~/GNUstep/Deafults to be read. (In this order).
1572 If they are not available then it will scan for them in
1573 $GNUSTEP_LOCAL_ROOT/Defaults, $GNUSTEP_SYSTEM_ROOT/Defaults or
1574 /usr/local/GNUstep/Defaults (in this order).
1576 Even if the file was found or not, it will always load the corresponding domain
1577 file under /usr/local/share/WindowMaker/Defaults.
1579 Then if the user file was found it will merge it over the global file, else
1580 the global file will be used.
1582 This way any settings that are set by the system administrator in the shared
1583 file will be available for users that do not have them in their config files.
1584 Any option the user have in his config file will override the one in the
1585 shared domain file.
1587 So any new runtime options that appear in WindowMaker domain, do not need to
1588 be set in all user files, except the ones the user wants a different behavior
1589 from the default set for all users in the shared file.
1591 Also it is possible for the user to not have any personal domain databases, and
1592 the global shared ones will be used, but it still needs to have the directory
1593 structure, so WMState gets written on session exit.
1594 So all it needs to have is ~/GNUstep/Defaults directory available.
1597 New behavior of the Slide Icons
1598 -------------------------------
1600 Animation constants are now runtime.
1601 They are:
1602 IconSlideDelay = 0;
1603 IconSlideStep = 5;
1604 IconSlideSlowDown = 50;
1606 To better adapt both slow and fast machines the behavior of sliding icons
1607 changed in the following manner:
1609 Old one was to keep moving the icon with a constant step (default 5 pixels)
1610 until it reached the destination.
1612 Now it will use a new parameter named IconSlideSlowDown to speed up or slow
1613 down the moving.
1615 Instead of moving it with a constant step it will use IconSlideSlowDown to
1616 divide the distance to the destination, and use this value as the first step.
1617 Then is will compute the remaining distance and will again use
1618 IconSlideSlowDown to divide it and get the new step. And so on.
1619 When the step to move becomes smaller than IconSlideStep, IconSlideStep will
1620 be used further until the destination is reached.
1622 This way a nice deceleration effect is achieved, since while the icon
1623 approaches destination, it will use smaller steps, gibing the illusion that
1624 the icons is moving slower.
1626 IconSlideDelay will give the pause between steps, and is expressed in ms.
1628 Giving large values to IconSlideSlowDown (>1024 for 1024x768 screen) will
1629 result in the old "constant step advance" behavior, since the computed step
1630 will always be smaller than IconSlideStep, and the last will be used instead.
1632 Making IconSlideSlowDown = 0 or 1, will result in an instant jump to the
1633 destination without any animation.
1636 Attribute editor
1637 ----------------
1639 Because the icon images on screen automatically update after any change in
1640 WMWindowAttributes domain file, the use of both Save and Apply buttons is no
1641 longer needed. If one wants to just apply the setting to the current window
1642 only, he will only use the Apply button.
1643 If he wants them saved for all applications in the same instance and/or class
1644 the using the Save button will write them to disk, and automatically
1645 WindowMaker will update all the icons that need to be updated on screen.
1648 Sound support
1649 -------------
1651 Some basic sound support is now part of WindowMaker. The sound server is not
1652 yet part of WindowMaker distribution, so you need to download it separately.
1653 This is because is linux specific, and need some changes before it can be
1654 included.
1655 Until them if you have a linux system and want to use sound, use the
1656 wmsound-0.5 available at http://www.geocities.com/SiliconValley/Bay/7874
1657 Download that package, and only build the sound server there.
1658 DO NO APPLY ANY PATCHES FROM THERE!, because they are already applied.
1659 Just build the sound and copy the executable in /usr/local/bin
1660 Follow the rest of the install steps described there, except the patch-ing
1661 procedure.
1663 To enable sound for WindowMaker pass --enable-sound to configure.
1665 Also use NoSound = Yes/No; to enable/disable sound at runtime without killing
1666 the sound server.
1668 If you cannot set the sound to work yet, then is not for you.
1669 Wait until the sound server will be fixed and will be part of WindowMaker.
1672 New entries in WindowMaker domain database
1673 ------------------------------------------
1675 The following entries have been added to the runtime options:
1677   SaveSessionOnExit = No;
1679 will autosave (or not) the session state on exit.
1681   WindowPlaceOrigin = "64, 64";
1683 will offset all windows in auto or cascade placement mode with the value
1684 (in pixels) before placing them on screen. First is horizontal direction and
1685 second is vertical.
1686 This do not apply to windows that request a specific position on screen.
1687 This is useful if you want your Clip on the top left corner to not be
1688 overlapped by mapping windows.
1689 It will let it to have a row and a column of docked appicons near the screen
1690 edge, that will not be overlapped by windows.
1691 If you set it to "128, 128" it will have 2 rows and 2 columns not overlapped.
1694   NoSound = No;
1696 Enable/disable sound at runtime without the need of killing the sound server.
1699   MenuScrollDelay = 10;
1700   MenuScrollStep = 5;
1702 Constants for the menu scrolling animation.
1704   IconSlideDelay = 0;
1705   IconSlideStep = 5;
1706   IconSlideSlowDown = 50;
1708 Constants for the icons sliding on screen. Explained above.
1710   ShadeDelay = 0;
1711   ShadeSteps = 15;
1713 Animation parameters for shading a window. How many steps it will take, and the
1714 delay between steps in ms.
1716   DoubleClickTime = 250;
1718 The time for the double click to be considered so. Expressed in ms.
1720   SClipColor = "#6f8ae2";
1722 Color for selected icons in Clip.
1724 All delays are expressed in ms.
1728 --- 0.14.1
1731 *** Enhanced fiend clone.
1733 Here are the new fiend features:
1734 1. Keys for raising/lowering the fiend, and their default values:
1735    FiendLowerKey = None;
1736    FiendRaiseKey = None;
1737    FiendRaiseLowerKey = None;
1739    All reside in WindowMaker configuration file.
1741 2. Added posibility to launch the workspace menu with button1 click on the
1742    idle indicator of fiend, or with button3 click on workspace name on the
1743    fiend.
1745 3. Added Control-button1-click on fiend's idle indicator, to create a new
1746    workspace and move to it. Same action as New item in Workspace menu.
1748 4. Fiend's idle indicator do have a color that reflects its normal/collapsed
1749    state.
1751 5. The delay between changing workspaces from fiend is now a runtime option:
1753    WorkspaceChangeDelay = 700;
1755    in WindowMaker configuration file.
1757 6. Application icons can be moved between dock and fiend now.
1759 7. The way workspaces are changed is controlled now by two runtime options:
1761    AdvanceToNewWorkspace=Yes/No;
1762    CycleWorkspaces=Yes/No;
1764    Both apply to either fiend navigating buttons or to next/prev worksapace
1765    keybindings. Both default to No, and are in WindowMaker configuration file.
1767 8. Also added posibility to advance to new workspace, no matter what value
1768    AdvanceToNewWorkspace have, with Control-button1-click on "next workspace"
1769    fiend button.
1772 *** Theme support ***
1774 Spixmap and tpixmap now work. Their syntax is:
1776 SomeStyleOption = (spixmap, file, color);
1777 SomeStyleOption = (tpixmap, file, color);
1779 - spixmap means scaled pixmap, so the image in the file will be scaled to
1780 adapt to the destination's size.
1781 - tpixmap means tiled pixmap, and the image from file will be tiled in the
1782 destination.
1784 file is searched in the PixmapPath, but can be a full path name.
1786 Color is used depending on which Style option is applied.
1787 For example in case of titlebars, color is used for miniwindows titles color.
1788 You are not restricted in selecting that color, but is better to put one
1789 that matches the overall color of the image.
1791 Currently they apply to all the options that accept (solid, color), or any
1792 type of gradient.
1793 This means they also apply to WorkspaceBack and IconBack, which allows theme
1794 support with the simple use of the setstyle and getstyle utilities.
1795 There is no need for an extra theme manager, just to include the needed
1796 options in the style files.
1798 In case of WorkspaceBack, color is used to be set in the background until
1799 the image gets loaded and displayed. This is to avoid the stippled screen
1800 the X server shows, in case the image is big and loads slow.
1801 There is a small utility in the util directory, named wmsetbg which is
1802 used to set the background image. This is needed for windowmaker not to
1803 freeze while loading and scaling the image.
1804 Currently it is hardcoded in windowmaker to use wmsetbg to set the background
1805 image, and is better to use it since is smaller that other image manipulation
1806 programs, and it is compiled with support for same image types as windowmaker.
1807 Since it comes and is installed with WindowMaker, there will be no need to
1808 download and use an external app, which also may not have support for the same
1809 image types as windowmaker.
1813 --- 0.14.0
1815 *** Fiend clone.
1817 The fiend clone is a dock extender, that lets you dock more than the default
1818 10-12 icons in the dock. It actually lets you dock how many icons you like,
1819 with a current default of 25 per workspace. The fiend have different docked
1820 icons on every workspace. Also the fiend main icon shows you the workspace
1821 you're on and lets you navigate through the workspaces with the small green
1822 buttons on the low right corner.
1823 To save screen space the fiend can be collapsed to the main icon either
1824 from the fiend menu (available with right click on the fiend icons), or
1825 with a double left click on the main fiend icon, which is a toggle for
1826 the collapsed/uncollapsed state.
1827 Collapsed state is marked by a different title color.
1828 Pressing on the small buttons on the low right corner, the workspaces are
1829 changed in increments of 1 to the left or right, but keeping the button
1830 pressed over them will continuously advance through workspaces until the
1831 mouse is moved away from the buttons or the button is released.
1832 The delay between workspace changes is set by FIEND_WKS_CHANGE_DELAY in
1833 src/wconfig.h, and defaults to 700 ms.
1834 Unlike the dock, fiend can hold icons in any directions, and can be placed
1835 in any position on screen.
1837 When an icons is to be docked, but the position can be either in the dock
1838 or in the fiend, the dock will be used first, and the icon will be docked
1839 there.
1841 Here are the new runtime options introduced by the fiend:
1842 Files are located in ~/GNUstep/Defaults/
1844 In WMWindowAttributes:
1845        "Logo.WMFiend" = {Icon = "Cone.xpm";};  - icon for the fiend
1847 In Windowmaker:
1848         FiendMaxIcons = 25;           - the max number of icons in fiend per
1849                                         workspace
1850         FiendTitleFont = "-*-helvetica-bold-r-normal-*-10-*-*-*-*-*-*-*";
1851                                       - the font used to show the current
1852                                         workspace
1853         FiendTitleColor = black;      - color for the uncollapsed fiend title
1854         CFiendTitleColor = "#616161"; - color for the collapsed fiend title
1855         AFiendColor = "#00ba70";      - color for the workspace changing
1856                                         buttons, when active
1857         IFiendColor = "#008000";      - color for the workspace changing
1858                                         buttons, when idle
1860 For the ones who don't want to use fiend, there is a option to wmaker named
1861 -nofiend that can be feed to the command line when starting wmaker.
1862 (This is the equivalent for -nodock, but removes fiend clone).
1864 The syntax of WMState file have changed, but you don't have to worry because
1865 WindowMaker will know to read the old format and will save it and further
1866 will use the new one. You do not need to change your file, for the new version
1867 to work.
1870 --- 0.13.1
1872 *** Enhanced Attribute editor.
1874 Now you can save defaults for all windows.
1875 Please note that only Icon, KeepInsideScree, and sometimes NoAppIcon
1876 can be useful in a normal environment. But others may have other opinion ;)
1877 If you set AlwaysUserIcon default for all windows, note that apps like
1878 asclock, wmload, wmmail, wmrack, will show that icon instead of their
1879 window.
1881 Now Attribute editor also counts for defaults saved for all windows,
1882 (not only the default "No" for all options hardcoded in WindowMaker),
1883 when saving options for some instance.class specification. This is to
1884 save disk space by saving only the options that differs from global defaults
1885 (either defaults for all windows or the hardcoded valued in WindowMaker).
1887 Attribute Editor now updates on the fly the appicon image or creates/deletes
1888 the appicon if you set that options in the Inspector panel and Apply them.
1889 Modifying Icon file, NoAppIcon or AlwaysUserIcon and Applying them will
1890 result in the image update for the app-icon.
1892 Note that if you apply but not save these options, the miniwindow image will
1893 not be updated. This is because app-icon is always on screen so it can be
1894 updated, but miniwindow image is read from the defaults database and from disk
1895 every time you minimize the window and is destroyed when you restore.
1898 --- 0.13.0
1900 *** Atribute editor is working ;).
1902 How it works is quite obvious.
1903 Anyway, here is a short description.
1905 Save   - only save the configuration in defaults database and updates
1906          WMWindowAttributes
1907 Apply  - only applies the values to the current window
1908 Revert - reverts the values from the defaults database
1910 Note that Save and Revert count for the window specification
1911 (instance & class), that are selected, and save/use the values for/from
1912 that.
1914  The Update button will show the icon who's name was typed in the textfield
1915 If the textfield is empty, will try to use the default icon.
1916 Also saving with and empty textfield for icon, uses the default icon.
1918  The Default button will use the icon in the textfield as default icon
1919 and save that value in WMWindowAttributes (Note that in this case is no
1920 need to press the Save button!). Also if the textfield is empty it will
1921 try to use the old default icon, if available.
1923 *** Now menus are saved between sessions, or over a restart.
1925  Just stick them to the desktop, and you will find them over sessions
1926 until you close them.
1927  Please note that only the root_menu, the window switch_menu and the
1928 workspaces_menu can be saved this way.
1930 *** Changed the lousy Windoze menu behaviour.
1932 This applies to 'NextMenuBehaviour = NO;'
1934  Now the items are no more automatically selected if you launch the menu
1935 and the mouse is over some item, if you use a short click to launch the
1936 menu (shorter than the default DBL click time).
1937  If you use a longer click or keep the mouse pressed, the item under mouse
1938 will be selected after that delay, and launched when you will release the
1939 mouse button.
1940  If the click was short, a second one is needed to launch the item.
1942 *** Autoarrange icons is now a runtime option
1945 AutoArrangeIcons = YES/NO;
1946 in 'WindowMaker'.
1948 *** Added configurable horizontal resize threshold
1951   HorizontalResizeThreshold = <n>;
1953 This will make the n pixels at the exterior side of the corner handle
1954 of the resize bar to restrict to horizontal only resize.
1955 Also you can use Shift-click&drag anywhere on the corner handle to
1956 restrict the resize only to horizontal.
1957 Note that the Shift-click&drag does not depend of the configured threshold
1958 and works completely independent.
1960 *** New option for OPEN_MENU (pipe from command)
1962 OPEN_MENU | /foo/bar/script
1964 will make a menu that is dinamically constructed by /foo/bar/script
1967 --- 0.12.0
1969 *** New option for OPEN_MENU
1971 OPEN_MENU /foo/bar/pics xv -root -quit
1973 will make a menu with all files in /foo/bar/pics and precede them
1974 with EXEC xv -root -quit
1976 thus, making a menu with entries like:
1979 "marble.gif" EXEC xv -root -quit marble.gif
1980 "water.jpg" EXEC xv -root -quit water.jpg
1984 *** Multicolor gradients
1986 (mhgradient, colorX, color1, color2, color3, ..., colorn)
1987 (mvgradient, colorX, color1, color2, color3, ..., colorn)
1989 You can put any number of colors >= 2. 
1991 colorX is a special color that is used as the solid color of the
1992 texture when wmaker needs a solid color (like in miniwindow title and
1993 resizebar)
1995 *** PixmapPath format changed
1997 What used to be
1999 PixmapPath = "/usr/local/share/pixmaps:~/foobar";
2001 must now be
2003 PixmapPath = ("/usr/local/share/pixmaps", "~/foobar");
2006 *** Added OffiX DND in dock
2008 Use the "Set drop arguments..." command in the menu and put a %d
2009 where the dropped object string should be substituted, like:
2011 xedit %d
2013 *** Escape thingies for menu and dock commands:
2015 %w - substitute with current selected X window ID
2016 %s - substitute with current selection
2017 %d - substitute with last dropped object
2018 %a(some text) - opens a input box with "some text" as a title. Then,
2019 the text typed will be substituted there
2021 \r, \n - substitute with corresponding characters
2024 *** The WMState file format has changed a little.
2025 The Command field for the dock application list is now a normal string,
2026 instead of a list. So, remove the parentheses and the commas for the command
2027 and join all the parts. Example:
2029 if it used to be
2031 Command = ( xterm," -geometry", "+10+10" );
2033 then make it
2035 Command = "xterm -geometry +10+10";
2038 --- 0.10.2
2040 AutoFocus = NO; disables automatic focusing of windows
2041 when they are first mapped
2044 --- 0.10.1
2046 titlebar gradients are in a single piece now
2048 the WMDock file was merged into the WMState file. You can insert this
2049 file in WMState and set it's key to Dock. For example, if your WMDock
2050 contains:
2053         Applications = { {Command = (); }};
2054         Position = "-64,0";
2055         Lowered = NO;
2058 and WMState contains:
2061         Workspaces = ( "Workspace 1" );
2064 then you can merge both and have:
2067         Workspaces = ( "Workspace 1" );
2068         Dock = {
2069                 Applications = { {Command = (); }};
2070                 Position = "-64,0";
2071                 Lowered = NO;
2072         };
2077 The configuration format has changed!! Forget everything about the old
2078 format.
2080 dockapp was removed and the old version will not work anymore. 
2082 the dialogs require tcl/tk. they will be rewritten in plain C
2085 These are some tips for people upgrading from older versions and don't want
2086 too many unused files around. There is no problem if you decide to keep 
2087 them for a while.
2089         you can  rm -r ~/gnustep if you don't want anything from there
2091         remove the files in /usr/local/share/WindowMaker before installation
2093         the /usr/local/share/pixmaps directory can be removed