update docs.
[wmaker-crm.git] / NEWS
blob9fcdfce112aa975a09a4b6dff352a832a78d5f91
2 NEWS for veteran Window Maker users
3 -----------------------------------
5 --- 0.54.0
8 User Menu
9 ---------
11 The user menu is now a compile time option disabled by default. 
12 Supply --enable-usermenu to configure to enable it.
15 root menu INCOMPATIBLE changes
16 ------------------------------
18 EXEC <program> will execute the named program
20 SHEXEC <command> will execute the shell command.
22 If you want to execute something like blabla > /dev/null, then use SHEXEC
24 Dont forget to update your menus.
27 New Option For setstyle
28 -----------------------
30 The --ignore flag will tell setstyle to not change the option that is
31 specified, when modifying the Window Maker configurations. For example:
33 setstyle --ignore MenuStyle sometheme.themed will cause the MenuStyle
34 option to not be changed.
36 setstyle --ignore FTitleBack --ignore UTitleBack --ignore PTitleBack bla.themed
37 will load the theme, but keep the titlebar background related options as
38 before.
41 New Options
42 -----------
44 WorkspaceNameDisplayPosition =
45 none/center/top/bottom/topleft/topright/bottomleft/bottomright
48 SmoothWorkspaceBack = YES/NO
50 will enable smoothing of scaled workspace background images.
54 Application User Menu Path Changes
55 ----------------------------------
57 Default configuration for user specific menus installed in
58 /usr/local/share/WindowMaker/UserMenus or $(datadir)/WindowMaker/UserMenus
59 and ~/GNUstep/Library/WindowMaker/UserMenus.
62 Omnipresent icons in Clip
63 -------------------------
65 Added ability to set icons docked in Clip to be omnipresent on all workspaces.
66 To set/reset this flag use the "Settings Panel" for that specific icon (right
67 click on docked icon, and select "Settings").
68 An icon can be set to omnipresent, only if its position is free in all the
69 workspaces, else you will be informed of the problem and asked to fix it first.
70 Also when dragging an omnipresent icon around in Clip, all the icons docked in
71 all the workspaces are shown while the dragging is done, to let one easily see
72 where are free slots in all workspaces.
74 Now before you load your gun to start a flame war because this is against your
75 principles you love so much, please sit down and think that this is a feature,
76 which, if you don't use, the old behaviour of the Clip is totally preserved.
77 It just adds some extra capabilities to the Clip for people who think that this
78 is useful.
81 XDND drop on dock support
82 -------------------------
84 Support for XDE on dock is now replaced by XDND.
85 To enable, edit src/wconfig.h
89 --- 0.53.0
91 New Options
92 -----------
94 ** MenuStyle
96 MenuStyle=<style>; will change the menu texture style.
98 <style> can be:
99 normal (default): for the traditional one texture per item, with bevels in 
100 each
102 singleTexture: for a single texture that spans the whole menu, with bevels
103 in each item
105 flat: singleTexture without the bevels
108 ** ResizebarBack
110 ResizebarBack=<texture>;
112 where <texture> is any of the textures you normally use in titlebars and
113 other places.
115 If the style file/theme does not contain a ResizebarBack option, setstyle
116 will automatically hack it so that wmaker will make the theme work like 
117 before.
120 New crash dialog panel
121 ----------------------
123 From now on, whenever a fatal situation appears, Window Maker will display a
124 dialog panel to the user and let him choose what to do.
125 The options are:
126 - Abort and leave a core file (usefull for debugging and getting backtraces)
127 - Restart Window Maker (default behaviour)
128 - Start alternate window manager (the one defined as fallback, or if not
129   possible fvwm or twm in this order).
131 If it will not be able to restart or start the alternate window manager, it
132 will abort and leave the core file.
135 Application User Menu
136 ---------------------
138 Applications with an appicon can have a user defined menu.
140 This menu will emulate keyboard events, and will be sent to the applications'
141 window(s), thus the application must accept key combinations (CTRL+N for
142 instance).
144 To enable this feature, #define USER_MENU in src/wconfig.h and place menu
145 files in ~/GNUstep/Defaults/UserMenus (/usr/local/etc/WindowMaker/UserMenus
146 globally).
148 The user menu is in PropList format and the filename is in:
149 <instance name>.<class name>.menu or application's main window.
150 (Example: the menu for xcalc would be - xcalc.XCalc.menu)
152 Example user menu syntax:
155   "Calculator",
156   ("Put 1", SHORTCUT, "2"),
157   ("Functions",
158     ("Put 2", SHORTCUT, "2"),
159     ("Put 3,4 and 5", SHORTCUT, (3,4,5))
160   ),
161   ("Exit", SHORTCUT, "Control+q")
166 --- 0.52.0
169 Appearance Editing in WPrefs
170 ----------------------------
172 Added Appearance/Texture editing capability in WPrefs. Workspace background
173 selection is not yet finished.
176 Themes
177 ------
179 Removed all themes from the source tree, and moved them in a separate package.
180 You can download the new package from the same place as this package:
181 ftp://ftp.windowmaker.org/pub/beta/srcs/
182 Look after WindowMaker-extra-<version-number>.tar.gz
183 Also WindowMaker-extra pack include the old WindowMaker-data.tar.gz which only
184 contained icons.
185 Look for the greatest version number when you download this package.
188 get-wraster-flags script change
189 -------------------------------
191 The name of the options passed to get-wraster-flags changed, to allow a better
192 name compatibility with the naming conventions used by other software.
193 The name change was as follows:
194 --lflags was changed in --ldflags
195 To allow backward compatibility, with already written software, the old
196 --lflags option is still recognized, but you are encouraged to move the the
197 new --ldflags.
201 --- 0.51.2
204 New Themes
205 ----------
207 Added 2 new cool themes (actually I added in 0.51.1, but forgot
208 to put it here...) from largo (LeetWM) and BadlandZ (STEP2000).
211 Full Screen Maximization
212 ------------------------
214 The FullMaximize window attribute will allow the window to
215 be maximized to the full size of the screen (ignoring anything
216 like titlebar, resizebar, dock, panels etc). It should be usefull
217 for programs that must use the whole screen, like games or things 
218 like presentation programs.
221 --- 0.51.1
223 KDE Application Menu script
224 ---------------------------
226 wkdemenu.sh is a converter from KDE application menu structures to wmaker 
227 menu that can be used as a piped menu. Look wkdemenu.sh for how to use it.
230 Window Edge Resistance
231 ----------------------
233 Window edge resistance was now added. No, feature freeze hasn't been
234 removed. Its just part of the edge resistance rewrite ;)
237 New Theme
238 ---------
240 Added SteelBlueSilk theme
242 Installation Path Changes
243 -------------------------
245 Default configuration data installed in /usr/local/etc/WindowMaker
246 or $(sysconfdir)/WindowMaker
249 --- 0.51.0
251 Window Maker has become a GNU program (part of the GNU Project).
253 Title text drop shadow
254 ----------------------
256 drop shadow option added for titlebar text. This is a compile time 
257 option which needs to be defined in src/wconfig.h after you run
258 configure and before you run make.
260 New options and syntax for your WindowMaker domain file are:
262   Shadow = yes/no;
263   FShadowColor = <color>;  
264   PShadowColor = <color>;
265   UShadowColor = <color>;
266   MShadowColor = <color>;
268 The shadow option is dynamic (no need for a restart).
269 MShadowColor is for the menu title text.
271 libPropList
272 -----------
274 WARNING!!! libPropList was removed from the Window Maker distribution
275 and is being distributed separately. If you dont have it installed yet,
276 get it from ftp.windowmaker.org/pub/libs and install before building
277 Window Maker.
280 signal handling change
281 ----------------------
282 SIGHUP will exit wmaker instead of restarting it!!! This is because
283 GNOME expects the window manager to exit instead of restarting...
284 Complaints should go to gnome people. SIGUSR1 will restart wmaker now.
287 script change
288 -------------
289 WINGs-flags was removed, and replaced by get-wraster-flags.
290 Please remove WINGs-flags from your system, since it was obsoloted by
291 get-wraster-flags.
292 Continuing to use WINGs-flags can lead to hazardous effects, since is no
293 longer updated.
296 docklib
297 -------
299 docklib is a little library for making dock applets. It's in the
300 docklib-0.0.tar.gz file. Unpack it and read the README file there.
303 Option Changes
304 --------------
306 Removed OnTopTransients option
308 Added OpenTransientOnOwnerWorkspace
311 Olwm Hint Support
312 -----------------
314 OPEN LOOK(tm)/olwm hints support was added.
316 Read the appropriate section in the README file.
320 --- 0.50.1
322 New option for WorkspaceBack. mpixmap is the same as spixmap, but
323 it will scale the pixmap by keeping the aspect ratio (maximize or maxpect).
324 The option only works for workspace backgrounds.
326 Also added IGNORE_PPOSITION compile time flag, which is equivalent
327 to NoPPosition from fvwm. 
332 --- 0.50.0
335 KDE and GNOME
336 -------------
338 Added full support for GNOME and KWM hints. 
339 Read the INSTALL file to see how enable them.
341 Everything in the so called GNOME window manager bla bla bla pseudo-spec is
342 implemented.
344 As for KDE stuff, it implements 90% of everything kwm does, adds some
345 Window Maker specific extensions to it and still uses half of the memory
346 kwm does, which should be enough to let you dump kwm ;) For details on what
347 exactly is implemented, see comments in src/kwm.c Read the README.KDE file 
348 for more information.
351 WARNING: Some KDE hints are badly designed, so doing things like using
352 kpanel's desktop switcher/pager and Window Maker's internal workspace
353 management functions to create, destroy and rename workspaces at the same 
354 time might cause unknown effects. To be on the safe side, only
355 use either of them to manage workspaces. Switching workspaces is hopefully,
356 safe, so you can switch workspaces from wherever you want.
360 Workspace Specific Background Images
361 ------------------------------------
363 Use the WorkspaceSpecificBack to set background images for specific
364 workspaces. The WorkspaceBack is used as the default background image.
366 Example:
368 WorkspaceSpecificBack = ((solid, red), (cpixmap, ship.jpg, gray), (), 
369                                 (dgradient, red, blue))
371 This will set the background image of workspace 1 to (solid, 0),
372 2 to ship.jpg and 4 to a gradient. Workspace 3 and other workspaces
373 will have the image defined by WorkspaceBack.
375 Note that this uses quite some memory...
378 setstyle/getstyle
379 -----------------
381 setstyle now accepts the -nofonts flag, which will load the style
382 file ignoring all font related options.
384 Example:
386 setstyle -nofonts Blabla.style
389 getstyle can be used to create theme packs. See the usage in the
390 WindowMaker/README.themes file.
394 New Texture Type
395 ----------------
397 Textured gradients will tile a texture pixmap and combine it with a gradient, 
398 using an arbitrary opaqueness. 
400 Syntax is (thgradient, <file>, <opaqueness>, <color1>, <color2>)
401           (tvgradient, <file>, <opaqueness>, <color1>, <color2>)
402           (tdgradient, <file>, <opaqueness>, <color1>, <color2>)
403 where:
404 <color1> and <color2> are the colors for the gradient,
405 <file> is the texture file and
406 <opaqueness> is the opaqueness to merge the texture witht the gradient,
407 ranging from 0 to 255.
409 Example:
411 (thgradient, "BlueImage.jpeg", 120, white, black)
413 The BlackTexture style and Checker theme are examples.
415 Hints:
417 You can use any type of pixmap file for this, but small (like 64x32)
418 grayscale pixmap files should get the best results (fast and low memory
419 usage). You can use color pixmaps, but it is harder to get the desired effect
420 with them.
422 Be warned that this texture type is the slowest.
426 New Options
427 -----------
429 IconTitleBack and IconTitleColor control the color of the
430 miniwindow title. Both of them are colors.
432 Example:
433 IconTitleColor=white;
434 IconTitleBack=black;
437 Since this introduces an incompatibility in themes and getting flamed by the
438 themes ppl isn't the most pleasant thing ("Whaddafuk you're thinking!? You
439 just broke 500 themes!!!" ;) the setstyle command was hacked so that it will
440 make old themes work as before, by trying to automatically set the above
441 options. Note that in some cases it will not have exactly the same results as
442 before.
445 StartMaximized window attribute. Will maximize the window when it
446 is mapped.
449 AutoRaiseLower option for the Clip. This allows automatic Raise/Lower of the
450 Clip icons when the mouse pointer enter/leave the Clip. To avoid unwanted
451 raising/lowering there is a time threshold before raising/lowering.
452 The thresholds can be changed in wconfig.h by changing one or both of
453 AUTO_LOWER_DELAY and AUTO_RAISE_DELAY (expressed in miliseconds).
454 For example if you set AUTO_RAISE_DELAY to 0, then the Clip will be raised as
455 soon as the mouse pointer enters it's area. Setting AUTO_RAISE_DELAY to a very
456 big value, will make the Clip to practically do not auto raise unless clicked,
457 but to be automatically lowered after AUTO_LOWER_DELAY (ms) when leaved.
460 New ThemePack Format
461 --------------------
463 Starting with this version, a new format of themes is being supported.
464 Before you open pine and start composing your flame, rest assured that
465 the old format is still supported. The new format is documented
466 in the WindowMaker/README.themes file.
469 Root Menu 
470 ---------
472 The -noext option for OPEN_MENU will strip whatever is after the last .
473 in file names that appear on the opened directory. So,
475 OPEN_MENU ~/bg WITH xv -root -quit
477 will create a menu with all the images in ~/bg without the extension.
481 --- 0.20.3
484 Icon (miniwindow) stacking
485 --------------------------
487 If you want miniwindows to reside under normal windows, edit
488 wconfig.h and change WNormalLevel (just grep for it) to
489 WDesktopLevel
492 5 Button Mouse
493 --------------
495 If you have a 5 button mouse and want to give some utility for
496 the extra 2 buttons, edit the appropriate line in src/wconfig.h
497 Clicking Button4 in the root window will switch you to the previous 
498 workspace and Button5 will do that for the next.
501 Option Changes
502 --------------
504 put NoWindowOverDock back
506 KeepOnBottom window attribute
509 -static command line option
510 ---------------------------
512 wmaker -static will start Window Maker in static mode. This will
513 prevent wmaker from checking or making any configuration changes.
514 That makes it possible to run wmaker before running wmaker.inst
517 Hysteresis for menu item selection
518 ----------------------------------
520 Hopefully it's intelligent enough, so you won't notice it.
522 In case you want to know what's it, it's equivalent to that
523 (insanely long) 2 second delay present in that Windoze95 menu, 
524 but more usefull than annoying (I hope :). To see it, do the following
525 with your current wmaker version and later with 0.20.3:
527 - open the apps menu and stick it
528 - click in the item for the "Workspaces" submenu and hold
529 - drag the mouse to the 4th or bigger entry (like "Workspace 4") in a
530 straight line, trying to select the target item before the submenu
531 is unmapped when you dragged over other items in the main menu
535 Window Shortcuts
536 ----------------
538 Window shortcuts are shortcuts to arbitrary windows. You can make up to 4
539 shortcuts. To assign a previously bound shortcut to a window use the "Select
540 Shortcut" submenu in the window commands menu. If the shortcut is not yet
541 assigned for any window, you can hit the shortcut to assign it to the active
542 window. The shortcut will do the same as clicking in an entry in the window
543 list menu. The keys for the shortcuts are defined in the ~/G/D/WindowMaker
544 file or in WPrefs.app
546 Option names are:
548 WindowShortcut1Key through WindowShortcut4Key
551 --- 0.20.2
554 The name of WindowMaker was changed to Window Maker.
556 Window creation animation disabled by default.
558 xdaliclock -shape
559 -----------------
561 If you use it edit src/wconfig.h and #define OPTIMIZE_SHAPE or disable the
562 titlebar and resizebar for the window. OPTIMIZE_SHAPE will remove the
563 flickering for xdaliclock and other programs that change their shapes often,
564 but will increase network traffic considerably. So, if you use xdaliclock
565 from a remote machine it can get slow.
568 Applications Menu
569 -----------------
571 The applications menu will now use the shell in the SHELL environment
572 variable to execute EXEC menu commands. If it is unset (I think it's always
573 automatically set by the shell program) it will use /bin/sh
576 Extra fancy icon kaboom :)
577 --------------------------
579 Edit src/wconfig.h and #define ICON_KABOOM_EXTRA to get
580 more effects for the icon undocking animation.
582 Options for superfluous stuff are even more superfluous, so this
583 will not become runtime.
586 XDE drag and drop support
587 -------------------------
589 Support for XDE drag and drop was added (by "]d" <id@maliwan.org>).
590 To enable, edit src/wconfig.h
591 The support works with gtk 1.1.2
594 libPropList
595 -----------
597 libPropList will now be built automatically by wmaker. Wich means
598 the (simplified) building process is now:
600 ./configure
601 make
602 make install
604 instead of:
606 tar xzf libPropList.tar.gz
607 (cd libPropList; make)
608 make
609 make install
611 You also don't need to worry about GNOME libPropList incompatibilities
612 anymore. 
615 Bug with focus lost in sloppy focus fixed
616 -----------------------------------------
618 The bug only occurs in sloppy or auto focus modes, with AutoFocus disabled
619 and Superfluous enabled. There is no easy/clean way to fix this, so Window
620 Maker will disable the animation of window creation if the focus mode is
621 either sloppy or auto AND AutoFocus=NO.
623 If you want the animation, enable AutoFocus or use manual focus mode
624 (prefered). 
627 The NoWindowUnderDock option was removed
628 ----------------------------------------
629 To obtain the same result, use the "Keep Dock On Top" option in the dock menu.
632 Persistent Program Suplied Icons
633 --------------------------------
635 Application supplied icons are now stored, so that the dock will keep
636 showing them after the app is exited. The icons are stored at
637 ~/GNUstep/.AppInfo/WindowMaker/
640 Sound support
641 -------------
643 Sound support is now on by default. Even if you don't use sound the overhead
644 is very small, and has no impact on performance. If you still want to
645 optimize it and remove a few hundred of bytes, then use --disable-sound or
646 --enable-sound=no options when you configure Window Maker.
649 --- 0.20.0
651   
652 Multihead support. wmaker will now manage all screens that are attached to the
653 display. 
654 ------------------------------------------------------------------------------
655   
657 It does so from a single process (instead of spawning a new process for each
658 screen, like fvwm does). This keeps memory usage a lot lower than fvwm.
660 State files have a suffix .n, where n is the number of the screen.
662 Since I don't have a real multiheaded machine, it probably has bugs.
664 Superfluous
665 -----------
667 Yet another useless superfluous animation. Find out what exactly it is
668 by yourself :)
671 exitscript
672 ----------
674 ~/G/L/W/exitscript will be called automatically when wmaker is exited.
677 New runtime options
678 -------------------
680 1. Miniaturization animation is now selectable by a runtime option
681 Add a line with
683 IconificationStyle = <style>;
685 to your WindowMaker configuration file.
686 <style> can be one of: Zoom, Twist, Flip or None
687 Case doesn't matter, and default is Zoom.
690 2. Edge resistance.
691 This can be controlled by setting:
693 EdgeResistance = xxx;
695 in your WindowMaker configuration file.
696 xxx is an integer greater than 0 and represents the number of pixels of edge
697 resistance. Setting it to 0 (default) will disable this feature.
699 New theme
700 ---------
702 A new theme named Night, is available in this distribution.
706 --- 0.19.3
708 GIF support was added. You will need libgif 2.2 to use it.
710 cpixmap added. Syntax is the same as tpixmap or spixmap
713 --- 0.19.2
715 getstyle will include IconBack info in Style files.
717 --- 0.19.0
719 libPropList was updated. If you have it installed, you must upgrade or
720 WPrefs will crash because of bugs in libPropList.
722 New options
723 -----------
725 Balloons!
726 ---------
728 WindowTitleBalloons = YES;
729 will enable balloons for window titles that are not fully visible.
731 MiniwindowTitleBalloons = YES;
732 will enable balloons for miniwindow titles.
734 AppIconBalloons = YES;
735 for application icons (docked or not)
738 IconPosition
739 ------------
741 IconPosition (the position of the icons) is specified as:
743 IconPosition = c1c2c3;
745 where:
747 c1 can be t or b (meaning top or bottom)
748 c2 can be l or r (meaning left or right)
749 c3 can be v or h (meaning vertical or horizontal)
751 case is insensitive.
753 For example, 
754 IconPosition = blh;
756 is the old iconPosition position.
758 IconPosition = trv;
760 will place the icons over the Dock.
762 New window attribute
763 --------------------
765 EmulateAppIcon = YES; will make the window have an application icon.
766 Only use this option for fully specified windows (like rxvt.Rxvt).
767 NEVER use in generic window specifications (like * or rxvt).
768 You must restart the application for the attribute to take effect.
771 WPrefs.app
772 ----------
774 Read WPrefs/README
777 --- 0.18.1
779 Boolean balues have changed!!! YES, Y and any non-zero integer will
780 mean TRUE and anything else (including True) will mean FALSE. This
781 is to conform to the OpenStep values used for booleans and
782 not cause headaches later, when GNUstep apps also starts using
783 defaults and users will try using True wich won't get recognized.
786 --- 0.18.0
788 Clip
789 ----
791 Clip button layout was changed. IT IS TEMPORARY AND THE DEFINITIVE LOOK
792 WILL BE DIFFERENT!!!
795 libPropList
796 -----------
798 More bugs were fixed in it. Upgrade the library if you have an older version
799 installed, with the one included.
802 Property list menus
803 -------------------
805 Format for property list menus has changed! The redundant array for
806 submenus was removed, so a menu that looked like:
808 ( Applications,
809   ("Xterm", EXEC, "xterm"),
810   ( 
811     (Paint,
812         ("Gimp", EXEC, "gimp"),
813         ("XV", EXEC, "xv")
814     )
815   )
818 must be changed to:
820 ( Applications,
821   ("Xterm", EXEC, "xterm"),
822   (Paint,
823         ("Gimp", EXEC, "gimp"),
824         ("XV", EXEC, "xv")
825   )
830 Misc
831 ----
833 NUMLOCK_HACK is back. This time it works and is enabled by default.
834 If you think you don't need it and promise me that you won't send 
835 "bug" reports saying that shortcuts stop working after a while, you can
836 disable it ;) It will save some memory and CPU.
839 Configuration
840 -------------
842 Removed the SwapMenuButton option and added 3 finer grained options:
844 SelectWindowsMouseButton
845 WindowListMouseButton
846 ApplicationMenuMouseButton
848 Values that can be used are Left, Middle, Right and Button1 through Button5
849 Left is equivalent to Button1, Middle to Button2 and Right to Button3
852 Removed the WorkspaceChangeDelay option and corresponding action.
853 Removed AClipColor and IClipColor
856 Added the SelectKey back
859 Changed default binding of Window commands menu from F10 to Control+Escape
861 --- 0.17.4
863 Misc
864 -----
866 libPropList has changed! Upgrade it before compiling wmaker.
868 Hopefully the bugs that caused wmaker to crash if an error is found
869 in the config files is fixed. If you do crash wmaker with a bad
870 file, please try to find out the smallest possible portion of the file
871 that still crashes wmaker and send it to me.
874 New Options
875 -----------
877 PixmapPath was split to PixmapPath and IconPath. PixmapPath is the path
878 for the pixmaps used as textures and IconPath is for the icons. 
879 Don't forget to add IconPath to your current configuration file.
881 There's also a new library in ~/GNUstep/Library/Icons. You should place
882 your icons there, since icons are not a WindowMaker specific resource.
885 DontConfirmKill=YES; will disable the confirmation panel for Kill
888 --- 0.17.3
890 Interface Changes
891 -----------------
893 Unhide Here in the appicon menu was changed to be the first entry.
894 This way you can unhide the appicon with a single click without
895 even moving the pointer.
898 Clip Commands
899 -------------
901 The collect icons commands was renamed to attract icons and
902 the attract icons options was renamed to Auto attract icons.
904 The Remove Selected Icons was renamed to Remove Icon(s). It will
905 act as before if some icon is selected and will remove the clicked
906 icon (without confirmation) if it is not.
908 Added a Keep Icon(s) command that will keep the selected icons if
909 any is selected and the current one if none.
911 The Move To command was renamed to Move Icon(s) To.
914 --- 0.17.0
916 If you have libPropList installed, you might want to reinstall it,
917 replacing with the included libPropList. It has a small bug fix.
919 Misc. Changes
920 -------------
922 Removed --with-gnome and made MWM_HINTS defined by default.
923 This means that "GNOME support" will work with no additional
924 flags passed to configure. 
926 Added support for KDE, by adding a DisableWorkspaceMouseActions option.
927 Set it to YES and run krootwm to be able to use everything in kfm.
930 Shortcuts for Root Menu
931 -----------------------
933 There is now a new SHORTCUT optional keyword for the menus.
934 For example, you can bind Control-F1 to xterm with:
936 "XTerm" SHORTCUT Control+F1 EXEC xterm
938 or F2 to ARRANGE_ICONS with:
940 "Arrange Icons" SHORTCUT F2 ARRANGE_ICONS
943 All commands allowed in the menu file accept the keyword, except for
944 MENU and OPEN_MENU
947 Interface Changes
948 -----------------
950 ** Configuration of docked applications is now done in a panel instead of
951 in the menu. 
953 ** Added a command menu for application icons
955 ** Shift double-click on the application icon will unhide the app
956 in the current workspace.
959 Option Changes
960 --------------
962 NotMiniaturizable option changed to NoMiniaturizeButton
963 NotClosable option changed to NoCloseButton
966 Speed options values are now UltraFast, Fast, Medium, Slow or UltraSlow
967                                               ^^^^^^
969 Removed the Select keyboard binding. You can access it in the window
970 commands menu.
972 Removed the ClipMaxIcons option and made it a compile time option.
974 Removed the ConstrainWindowSize option
976 Renamed NoSound to DisableSound
978 Renamed NoAutowrap to DontLinkWorkspaces
980 Renamed NoDithering to DisableDithering
982 Renamed NoAnimations to DisableAnimations
984 Removed the LeftHanded option and added a SwapMenuButton option.
985 SwapMenuButton will make the rubberband selection in the root window
986 be bound to the right button and the root menu to the left button.
989 New way to display temporary icons
990 ----------------------------------
992 The icons that are attracted by Clip, but will not be kept after the
993 application close, are now using a different color for shading, unlike previous
994 version that always used white. This will improve look for very different color
995 combinations, and allow the user to control the look of the shaded icon.
996 The color used for shading the icons is computed as follows:
998 First a color is computed depending on the IconBack type:
999  - for solid the color is the solid color itself.
1000  - for simple gradients the color is (from_color + to_color)/2.
1001  - for multiple gradients, the color is the first color in list.
1002  - for pixmaps, the color is the solid color specified for that pixmap.
1004 Then the color is made lighter by multiplying each red/green/blue filed with
1005 1.7 and limiting each field to 0xff in case they exceed this value.
1006 Then this new color will be used by superposing it with the icon we want to
1007 shade, using a proper alpha value.
1009 To control the color for shading is simple:
1011 - In case of multi gradients you just need to put the first color, as the color
1012 you like. WindowMaker do not use the first color in the list to directly build
1013 the gradient, but only when it needs a solid color for something (like in this
1014 case).
1016 - For pixmaps, put the needed color as the solid color the syntax for pixmaps
1017 require. This color is also not used when displaying normal icons, just when
1018 solid colors are needed (like this case).
1020 - For solid color, or simple gradients, in case the color it uses after
1021 computing is not good enough, you can always convert the solid or simple
1022 gradient to a multi gradient with the same look, and use that one. In this
1023 case is simple, just put the needed color as first color in list.
1025 Please note that this will not slow down WindowMaker, because the IconBack is
1026 read only once at startup, and then only if it is changed. After reading it WM
1027 will construct the image of the tile, and use the image instead of recomputing
1028 the gradient every time.
1030 Here are 2 examples of converting solid or simple gradient to a same looking
1031 multi gradient:
1033 IconBack = (solid, Blue);
1034 will become
1035 IconBack = (mhgradient , LightBlue, Blue, Blue);
1036 using LightBlue as color for shading.
1038 IconBack = (dgradient, "#284569", "#082420");
1039 will become
1040 IconBack = (mdgradient, "#183454", "#284569", "#082420");
1041 looking the same, but using #183454 for shading.
1044 New Sound Server Location
1045 -------------------------
1047 The sound server new URL is http://www.frontiernet.net/~southgat/wmsound
1048 Also it seems to be running on FreeBSD too (with little changes maybe).
1051 --- 0.16.1
1053 WINGs
1054 -----
1056 The path for the WINGs resource files was changed. If you don't
1057 do make install, you must move /usr/local/share/WindowMaker/Resources to
1058 /usr/local/share/WINGs
1061 New Options
1062 -----------
1064 The following new options are available:
1065 NewStyle = Yes/No; (static) Replaces --enable-newstyle
1066 DisableDock = Yes/No; (static) Same as -nodock command line option.
1067 DisableClip = Yes/No; (static) Same as -noclip.
1068 Superfluous = Yes/No; (dynamic) Replaces --enable-superfluous.
1070 NOTES.
1071 - The static options are only read at startup. Changing them, needs to restart,
1072   so they will be accounted.
1073 - DisableDock and DisableClip have lower precedence than -nodock -noclip
1074   command line options. If both option/command line option are given, then the
1075   command line option will be accounted.
1078 Start Hidden option
1079 -------------------
1081 The start hidden option was fixed, and made to be an application wide option.
1082 It will apply to every window the application owns. Also its place in the
1083 Attribute Inspector panel, changed accordingly, to reflect this.
1084 The start miniaturized is however still applying to particular windows of an
1085 application, unless the option is set for the class.
1086 Start miniaturized, will override start hidden if both set.
1088 IMPORTANT NOTE.
1089 Because of the way Netscape Communicator is implemented, it is NOT possible
1090 to set the start hidden or miniatirized flags for it. This is because Netscape
1091 chooses to send a second map event to the window it maps. This makes the
1092 window to receive a second map request and to be unhidden or maximized back,
1093 immediately after it was hidden or miniaturized by WindowMaker at startup.
1097 --- 0.16.0
1099 Misc. Changes
1100 -------------
1102 The NextMenuBehaviour option was renamed to WrapMenus
1103 The WorkspaceTiedMiniwindows option was renamed to StickyIcons
1105 The .tif files were renamed to .tiff
1108 Selecting Mini Windows
1109 ----------------------
1111 Now miniaturized windows can be selected as well as normal windows.
1112 You can do this by Shift-Click-ing them. They will be marked, and will follow
1113 you through workspaces like normal selected windows do.
1114 Miniaturizing a window will no longer deselect the window, but will place the
1115 icon and mark it as selected.
1116 The only difference between miniaturized and normal window selection is that
1117 for the moment the rubber-band selecting method works only for normal windows.
1120 Icon Selection Panel in Attributes Editor
1121 -----------------------------------------
1123 Now, selecting icons is as easy as clicking in the file name in a list.
1126 Simplified Options
1127 ------------------
1129 IconSlideStep, IconSlideSlowDown and IconSlideDelay were merged to 
1130 IconSlideSpeed
1132 MenuScrollStep and MenuScrollDelay were merged to MenuScrollSpeed
1134 ShadeStep and ShadeDelay were merged to ShadeSpeed
1137 Valid values for them are: Fast, Normal, Slow or UltraSlow
1139 If you want to fine tune the values, they can be changed in wconfig.h
1140 Send me your set of values with an indication of how fast is your hardware,
1141 so that I can make the default values more adequate.
1144 New Window Attributes
1145 ---------------------
1147 Added StartMiniaturized and StartHidden as window attributes and
1148 removed the previous implementation. Also removed the dock menu entries.
1149 They are now settable in the Attributes Panel.
1151 Also added DontSaveSession attribute. This way, you won't end up with multiple
1152 unwanted copies of the same app after the previous session is restored.
1153 I start X with a xterm in .xinitrc instead of wmaker, wich will cause the
1154 xterm restored by wmaker be duplicate. Just add -name something to the
1155 xterm started form .xinitrc and mark DontSaveSession=YES for that window.
1159 User Specifiable Visual IDs
1160 ---------------------------
1162 wmaker now supports different visuals than the default one. It isn't of much
1163 use for most people, but can be usefull for lucky SGI users who want it
1164 to use TrueColor instead of the default PseudoColor.
1166 wmaker -visualid VISUAL_ID
1168 where VISUAL_ID is the hex code for the visual you want.
1170 Note: I don't have an SGI box and haven't tested it...
1174 Starting Workspace
1175 ------------------
1177 The starting workspace is identified in the following order:
1178 1. If the app is omnipresent will be mapped on the current workspace.
1179 2. Else if the application have a StartWorkspace option set as attribute
1180    then this one will be used.
1181 3. Else, if the application was started from Clip, the workspace on which
1182    the Clip from where it was started is used.
1183 4. Else the current workspace is used.
1185 Restoring saved sessions will always use the saved workspace, no matter
1186 what other options are, except onmipresent.
1190 --- 0.15.1
1192 Workspace specific mini windows
1193 -------------------------------
1195 The minimized windows can be workspace specific, being more consistent with
1196 the rest. This is because minimized window represents just another state of a
1197 window (like normal or shaded), which all are workspace specific.
1198 This (or the old "present anywhere") behavior can be set using an option in
1199 the WindowMaker database: WorkspaceTiedMiniWindows = Yes/No;
1201 New way to animate the blowing icons
1202 ------------------------------------
1204 There is now a compile time option that allows one to set how the icons are
1205 animated when detaching from dock/clip in superfluous mode.
1206 By default the classic "Falling pieces" animation is used.
1207 If SPREAD_ICON is #define-ed in wconfig.h, then a "Spread in four directions"
1208 animation is used instead. Take a look at the section where this is described
1209 in src/wconfig.h
1210 By default there is #undef SPREAD_ICON to select "Falling pieces" animation.
1212 Auto Colapse for Clip
1213 ---------------------
1215 The clip now supports an option named "Auto Collapse" which can be set from
1216 the clip main menu. When set, clip will stay collapsed, and will show itself
1217 when the mouse moves over it. While the mouse is over it, or over any of the
1218 icons attached to the clip, the clip will stay uncollapsed, letting you to
1219 access the attached icons. This is not true for applications like asclock, or
1220 applets of that kind, because the icon window do not belongs to WindowMaker,
1221 but to the application itself. For such icons you must keep the mouse over the
1222 icon groundplate, else it will collapse back. But usually these type of icons
1223 will not stay in a collapsed clip, since one needs to see what they show.
1224 When the clip is leaved it will collapse back after a delay of 1 second, unless
1225 the mouse is moved back to the clip area. The delay can be set modifying
1226 AUTO_COLLAPSE_DELAY in wconfig.h. Default is 1000 (ms) which means 1 second.
1231 --- 0.15.0
1233 Changed name from Fiend to Clip
1234 -----------------------------------
1236 All occurrences of word Fiend with or without capital F were replaced with
1237 the corresponding Clip (same capital).
1238 This affects all configuration files under ~/GNUstep that contain this word.
1239 It can be refered as "Workspace Dock" too.
1242 New option in Clip menu, and extended Clip behavior
1243 ---------------------------------------------------
1245 The following new items are available in the dock menu:
1247 1. Attract Icons
1248 2. Keep Attracted Icons
1249 3. Collect Icons
1250 4. (Un)select All Icons
1251 5. Remove Selected Icons
1252 6. Move To
1253 7. Start miniaturized    (also available for regular dock)
1254 8. Start hidden          (also available for regular dock)
1255 9. Selected
1256 10. Set icon...          (also available for regular dock)
1259 Here is what they do:
1261 1. "Attract Icons" will let the Clip to attract and attach any new appicon that
1262    is created when an application starts. It will not do this if the Clip is
1263    full. If the Clip is Collapsed then the appicon will be hidden after it is
1264    attached.
1265 2. "Keep Attracted Icons" will tell the Clip to keep the attracted appicons,
1266    after the application is closed. Without this the appicons will vanish,
1267    leaving the Clip in the original state. If you move an appicon that was
1268    attracted from Clip to regular Dock, it will be kept when closed, no matter
1269    what "Keep Attracted Icons" is set to in Clip.
1270 3. "Collect Icons" will collect all appicons that are not yet attached to Dock
1271    or Clip, and attach them to the current workspace Clip. The value of
1272    "Keep Attracted Icons" will apply when applications close. If Clip is
1273    collapsed, the appicons will be hidden.
1274 4. "(Un)select All Icons" will select all icons in the clip if none is
1275    selected, or it will deselect all selected ones. The selected icons are
1276    marked using a small triangle in the bottom right corner of the appicon.
1277    The color of the mark is set using SClipColor in WindowMaker domain
1278    database.
1279 5. "Remove Selected Icons" will remove from Clip all selected icons. The ones
1280    that still run, will be detached, all the others will vanish.
1281 6. "Move To" will transfer all selected icons to another workspace and attach
1282    them to the Clip in that workspace. If none is selected, only the one the
1283    mouse was pressed on will be moved.
1284 7. "Start miniaturized" will launch (or autolaunch if set) the application in
1285    a miniaturized state.
1286 8. "Start hidden" will launch (or autolaunch if set) the application in a
1287    hidden state. Note that only one of the two can be set at a time.
1288 9. "Selected" can be used to toggle the selected state of the appicon
1289    individually. The same can be achieved using Shift-LeftClick on the appicon.
1290    In fact the intended way of toggling the selected state is by using
1291    the Shift-LeftClick on icon. The menu entry is just another way to do the
1292    same.
1293 10. "Set icon..." will allow one to set the image for the appicon. The image
1294    will be updated without restart, and also all appicons in the same
1295    instance.class as the one we set for, will be updated.
1297 So a simple way of avoiding the screen to be filled up with appicons is to set
1298 the "Attract Icons" in the Clip. Also the "Keep Attracted Icons" can be set to
1299 No, so the attracted icons will be deleted when application exits, thus leaving
1300 the Clip clean. If also one to not want to see the appicons that keep filling
1301 the Clip, he can set the Clip to be Collapsed.
1303 Getting rid of unneeded icons in Clip is as simple as selecting them
1304 individually using Shift-LeftClick, and then using the "Remove selected Icons"
1305 entry in menu.
1308 Support for different visuals.
1309 ------------------------------
1311 WindowMaker is now able to support any visual, except DirectColor, in any
1312 depth from 1bpp to 32bpp.
1314 One can start the X server with different visuals, by passing the X server the
1315 right option. For XFree 3.3.x is -cc <id>.
1316 WindowMaker is not yet able to choose a different visual from the Default one
1317 on a given screen, but can use any default visual it finds, except the direct
1318 color visual.
1319 For example starting X like (for XFree 3.3.x, and if the driver for the
1320 card supports this. Read the man page for your X server):
1321 startx -- -bpp 8 -cc 0 will give you the StaticGray visual.
1322 startx -- -bpp 8 -cc 1 will give the GrayScale visual
1323 and so on.
1325 Wrlib code is now generic, and will support any visual except DirectColor in
1326 any depth. Programs written with wrlib can work on different visuals from
1327 the default visual for a given screen.
1328 Behavior in different visuals can be tested using the testgrad program in
1329 wrlib subdirectory in distribution.
1330 testgrad -h will show the usage.
1332 Multidiagonal gradients are also implemented now in wrlib, and a new algorithm
1333 is used to speed up the generation of diagonal gradients.
1336 New arrangement of the directory structure under ~/GNUstep/
1337 ---------------------------------------------------------------
1339 To better adapt to theme support the directory structure changed under
1340 ~/GNUstep/Library/WindowMaker
1342 1. Style directory moved to Styles.
1343 2. Added the following directories: Backgrounds, IconSets, Pixmaps, Sounds and
1344    Themes.
1345 3. The .style files no longer get copied in the user's Styles directory.
1346    Instead they are read from the global /usr/local/share/WindowMaker/Styles
1347    directory.
1349 Under ~/GNUstep/Defaults the following changes occurred:
1351 1. A default WMState is installed by wmaker.inst.
1352    It contains the dockit program assigned to the top icon of the dock, and
1353    the wmsetbg program assigned for the drop command on both dock's and clip's
1354    main icon.
1355    Double clicking the dock's main icon will bring up dockit that will let you
1356    dock any application that do not have an application icon.
1357    Dropping an image on dock's or clip's main icon, from an Offix DND aware
1358    application, will put the image on the background tiled, and will update
1359    WindowMaker domain database file.
1360 2. Syntax of WMState changed a little. The old position will not be restored
1361    when you will first start the new version, but after that it will be
1362    normally remembered. This is because now the main clip icons is only saved
1363    once, not for every workspace.
1364    You should replace Fiend with Clip in any place where it appears, if you
1365    want to keep the old WMState file, else it will not work.
1366 3. At compile time, it will detect if you have support for tif, and will
1367    install a WMWindowAttributes with corresponding image name extension
1368    (.tif or .xpm). This is true only for pixmaps that come with the source
1369    distribution and get installed under /usr/local/share/WindowMaker/Pixmaps
1371 The menu file changed a lot. Old menu file will *not* work with new theme
1372 support, so please upgrade.
1375 New behavior of OPEN_MENU command
1376 ---------------------------------
1378 The OPEN_MENU command now supports the following syntax:
1379 1. File menu handling.
1380    // opens file.menu which must contain a valid menu file and inserts
1381    // it in current position
1382    OPEN_MENU file.menu
1383 2. Pipe menu handling.
1384    // opens command and uses it's stdout to construct menu.
1385    // Command's output must be a valid menu description.
1386    OPEN_MENU | command
1387 3. Directory handling.
1388    // Opens one or more directories and construct a menu with all
1389    // the subdirectories and executable files in them sorted alphabetically.
1390    OPEN_MENU /some/dir [/some/other/dir ...]
1391 4. Directory handling with command.
1392    // Opens one or more directories and construct menu with all
1393    // subdirectories and readable files in them sorted alphabetically,
1394    // preceding each of them with command.
1395    // WITH is a required keyword!!!
1396    OPEN_MENU /some/dir [/some/other/dir ...] WITH command -options
1398 Please note that because of the 'WITH' keyword old menu files no longer work
1399 for the OPEN_MENU with a command.
1402 Theme support
1403 -------------
1405 Theme support is now as easy as untar-ing a tarball in the right place.
1406 Because of the way OPEN_MENU works, they can be installed on a global
1407 shareable basis, or for personal user use.
1408 Themes installed under ~/GNUstep will be available only for a user, but
1409 if if they are installed under /usr/local/share/WindowMaker they will be seen
1410 by all users. This is also true for style files, background images, pixmaps,
1411 etc that get installed under /usr/local/share/WindowMaker.
1412 Themes can be saved or loaded using the Appereance menu.
1414 Also support for different IconSets is available. You can save or load a new
1415 IconSet using the Appereance menu.
1417 Setting background images is now as simple as putting the images in the right
1418 place (~/GNUstep/Library/WindowMaker/Backgrounds or
1419 /usr/local/share/WindowMaker/Backgrounds, or any other place in your
1420 PixmapPath). Then use the Appereance menu. They will be instantly available
1421 since they are opened by a OPEN_MENU command. Also the image do not need to
1422 have a .jpg or any other extension. It will be recognized anyhow.
1423 As an example please see the OpenStep theme supplied with WindowMaker.
1424 The OpenStep image is a jpeg file without extension.
1426 Please keep in mind that anything under /usr/local/share/WindowMaker will be
1427 available for all users.
1430 New options for wmsetbg and getstyle
1431 ------------------------------------
1433 wmsetbg now accepts the following options:
1434 usage: wmsetbg [-options] image
1435 options:
1436  -d             dither image
1437  -m             match  colors
1438  -t             tile   image
1439  -s             scale  image (default)
1440  -u             update WindowMaker domain database
1441  -D <domain>    update <domain> database
1442  -c <cpc>       colors per channel to use
1444 By default, it will try to guess if dithering is needed or not and proceed
1445 accordingly.
1446 Using -d or -m will force it to dither or match colors.
1448 Dithering for more than 15bpp is generally not needed, and will only result
1449 in a slower processing.
1450 Don't use dithering except when needed, because it is slower. Else rely on
1451 wmsetbg which will detect if dithering is needed and use it.
1453 -u will update the WorkspaceBack in the default database domain file in
1454    ~/GNUstep/Defaults/WindowMaker, and let WindowMaker refresh the screen.
1455    Please note that this option only works under WindowMaker, and will have no
1456    effect under other window managers, since it rely on WindowMaker to update
1457    the image after it reads the updated defaults database.
1459 -D <domain> is same as above, but will update the domain <domain> instead of
1460    the default WindowMaker domain.
1462 -c <cpc> will set the color per channel to use. Only needed for PseudoColor
1463    visuals. WindowMaker will automatically pass the value read from the
1464    WindowMaker domain database.
1467 getstyle now have the -t option, that instructs it to read all options
1468 related to theme. Without -t getstyle will read only style options that
1469 means it will not read WorkspaceBack and IconBack.
1470 Use -t when you want to make a theme and need all theme options to be saved.
1471 Else it will extract just a style file.
1474 Session management support
1475 --------------------------
1477 Two new commands are available for use in menus:
1479 SAVE_SESSION and CLEAR_SESSION.
1481 SAVE_SESSION:
1482 will take a snapshot of all running applications, and their current hints
1483 (shaded, hidden, minimized, geometry and workspace they are on),
1484 and save it inside the WMState file. Also the current workspace we are on is
1485 saved. The applications that are running and were started from dock or clip are
1486 marked, so they will be attached to the corresponding dock/clip when restored.
1487 This state is restored every next session, until a new one is saved or
1488 CLEAR_SESSION is used.
1490 CLEAR_SESSION:
1491 will clear any previous saved session.
1493 There is also a run time option named SaveSessionOnExit = Yes/No; that allows
1494 one to automatically save the state of desktop when leaving WindowMaker.
1495 This way next session, the state of the desktop before last exit is restored.
1497 Please note that if this option is set to Yes, than any manual saving of the
1498 state, or any clearing of the state will be overridden when exiting
1499 WindowMaker.
1501 These options are available under the "Workspace" menu.
1504 User WindowMaker configuration files are now merged with global ones
1505 --------------------------------------------------------------------
1507 When starts WindowMaker will look for database domain files under
1508 $GNUSTEP_USER_ROOT/Defaults or ~/GNUstep/Deafults to be read. (In this order).
1510 If they are not available then it will scan for them in
1511 $GNUSTEP_LOCAL_ROOT/Defaults, $GNUSTEP_SYSTEM_ROOT/Defaults or
1512 /usr/local/GNUstep/Defaults (in this order).
1514 Even if the file was found or not, it will always load the corresponding domain
1515 file under /usr/local/share/WindowMaker/Defaults.
1517 Then if the user file was found it will merge it over the global file, else
1518 the global file will be used.
1520 This way any settings that are set by the system administrator in the shared
1521 file will be available for users that do not have them in their config files.
1522 Any option the user have in his config file will override the one in the
1523 shared domain file.
1525 So any new runtime options that appear in WindowMaker domain, do not need to
1526 be set in all user files, except the ones the user wants a different behavior
1527 from the default set for all users in the shared file.
1529 Also it is possible for the user to not have any personal domain databases, and
1530 the global shared ones will be used, but it still needs to have the directory
1531 structure, so WMState gets written on session exit.
1532 So all it needs to have is ~/GNUstep/Defaults directory available.
1535 New behavior of the Slide Icons
1536 -------------------------------
1538 Animation constants are now runtime.
1539 They are:
1540 IconSlideDelay = 0;
1541 IconSlideStep = 5;
1542 IconSlideSlowDown = 50;
1544 To better adapt both slow and fast machines the behavior of sliding icons
1545 changed in the following manner:
1547 Old one was to keep moving the icon with a constant step (default 5 pixels)
1548 until it reached the destination.
1550 Now it will use a new parameter named IconSlideSlowDown to speed up or slow
1551 down the moving.
1553 Instead of moving it with a constant step it will use IconSlideSlowDown to
1554 divide the distance to the destination, and use this value as the first step.
1555 Then is will compute the remaining distance and will again use
1556 IconSlideSlowDown to divide it and get the new step. And so on.
1557 When the step to move becomes smaller than IconSlideStep, IconSlideStep will
1558 be used further until the destination is reached.
1560 This way a nice deceleration effect is achieved, since while the icon
1561 approaches destination, it will use smaller steps, gibing the illusion that
1562 the icons is moving slower.
1564 IconSlideDelay will give the pause between steps, and is expressed in ms.
1566 Giving large values to IconSlideSlowDown (>1024 for 1024x768 screen) will
1567 result in the old "constant step advance" behavior, since the computed step
1568 will always be smaller than IconSlideStep, and the last will be used instead.
1570 Making IconSlideSlowDown = 0 or 1, will result in an instant jump to the
1571 destination without any animation.
1574 Attribute editor
1575 ----------------
1577 Because the icon images on screen automatically update after any change in
1578 WMWindowAttributes domain file, the use of both Save and Apply buttons is no
1579 longer needed. If one wants to just apply the setting to the current window
1580 only, he will only use the Apply button.
1581 If he wants them saved for all applications in the same instance and/or class
1582 the using the Save button will write them to disk, and automatically
1583 WindowMaker will update all the icons that need to be updated on screen.
1586 Sound support
1587 -------------
1589 Some basic sound support is now part of WindowMaker. The sound server is not
1590 yet part of WindowMaker distribution, so you need to download it separately.
1591 This is because is linux specific, and need some changes before it can be
1592 included.
1593 Until them if you have a linux system and want to use sound, use the
1594 wmsound-0.5 available at http://www.geocities.com/SiliconValley/Bay/7874
1595 Download that package, and only build the sound server there.
1596 DO NO APPLY ANY PATCHES FROM THERE!, because they are already applied.
1597 Just build the sound and copy the executable in /usr/local/bin
1598 Follow the rest of the install steps described there, except the patch-ing
1599 procedure.
1601 To enable sound for WindowMaker pass --enable-sound to configure.
1603 Also use NoSound = Yes/No; to enable/disable sound at runtime without killing
1604 the sound server.
1606 If you cannot set the sound to work yet, then is not for you.
1607 Wait until the sound server will be fixed and will be part of WindowMaker.
1610 New entries in WindowMaker domain database
1611 ------------------------------------------
1613 The following entries have been added to the runtime options:
1615   SaveSessionOnExit = No;
1617 will autosave (or not) the session state on exit.
1619   WindowPlaceOrigin = "64, 64";
1621 will offset all windows in auto or cascade placement mode with the value
1622 (in pixels) before placing them on screen. First is horizontal direction and
1623 second is vertical.
1624 This do not apply to windows that request a specific position on screen.
1625 This is useful if you want your Clip on the top left corner to not be
1626 overlapped by mapping windows.
1627 It will let it to have a row and a column of docked appicons near the screen
1628 edge, that will not be overlapped by windows.
1629 If you set it to "128, 128" it will have 2 rows and 2 columns not overlapped.
1632   NoSound = No;
1634 Enable/disable sound at runtime without the need of killing the sound server.
1637   MenuScrollDelay = 10;
1638   MenuScrollStep = 5;
1640 Constants for the menu scrolling animation.
1642   IconSlideDelay = 0;
1643   IconSlideStep = 5;
1644   IconSlideSlowDown = 50;
1646 Constants for the icons sliding on screen. Explained above.
1648   ShadeDelay = 0;
1649   ShadeSteps = 15;
1651 Animation parameters for shading a window. How many steps it will take, and the
1652 delay between steps in ms.
1654   DoubleClickTime = 250;
1656 The time for the double click to be considered so. Expressed in ms.
1658   SClipColor = "#6f8ae2";
1660 Color for selected icons in Clip.
1662 All delays are expressed in ms.
1666 --- 0.14.1
1669 *** Enhanced fiend clone.
1671 Here are the new fiend features:
1672 1. Keys for raising/lowering the fiend, and their default values:
1673    FiendLowerKey = None;
1674    FiendRaiseKey = None;
1675    FiendRaiseLowerKey = None;
1677    All reside in WindowMaker configuration file.
1679 2. Added posibility to launch the workspace menu with button1 click on the
1680    idle indicator of fiend, or with button3 click on workspace name on the
1681    fiend.
1683 3. Added Control-button1-click on fiend's idle indicator, to create a new
1684    workspace and move to it. Same action as New item in Workspace menu.
1686 4. Fiend's idle indicator do have a color that reflects its normal/collapsed
1687    state.
1689 5. The delay between changing workspaces from fiend is now a runtime option:
1691    WorkspaceChangeDelay = 700;
1693    in WindowMaker configuration file.
1695 6. Application icons can be moved between dock and fiend now.
1697 7. The way workspaces are changed is controlled now by two runtime options:
1699    AdvanceToNewWorkspace=Yes/No;
1700    CycleWorkspaces=Yes/No;
1702    Both apply to either fiend navigating buttons or to next/prev worksapace
1703    keybindings. Both default to No, and are in WindowMaker configuration file.
1705 8. Also added posibility to advance to new workspace, no matter what value
1706    AdvanceToNewWorkspace have, with Control-button1-click on "next workspace"
1707    fiend button.
1710 *** Theme support ***
1712 Spixmap and tpixmap now work. Their syntax is:
1714 SomeStyleOption = (spixmap, file, color);
1715 SomeStyleOption = (tpixmap, file, color);
1717 - spixmap means scaled pixmap, so the image in the file will be scaled to
1718 adapt to the destination's size.
1719 - tpixmap means tiled pixmap, and the image from file will be tiled in the
1720 destination.
1722 file is searched in the PixmapPath, but can be a full path name.
1724 Color is used depending on which Style option is applied.
1725 For example in case of titlebars, color is used for miniwindows titles color.
1726 You are not restricted in selecting that color, but is better to put one
1727 that matches the overall color of the image.
1729 Currently they apply to all the options that accept (solid, color), or any
1730 type of gradient.
1731 This means they also apply to WorkspaceBack and IconBack, which allows theme
1732 support with the simple use of the setstyle and getstyle utilities.
1733 There is no need for an extra theme manager, just to include the needed
1734 options in the style files.
1736 In case of WorkspaceBack, color is used to be set in the background until
1737 the image gets loaded and displayed. This is to avoid the stippled screen
1738 the X server shows, in case the image is big and loads slow.
1739 There is a small utility in the util directory, named wmsetbg which is
1740 used to set the background image. This is needed for windowmaker not to
1741 freeze while loading and scaling the image.
1742 Currently it is hardcoded in windowmaker to use wmsetbg to set the background
1743 image, and is better to use it since is smaller that other image manipulation
1744 programs, and it is compiled with support for same image types as windowmaker.
1745 Since it comes and is installed with WindowMaker, there will be no need to
1746 download and use an external app, which also may not have support for the same
1747 image types as windowmaker.
1751 --- 0.14.0
1753 *** Fiend clone.
1755 The fiend clone is a dock extender, that lets you dock more than the default
1756 10-12 icons in the dock. It actually lets you dock how many icons you like,
1757 with a current default of 25 per workspace. The fiend have different docked
1758 icons on every workspace. Also the fiend main icon shows you the workspace
1759 you're on and lets you navigate through the workspaces with the small green
1760 buttons on the low right corner.
1761 To save screen space the fiend can be collapsed to the main icon either
1762 from the fiend menu (available with right click on the fiend icons), or
1763 with a double left click on the main fiend icon, which is a toggle for
1764 the collapsed/uncollapsed state.
1765 Collapsed state is marked by a different title color.
1766 Pressing on the small buttons on the low right corner, the workspaces are
1767 changed in increments of 1 to the left or right, but keeping the button
1768 pressed over them will continuously advance through workspaces until the
1769 mouse is moved away from the buttons or the button is released.
1770 The delay between workspace changes is set by FIEND_WKS_CHANGE_DELAY in
1771 src/wconfig.h, and defaults to 700 ms.
1772 Unlike the dock, fiend can hold icons in any directions, and can be placed
1773 in any position on screen.
1775 When an icons is to be docked, but the position can be either in the dock
1776 or in the fiend, the dock will be used first, and the icon will be docked
1777 there.
1779 Here are the new runtime options introduced by the fiend:
1780 Files are located in ~/GNUstep/Defaults/
1782 In WMWindowAttributes:
1783        "Logo.WMFiend" = {Icon = "Cone.xpm";};  - icon for the fiend
1785 In Windowmaker:
1786         FiendMaxIcons = 25;           - the max number of icons in fiend per
1787                                         workspace
1788         FiendTitleFont = "-*-helvetica-bold-r-normal-*-10-*-*-*-*-*-*-*";
1789                                       - the font used to show the current
1790                                         workspace
1791         FiendTitleColor = black;      - color for the uncollapsed fiend title
1792         CFiendTitleColor = "#616161"; - color for the collapsed fiend title
1793         AFiendColor = "#00ba70";      - color for the workspace changing
1794                                         buttons, when active
1795         IFiendColor = "#008000";      - color for the workspace changing
1796                                         buttons, when idle
1798 For the ones who don't want to use fiend, there is a option to wmaker named
1799 -nofiend that can be feed to the command line when starting wmaker.
1800 (This is the equivalent for -nodock, but removes fiend clone).
1802 The syntax of WMState file have changed, but you don't have to worry because
1803 WindowMaker will know to read the old format and will save it and further
1804 will use the new one. You do not need to change your file, for the new version
1805 to work.
1808 --- 0.13.1
1810 *** Enhanced Attribute editor.
1812 Now you can save defaults for all windows.
1813 Please note that only Icon, KeepInsideScree, and sometimes NoAppIcon
1814 can be useful in a normal environment. But others may have other opinion ;)
1815 If you set AlwaysUserIcon default for all windows, note that apps like
1816 asclock, wmload, wmmail, wmrack, will show that icon instead of their
1817 window.
1819 Now Attribute editor also counts for defaults saved for all windows,
1820 (not only the default "No" for all options hardcoded in WindowMaker),
1821 when saving options for some instance.class specification. This is to
1822 save disk space by saving only the options that differs from global defaults
1823 (either defaults for all windows or the hardcoded valued in WindowMaker).
1825 Attribute Editor now updates on the fly the appicon image or creates/deletes
1826 the appicon if you set that options in the Inspector panel and Apply them.
1827 Modifying Icon file, NoAppIcon or AlwaysUserIcon and Applying them will
1828 result in the image update for the app-icon.
1830 Note that if you apply but not save these options, the miniwindow image will
1831 not be updated. This is because app-icon is always on screen so it can be
1832 updated, but miniwindow image is read from the defaults database and from disk
1833 every time you minimize the window and is destroyed when you restore.
1836 --- 0.13.0
1838 *** Atribute editor is working ;).
1840 How it works is quite obvious.
1841 Anyway, here is a short description.
1843 Save   - only save the configuration in defaults database and updates
1844          WMWindowAttributes
1845 Apply  - only applies the values to the current window
1846 Revert - reverts the values from the defaults database
1848 Note that Save and Revert count for the window specification
1849 (instance & class), that are selected, and save/use the values for/from
1850 that.
1852  The Update button will show the icon who's name was typed in the textfield
1853 If the textfield is empty, will try to use the default icon.
1854 Also saving with and empty textfield for icon, uses the default icon.
1856  The Default button will use the icon in the textfield as default icon
1857 and save that value in WMWindowAttributes (Note that in this case is no
1858 need to press the Save button!). Also if the textfield is empty it will
1859 try to use the old default icon, if available.
1861 *** Now menus are saved between sessions, or over a restart.
1863  Just stick them to the desktop, and you will find them over sessions
1864 until you close them.
1865  Please note that only the root_menu, the window switch_menu and the
1866 workspaces_menu can be saved this way.
1868 *** Changed the lousy Windoze menu behaviour.
1870 This applies to 'NextMenuBehaviour = NO;'
1872  Now the items are no more automatically selected if you launch the menu
1873 and the mouse is over some item, if you use a short click to launch the
1874 menu (shorter than the default DBL click time).
1875  If you use a longer click or keep the mouse pressed, the item under mouse
1876 will be selected after that delay, and launched when you will release the
1877 mouse button.
1878  If the click was short, a second one is needed to launch the item.
1880 *** Autoarrange icons is now a runtime option
1883 AutoArrangeIcons = YES/NO;
1884 in 'WindowMaker'.
1886 *** Added configurable horizontal resize threshold
1889   HorizontalResizeThreshold = <n>;
1891 This will make the n pixels at the exterior side of the corner handle
1892 of the resize bar to restrict to horizontal only resize.
1893 Also you can use Shift-click&drag anywhere on the corner handle to
1894 restrict the resize only to horizontal.
1895 Note that the Shift-click&drag does not depend of the configured threshold
1896 and works completely independent.
1898 *** New option for OPEN_MENU (pipe from command)
1900 OPEN_MENU | /foo/bar/script
1902 will make a menu that is dinamically constructed by /foo/bar/script
1905 --- 0.12.0
1907 *** New option for OPEN_MENU
1909 OPEN_MENU /foo/bar/pics xv -root -quit
1911 will make a menu with all files in /foo/bar/pics and precede them
1912 with EXEC xv -root -quit
1914 thus, making a menu with entries like:
1917 "marble.gif" EXEC xv -root -quit marble.gif
1918 "water.jpg" EXEC xv -root -quit water.jpg
1922 *** Multicolor gradients
1924 (mhgradient, colorX, color1, color2, color3, ..., colorn)
1925 (mvgradient, colorX, color1, color2, color3, ..., colorn)
1927 You can put any number of colors >= 2. 
1929 colorX is a special color that is used as the solid color of the
1930 texture when wmaker needs a solid color (like in miniwindow title and
1931 resizebar)
1933 *** PixmapPath format changed
1935 What used to be
1937 PixmapPath = "/usr/local/share/pixmaps:~/foobar";
1939 must now be
1941 PixmapPath = ("/usr/local/share/pixmaps", "~/foobar");
1944 *** Added OffiX DND in dock
1946 Use the "Set drop arguments..." command in the menu and put a %d
1947 where the dropped object string should be substituted, like:
1949 xedit %d
1951 *** Escape thingies for menu and dock commands:
1953 %w - substitute with current selected X window ID
1954 %s - substitute with current selection
1955 %d - substitute with last dropped object
1956 %a(some text) - opens a input box with "some text" as a title. Then,
1957 the text typed will be substituted there
1959 \r, \n - substitute with corresponding characters
1962 *** The WMState file format has changed a little.
1963 The Command field for the dock application list is now a normal string,
1964 instead of a list. So, remove the parentheses and the commas for the command
1965 and join all the parts. Example:
1967 if it used to be
1969 Command = ( xterm," -geometry", "+10+10" );
1971 then make it
1973 Command = "xterm -geometry +10+10";
1976 --- 0.10.2
1978 AutoFocus = NO; disables automatic focusing of windows
1979 when they are first mapped
1982 --- 0.10.1
1984 titlebar gradients are in a single piece now
1986 the WMDock file was merged into the WMState file. You can insert this
1987 file in WMState and set it's key to Dock. For example, if your WMDock
1988 contains:
1991         Applications = { {Command = (); }};
1992         Position = "-64,0";
1993         Lowered = NO;
1996 and WMState contains:
1999         Workspaces = ( "Workspace 1" );
2002 then you can merge both and have:
2005         Workspaces = ( "Workspace 1" );
2006         Dock = {
2007                 Applications = { {Command = (); }};
2008                 Position = "-64,0";
2009                 Lowered = NO;
2010         };
2015 The configuration format has changed!! Forget everything about the old
2016 format.
2018 dockapp was removed and the old version will not work anymore. 
2020 the dialogs require tcl/tk. they will be rewritten in plain C
2023 These are some tips for people upgrading from older versions and don't want
2024 too many unused files around. There is no problem if you decide to keep 
2025 them for a while.
2027         you can  rm -r ~/gnustep if you don't want anything from there
2029         remove the files in /usr/local/share/WindowMaker before installation
2031         the /usr/local/share/pixmaps directory can be removed