Fix syntax error in NEWS.
[wmaker-crm.git] / NEWS
blobf6af6e9fa2adac44c0535539e0693f6ec1c1cae6
2 NEWS for veteran Window Maker users
3 -----------------------------------
5 --- 0.53.0
8 KDE 1.1 compatibility
9 ---------------------
14 New Options
15 -----------
17 ** MenuStyle
19 MenuStyle=<style>; will change the menu texture style.
21 <style> can be:
22 normal (default): for the traditional one texture per item, with bevels in 
23 each
25 singleTexture: for a single texture that spans the whole menu, with bevels
26 in each item
28 flat: singleTexture without the bevels
31 ** ResizebarBack
33 ResizebarBack=<texture>;
35 where <texture> is any of the textures you normally use in titlebars and
36 other places.
38 If the style file/theme does not contain a ResizebarBack option, setstyle
39 will automatically hack it so that wmaker will make the theme work like 
40 before.
43 New crash dialog panel
44 ----------------------
46 From now on, whenever a fatal situation appears, Window Maker will display a
47 dialog panel to the user and let him choose what to do.
48 The options are:
49 - Abort and leave a core file (usefull for debugging and getting backtraces)
50 - Restart Window Maker (default behaviour)
51 - Start alternate window manager (the one defined as fallback, or if not
52   possible fvwm or twm in this order).
54 If it will not be able to restart or start the alternate window manager, it
55 will abort and leave the core file.
58 Application User Menu
59 ---------------------
61 Applications with an appicon can have a user defined menu.
63 This menu will emulate keyboard events, and will be sent to the applications'
64 window(s), thus the application must accept key combinations (CTRL+N for
65 instance).
67 To enable this feature, #define USER_MENU in src/wconfig.h and place menu
68 files in ~/GNUstep/Defaults/UserMenus (/usr/local/etc/WindowMaker/UserMenus
69 globally).
71 The user menu is in PropList format and the filename is in:
72 <instance name>.<class name>.menu or application's main window.
73 (Example: the menu for xcalc would be - xcalc.XCalc.menu)
75 Example user menu syntax:
78   "Calculator",
79   ("Put 1", SHORTCUT, "2"),
80   ("Functions",
81     ("Put 2", SHORTCUT, "2"),
82     ("Put 3,4 and 5", SHORTCUT, (3,4,5))
83   ),
84   ("Exit", SHORTCUT, "Control+q")
89 --- 0.52.0
92 Appearance Editing in WPrefs
93 ----------------------------
95 Added Appearance/Texture editing capability in WPrefs. Workspace background
96 selection is not yet finished.
99 Themes
100 ------
102 Removed all themes from the source tree, and moved them in a separate package.
103 You can download the new package from the same place as this package:
104 ftp://ftp.windowmaker.org/pub/beta/srcs/
105 Look after WindowMaker-extra-<version-number>.tar.gz
106 Also WindowMaker-extra pack include the old WindowMaker-data.tar.gz which only
107 contained icons.
108 Look for the greatest version number when you download this package.
111 get-wraster-flags script change
112 -------------------------------
114 The name of the options passed to get-wraster-flags changed, to allow a better
115 name compatibility with the naming conventions used by other software.
116 The name change was as follows:
117 --lflags was changed in --ldflags
118 To allow backward compatibility, with already written software, the old
119 --lflags option is still recognized, but you are encouraged to move the the
120 new --ldflags.
124 --- 0.51.2
127 New Themes
128 ----------
130 Added 2 new cool themes (actually I added in 0.51.1, but forgot
131 to put it here...) from largo (LeetWM) and BadlandZ (STEP2000).
134 Full Screen Maximization
135 ------------------------
137 The FullMaximize window attribute will allow the window to
138 be maximized to the full size of the screen (ignoring anything
139 like titlebar, resizebar, dock, panels etc). It should be usefull
140 for programs that must use the whole screen, like games or things 
141 like presentation programs.
144 --- 0.51.1
146 KDE Application Menu script
147 ---------------------------
149 wkdemenu.sh is a converter from KDE application menu structures to wmaker 
150 menu that can be used as a piped menu. Look wkdemenu.sh for how to use it.
153 Window Edge Resistance
154 ----------------------
156 Window edge resistance was now added. No, feature freeze hasn't been
157 removed. Its just part of the edge resistance rewrite ;)
160 New Theme
161 ---------
163 Added SteelBlueSilk theme
165 Installation Path Changes
166 -------------------------
168 Default configuration data installed in /usr/local/etc/WindowMaker
169 or $(sysconfdir)/WindowMaker
172 --- 0.51.0
174 Window Maker has become a GNU program (part of the GNU Project).
176 Title text drop shadow
177 ----------------------
179 drop shadow option added for titlebar text. This is a compile time 
180 option which needs to be defined in src/wconfig.h after you run
181 configure and before you run make.
183 New options and syntax for your WindowMaker domain file are:
185   Shadow = yes/no;
186   FShadowColor = <color>;  
187   PShadowColor = <color>;
188   UShadowColor = <color>;
189   MShadowColor = <color>;
191 The shadow option is dynamic (no need for a restart).
192 MShadowColor is for the menu title text.
194 libPropList
195 -----------
197 WARNING!!! libPropList was removed from the Window Maker distribution
198 and is being distributed separately. If you dont have it installed yet,
199 get it from ftp.windowmaker.org/pub/libs and install before building
200 Window Maker.
203 signal handling change
204 ----------------------
205 SIGHUP will exit wmaker instead of restarting it!!! This is because
206 GNOME expects the window manager to exit instead of restarting...
207 Complaints should go to gnome people. SIGUSR1 will restart wmaker now.
210 script change
211 -------------
212 WINGs-flags was removed, and replaced by get-wraster-flags.
213 Please remove WINGs-flags from your system, since it was obsoloted by
214 get-wraster-flags.
215 Continuing to use WINGs-flags can lead to hazardous effects, since is no
216 longer updated.
219 docklib
220 -------
222 docklib is a little library for making dock applets. It's in the
223 docklib-0.0.tar.gz file. Unpack it and read the README file there.
226 Option Changes
227 --------------
229 Removed OnTopTransients option
231 Added OpenTransientOnOwnerWorkspace
234 Olwm Hint Support
235 -----------------
237 OPEN LOOK(tm)/olwm hints support was added.
239 Read the appropriate section in the README file.
243 --- 0.50.1
245 New option for WorkspaceBack. mpixmap is the same as spixmap, but
246 it will scale the pixmap by keeping the aspect ratio (maximize or maxpect).
247 The option only works for workspace backgrounds.
249 Also added IGNORE_PPOSITION compile time flag, which is equivalent
250 to NoPPosition from fvwm. 
255 --- 0.50.0
258 KDE and GNOME
259 -------------
261 Added full support for GNOME and KWM hints. 
262 Read the INSTALL file to see how enable them.
264 Everything in the so called GNOME window manager bla bla bla pseudo-spec is
265 implemented.
267 As for KDE stuff, it implements 90% of everything kwm does, adds some
268 Window Maker specific extensions to it and still uses half of the memory
269 kwm does, which should be enough to let you dump kwm ;) For details on what
270 exactly is implemented, see comments in src/kwm.c Read the README.KDE file 
271 for more information.
274 WARNING: Some KDE hints are badly designed, so doing things like using
275 kpanel's desktop switcher/pager and Window Maker's internal workspace
276 management functions to create, destroy and rename workspaces at the same 
277 time might cause unknown effects. To be on the safe side, only
278 use either of them to manage workspaces. Switching workspaces is hopefully,
279 safe, so you can switch workspaces from wherever you want.
283 Workspace Specific Background Images
284 ------------------------------------
286 Use the WorkspaceSpecificBack to set background images for specific
287 workspaces. The WorkspaceBack is used as the default background image.
289 Example:
291 WorkspaceSpecificBack = ((solid, red), (cpixmap, ship.jpg, gray), (), 
292                                 (dgradient, red, blue))
294 This will set the background image of workspace 1 to (solid, 0),
295 2 to ship.jpg and 4 to a gradient. Workspace 3 and other workspaces
296 will have the image defined by WorkspaceBack.
298 Note that this uses quite some memory...
301 setstyle/getstyle
302 -----------------
304 setstyle now accepts the -nofonts flag, which will load the style
305 file ignoring all font related options.
307 Example:
309 setstyle -nofonts Blabla.style
312 getstyle can be used to create theme packs. See the usage in the
313 WindowMaker/README.themes file.
317 New Texture Type
318 ----------------
320 Textured gradients will tile a texture pixmap and combine it with a gradient, 
321 using an arbitrary opaqueness. 
323 Syntax is (thgradient, <file>, <opaqueness>, <color1>, <color2>)
324           (tvgradient, <file>, <opaqueness>, <color1>, <color2>)
325           (tdgradient, <file>, <opaqueness>, <color1>, <color2>)
326 where:
327 <color1> and <color2> are the colors for the gradient,
328 <file> is the texture file and
329 <opaqueness> is the opaqueness to merge the texture witht the gradient,
330 ranging from 0 to 255.
332 Example:
334 (thgradient, "BlueImage.jpeg", 120, white, black)
336 The BlackTexture style and Checker theme are examples.
338 Hints:
340 You can use any type of pixmap file for this, but small (like 64x32)
341 grayscale pixmap files should get the best results (fast and low memory
342 usage). You can use color pixmaps, but it is harder to get the desired effect
343 with them.
345 Be warned that this texture type is the slowest.
349 New Options
350 -----------
352 IconTitleBack and IconTitleColor control the color of the
353 miniwindow title. Both of them are colors.
355 Example:
356 IconTitleColor=white;
357 IconTitleBack=black;
360 Since this introduces an incompatibility in themes and getting flamed by the
361 themes ppl isn't the most pleasant thing ("Whaddafuk you're thinking!? You
362 just broke 500 themes!!!" ;) the setstyle command was hacked so that it will
363 make old themes work as before, by trying to automatically set the above
364 options. Note that in some cases it will not have exactly the same results as
365 before.
368 StartMaximized window attribute. Will maximize the window when it
369 is mapped.
372 AutoRaiseLower option for the Clip. This allows automatic Raise/Lower of the
373 Clip icons when the mouse pointer enter/leave the Clip. To avoid unwanted
374 raising/lowering there is a time threshold before raising/lowering.
375 The thresholds can be changed in wconfig.h by changing one or both of
376 AUTO_LOWER_DELAY and AUTO_RAISE_DELAY (expressed in miliseconds).
377 For example if you set AUTO_RAISE_DELAY to 0, then the Clip will be raised as
378 soon as the mouse pointer enters it's area. Setting AUTO_RAISE_DELAY to a very
379 big value, will make the Clip to practically do not auto raise unless clicked,
380 but to be automatically lowered after AUTO_LOWER_DELAY (ms) when leaved.
383 New ThemePack Format
384 --------------------
386 Starting with this version, a new format of themes is being supported.
387 Before you open pine and start composing your flame, rest assured that
388 the old format is still supported. The new format is documented
389 in the WindowMaker/README.themes file.
392 Root Menu 
393 ---------
395 The -noext option for OPEN_MENU will strip whatever is after the last .
396 in file names that appear on the opened directory. So,
398 OPEN_MENU ~/bg WITH xv -root -quit
400 will create a menu with all the images in ~/bg without the extension.
404 --- 0.20.3
407 Icon (miniwindow) stacking
408 --------------------------
410 If you want miniwindows to reside under normal windows, edit
411 wconfig.h and change WNormalLevel (just grep for it) to
412 WDesktopLevel
415 5 Button Mouse
416 --------------
418 If you have a 5 button mouse and want to give some utility for
419 the extra 2 buttons, edit the appropriate line in src/wconfig.h
420 Clicking Button4 in the root window will switch you to the previous 
421 workspace and Button5 will do that for the next.
424 Option Changes
425 --------------
427 put NoWindowOverDock back
429 KeepOnBottom window attribute
432 -static command line option
433 ---------------------------
435 wmaker -static will start Window Maker in static mode. This will
436 prevent wmaker from checking or making any configuration changes.
437 That makes it possible to run wmaker before running wmaker.inst
440 Hysteresis for menu item selection
441 ----------------------------------
443 Hopefully it's intelligent enough, so you won't notice it.
445 In case you want to know what's it, it's equivalent to that
446 (insanely long) 2 second delay present in that Windoze95 menu, 
447 but more usefull than annoying (I hope :). To see it, do the following
448 with your current wmaker version and later with 0.20.3:
450 - open the apps menu and stick it
451 - click in the item for the "Workspaces" submenu and hold
452 - drag the mouse to the 4th or bigger entry (like "Workspace 4") in a
453 straight line, trying to select the target item before the submenu
454 is unmapped when you dragged over other items in the main menu
458 Window Shortcuts
459 ----------------
461 Window shortcuts are shortcuts to arbitrary windows. You can make up to 4
462 shortcuts. To assign a previously bound shortcut to a window use the "Select
463 Shortcut" submenu in the window commands menu. If the shortcut is not yet
464 assigned for any window, you can hit the shortcut to assign it to the active
465 window. The shortcut will do the same as clicking in an entry in the window
466 list menu. The keys for the shortcuts are defined in the ~/G/D/WindowMaker
467 file or in WPrefs.app
469 Option names are:
471 WindowShortcut1Key through WindowShortcut4Key
474 --- 0.20.2
477 The name of WindowMaker was changed to Window Maker.
479 Window creation animation disabled by default.
481 xdaliclock -shape
482 -----------------
484 If you use it edit src/wconfig.h and #define OPTIMIZE_SHAPE or disable the
485 titlebar and resizebar for the window. OPTIMIZE_SHAPE will remove the
486 flickering for xdaliclock and other programs that change their shapes often,
487 but will increase network traffic considerably. So, if you use xdaliclock
488 from a remote machine it can get slow.
491 Applications Menu
492 -----------------
494 The applications menu will now use the shell in the SHELL environment
495 variable to execute EXEC menu commands. If it is unset (I think it's always
496 automatically set by the shell program) it will use /bin/sh
499 Extra fancy icon kaboom :)
500 --------------------------
502 Edit src/wconfig.h and #define ICON_KABOOM_EXTRA to get
503 more effects for the icon undocking animation.
505 Options for superfluous stuff are even more superfluous, so this
506 will not become runtime.
509 XDE drag and drop support
510 -------------------------
512 Support for XDE drag and drop was added (by "]d" <id@maliwan.org>).
513 To enable, edit src/wconfig.h
514 The support works with gtk 1.1.2
517 libPropList
518 -----------
520 libPropList will now be built automatically by wmaker. Wich means
521 the (simplified) building process is now:
523 ./configure
524 make
525 make install
527 instead of:
529 tar xzf libPropList.tar.gz
530 (cd libPropList; make)
531 make
532 make install
534 You also don't need to worry about GNOME libPropList incompatibilities
535 anymore. 
538 Bug with focus lost in sloppy focus fixed
539 -----------------------------------------
541 The bug only occurs in sloppy or auto focus modes, with AutoFocus disabled
542 and Superfluous enabled. There is no easy/clean way to fix this, so Window
543 Maker will disable the animation of window creation if the focus mode is
544 either sloppy or auto AND AutoFocus=NO.
546 If you want the animation, enable AutoFocus or use manual focus mode
547 (prefered). 
550 The NoWindowUnderDock option was removed
551 ----------------------------------------
552 To obtain the same result, use the "Keep Dock On Top" option in the dock menu.
555 Persistent Program Suplied Icons
556 --------------------------------
558 Application supplied icons are now stored, so that the dock will keep
559 showing them after the app is exited. The icons are stored at
560 ~/GNUstep/.AppInfo/WindowMaker/
563 Sound support
564 -------------
566 Sound support is now on by default. Even if you don't use sound the overhead
567 is very small, and has no impact on performance. If you still want to
568 optimize it and remove a few hundred of bytes, then use --disable-sound or
569 --enable-sound=no options when you configure Window Maker.
572 --- 0.20.0
574   
575 Multihead support. wmaker will now manage all screens that are attached to the
576 display. 
577 ------------------------------------------------------------------------------
578   
580 It does so from a single process (instead of spawning a new process for each
581 screen, like fvwm does). This keeps memory usage a lot lower than fvwm.
583 State files have a suffix .n, where n is the number of the screen.
585 Since I don't have a real multiheaded machine, it probably has bugs.
587 Superfluous
588 -----------
590 Yet another useless superfluous animation. Find out what exactly it is
591 by yourself :)
594 exitscript
595 ----------
597 ~/G/L/W/exitscript will be called automatically when wmaker is exited.
600 New runtime options
601 -------------------
603 1. Miniaturization animation is now selectable by a runtime option
604 Add a line with
606 IconificationStyle = <style>;
608 to your WindowMaker configuration file.
609 <style> can be one of: Zoom, Twist, Flip or None
610 Case doesn't matter, and default is Zoom.
613 2. Edge resistance.
614 This can be controlled by setting:
616 EdgeResistance = xxx;
618 in your WindowMaker configuration file.
619 xxx is an integer greater than 0 and represents the number of pixels of edge
620 resistance. Setting it to 0 (default) will disable this feature.
622 New theme
623 ---------
625 A new theme named Night, is available in this distribution.
629 --- 0.19.3
631 GIF support was added. You will need libgif 2.2 to use it.
633 cpixmap added. Syntax is the same as tpixmap or spixmap
636 --- 0.19.2
638 getstyle will include IconBack info in Style files.
640 --- 0.19.0
642 libPropList was updated. If you have it installed, you must upgrade or
643 WPrefs will crash because of bugs in libPropList.
645 New options
646 -----------
648 Balloons!
649 ---------
651 WindowTitleBalloons = YES;
652 will enable balloons for window titles that are not fully visible.
654 MiniwindowTitleBalloons = YES;
655 will enable balloons for miniwindow titles.
657 AppIconBalloons = YES;
658 for application icons (docked or not)
661 IconPosition
662 ------------
664 IconPosition (the position of the icons) is specified as:
666 IconPosition = c1c2c3;
668 where:
670 c1 can be t or b (meaning top or bottom)
671 c2 can be l or r (meaning left or right)
672 c3 can be v or h (meaning vertical or horizontal)
674 case is insensitive.
676 For example, 
677 IconPosition = blh;
679 is the old iconPosition position.
681 IconPosition = trv;
683 will place the icons over the Dock.
685 New window attribute
686 --------------------
688 EmulateAppIcon = YES; will make the window have an application icon.
689 Only use this option for fully specified windows (like rxvt.Rxvt).
690 NEVER use in generic window specifications (like * or rxvt).
691 You must restart the application for the attribute to take effect.
694 WPrefs.app
695 ----------
697 Read WPrefs/README
700 --- 0.18.1
702 Boolean balues have changed!!! YES, Y and any non-zero integer will
703 mean TRUE and anything else (including True) will mean FALSE. This
704 is to conform to the OpenStep values used for booleans and
705 not cause headaches later, when GNUstep apps also starts using
706 defaults and users will try using True wich won't get recognized.
709 --- 0.18.0
711 Clip
712 ----
714 Clip button layout was changed. IT IS TEMPORARY AND THE DEFINITIVE LOOK
715 WILL BE DIFFERENT!!!
718 libPropList
719 -----------
721 More bugs were fixed in it. Upgrade the library if you have an older version
722 installed, with the one included.
725 Property list menus
726 -------------------
728 Format for property list menus has changed! The redundant array for
729 submenus was removed, so a menu that looked like:
731 ( Applications,
732   ("Xterm", EXEC, "xterm"),
733   ( 
734     (Paint,
735         ("Gimp", EXEC, "gimp"),
736         ("XV", EXEC, "xv")
737     )
738   )
741 must be changed to:
743 ( Applications,
744   ("Xterm", EXEC, "xterm"),
745   (Paint,
746         ("Gimp", EXEC, "gimp"),
747         ("XV", EXEC, "xv")
748   )
753 Misc
754 ----
756 NUMLOCK_HACK is back. This time it works and is enabled by default.
757 If you think you don't need it and promise me that you won't send 
758 "bug" reports saying that shortcuts stop working after a while, you can
759 disable it ;) It will save some memory and CPU.
762 Configuration
763 -------------
765 Removed the SwapMenuButton option and added 3 finer grained options:
767 SelectWindowsMouseButton
768 WindowListMouseButton
769 ApplicationMenuMouseButton
771 Values that can be used are Left, Middle, Right and Button1 through Button5
772 Left is equivalent to Button1, Middle to Button2 and Right to Button3
775 Removed the WorkspaceChangeDelay option and corresponding action.
776 Removed AClipColor and IClipColor
779 Added the SelectKey back
782 Changed default binding of Window commands menu from F10 to Control+Escape
784 --- 0.17.4
786 Misc
787 -----
789 libPropList has changed! Upgrade it before compiling wmaker.
791 Hopefully the bugs that caused wmaker to crash if an error is found
792 in the config files is fixed. If you do crash wmaker with a bad
793 file, please try to find out the smallest possible portion of the file
794 that still crashes wmaker and send it to me.
797 New Options
798 -----------
800 PixmapPath was split to PixmapPath and IconPath. PixmapPath is the path
801 for the pixmaps used as textures and IconPath is for the icons. 
802 Don't forget to add IconPath to your current configuration file.
804 There's also a new library in ~/GNUstep/Library/Icons. You should place
805 your icons there, since icons are not a WindowMaker specific resource.
808 DontConfirmKill=YES; will disable the confirmation panel for Kill
811 --- 0.17.3
813 Interface Changes
814 -----------------
816 Unhide Here in the appicon menu was changed to be the first entry.
817 This way you can unhide the appicon with a single click without
818 even moving the pointer.
821 Clip Commands
822 -------------
824 The collect icons commands was renamed to attract icons and
825 the attract icons options was renamed to Auto attract icons.
827 The Remove Selected Icons was renamed to Remove Icon(s). It will
828 act as before if some icon is selected and will remove the clicked
829 icon (without confirmation) if it is not.
831 Added a Keep Icon(s) command that will keep the selected icons if
832 any is selected and the current one if none.
834 The Move To command was renamed to Move Icon(s) To.
837 --- 0.17.0
839 If you have libPropList installed, you might want to reinstall it,
840 replacing with the included libPropList. It has a small bug fix.
842 Misc. Changes
843 -------------
845 Removed --with-gnome and made MWM_HINTS defined by default.
846 This means that "GNOME support" will work with no additional
847 flags passed to configure. 
849 Added support for KDE, by adding a DisableWorkspaceMouseActions option.
850 Set it to YES and run krootwm to be able to use everything in kfm.
853 Shortcuts for Root Menu
854 -----------------------
856 There is now a new SHORTCUT optional keyword for the menus.
857 For example, you can bind Control-F1 to xterm with:
859 "XTerm" SHORTCUT Control+F1 EXEC xterm
861 or F2 to ARRANGE_ICONS with:
863 "Arrange Icons" SHORTCUT F2 ARRANGE_ICONS
866 All commands allowed in the menu file accept the keyword, except for
867 MENU and OPEN_MENU
870 Interface Changes
871 -----------------
873 ** Configuration of docked applications is now done in a panel instead of
874 in the menu. 
876 ** Added a command menu for application icons
878 ** Shift double-click on the application icon will unhide the app
879 in the current workspace.
882 Option Changes
883 --------------
885 NotMiniaturizable option changed to NoMiniaturizeButton
886 NotClosable option changed to NoCloseButton
889 Speed options values are now UltraFast, Fast, Medium, Slow or UltraSlow
890                                               ^^^^^^
892 Removed the Select keyboard binding. You can access it in the window
893 commands menu.
895 Removed the ClipMaxIcons option and made it a compile time option.
897 Removed the ConstrainWindowSize option
899 Renamed NoSound to DisableSound
901 Renamed NoAutowrap to DontLinkWorkspaces
903 Renamed NoDithering to DisableDithering
905 Renamed NoAnimations to DisableAnimations
907 Removed the LeftHanded option and added a SwapMenuButton option.
908 SwapMenuButton will make the rubberband selection in the root window
909 be bound to the right button and the root menu to the left button.
912 New way to display temporary icons
913 ----------------------------------
915 The icons that are attracted by Clip, but will not be kept after the
916 application close, are now using a different color for shading, unlike previous
917 version that always used white. This will improve look for very different color
918 combinations, and allow the user to control the look of the shaded icon.
919 The color used for shading the icons is computed as follows:
921 First a color is computed depending on the IconBack type:
922  - for solid the color is the solid color itself.
923  - for simple gradients the color is (from_color + to_color)/2.
924  - for multiple gradients, the color is the first color in list.
925  - for pixmaps, the color is the solid color specified for that pixmap.
927 Then the color is made lighter by multiplying each red/green/blue filed with
928 1.7 and limiting each field to 0xff in case they exceed this value.
929 Then this new color will be used by superposing it with the icon we want to
930 shade, using a proper alpha value.
932 To control the color for shading is simple:
934 - In case of multi gradients you just need to put the first color, as the color
935 you like. WindowMaker do not use the first color in the list to directly build
936 the gradient, but only when it needs a solid color for something (like in this
937 case).
939 - For pixmaps, put the needed color as the solid color the syntax for pixmaps
940 require. This color is also not used when displaying normal icons, just when
941 solid colors are needed (like this case).
943 - For solid color, or simple gradients, in case the color it uses after
944 computing is not good enough, you can always convert the solid or simple
945 gradient to a multi gradient with the same look, and use that one. In this
946 case is simple, just put the needed color as first color in list.
948 Please note that this will not slow down WindowMaker, because the IconBack is
949 read only once at startup, and then only if it is changed. After reading it WM
950 will construct the image of the tile, and use the image instead of recomputing
951 the gradient every time.
953 Here are 2 examples of converting solid or simple gradient to a same looking
954 multi gradient:
956 IconBack = (solid, Blue);
957 will become
958 IconBack = (mhgradient , LightBlue, Blue, Blue);
959 using LightBlue as color for shading.
961 IconBack = (dgradient, "#284569", "#082420");
962 will become
963 IconBack = (mdgradient, "#183454", "#284569", "#082420");
964 looking the same, but using #183454 for shading.
967 New Sound Server Location
968 -------------------------
970 The sound server new URL is http://www.frontiernet.net/~southgat/wmsound
971 Also it seems to be running on FreeBSD too (with little changes maybe).
974 --- 0.16.1
976 WINGs
977 -----
979 The path for the WINGs resource files was changed. If you don't
980 do make install, you must move /usr/local/share/WindowMaker/Resources to
981 /usr/local/share/WINGs
984 New Options
985 -----------
987 The following new options are available:
988 NewStyle = Yes/No; (static) Replaces --enable-newstyle
989 DisableDock = Yes/No; (static) Same as -nodock command line option.
990 DisableClip = Yes/No; (static) Same as -noclip.
991 Superfluous = Yes/No; (dynamic) Replaces --enable-superfluous.
993 NOTES.
994 - The static options are only read at startup. Changing them, needs to restart,
995   so they will be accounted.
996 - DisableDock and DisableClip have lower precedence than -nodock -noclip
997   command line options. If both option/command line option are given, then the
998   command line option will be accounted.
1001 Start Hidden option
1002 -------------------
1004 The start hidden option was fixed, and made to be an application wide option.
1005 It will apply to every window the application owns. Also its place in the
1006 Attribute Inspector panel, changed accordingly, to reflect this.
1007 The start miniaturized is however still applying to particular windows of an
1008 application, unless the option is set for the class.
1009 Start miniaturized, will override start hidden if both set.
1011 IMPORTANT NOTE.
1012 Because of the way Netscape Communicator is implemented, it is NOT possible
1013 to set the start hidden or miniatirized flags for it. This is because Netscape
1014 chooses to send a second map event to the window it maps. This makes the
1015 window to receive a second map request and to be unhidden or maximized back,
1016 immediately after it was hidden or miniaturized by WindowMaker at startup.
1020 --- 0.16.0
1022 Misc. Changes
1023 -------------
1025 The NextMenuBehaviour option was renamed to WrapMenus
1026 The WorkspaceTiedMiniwindows option was renamed to StickyIcons
1028 The .tif files were renamed to .tiff
1031 Selecting Mini Windows
1032 ----------------------
1034 Now miniaturized windows can be selected as well as normal windows.
1035 You can do this by Shift-Click-ing them. They will be marked, and will follow
1036 you through workspaces like normal selected windows do.
1037 Miniaturizing a window will no longer deselect the window, but will place the
1038 icon and mark it as selected.
1039 The only difference between miniaturized and normal window selection is that
1040 for the moment the rubber-band selecting method works only for normal windows.
1043 Icon Selection Panel in Attributes Editor
1044 -----------------------------------------
1046 Now, selecting icons is as easy as clicking in the file name in a list.
1049 Simplified Options
1050 ------------------
1052 IconSlideStep, IconSlideSlowDown and IconSlideDelay were merged to 
1053 IconSlideSpeed
1055 MenuScrollStep and MenuScrollDelay were merged to MenuScrollSpeed
1057 ShadeStep and ShadeDelay were merged to ShadeSpeed
1060 Valid values for them are: Fast, Normal, Slow or UltraSlow
1062 If you want to fine tune the values, they can be changed in wconfig.h
1063 Send me your set of values with an indication of how fast is your hardware,
1064 so that I can make the default values more adequate.
1067 New Window Attributes
1068 ---------------------
1070 Added StartMiniaturized and StartHidden as window attributes and
1071 removed the previous implementation. Also removed the dock menu entries.
1072 They are now settable in the Attributes Panel.
1074 Also added DontSaveSession attribute. This way, you won't end up with multiple
1075 unwanted copies of the same app after the previous session is restored.
1076 I start X with a xterm in .xinitrc instead of wmaker, wich will cause the
1077 xterm restored by wmaker be duplicate. Just add -name something to the
1078 xterm started form .xinitrc and mark DontSaveSession=YES for that window.
1082 User Specifiable Visual IDs
1083 ---------------------------
1085 wmaker now supports different visuals than the default one. It isn't of much
1086 use for most people, but can be usefull for lucky SGI users who want it
1087 to use TrueColor instead of the default PseudoColor.
1089 wmaker -visualid VISUAL_ID
1091 where VISUAL_ID is the hex code for the visual you want.
1093 Note: I don't have an SGI box and haven't tested it...
1097 Starting Workspace
1098 ------------------
1100 The starting workspace is identified in the following order:
1101 1. If the app is omnipresent will be mapped on the current workspace.
1102 2. Else if the application have a StartWorkspace option set as attribute
1103    then this one will be used.
1104 3. Else, if the application was started from Clip, the workspace on which
1105    the Clip from where it was started is used.
1106 4. Else the current workspace is used.
1108 Restoring saved sessions will always use the saved workspace, no matter
1109 what other options are, except onmipresent.
1113 --- 0.15.1
1115 Workspace specific mini windows
1116 -------------------------------
1118 The minimized windows can be workspace specific, being more consistent with
1119 the rest. This is because minimized window represents just another state of a
1120 window (like normal or shaded), which all are workspace specific.
1121 This (or the old "present anywhere") behavior can be set using an option in
1122 the WindowMaker database: WorkspaceTiedMiniWindows = Yes/No;
1124 New way to animate the blowing icons
1125 ------------------------------------
1127 There is now a compile time option that allows one to set how the icons are
1128 animated when detaching from dock/clip in superfluous mode.
1129 By default the classic "Falling pieces" animation is used.
1130 If SPREAD_ICON is #define-ed in wconfig.h, then a "Spread in four directions"
1131 animation is used instead. Take a look at the section where this is described
1132 in src/wconfig.h
1133 By default there is #undef SPREAD_ICON to select "Falling pieces" animation.
1135 Auto Colapse for Clip
1136 ---------------------
1138 The clip now supports an option named "Auto Collapse" which can be set from
1139 the clip main menu. When set, clip will stay collapsed, and will show itself
1140 when the mouse moves over it. While the mouse is over it, or over any of the
1141 icons attached to the clip, the clip will stay uncollapsed, letting you to
1142 access the attached icons. This is not true for applications like asclock, or
1143 applets of that kind, because the icon window do not belongs to WindowMaker,
1144 but to the application itself. For such icons you must keep the mouse over the
1145 icon groundplate, else it will collapse back. But usually these type of icons
1146 will not stay in a collapsed clip, since one needs to see what they show.
1147 When the clip is leaved it will collapse back after a delay of 1 second, unless
1148 the mouse is moved back to the clip area. The delay can be set modifying
1149 AUTO_COLLAPSE_DELAY in wconfig.h. Default is 1000 (ms) which means 1 second.
1154 --- 0.15.0
1156 Changed name from Fiend to Clip
1157 -----------------------------------
1159 All occurrences of word Fiend with or without capital F were replaced with
1160 the corresponding Clip (same capital).
1161 This affects all configuration files under ~/GNUstep that contain this word.
1162 It can be refered as "Workspace Dock" too.
1165 New option in Clip menu, and extended Clip behavior
1166 ---------------------------------------------------
1168 The following new items are available in the dock menu:
1170 1. Attract Icons
1171 2. Keep Attracted Icons
1172 3. Collect Icons
1173 4. (Un)select All Icons
1174 5. Remove Selected Icons
1175 6. Move To
1176 7. Start miniaturized    (also available for regular dock)
1177 8. Start hidden          (also available for regular dock)
1178 9. Selected
1179 10. Set icon...          (also available for regular dock)
1182 Here is what they do:
1184 1. "Attract Icons" will let the Clip to attract and attach any new appicon that
1185    is created when an application starts. It will not do this if the Clip is
1186    full. If the Clip is Collapsed then the appicon will be hidden after it is
1187    attached.
1188 2. "Keep Attracted Icons" will tell the Clip to keep the attracted appicons,
1189    after the application is closed. Without this the appicons will vanish,
1190    leaving the Clip in the original state. If you move an appicon that was
1191    attracted from Clip to regular Dock, it will be kept when closed, no matter
1192    what "Keep Attracted Icons" is set to in Clip.
1193 3. "Collect Icons" will collect all appicons that are not yet attached to Dock
1194    or Clip, and attach them to the current workspace Clip. The value of
1195    "Keep Attracted Icons" will apply when applications close. If Clip is
1196    collapsed, the appicons will be hidden.
1197 4. "(Un)select All Icons" will select all icons in the clip if none is
1198    selected, or it will deselect all selected ones. The selected icons are
1199    marked using a small triangle in the bottom right corner of the appicon.
1200    The color of the mark is set using SClipColor in WindowMaker domain
1201    database.
1202 5. "Remove Selected Icons" will remove from Clip all selected icons. The ones
1203    that still run, will be detached, all the others will vanish.
1204 6. "Move To" will transfer all selected icons to another workspace and attach
1205    them to the Clip in that workspace. If none is selected, only the one the
1206    mouse was pressed on will be moved.
1207 7. "Start miniaturized" will launch (or autolaunch if set) the application in
1208    a miniaturized state.
1209 8. "Start hidden" will launch (or autolaunch if set) the application in a
1210    hidden state. Note that only one of the two can be set at a time.
1211 9. "Selected" can be used to toggle the selected state of the appicon
1212    individually. The same can be achieved using Shift-LeftClick on the appicon.
1213    In fact the intended way of toggling the selected state is by using
1214    the Shift-LeftClick on icon. The menu entry is just another way to do the
1215    same.
1216 10. "Set icon..." will allow one to set the image for the appicon. The image
1217    will be updated without restart, and also all appicons in the same
1218    instance.class as the one we set for, will be updated.
1220 So a simple way of avoiding the screen to be filled up with appicons is to set
1221 the "Attract Icons" in the Clip. Also the "Keep Attracted Icons" can be set to
1222 No, so the attracted icons will be deleted when application exits, thus leaving
1223 the Clip clean. If also one to not want to see the appicons that keep filling
1224 the Clip, he can set the Clip to be Collapsed.
1226 Getting rid of unneeded icons in Clip is as simple as selecting them
1227 individually using Shift-LeftClick, and then using the "Remove selected Icons"
1228 entry in menu.
1231 Support for different visuals.
1232 ------------------------------
1234 WindowMaker is now able to support any visual, except DirectColor, in any
1235 depth from 1bpp to 32bpp.
1237 One can start the X server with different visuals, by passing the X server the
1238 right option. For XFree 3.3.x is -cc <id>.
1239 WindowMaker is not yet able to choose a different visual from the Default one
1240 on a given screen, but can use any default visual it finds, except the direct
1241 color visual.
1242 For example starting X like (for XFree 3.3.x, and if the driver for the
1243 card supports this. Read the man page for your X server):
1244 startx -- -bpp 8 -cc 0 will give you the StaticGray visual.
1245 startx -- -bpp 8 -cc 1 will give the GrayScale visual
1246 and so on.
1248 Wrlib code is now generic, and will support any visual except DirectColor in
1249 any depth. Programs written with wrlib can work on different visuals from
1250 the default visual for a given screen.
1251 Behavior in different visuals can be tested using the testgrad program in
1252 wrlib subdirectory in distribution.
1253 testgrad -h will show the usage.
1255 Multidiagonal gradients are also implemented now in wrlib, and a new algorithm
1256 is used to speed up the generation of diagonal gradients.
1259 New arrangement of the directory structure under ~/GNUstep/
1260 ---------------------------------------------------------------
1262 To better adapt to theme support the directory structure changed under
1263 ~/GNUstep/Library/WindowMaker
1265 1. Style directory moved to Styles.
1266 2. Added the following directories: Backgrounds, IconSets, Pixmaps, Sounds and
1267    Themes.
1268 3. The .style files no longer get copied in the user's Styles directory.
1269    Instead they are read from the global /usr/local/share/WindowMaker/Styles
1270    directory.
1272 Under ~/GNUstep/Defaults the following changes occurred:
1274 1. A default WMState is installed by wmaker.inst.
1275    It contains the dockit program assigned to the top icon of the dock, and
1276    the wmsetbg program assigned for the drop command on both dock's and clip's
1277    main icon.
1278    Double clicking the dock's main icon will bring up dockit that will let you
1279    dock any application that do not have an application icon.
1280    Dropping an image on dock's or clip's main icon, from an Offix DND aware
1281    application, will put the image on the background tiled, and will update
1282    WindowMaker domain database file.
1283 2. Syntax of WMState changed a little. The old position will not be restored
1284    when you will first start the new version, but after that it will be
1285    normally remembered. This is because now the main clip icons is only saved
1286    once, not for every workspace.
1287    You should replace Fiend with Clip in any place where it appears, if you
1288    want to keep the old WMState file, else it will not work.
1289 3. At compile time, it will detect if you have support for tif, and will
1290    install a WMWindowAttributes with corresponding image name extension
1291    (.tif or .xpm). This is true only for pixmaps that come with the source
1292    distribution and get installed under /usr/local/share/WindowMaker/Pixmaps
1294 The menu file changed a lot. Old menu file will *not* work with new theme
1295 support, so please upgrade.
1298 New behavior of OPEN_MENU command
1299 ---------------------------------
1301 The OPEN_MENU command now supports the following syntax:
1302 1. File menu handling.
1303    // opens file.menu which must contain a valid menu file and inserts
1304    // it in current position
1305    OPEN_MENU file.menu
1306 2. Pipe menu handling.
1307    // opens command and uses it's stdout to construct menu.
1308    // Command's output must be a valid menu description.
1309    OPEN_MENU | command
1310 3. Directory handling.
1311    // Opens one or more directories and construct a menu with all
1312    // the subdirectories and executable files in them sorted alphabetically.
1313    OPEN_MENU /some/dir [/some/other/dir ...]
1314 4. Directory handling with command.
1315    // Opens one or more directories and construct menu with all
1316    // subdirectories and readable files in them sorted alphabetically,
1317    // preceding each of them with command.
1318    // WITH is a required keyword!!!
1319    OPEN_MENU /some/dir [/some/other/dir ...] WITH command -options
1321 Please note that because of the 'WITH' keyword old menu files no longer work
1322 for the OPEN_MENU with a command.
1325 Theme support
1326 -------------
1328 Theme support is now as easy as untar-ing a tarball in the right place.
1329 Because of the way OPEN_MENU works, they can be installed on a global
1330 shareable basis, or for personal user use.
1331 Themes installed under ~/GNUstep will be available only for a user, but
1332 if if they are installed under /usr/local/share/WindowMaker they will be seen
1333 by all users. This is also true for style files, background images, pixmaps,
1334 etc that get installed under /usr/local/share/WindowMaker.
1335 Themes can be saved or loaded using the Appereance menu.
1337 Also support for different IconSets is available. You can save or load a new
1338 IconSet using the Appereance menu.
1340 Setting background images is now as simple as putting the images in the right
1341 place (~/GNUstep/Library/WindowMaker/Backgrounds or
1342 /usr/local/share/WindowMaker/Backgrounds, or any other place in your
1343 PixmapPath). Then use the Appereance menu. They will be instantly available
1344 since they are opened by a OPEN_MENU command. Also the image do not need to
1345 have a .jpg or any other extension. It will be recognized anyhow.
1346 As an example please see the OpenStep theme supplied with WindowMaker.
1347 The OpenStep image is a jpeg file without extension.
1349 Please keep in mind that anything under /usr/local/share/WindowMaker will be
1350 available for all users.
1353 New options for wmsetbg and getstyle
1354 ------------------------------------
1356 wmsetbg now accepts the following options:
1357 usage: wmsetbg [-options] image
1358 options:
1359  -d             dither image
1360  -m             match  colors
1361  -t             tile   image
1362  -s             scale  image (default)
1363  -u             update WindowMaker domain database
1364  -D <domain>    update <domain> database
1365  -c <cpc>       colors per channel to use
1367 By default, it will try to guess if dithering is needed or not and proceed
1368 accordingly.
1369 Using -d or -m will force it to dither or match colors.
1371 Dithering for more than 15bpp is generally not needed, and will only result
1372 in a slower processing.
1373 Don't use dithering except when needed, because it is slower. Else rely on
1374 wmsetbg which will detect if dithering is needed and use it.
1376 -u will update the WorkspaceBack in the default database domain file in
1377    ~/GNUstep/Defaults/WindowMaker, and let WindowMaker refresh the screen.
1378    Please note that this option only works under WindowMaker, and will have no
1379    effect under other window managers, since it rely on WindowMaker to update
1380    the image after it reads the updated defaults database.
1382 -D <domain> is same as above, but will update the domain <domain> instead of
1383    the default WindowMaker domain.
1385 -c <cpc> will set the color per channel to use. Only needed for PseudoColor
1386    visuals. WindowMaker will automatically pass the value read from the
1387    WindowMaker domain database.
1390 getstyle now have the -t option, that instructs it to read all options
1391 related to theme. Without -t getstyle will read only style options that
1392 means it will not read WorkspaceBack and IconBack.
1393 Use -t when you want to make a theme and need all theme options to be saved.
1394 Else it will extract just a style file.
1397 Session management support
1398 --------------------------
1400 Two new commands are available for use in menus:
1402 SAVE_SESSION and CLEAR_SESSION.
1404 SAVE_SESSION:
1405 will take a snapshot of all running applications, and their current hints
1406 (shaded, hidden, minimized, geometry and workspace they are on),
1407 and save it inside the WMState file. Also the current workspace we are on is
1408 saved. The applications that are running and were started from dock or clip are
1409 marked, so they will be attached to the corresponding dock/clip when restored.
1410 This state is restored every next session, until a new one is saved or
1411 CLEAR_SESSION is used.
1413 CLEAR_SESSION:
1414 will clear any previous saved session.
1416 There is also a run time option named SaveSessionOnExit = Yes/No; that allows
1417 one to automatically save the state of desktop when leaving WindowMaker.
1418 This way next session, the state of the desktop before last exit is restored.
1420 Please note that if this option is set to Yes, than any manual saving of the
1421 state, or any clearing of the state will be overridden when exiting
1422 WindowMaker.
1424 These options are available under the "Workspace" menu.
1427 User WindowMaker configuration files are now merged with global ones
1428 --------------------------------------------------------------------
1430 When starts WindowMaker will look for database domain files under
1431 $GNUSTEP_USER_ROOT/Defaults or ~/GNUstep/Deafults to be read. (In this order).
1433 If they are not available then it will scan for them in
1434 $GNUSTEP_LOCAL_ROOT/Defaults, $GNUSTEP_SYSTEM_ROOT/Defaults or
1435 /usr/local/GNUstep/Defaults (in this order).
1437 Even if the file was found or not, it will always load the corresponding domain
1438 file under /usr/local/share/WindowMaker/Defaults.
1440 Then if the user file was found it will merge it over the global file, else
1441 the global file will be used.
1443 This way any settings that are set by the system administrator in the shared
1444 file will be available for users that do not have them in their config files.
1445 Any option the user have in his config file will override the one in the
1446 shared domain file.
1448 So any new runtime options that appear in WindowMaker domain, do not need to
1449 be set in all user files, except the ones the user wants a different behavior
1450 from the default set for all users in the shared file.
1452 Also it is possible for the user to not have any personal domain databases, and
1453 the global shared ones will be used, but it still needs to have the directory
1454 structure, so WMState gets written on session exit.
1455 So all it needs to have is ~/GNUstep/Defaults directory available.
1458 New behavior of the Slide Icons
1459 -------------------------------
1461 Animation constants are now runtime.
1462 They are:
1463 IconSlideDelay = 0;
1464 IconSlideStep = 5;
1465 IconSlideSlowDown = 50;
1467 To better adapt both slow and fast machines the behavior of sliding icons
1468 changed in the following manner:
1470 Old one was to keep moving the icon with a constant step (default 5 pixels)
1471 until it reached the destination.
1473 Now it will use a new parameter named IconSlideSlowDown to speed up or slow
1474 down the moving.
1476 Instead of moving it with a constant step it will use IconSlideSlowDown to
1477 divide the distance to the destination, and use this value as the first step.
1478 Then is will compute the remaining distance and will again use
1479 IconSlideSlowDown to divide it and get the new step. And so on.
1480 When the step to move becomes smaller than IconSlideStep, IconSlideStep will
1481 be used further until the destination is reached.
1483 This way a nice deceleration effect is achieved, since while the icon
1484 approaches destination, it will use smaller steps, gibing the illusion that
1485 the icons is moving slower.
1487 IconSlideDelay will give the pause between steps, and is expressed in ms.
1489 Giving large values to IconSlideSlowDown (>1024 for 1024x768 screen) will
1490 result in the old "constant step advance" behavior, since the computed step
1491 will always be smaller than IconSlideStep, and the last will be used instead.
1493 Making IconSlideSlowDown = 0 or 1, will result in an instant jump to the
1494 destination without any animation.
1497 Attribute editor
1498 ----------------
1500 Because the icon images on screen automatically update after any change in
1501 WMWindowAttributes domain file, the use of both Save and Apply buttons is no
1502 longer needed. If one wants to just apply the setting to the current window
1503 only, he will only use the Apply button.
1504 If he wants them saved for all applications in the same instance and/or class
1505 the using the Save button will write them to disk, and automatically
1506 WindowMaker will update all the icons that need to be updated on screen.
1509 Sound support
1510 -------------
1512 Some basic sound support is now part of WindowMaker. The sound server is not
1513 yet part of WindowMaker distribution, so you need to download it separately.
1514 This is because is linux specific, and need some changes before it can be
1515 included.
1516 Until them if you have a linux system and want to use sound, use the
1517 wmsound-0.5 available at http://www.geocities.com/SiliconValley/Bay/7874
1518 Download that package, and only build the sound server there.
1519 DO NO APPLY ANY PATCHES FROM THERE!, because they are already applied.
1520 Just build the sound and copy the executable in /usr/local/bin
1521 Follow the rest of the install steps described there, except the patch-ing
1522 procedure.
1524 To enable sound for WindowMaker pass --enable-sound to configure.
1526 Also use NoSound = Yes/No; to enable/disable sound at runtime without killing
1527 the sound server.
1529 If you cannot set the sound to work yet, then is not for you.
1530 Wait until the sound server will be fixed and will be part of WindowMaker.
1533 New entries in WindowMaker domain database
1534 ------------------------------------------
1536 The following entries have been added to the runtime options:
1538   SaveSessionOnExit = No;
1540 will autosave (or not) the session state on exit.
1542   WindowPlaceOrigin = "64, 64";
1544 will offset all windows in auto or cascade placement mode with the value
1545 (in pixels) before placing them on screen. First is horizontal direction and
1546 second is vertical.
1547 This do not apply to windows that request a specific position on screen.
1548 This is useful if you want your Clip on the top left corner to not be
1549 overlapped by mapping windows.
1550 It will let it to have a row and a column of docked appicons near the screen
1551 edge, that will not be overlapped by windows.
1552 If you set it to "128, 128" it will have 2 rows and 2 columns not overlapped.
1555   NoSound = No;
1557 Enable/disable sound at runtime without the need of killing the sound server.
1560   MenuScrollDelay = 10;
1561   MenuScrollStep = 5;
1563 Constants for the menu scrolling animation.
1565   IconSlideDelay = 0;
1566   IconSlideStep = 5;
1567   IconSlideSlowDown = 50;
1569 Constants for the icons sliding on screen. Explained above.
1571   ShadeDelay = 0;
1572   ShadeSteps = 15;
1574 Animation parameters for shading a window. How many steps it will take, and the
1575 delay between steps in ms.
1577   DoubleClickTime = 250;
1579 The time for the double click to be considered so. Expressed in ms.
1581   SClipColor = "#6f8ae2";
1583 Color for selected icons in Clip.
1585 All delays are expressed in ms.
1589 --- 0.14.1
1592 *** Enhanced fiend clone.
1594 Here are the new fiend features:
1595 1. Keys for raising/lowering the fiend, and their default values:
1596    FiendLowerKey = None;
1597    FiendRaiseKey = None;
1598    FiendRaiseLowerKey = None;
1600    All reside in WindowMaker configuration file.
1602 2. Added posibility to launch the workspace menu with button1 click on the
1603    idle indicator of fiend, or with button3 click on workspace name on the
1604    fiend.
1606 3. Added Control-button1-click on fiend's idle indicator, to create a new
1607    workspace and move to it. Same action as New item in Workspace menu.
1609 4. Fiend's idle indicator do have a color that reflects its normal/collapsed
1610    state.
1612 5. The delay between changing workspaces from fiend is now a runtime option:
1614    WorkspaceChangeDelay = 700;
1616    in WindowMaker configuration file.
1618 6. Application icons can be moved between dock and fiend now.
1620 7. The way workspaces are changed is controlled now by two runtime options:
1622    AdvanceToNewWorkspace=Yes/No;
1623    CycleWorkspaces=Yes/No;
1625    Both apply to either fiend navigating buttons or to next/prev worksapace
1626    keybindings. Both default to No, and are in WindowMaker configuration file.
1628 8. Also added posibility to advance to new workspace, no matter what value
1629    AdvanceToNewWorkspace have, with Control-button1-click on "next workspace"
1630    fiend button.
1633 *** Theme support ***
1635 Spixmap and tpixmap now work. Their syntax is:
1637 SomeStyleOption = (spixmap, file, color);
1638 SomeStyleOption = (tpixmap, file, color);
1640 - spixmap means scaled pixmap, so the image in the file will be scaled to
1641 adapt to the destination's size.
1642 - tpixmap means tiled pixmap, and the image from file will be tiled in the
1643 destination.
1645 file is searched in the PixmapPath, but can be a full path name.
1647 Color is used depending on which Style option is applied.
1648 For example in case of titlebars, color is used for miniwindows titles color.
1649 You are not restricted in selecting that color, but is better to put one
1650 that matches the overall color of the image.
1652 Currently they apply to all the options that accept (solid, color), or any
1653 type of gradient.
1654 This means they also apply to WorkspaceBack and IconBack, which allows theme
1655 support with the simple use of the setstyle and getstyle utilities.
1656 There is no need for an extra theme manager, just to include the needed
1657 options in the style files.
1659 In case of WorkspaceBack, color is used to be set in the background until
1660 the image gets loaded and displayed. This is to avoid the stippled screen
1661 the X server shows, in case the image is big and loads slow.
1662 There is a small utility in the util directory, named wmsetbg which is
1663 used to set the background image. This is needed for windowmaker not to
1664 freeze while loading and scaling the image.
1665 Currently it is hardcoded in windowmaker to use wmsetbg to set the background
1666 image, and is better to use it since is smaller that other image manipulation
1667 programs, and it is compiled with support for same image types as windowmaker.
1668 Since it comes and is installed with WindowMaker, there will be no need to
1669 download and use an external app, which also may not have support for the same
1670 image types as windowmaker.
1674 --- 0.14.0
1676 *** Fiend clone.
1678 The fiend clone is a dock extender, that lets you dock more than the default
1679 10-12 icons in the dock. It actually lets you dock how many icons you like,
1680 with a current default of 25 per workspace. The fiend have different docked
1681 icons on every workspace. Also the fiend main icon shows you the workspace
1682 you're on and lets you navigate through the workspaces with the small green
1683 buttons on the low right corner.
1684 To save screen space the fiend can be collapsed to the main icon either
1685 from the fiend menu (available with right click on the fiend icons), or
1686 with a double left click on the main fiend icon, which is a toggle for
1687 the collapsed/uncollapsed state.
1688 Collapsed state is marked by a different title color.
1689 Pressing on the small buttons on the low right corner, the workspaces are
1690 changed in increments of 1 to the left or right, but keeping the button
1691 pressed over them will continuously advance through workspaces until the
1692 mouse is moved away from the buttons or the button is released.
1693 The delay between workspace changes is set by FIEND_WKS_CHANGE_DELAY in
1694 src/wconfig.h, and defaults to 700 ms.
1695 Unlike the dock, fiend can hold icons in any directions, and can be placed
1696 in any position on screen.
1698 When an icons is to be docked, but the position can be either in the dock
1699 or in the fiend, the dock will be used first, and the icon will be docked
1700 there.
1702 Here are the new runtime options introduced by the fiend:
1703 Files are located in ~/GNUstep/Defaults/
1705 In WMWindowAttributes:
1706        "Logo.WMFiend" = {Icon = "Cone.xpm";};  - icon for the fiend
1708 In Windowmaker:
1709         FiendMaxIcons = 25;           - the max number of icons in fiend per
1710                                         workspace
1711         FiendTitleFont = "-*-helvetica-bold-r-normal-*-10-*-*-*-*-*-*-*";
1712                                       - the font used to show the current
1713                                         workspace
1714         FiendTitleColor = black;      - color for the uncollapsed fiend title
1715         CFiendTitleColor = "#616161"; - color for the collapsed fiend title
1716         AFiendColor = "#00ba70";      - color for the workspace changing
1717                                         buttons, when active
1718         IFiendColor = "#008000";      - color for the workspace changing
1719                                         buttons, when idle
1721 For the ones who don't want to use fiend, there is a option to wmaker named
1722 -nofiend that can be feed to the command line when starting wmaker.
1723 (This is the equivalent for -nodock, but removes fiend clone).
1725 The syntax of WMState file have changed, but you don't have to worry because
1726 WindowMaker will know to read the old format and will save it and further
1727 will use the new one. You do not need to change your file, for the new version
1728 to work.
1731 --- 0.13.1
1733 *** Enhanced Attribute editor.
1735 Now you can save defaults for all windows.
1736 Please note that only Icon, KeepInsideScree, and sometimes NoAppIcon
1737 can be useful in a normal environment. But others may have other opinion ;)
1738 If you set AlwaysUserIcon default for all windows, note that apps like
1739 asclock, wmload, wmmail, wmrack, will show that icon instead of their
1740 window.
1742 Now Attribute editor also counts for defaults saved for all windows,
1743 (not only the default "No" for all options hardcoded in WindowMaker),
1744 when saving options for some instance.class specification. This is to
1745 save disk space by saving only the options that differs from global defaults
1746 (either defaults for all windows or the hardcoded valued in WindowMaker).
1748 Attribute Editor now updates on the fly the appicon image or creates/deletes
1749 the appicon if you set that options in the Inspector panel and Apply them.
1750 Modifying Icon file, NoAppIcon or AlwaysUserIcon and Applying them will
1751 result in the image update for the app-icon.
1753 Note that if you apply but not save these options, the miniwindow image will
1754 not be updated. This is because app-icon is always on screen so it can be
1755 updated, but miniwindow image is read from the defaults database and from disk
1756 every time you minimize the window and is destroyed when you restore.
1759 --- 0.13.0
1761 *** Atribute editor is working ;).
1763 How it works is quite obvious.
1764 Anyway, here is a short description.
1766 Save   - only save the configuration in defaults database and updates
1767          WMWindowAttributes
1768 Apply  - only applies the values to the current window
1769 Revert - reverts the values from the defaults database
1771 Note that Save and Revert count for the window specification
1772 (instance & class), that are selected, and save/use the values for/from
1773 that.
1775  The Update button will show the icon who's name was typed in the textfield
1776 If the textfield is empty, will try to use the default icon.
1777 Also saving with and empty textfield for icon, uses the default icon.
1779  The Default button will use the icon in the textfield as default icon
1780 and save that value in WMWindowAttributes (Note that in this case is no
1781 need to press the Save button!). Also if the textfield is empty it will
1782 try to use the old default icon, if available.
1784 *** Now menus are saved between sessions, or over a restart.
1786  Just stick them to the desktop, and you will find them over sessions
1787 until you close them.
1788  Please note that only the root_menu, the window switch_menu and the
1789 workspaces_menu can be saved this way.
1791 *** Changed the lousy Windoze menu behaviour.
1793 This applies to 'NextMenuBehaviour = NO;'
1795  Now the items are no more automatically selected if you launch the menu
1796 and the mouse is over some item, if you use a short click to launch the
1797 menu (shorter than the default DBL click time).
1798  If you use a longer click or keep the mouse pressed, the item under mouse
1799 will be selected after that delay, and launched when you will release the
1800 mouse button.
1801  If the click was short, a second one is needed to launch the item.
1803 *** Autoarrange icons is now a runtime option
1806 AutoArrangeIcons = YES/NO;
1807 in 'WindowMaker'.
1809 *** Added configurable horizontal resize threshold
1812   HorizontalResizeThreshold = <n>;
1814 This will make the n pixels at the exterior side of the corner handle
1815 of the resize bar to restrict to horizontal only resize.
1816 Also you can use Shift-click&drag anywhere on the corner handle to
1817 restrict the resize only to horizontal.
1818 Note that the Shift-click&drag does not depend of the configured threshold
1819 and works completely independent.
1821 *** New option for OPEN_MENU (pipe from command)
1823 OPEN_MENU | /foo/bar/script
1825 will make a menu that is dinamically constructed by /foo/bar/script
1828 --- 0.12.0
1830 *** New option for OPEN_MENU
1832 OPEN_MENU /foo/bar/pics xv -root -quit
1834 will make a menu with all files in /foo/bar/pics and precede them
1835 with EXEC xv -root -quit
1837 thus, making a menu with entries like:
1840 "marble.gif" EXEC xv -root -quit marble.gif
1841 "water.jpg" EXEC xv -root -quit water.jpg
1845 *** Multicolor gradients
1847 (mhgradient, colorX, color1, color2, color3, ..., colorn)
1848 (mvgradient, colorX, color1, color2, color3, ..., colorn)
1850 You can put any number of colors >= 2. 
1852 colorX is a special color that is used as the solid color of the
1853 texture when wmaker needs a solid color (like in miniwindow title and
1854 resizebar)
1856 *** PixmapPath format changed
1858 What used to be
1860 PixmapPath = "/usr/local/share/pixmaps:~/foobar";
1862 must now be
1864 PixmapPath = ("/usr/local/share/pixmaps", "~/foobar");
1867 *** Added OffiX DND in dock
1869 Use the "Set drop arguments..." command in the menu and put a %d
1870 where the dropped object string should be substituted, like:
1872 xedit %d
1874 *** Escape thingies for menu and dock commands:
1876 %w - substitute with current selected X window ID
1877 %s - substitute with current selection
1878 %d - substitute with last dropped object
1879 %a(some text) - opens a input box with "some text" as a title. Then,
1880 the text typed will be substituted there
1882 \r, \n - substitute with corresponding characters
1885 *** The WMState file format has changed a little.
1886 The Command field for the dock application list is now a normal string,
1887 instead of a list. So, remove the parentheses and the commas for the command
1888 and join all the parts. Example:
1890 if it used to be
1892 Command = ( xterm," -geometry", "+10+10" );
1894 then make it
1896 Command = "xterm -geometry +10+10";
1899 --- 0.10.2
1901 AutoFocus = NO; disables automatic focusing of windows
1902 when they are first mapped
1905 --- 0.10.1
1907 titlebar gradients are in a single piece now
1909 the WMDock file was merged into the WMState file. You can insert this
1910 file in WMState and set it's key to Dock. For example, if your WMDock
1911 contains:
1914         Applications = { {Command = (); }};
1915         Position = "-64,0";
1916         Lowered = NO;
1919 and WMState contains:
1922         Workspaces = ( "Workspace 1" );
1925 then you can merge both and have:
1928         Workspaces = ( "Workspace 1" );
1929         Dock = {
1930                 Applications = { {Command = (); }};
1931                 Position = "-64,0";
1932                 Lowered = NO;
1933         };
1938 The configuration format has changed!! Forget everything about the old
1939 format.
1941 dockapp was removed and the old version will not work anymore. 
1943 the dialogs require tcl/tk. they will be rewritten in plain C
1946 These are some tips for people upgrading from older versions and don't want
1947 too many unused files around. There is no problem if you decide to keep 
1948 them for a while.
1950         you can  rm -r ~/gnustep if you don't want anything from there
1952         remove the files in /usr/local/share/WindowMaker before installation
1954         the /usr/local/share/pixmaps directory can be removed