Remove unused wWindowCanReceiveFocus()
[wmaker-crm.git] / NEWS
blob2f1c7bdb1067f9e41690968dd3bd2abbf6ff8aba
2 NEWS for veteran Window Maker users
3 -----------------------------------
5 --- 0.95.X
7 New application Relaunching functionality
8 -----------------------------------------
10 There are now several ways to launch a new instance of an application with the
11 same command line that was originally used to start it.
13 1. By selecting Launch from the application's window menu.
14 2. By using the "Launch new instance of application" keyboard shortcut.
15 3. By clicking the application's appicon with the middle button.
16 4. By double-clicking the application's appicon while holding Control.
18 For example, if you have two xterms open, one started with "xterm" and one
19 started with "xterm -rv", using the Relaunch functionality on the first xterm
20 would run "xterm" and using it on the second would run "xterm -rv".  Thus
21 Relaunching can also be thought of as "cloning" an application.
23 Application Relaunching works by examining the window's WM_COMMAND property and
24 so will not work if it is not set.
26 Options to limit the window/menu title height
27 ---------------------------------------------
29 You can now set the minimum and maximum titlebar heights.
30 For example, to force all titlebars to 24 pixels execute
31 the following commands:
33 $ wdwrite WindowMaker WindowTitleMinHeight 24
34 $ wdwrite WindowMaker WindowTitleMaxHeight 24
35 $ wdwrite WindowMaker MenuTitleMinHeight 24
36 $ wdwrite WindowMaker MenuTitleMaxHeight 24
39 --- 0.95.2
41 New Resizing functionality
42 --------------------------
44 You can now use the mouse wheel and modifier keys to resize windows.
45 MOD+Wheel will resize windows vertically and CTRL+Wheel will resize
46 windows horizontally. MOD+CTRL+Wheel will resize both at the same time.
47 The resize step, or increment can be set in WPrefs in the "Window Handling"
48 page, or in the config file with "ResizeIncrement". If this intrudes into
49 a specific application's functionality, you can disable it on an application-
50 by-application basis by setting the "Do not bind mouse clicks" attribute in
51 "Advanced Options".
53 New Maximize functionality
54 --------------------------
56 Maximus/Maximumize. A new tiled maximization, configured with a keyboard
57 shortcut. Using it will maximize the window to the greatest area such that it
58 will not overlap any other window of the same workspace. This can be configured
59 in WPrefs in the "Keyboard Shortcuts" page, or in the config file with
60 "MaximusKey".
62 Left/right maximization. Now wmaker supports maximizing a window to the
63 left or right half of the screen, making it occupy 50% of the area. This is
64 useful on widescreen displays where you want to bring up two windows side-by-
65 side. The shortcut keys for this can be configured in WPrefs in the "Keyboard
66 Shortcuts" page, or in the config file with "LHMaximizeKey" and "RHMaximizeKey"
68 History and AutoComplete in the run dialog
69 ------------------------------------------
71 The "Run..." dialog now autocompletes executables in your path (triggered by
72 the TAB key) and records the history of past commands (last 500 by default).
73 It can also complete folder names if you start the complete with a "/"
74 To use it replace %a with %A in the "Run..." entry in your WMRootMenu file.
75 See commit 05720d97076ffc1569e5 for more details.
77 Automatic menu generator (wmgenmenu)
78 -----------------------------------
80 There is now a new utility to generate the Window Maker menu automatically,
81 called wmgenmenu. It searches from a list of pre-defined applications the
82 ones which exist in your $PATH and adds them to the corresponding submenus
83 ("Internet", "Terminals", "Editors" etc) of your WM menu. It also supports
84 localization (currently English and German). You can use it like:
86 $ wmgenmenu > WMRootMenu-new
87 $ cp WMRootMenu-new $HOME/GNUstep/Defaults/WMRootMenu
89 and WM will automatically detect the new menu file and use it without
90 restarting wmaker (made possible by the 'inotify' mechanism)
92 Automatic detection of menu changes (via inotify)
93 -------------------------------------------------
95 Window Maker now uses the 'inotify' mechanism from the linux kernel
96 to automatically detect changes in the WMRootMenu file. So the
97 --no-polling option is now gone and Window Maker does not wake up
98 your CPU unnecessarily (0 wakeups when idle, instead of 4).
99 So if you edit the WMRootMenu file by hand (or by using 'wmgenmenu'),
100 there is no need to restart wmaker for the changes to take effect.
102 DockApp recognition
103 -------------------
105 In addition to applications with only Withdrawn windows, Window Maker
106 will now treat any application with its WM_CLASS res_class set as
107 "DockApp". This provides an easy workaround for toolkits like gtk+ that
108 do not allow creation of windows with the initial_state member of
109 XWMHints set to WithdrawnState.
112 --- 0.92.0
114 GNUstep Installation Directory
115 ------------------------------
117 WPrefs is now installed in /usr/local/bin and /usr/local/share by default.
118 If you use GNUstep and want it to install in /usr/GNUstep/Applications,
119 you may specify --with-gnustepdir=/usr/GNUstep
120 If the GNUSTEP_LOCAL_ROOT environment variable is defined when configure is
121 executed, it will be used (and you don't need to use --with-gnustepdir)
123 Cached Pixmaps Directory
124 ------------------------
126 The directory where Window Maker stores the cached application pixmaps for
127 its later use has changed from ~/GNUstep/.AppInfo/WindowMaker to
128 ~/GNUstep/Library/WindowMaker/CachedPixmaps for better compatibility with
129 the GNUstep path structure.
130 Also WPrefs now stores internal data in ~/GNUstep/Library/WindowMaker/WPrefs
131 (it was ~/GNUstep/.AppInfo/WPrefs before)
133 X Input Methods support in WINGs
134 --------------------------------
136 Preliminary support for X Input Methods was added to textfield and text
137 widgets in WINGs. Input for text in other languages than English should
138 work now (except for kanji which will most likely not work, even though
139 it wasn't tested).
142 Disabling the switch panel
143 --------------------------
145 To disable the panel shown during Alt-tabbing, you may put the following in
146 ~/GNUstep/Defaults/WindowMaker
148 SwitchPanelImages= None;
152 --- 0.91.0
154 Alt-Tab Window Switching
155 ------------------------
157 You can change the appearance of the panel shown during Alt-Tab window switching
158 with the SwitchPanelImages option:
160  (selected_icon_tile_image, background_image, width, height)
162 selected_icon_tile_image is the image used to highlight the currently selected
163 window icon. It must be 64x64 pixels.
165 background_image is the image used in the background of the panel. It must
166 be at least 64x80.
168 width and height are the width and size of the central part of the image.
169 When drawing the panel, the image will be split as:
170                            |W |
171                         +--+--+--+
172                         |  |  |  |
173                         +--+--+--+ -
174                         |  |  |  | H
175                         +--+--+--+ -
176                         |  |  |  |
177                         +--+--+--+
179 The 4 corner images will be copied in their original sizes and the rest will
180 be scaled to the final panel size.
182 background_image, width and height are optional. If you leave them out,
183 a gray panel will be used. If your machine is not very fast, you may want 
184 to use it.
187 --- 0.90.0
190 NetWM / EWMH Support
191 --------------------
193 Support for the EWMH standard has been added. Applications from GNOME 2.x and
194 KDE 3.x should now interoperate better with Window Maker.
196 Support for the obsolete/legacy GNOME 1.x, KDE 1.x and OpenLook(!) hints was
197 wiped out for the sake of sanity.
200 Antialiased font support
201 ------------------------
203 With the addition of Xft2 support in the WINGs library, now
204 Window Maker can display antialiased text with TrueType or any scalable fonts.
206 You can pick fonts for Window Maker in the Font configuration section of 
207 WPrefs.
209 Antialiased text is enabled by default, but can be disabled by adding
211 AntialiasedText = NO; in ~/GNUstep/Defaults/WMGLOBAL
213 This will disable antialiased text for any WINGs based application. If you
214 only want to disable them for a specific application only, like WindowMaker
215 for example, then add the same option in the applications configuration file,
216 in this case ~/GNUstep/Defaults/WindowMaker
217 For WindowMaker, this can also be achieved from the Expert panel in WPrefs.
219 Note that bitmapped fonts look much better than TrueType when antialiasing is
220 disabled.
222 Global Submenus
223 ---------------
225 Global menus allow for system wide menus that are added to every users
226 application menus. They are located in /usr/etc/WindowMaker/,
227 /usr/local/etc/WindowMaker or whatever is your sysconf directory
228 for WindowMaker. There are 2 files:
230 GlobalMenu.pre, which is added to the beginning of the menu and
231 GlobalMenu.post, which is added to the end of the menu.
233 These are to be proplist format menus, for example:
235 (("Foobar", EXEC, foobar),
236  ("Blabla", EXEC, blabla))
238 or, in case you want a submenu:
240 (("Submenu", 
241         ("Foobar", EXEC, foobar),
242         ("Blabla", EXEC, blabla)))
245 UTF-8 Support
246 -------------
248 Window Maker now uses UTF-8 internally (and thus can display UTF-8 text
249 in window titles and other places). Menus and po files must now be
250 encoded in UTF-8. If your menus contain non ASCII characters, you can convert
251 them to UTF-8 with the following command:
253 iconv -f <current-file-encoding> -t utf-8 <filename> > <filename>.utf8
255 For example:
257 iconv -f iso-8859-1 -t utf-8 menu > menu.utf
258 mv menu.utf menu
261 Icon Panel for Alt-Tabbing
262 --------------------------
264 A panel with icons for the windows that you can switch to will appear
265 when you press Alt-Tab. You can navigate through the windows with Alt-Tab
266 (Alt-Shift-Tab) or with the left/right keys once the panel is shown.
270 --- 0.80.0
272 Shading/Unshading windows using mouse wheel on their titlebar
273 -------------------------------------------------------------
275 In addition to the known methods of shading/unshading a window,  one can now
276 do this by using the mouse wheel on the window's titlebar. The mouse events
277 are interpreted via a mapping in the global WINGs configuration file,
278 WMGLOBAL, by the MouseWheelUp and MouseWheelDown directives which will do
279 shading and unshading respectfully.
281 However, to avoid unwanted triggers of shading/unshading the window, two
282 consecutive mouse wheel events in the same direction are required. The
283 trigger won't occur if the events are separated by more than a double-click's 
284 worth of time, which is technically speaking like making a double-click with
285 the button that corresponds to the mouse wheel direction.
287 Practically speaking, this means that you have to move the mouse wheel up
288 or down quickly, like when you want to quickly scroll over something big.
291 Shared application icons
292 ------------------------
294 Real application icon sharing was implemented in place of the collapse
295 appicon thing. With this applications of the same instance.class will
296 have a single shared application icon and hiding will hide all windows
297 of the aplications attached to that appicon as if there is a single
298 application. This feature is enabled by default for all applications in
299 the global WMWindowAttributes defaults domain using:
301 "*" = {SharedAppIcon = Yes;};
303 If you're not satisfied with this or want the old behaviour back you
304 can revert this (either in the global domain for all users or in your
305 personal WMWindowAttibutes domain) using SharedAppIcon = No; for "*"
306 It can also be enabled/disabled for individual applications as needed.
308 Setting this option can be done using the window's inspector panel in the
309 "Application Specific" section. You can set/unset it for all applications by
310 using the "Defaults for all windows" in the "Window Specification" section
312 Basically using this can have 2 major scenarios:
313 1. Leave it on by default, but disable it for the few specific
314    applications that do not behave well with it. (default)
315 2. Leave it off by default, and enable it for all applications for
316    which you want it enabled.
318 At this point all applications we tested work ok, some of them even
319 work better with this feature turned on: for example xmms and Corel's
320 WorkPerfect8 now only have 1 appicon (they used to have 2 without this
321 feature).
323 This feature is turned off by default for the following applications
324 because it's incompatible with them:
325 1. all GNUstep applications
326 2. applications with an application menu (wterm, Aileron, etc)
327 3. all applications with withdrawn windows only (this means all dockapps)
329 As a side note: wterm can use the shared appicon feature as long as it
330 doesn't use the appmenu (will do this by default). If you start it
331 using the appmenu (wterm -wm) it will disable the shared appicon
332 feature because apps with appmenus are incompatible with this feature.
334 If an application is a GNUstep application or if it has an appmenu, it's
335 detected automatically and the shared appicon is disabled automatically
336 without any user intervention or need to configure anything.
339 Dock/Clip stealing appicons
340 ---------------------------
342 This feature is different form the Clip's "Autoattract Icons" feature
343 as it won't attach any new icon to the dock/clip.
344 What it does, is when you start an application by other means than
345 dock/clip, like for example using the main menu or a terminal, it will
346 search the dock/clips for the presence of an appicon for that
347 application, that is not already running at that moment and will attach
348 the started application to that appicon in the dock/clip if available,
349 making it look like the dock/clip just stole the appicon for the started
350 application. There is an animation for this to offer visual feedback
351 that this happened.
355 --- 0.70.0
357 New dock option
358 ---------------
360 Copy/paste launch in dock.
361 ==========================
363 For example, put netscape %s in the Docked icon for Netscape, select an url
364 somewhere and then middle-click the icon. The command will be launched with
365 the "pasted" string.
368 Xinerama Support
369 ================
371 Supported Xinerama features:
373 - Normal maximization of windows will maximize to only one of the screens,
374 the one where the cursor pointer is.
376 - Full Maximize command in window menu
378 - Place dialogs in the middle of the head where the pointer is
380 - Try to place windows inside one head in non-manual placement modes
383 Less dependancies
384 -----------------
386 starting with 0.70.0 libPropList is no longer required to build Window
387 Maker. PropList handling code was added to WINGs being now better
388 integrated with all the rest. For more details check the Changelog and the 
389 following files:
390 ./WINGs/ChangeLog
391 ./WINGs/NEWS
392 ./WINGs/WINGs/WUtil.h
393 ./WINGs/WINGs/proplist-compat.h
397 --- 0.65.1
399 Removed FocusFollowMouse option, only SloppyFocus present now.
401 Added None option to MoveDisplay and ResizeDisplay
405 --- 0.65.0
407 Single AppIcon
408 --------------
410 Removed --single-appicon patch and replaced it with a application
411 specific collapsing option. Check inspector panel and appicon menu.
413 New options to configure the workspace mouse actions
414 ----------------------------------------------------
416 The following options were removed from the WindowMaker defaults configuration
417 file:
419 SelectWindowsMouseButton, WindowListMouseButton and ApplicationMenuMouseButton.
421 They were replaced with the following 3+1:
423 MouseLeftButtonAction, MouseMiddleButtonAction and MouseRightButtonAction plus
424 MouseWheelAction
426 In the old way because all gravitated around the workspace actions to which
427 specific mouse buttons could have been bound, it allowed one to specify in
428 the configuration file settings which would have led to weird situations
429 that also had undesirable results.
430 For example the same mouse button (for example left) could have been
431 assigned to all workspace actions: 'select windows', 'show window list menu'
432 and 'show applications menu' which of course were not only impossible to
433 accomplish while still having a properly working workspace, but they also
434 allowed one to specify some settings in the configuration file that were
435 never in fact translatable to proper workspace actions.
437 To void this kind of user interface inconsistency, the new options now
438 gravitate around the physical device (the mouse and its buttons) to which
439 specific workspace actions can be bound. This way, even if one assigns the
440 same action to all mouse buttons, that situation while gives redundant and
441 unpractical settings it will still translatable to proper workspace actions:
442 all buttons will execute the same action, but a button will execute only one
443 action at a time.
445 The new options take the following values:
446 all Mouse...ButtonAction can have one of the following values:
448 None, SelectWindows, OpenApplicationsMenu or OpenWindowListMenu
450 MouseWheelAction can be one of None or SwitchWorkspaces
452 If you had the default actions bound to mouse buttons before, then it will
453 work for you without any intervention in the configuration files.
454 Else you need to use WPrefs.app to bind the actions to the mouse buttons
455 again to your old settings. Also if you want to change the mouse wheel
456 behavior regarding workspaces you can now (use WPrefs.app to do this).
458 Client supplied icons
459 ---------------------
461 Window Maker saves the client supplied icons in 
462 ~/GNUstep/Library/WindowMaker/CachedPixmaps in XPM format for later use 
463 when the app is no longer running (to have the image to display for docked 
464 icons for example).
466 Until recently the XPM images saved by Window Maker were incorrect, but a
467 recent fix in the code to save XPM's fixed them. But with this fix, all
468 previously saved XPM's in that directory are no longer readable (they give
469 wrong images on screen or fail to load).
471 To avoid the need for the user to fix this by hand editing WMWindowAttributes 
472 and removing all references to icons in ~/GNUstep/Library/WindowMaker/CachedPixmaps 
473 which can be annoying, new code was added to Window Maker to permit the 
474 regeneration of images in ~/GNUstep/Library/WindowMaker/CachedPixmaps if they are missing.
476 With this addition, all you need to do to fix your old broken images, is to
477 delete all *.xpm files from ~/GNUstep/Library/WindowMaker/CachedPixmaps. Next time the
478 application that is supplying an icon image will start the icon will be
479 recreated if missing, but this time it will be saved with the new XPM save
480 code which produces good XPM images.
481 All the rest of the process is transparent to the user.
483 Hermes library support
484 ----------------------
486 If configure finds hermes library (an optimized pixel format conversion
487 library) installed it will use it to do the pixel format conversion in
488 the wraster library for some cases (TrueColor visuals without dithering).
489 Currently the hermes routines cannot convert to an indexed destination,
490 so we can't use hermes for PseudoColor, GrayScale and StaticGray visuals.
491 Also hermes only does dithering for just 2 combinations of source/destination
492 bits/masks none of them useful to out needs so for dithering we still
493 use out routines.
495 The Hermes library is completely optional, you can build Window Maker
496 without having it, it just speeds up the things a little for some
497 situations.
499 hermes library is available here: http://www.clanlib.org/hermes/
502 --- 0.64.0
504 No Polling of Configuration Files
505 ---------------------------------
507 Running Window Maker with one of -nopolling or --no-polling command line
508 options will make it not to poll every 3 seconds for changes in its
509 configuration files (good for laptops to let them spin disks down when idle).
511 Note:
512 For the ones used with Jim Knoble's 'no polling' patch, this is the same,
513 except that the need to #define ENABLE_NO_POLLING in wconfig.h was removed
514 and the behaviour is always available if you use the command line option.
517 --- 0.63.0
520 Interwoven Gradient
521 -------------------
523 interwoven gradients rip^Winspired on blackbox. Will render a texture that
524 interweaves 2 different ones.
526 (igradient, from1, to1, thickness1, from2, to2, thickness2)
528 Will render a interwoven texture with the 2 specified gradients,
529 with each section having the specified thickness.
531 wmagnify
532 --------
534 The wmagnify utility will magnify the area on teh screen where
535 your mouse pointer is located, updating it in real-time.
537 tip: maximize it horizontally, make it Omnipresent and Always at Bottom.
538 Then leave it in the bottom of the screen.
540 workspace border
541 ----------------
543 2 options (WorkspaceBorder and WorkspaceBorderSize) were added to allow one to
544 set a small (0..5 pixels) border for the workspace. This border will not be
545 covered by windows when maximizing, allowing one to easily access the clip
546 or map a menu using the mouse in the border area, even when there are
547 windows maximized in both horizontal and vertical directions.
548 WorkspaceBorder can be one of (None, LeftRight, TopBottom, AllDirections)
549 while WorkspaceBorderSize is the size in pixles of the border not to be
550 covered by windows when maximizing (usually a small amount 0..5 pixles).
552 Both options can be set using WPrefs.app in the "Miscelaneous Ergonomic
553 Preferences" section. WPrefs will always limit WorkspaceBorderSize in the
554 (0..5) range.
556 Note that if "full screen maximization" option is set for a window, that
557 window will ignore this border area, maximizing to full screen.
560 --- 0.62.0
563 Optimizations!!
564 ---------------
566 Code for converting wrlib images into X Pixmaps was optimized in many ways,
567 both in the original C code and in assembly for Pentium(tm) processors (with
568 and without MMX(tm)). Depending on the bit depth/color mode and CPU model,
569 performance increases can go up to 150%
572 Weendoze Window Cycling (alt-tab)
573 ---------------------------------
575 Window cycling was changed to weendoze style. 
578 NoBorder Window Attribute
579 --------------------------
581 The NoBorder window attribute (to be put in
582 ~/GNUstep/Defaults/WindowAttributes) was added and will remove the
583 1 pixel border around windows.
586 Removed "Keep Attracted Icons" option from Clip's menu
587 ------------------------------------------------------
589 Since this option brought more confusion than usefulness among users, and
590 since it was usable only in a very limited context, being able to fill up
591 the Clip very easily, it was removed.
592 An alternative way of gaining the same functionality is to use the "Keep icon"
593 entry in the Clip's main menu. Or select multiple icons before calling that
594 entry, to make it apply to more than one icon.
596 Note: "Keep icon", as the obsoleted "Keep Attracted Icons" had nothing to do
597       with holding icons in Clip, while the application is running. Once they
598       are attracted, they are kept until the application close. Using
599       "Keep icon", will only assure that the icon will be kept, even after the
600       application is closed.
602 Please don't ask for this option back. It's error prone, and very unintuitive.
603 Considering it's very restrictive usability, and it's very ambiguous topic, it
604 does not need a special entry in the Clip's menu, taking in count that there
605 are already better alternative ways of gaining the same functionality.
608 Removed DisplayFont Option
609 ---------------------------
611 The font for the geometry size will be controlled by the default
612 WINGs font (SystemFont in WMGLOBAL) now.
615 Others
616 ------
618 - added DONT_SCALE_ICONS compile time option
619 - added --dont-restore cmd line option. When passed to wmaker, it
620   wont restore the state saved previously.
622 --- 0.61.1
624 New libPropList
625 ---------------
627 new libPropList-0.9.1 is REQUIRED to build Window Maker 0.61.1.
628 go grab it and install it first.
631 --- 0.60.1
634 Window Edge Attraction
635 ----------------------
637 Window edge attraction was now added.
639 Attraction = YES/NO;
641 will enable/disable gravity to edge's boder.
642 The strength of gravity can be controled by modify `EdgeResistance' value
643 in WindowMaker configuration file.
646 Titlebar Draw String Plugin
647 ---------------------------
649 FTitleColor, UTitleColor, PTitleColor, MenuTitleColor can be assigend with
650 drawstring plugin instead of plain color. For example:
652     FTitleColor = (
653         function,
654         libwmfun.so,
655         drawPlainString,
656         gold,
657         black,
658         gray49
659     );
661 will invoke function drawplainstring from libwmfun.so and pass 3 colors for
662 arguments. To code new plugin, please see plugin.h for more informations.
665 --- 0.60.0
668 User Menu
669 ---------
671 The user menu is now a compile time option disabled by default. 
672 Supply --enable-usermenu to configure to enable it.
675 root menu INCOMPATIBLE changes
676 ------------------------------
678 EXEC <program> will execute the named program
680 SHEXEC <command> will execute the shell command.
682 If you want to execute something like blabla > /dev/null, then use SHEXEC
684 Dont forget to update your menus.
687 New Option For setstyle
688 -----------------------
690 The --ignore flag will tell setstyle to not change the option that is
691 specified, when modifying the Window Maker configurations. For example:
693 setstyle --ignore MenuStyle sometheme.themed will cause the MenuStyle
694 option to not be changed.
696 setstyle --ignore FTitleBack --ignore UTitleBack --ignore PTitleBack bla.themed
697 will load the theme, but keep the titlebar background related options as
698 before.
701 MultiByte Text Support Changes
702 ------------------------------
704 The --enable-kanji configure option is not needed anymore and was removed.
705 To enable support for multibyte text, you must:
706 - set the LANG environment variable to the appropriate value
707 - change the font configurations to contain font sets in the appropriate
708   encodings in both ~/G/D/WindowMaker and ~/G/D/WMGLOBAL (for WPrefs)
709 - set the MultiByteText option to YES in both of the above files
712 New Options
713 -----------
715 WorkspaceNameDisplayPosition =
716 none/center/top/bottom/topleft/topright/bottomleft/bottomright
719 SmoothWorkspaceBack = YES/NO
721 will enable smoothing of scaled workspace background images.
725 Application User Menu Path Changes
726 ----------------------------------
728 Default configuration for user specific menus installed in
729 /usr/local/share/WindowMaker/UserMenus or $(datadir)/WindowMaker/UserMenus
730 and ~/GNUstep/Library/WindowMaker/UserMenus.
733 Omnipresent icons in Clip
734 -------------------------
736 Added ability to set icons docked in Clip to be omnipresent on all workspaces.
737 To set/reset this flag use the clip menu.
738 The Clip menu changed in the following way:
739  - if you bring up the menu from the Clip's main icon, it will contain as
740    before the "Rename Workspace" entry in the second position.
741  - however, if you bring up the menu from any other icon in clip, the
742    "Rename Workspace" menu entry is replaced by "Omnipresent" or
743    "Toggle Omnipresent" depending on the context.
745 This entry will work in the following way, depending on the context:
747 1. If there is no icon selected in the clip, then the menu will contain the
748    entry named "Omnipresent" which will be checked accordingly to the current
749    state of the icon (omnipresent or not), and will let you change the
750    omnipresent state of the icon you brought the menu from.
751 2. If one or more icons are already selected when the Clip menu is called, the
752    entry will be named "Toggle Omnipresent" and will apply to all selected
753    icons trying to toggle their omnipresent state. The icons which will be
754    succesfully changed to their new state as requested, will be unselected,
755    while the ones that will fail for some reason to gain their new state,
756    will remain selected.
758 In both cases if there is no success in setting what user requested a panel
759 will inform user of the failure.
760 (Note: trying to set an icon to not-omnipresent will never fail. Failures can
761        be met only when trying to set omnipresent for an icon).
763 The icons set to omnipresent will be marked with a triangle in the upper left
764 corner, having the color of the IconTitleColor.
766 An icon can be set to omnipresent, only if its position is free in all the
767 workspaces, else you will be informed of the problem and asked to fix it first.
768 Also when dragging an omnipresent icon around in Clip, all the icons docked in
769 all the workspaces are shown while the dragging is done, to let one easily see
770 where are free slots in all workspaces.
772 For advanced users, there is also a shortcut to set/reset the omnipresent
773 state of an icon: just use "Shift+MiddleButton" (button2) on the icon you want
774 to change.
775 In this case only the mark in the upper left corner will appear in case of
776 success, or nothing will happen if icon cannot be made omnipresent (advanced
777 users are expected to know why the icon failed to be made omnipresent, so they
778 don't need a panel to explain them why ;) ).
780 Now before you load your gun to start a flame war because this is against your
781 principles you love so much, please sit down and think that this is a feature,
782 which, if you don't use, the old behaviour of the Clip is totally preserved.
783 It just adds some extra capabilities to the Clip for people who think that this
784 is useful.
787 XDND drop on dock support
788 -------------------------
790 Support for XDE on dock is now replaced by XDND.
791 To enable, edit src/wconfig.h
795 --- 0.53.0
797 New Options
798 -----------
800 ** MenuStyle
802 MenuStyle=<style>; will change the menu texture style.
804 <style> can be:
805 normal (default): for the traditional one texture per item, with bevels in 
806 each
808 singleTexture: for a single texture that spans the whole menu, with bevels
809 in each item
811 flat: singleTexture without the bevels
814 ** ResizebarBack
816 ResizebarBack=<texture>;
818 where <texture> is any of the textures you normally use in titlebars and
819 other places.
821 If the style file/theme does not contain a ResizebarBack option, setstyle
822 will automatically hack it so that wmaker will make the theme work like 
823 before.
826 New crash dialog panel
827 ----------------------
829 From now on, whenever a fatal situation appears, Window Maker will display a
830 dialog panel to the user and let him choose what to do.
831 The options are:
832 - Abort and leave a core file (usefull for debugging and getting backtraces)
833 - Restart Window Maker (default behaviour)
834 - Start alternate window manager (the one defined as fallback, or if not
835   possible fvwm or twm in this order).
837 If it will not be able to restart or start the alternate window manager, it
838 will abort and leave the core file.
841 Application User Menu
842 ---------------------
844 Applications with an appicon can have a user defined menu.
846 This menu will emulate keyboard events, and will be sent to the applications'
847 window(s), thus the application must accept key combinations (CTRL+N for
848 instance).
850 To enable this feature, #define USER_MENU in src/wconfig.h and place menu
851 files in ~/GNUstep/Defaults/UserMenus (/usr/local/etc/WindowMaker/UserMenus
852 globally).
854 The user menu is in PropList format and the filename is in:
855 <instance name>.<class name>.menu or application's main window.
856 (Example: the menu for xcalc would be - xcalc.XCalc.menu)
858 Example user menu syntax:
861   "Calculator",
862   ("Put 1", SHORTCUT, "2"),
863   ("Functions",
864     ("Put 2", SHORTCUT, "2"),
865     ("Put 3,4 and 5", SHORTCUT, (3,4,5))
866   ),
867   ("Exit", SHORTCUT, "Control+q")
872 --- 0.52.0
875 Appearance Editing in WPrefs
876 ----------------------------
878 Added Appearance/Texture editing capability in WPrefs. Workspace background
879 selection is not yet finished.
882 Themes
883 ------
885 Removed all themes from the source tree, and moved them in a separate package.
886 You can download the new package from the same place as this package:
887 ftp://ftp.windowmaker.info/pub/beta/srcs/
888 Look after WindowMaker-extra-<version-number>.tar.gz
889 Also WindowMaker-extra pack include the old WindowMaker-data.tar.gz which only
890 contained icons.
891 Look for the greatest version number when you download this package.
894 get-wraster-flags script change
895 -------------------------------
897 The name of the options passed to get-wraster-flags changed, to allow a better
898 name compatibility with the naming conventions used by other software.
899 The name change was as follows:
900 --lflags was changed in --ldflags
901 To allow backward compatibility, with already written software, the old
902 --lflags option is still recognized, but you are encouraged to move the the
903 new --ldflags.
907 --- 0.51.2
910 New Themes
911 ----------
913 Added 2 new cool themes (actually I added in 0.51.1, but forgot
914 to put it here...) from largo (LeetWM) and BadlandZ (STEP2000).
917 Full Screen Maximization
918 ------------------------
920 The FullMaximize window attribute will allow the window to
921 be maximized to the full size of the screen (ignoring anything
922 like titlebar, resizebar, dock, panels etc). It should be usefull
923 for programs that must use the whole screen, like games or things 
924 like presentation programs.
927 --- 0.51.1
929 KDE Application Menu script
930 ---------------------------
932 wkdemenu.pl is a converter from KDE application menu structures to wmaker 
933 menu that can be used as a piped menu. Look wkdemenu.sh for how to use it.
936 Window Edge Resistance
937 ----------------------
939 Window edge resistance was now added. No, feature freeze hasn't been
940 removed. Its just part of the edge resistance rewrite ;)
943 New Theme
944 ---------
946 Added SteelBlueSilk theme
948 Installation Path Changes
949 -------------------------
951 Default configuration data installed in /usr/local/etc/WindowMaker
952 or $(sysconfdir)/WindowMaker
955 --- 0.51.0
957 Window Maker has become a GNU program (part of the GNU Project).
959 Title text drop shadow
960 ----------------------
962 drop shadow option added for titlebar text. This is a compile time 
963 option which needs to be defined in src/wconfig.h after you run
964 configure and before you run make.
966 New options and syntax for your WindowMaker domain file are:
968   Shadow = yes/no;
969   FShadowColor = <color>;  
970   PShadowColor = <color>;
971   UShadowColor = <color>;
972   MShadowColor = <color>;
974 The shadow option is dynamic (no need for a restart).
975 MShadowColor is for the menu title text.
977 libPropList
978 -----------
980 WARNING!!! libPropList was removed from the Window Maker distribution
981 and is being distributed separately. If you dont have it installed yet,
982 get it from ftp.windowmaker.info/pub/libs and install before building
983 Window Maker.
986 signal handling change
987 ----------------------
988 SIGHUP will exit wmaker instead of restarting it!!! This is because
989 GNOME expects the window manager to exit instead of restarting...
990 Complaints should go to gnome people. SIGUSR1 will restart wmaker now.
993 script change
994 -------------
995 WINGs-flags was removed, and replaced by get-wraster-flags.
996 Please remove WINGs-flags from your system, since it was obsoloted by
997 get-wraster-flags.
998 Continuing to use WINGs-flags can lead to hazardous effects, since is no
999 longer updated.
1002 docklib
1003 -------
1005 docklib is a little library for making dock applets. It's in the
1006 docklib-0.0.tar.gz file. Unpack it and read the README file there.
1009 Option Changes
1010 --------------
1012 Removed OnTopTransients option
1014 Added OpenTransientOnOwnerWorkspace
1017 Olwm Hint Support
1018 -----------------
1020 OPEN LOOK(tm)/olwm hints support was added.
1022 Read the appropriate section in the README file.
1026 --- 0.50.1
1028 New option for WorkspaceBack. mpixmap is the same as spixmap, but
1029 it will scale the pixmap by keeping the aspect ratio (maximize or maxpect).
1030 The option only works for workspace backgrounds.
1032 Also added IGNORE_PPOSITION compile time flag, which is equivalent
1033 to NoPPosition from fvwm. 
1038 --- 0.50.0
1041 KDE and GNOME
1042 -------------
1044 Added full support for GNOME and KWM hints. 
1045 Read the INSTALL file to see how enable them.
1047 Everything in the so called GNOME window manager bla bla bla pseudo-spec is
1048 implemented.
1050 As for KDE stuff, it implements 90% of everything kwm does, adds some
1051 Window Maker specific extensions to it and still uses half of the memory
1052 kwm does, which should be enough to let you dump kwm ;) For details on what
1053 exactly is implemented, see comments in src/kwm.c Read the README.KDE file 
1054 for more information.
1057 WARNING: Some KDE hints are badly designed, so doing things like using
1058 kpanel's desktop switcher/pager and Window Maker's internal workspace
1059 management functions to create, destroy and rename workspaces at the same 
1060 time might cause unknown effects. To be on the safe side, only
1061 use either of them to manage workspaces. Switching workspaces is hopefully,
1062 safe, so you can switch workspaces from wherever you want.
1066 Workspace Specific Background Images
1067 ------------------------------------
1069 Use the WorkspaceSpecificBack to set background images for specific
1070 workspaces. The WorkspaceBack is used as the default background image.
1072 Example:
1074 WorkspaceSpecificBack = ((solid, red), (cpixmap, ship.jpg, gray), (), 
1075                                 (dgradient, red, blue))
1077 This will set the background image of workspace 1 to (solid, 0),
1078 2 to ship.jpg and 4 to a gradient. Workspace 3 and other workspaces
1079 will have the image defined by WorkspaceBack.
1081 Note that this uses quite some memory...
1084 setstyle/getstyle
1085 -----------------
1087 setstyle now accepts the -nofonts flag, which will load the style
1088 file ignoring all font related options.
1090 Example:
1092 setstyle -nofonts Blabla.style
1095 getstyle can be used to create theme packs. See the usage in the
1096 WindowMaker/README.themes file.
1100 New Texture Type
1101 ----------------
1103 Textured gradients will tile a texture pixmap and combine it with a gradient, 
1104 using an arbitrary opaqueness. 
1106 Syntax is (thgradient, <file>, <opaqueness>, <color1>, <color2>)
1107           (tvgradient, <file>, <opaqueness>, <color1>, <color2>)
1108           (tdgradient, <file>, <opaqueness>, <color1>, <color2>)
1109 where:
1110 <color1> and <color2> are the colors for the gradient,
1111 <file> is the texture file and
1112 <opaqueness> is the opaqueness to merge the texture witht the gradient,
1113 ranging from 0 to 255.
1115 Example:
1117 (thgradient, "BlueImage.jpeg", 120, white, black)
1119 The BlackTexture style and Checker theme are examples.
1121 Hints:
1123 You can use any type of pixmap file for this, but small (like 64x32)
1124 grayscale pixmap files should get the best results (fast and low memory
1125 usage). You can use color pixmaps, but it is harder to get the desired effect
1126 with them.
1128 Be warned that this texture type is the slowest.
1132 New Options
1133 -----------
1135 IconTitleBack and IconTitleColor control the color of the
1136 miniwindow title. Both of them are colors.
1138 Example:
1139 IconTitleColor=white;
1140 IconTitleBack=black;
1143 Since this introduces an incompatibility in themes and getting flamed by the
1144 themes ppl isn't the most pleasant thing ("Whaddafuk you're thinking!? You
1145 just broke 500 themes!!!" ;) the setstyle command was hacked so that it will
1146 make old themes work as before, by trying to automatically set the above
1147 options. Note that in some cases it will not have exactly the same results as
1148 before.
1151 StartMaximized window attribute. Will maximize the window when it
1152 is mapped.
1155 AutoRaiseLower option for the Clip. This allows automatic Raise/Lower of the
1156 Clip icons when the mouse pointer enter/leave the Clip. To avoid unwanted
1157 raising/lowering there is a time threshold before raising/lowering.
1158 The thresholds can be changed in wconfig.h by changing one or both of
1159 AUTO_LOWER_DELAY and AUTO_RAISE_DELAY (expressed in miliseconds).
1160 For example if you set AUTO_RAISE_DELAY to 0, then the Clip will be raised as
1161 soon as the mouse pointer enters it's area. Setting AUTO_RAISE_DELAY to a very
1162 big value, will make the Clip to practically do not auto raise unless clicked,
1163 but to be automatically lowered after AUTO_LOWER_DELAY (ms) when leaved.
1166 New ThemePack Format
1167 --------------------
1169 Starting with this version, a new format of themes is being supported.
1170 Before you open pine and start composing your flame, rest assured that
1171 the old format is still supported. The new format is documented
1172 in the WindowMaker/README.themes file.
1175 Root Menu 
1176 ---------
1178 The -noext option for OPEN_MENU will strip whatever is after the last .
1179 in file names that appear on the opened directory. So,
1181 OPEN_MENU ~/bg WITH xv -root -quit
1183 will create a menu with all the images in ~/bg without the extension.
1187 --- 0.20.3
1190 Icon (miniwindow) stacking
1191 --------------------------
1193 If you want miniwindows to reside under normal windows, edit
1194 wconfig.h and change WNormalLevel (just grep for it) to
1195 WDesktopLevel
1198 5 Button Mouse
1199 --------------
1201 If you have a 5 button mouse and want to give some utility for
1202 the extra 2 buttons, edit the appropriate line in src/wconfig.h
1203 Clicking Button4 in the root window will switch you to the previous 
1204 workspace and Button5 will do that for the next.
1207 Option Changes
1208 --------------
1210 put NoWindowOverDock back
1212 KeepOnBottom window attribute
1215 -static command line option
1216 ---------------------------
1218 wmaker -static will start Window Maker in static mode. This will
1219 prevent wmaker from checking or making any configuration changes.
1220 That makes it possible to run wmaker before running wmaker.inst
1223 Hysteresis for menu item selection
1224 ----------------------------------
1226 Hopefully it's intelligent enough, so you won't notice it.
1228 In case you want to know what's it, it's equivalent to that
1229 (insanely long) 2 second delay present in that Windoze95 menu, 
1230 but more usefull than annoying (I hope :). To see it, do the following
1231 with your current wmaker version and later with 0.20.3:
1233 - open the apps menu and stick it
1234 - click in the item for the "Workspaces" submenu and hold
1235 - drag the mouse to the 4th or bigger entry (like "Workspace 4") in a
1236 straight line, trying to select the target item before the submenu
1237 is unmapped when you dragged over other items in the main menu
1241 Window Shortcuts
1242 ----------------
1244 Window shortcuts are shortcuts to arbitrary windows. You can make up to 4
1245 shortcuts. To assign a previously bound shortcut to a window use the "Select
1246 Shortcut" submenu in the window commands menu. If the shortcut is not yet
1247 assigned for any window, you can hit the shortcut to assign it to the active
1248 window. The shortcut will do the same as clicking in an entry in the window
1249 list menu. The keys for the shortcuts are defined in the ~/G/D/WindowMaker
1250 file or in WPrefs.app
1252 Option names are:
1254 WindowShortcut1Key through WindowShortcut4Key
1257 --- 0.20.2
1260 The name of WindowMaker was changed to Window Maker.
1262 Window creation animation disabled by default.
1264 xdaliclock -shape
1265 -----------------
1267 If you use it edit src/wconfig.h and #define OPTIMIZE_SHAPE or disable the
1268 titlebar and resizebar for the window. OPTIMIZE_SHAPE will remove the
1269 flickering for xdaliclock and other programs that change their shapes often,
1270 but will increase network traffic considerably. So, if you use xdaliclock
1271 from a remote machine it can get slow.
1274 Applications Menu
1275 -----------------
1277 The applications menu will now use the shell in the SHELL environment
1278 variable to execute EXEC menu commands. If it is unset (I think it's always
1279 automatically set by the shell program) it will use /bin/sh
1282 Extra fancy icon kaboom :)
1283 --------------------------
1285 Edit src/wconfig.h and #define ICON_KABOOM_EXTRA to get
1286 more effects for the icon undocking animation.
1288 Options for superfluous stuff are even more superfluous, so this
1289 will not become runtime.
1292 XDE drag and drop support
1293 -------------------------
1295 Support for XDE drag and drop was added (by "]d" <id@maliwan.org>).
1296 To enable, edit src/wconfig.h
1297 The support works with gtk 1.1.2
1300 libPropList
1301 -----------
1303 libPropList will now be built automatically by wmaker. Wich means
1304 the (simplified) building process is now:
1306 ./configure
1307 make
1308 make install
1310 instead of:
1312 tar xzf libPropList.tar.gz
1313 (cd libPropList; make)
1314 make
1315 make install
1317 You also don't need to worry about GNOME libPropList incompatibilities
1318 anymore. 
1321 Bug with focus lost in sloppy focus fixed
1322 -----------------------------------------
1324 The bug only occurs in sloppy or auto focus modes, with AutoFocus disabled
1325 and Superfluous enabled. There is no easy/clean way to fix this, so Window
1326 Maker will disable the animation of window creation if the focus mode is
1327 either sloppy or auto AND AutoFocus=NO.
1329 If you want the animation, enable AutoFocus or use manual focus mode
1330 (prefered). 
1333 The NoWindowUnderDock option was removed
1334 ----------------------------------------
1335 To obtain the same result, use the "Keep Dock On Top" option in the dock menu.
1338 Persistent Program Suplied Icons
1339 --------------------------------
1341 Application supplied icons are now stored, so that the dock will keep
1342 showing them after the app is exited. The icons are stored at
1343 ~/GNUstep/Library/WindowMaker/CachedPixmaps
1346 Sound support
1347 -------------
1349 Sound support is now on by default. Even if you don't use sound the overhead
1350 is very small, and has no impact on performance. If you still want to
1351 optimize it and remove a few hundred of bytes, then use --disable-sound or
1352 --enable-sound=no options when you configure Window Maker.
1355 --- 0.20.0
1357   
1358 Multihead support. wmaker will now manage all screens that are attached to the
1359 display. 
1360 ------------------------------------------------------------------------------
1361   
1363 It does so from a single process (instead of spawning a new process for each
1364 screen, like fvwm does). This keeps memory usage a lot lower than fvwm.
1366 State files have a suffix .n, where n is the number of the screen.
1368 Since I don't have a real multiheaded machine, it probably has bugs.
1370 Superfluous
1371 -----------
1373 Yet another useless superfluous animation. Find out what exactly it is
1374 by yourself :)
1377 exitscript
1378 ----------
1380 ~/G/L/W/exitscript will be called automatically when wmaker is exited.
1383 New runtime options
1384 -------------------
1386 1. Miniaturization animation is now selectable by a runtime option
1387 Add a line with
1389 IconificationStyle = <style>;
1391 to your WindowMaker configuration file.
1392 <style> can be one of: Zoom, Twist, Flip or None
1393 Case doesn't matter, and default is Zoom.
1396 2. Edge resistance.
1397 This can be controlled by setting:
1399 EdgeResistance = xxx;
1401 in your WindowMaker configuration file.
1402 xxx is an integer greater than 0 and represents the number of pixels of edge
1403 resistance. Setting it to 0 (default) will disable this feature.
1405 New theme
1406 ---------
1408 A new theme named Night, is available in this distribution.
1412 --- 0.19.3
1414 GIF support was added. You will need libgif 2.2 to use it.
1416 cpixmap added. Syntax is the same as tpixmap or spixmap
1419 --- 0.19.2
1421 getstyle will include IconBack info in Style files.
1423 --- 0.19.0
1425 libPropList was updated. If you have it installed, you must upgrade or
1426 WPrefs will crash because of bugs in libPropList.
1428 New options
1429 -----------
1431 Balloons!
1432 ---------
1434 WindowTitleBalloons = YES;
1435 will enable balloons for window titles that are not fully visible.
1437 MiniwindowTitleBalloons = YES;
1438 will enable balloons for miniwindow titles.
1440 AppIconBalloons = YES;
1441 for application icons (docked or not)
1444 IconPosition
1445 ------------
1447 IconPosition (the position of the icons) is specified as:
1449 IconPosition = c1c2c3;
1451 where:
1453 c1 can be t or b (meaning top or bottom)
1454 c2 can be l or r (meaning left or right)
1455 c3 can be v or h (meaning vertical or horizontal)
1457 case is insensitive.
1459 For example, 
1460 IconPosition = blh;
1462 is the old iconPosition position.
1464 IconPosition = trv;
1466 will place the icons over the Dock.
1468 New window attribute
1469 --------------------
1471 EmulateAppIcon = YES; will make the window have an application icon.
1472 Only use this option for fully specified windows (like rxvt.Rxvt).
1473 NEVER use in generic window specifications (like * or rxvt).
1474 You must restart the application for the attribute to take effect.
1477 WPrefs.app
1478 ----------
1480 Read WPrefs/README
1483 --- 0.18.1
1485 Boolean balues have changed!!! YES, Y and any non-zero integer will
1486 mean TRUE and anything else (including True) will mean FALSE. This
1487 is to conform to the OpenStep values used for booleans and
1488 not cause headaches later, when GNUstep apps also starts using
1489 defaults and users will try using True wich won't get recognized.
1492 --- 0.18.0
1494 Clip
1495 ----
1497 Clip button layout was changed. IT IS TEMPORARY AND THE DEFINITIVE LOOK
1498 WILL BE DIFFERENT!!!
1501 libPropList
1502 -----------
1504 More bugs were fixed in it. Upgrade the library if you have an older version
1505 installed, with the one included.
1508 Property list menus
1509 -------------------
1511 Format for property list menus has changed! The redundant array for
1512 submenus was removed, so a menu that looked like:
1514 ( Applications,
1515   ("Xterm", EXEC, "xterm"),
1516   ( 
1517     (Paint,
1518         ("Gimp", EXEC, "gimp"),
1519         ("XV", EXEC, "xv")
1520     )
1521   )
1524 must be changed to:
1526 ( Applications,
1527   ("Xterm", EXEC, "xterm"),
1528   (Paint,
1529         ("Gimp", EXEC, "gimp"),
1530         ("XV", EXEC, "xv")
1531   )
1536 Misc
1537 ----
1539 NUMLOCK_HACK is back. This time it works and is enabled by default.
1540 If you think you don't need it and promise me that you won't send 
1541 "bug" reports saying that shortcuts stop working after a while, you can
1542 disable it ;) It will save some memory and CPU.
1545 Configuration
1546 -------------
1548 Removed the SwapMenuButton option and added 3 finer grained options:
1550 SelectWindowsMouseButton
1551 WindowListMouseButton
1552 ApplicationMenuMouseButton
1554 Values that can be used are Left, Middle, Right and Button1 through Button5
1555 Left is equivalent to Button1, Middle to Button2 and Right to Button3
1558 Removed the WorkspaceChangeDelay option and corresponding action.
1559 Removed AClipColor and IClipColor
1562 Added the SelectKey back
1565 Changed default binding of Window commands menu from F10 to Control+Escape
1567 --- 0.17.4
1569 Misc
1570 -----
1572 libPropList has changed! Upgrade it before compiling wmaker.
1574 Hopefully the bugs that caused wmaker to crash if an error is found
1575 in the config files is fixed. If you do crash wmaker with a bad
1576 file, please try to find out the smallest possible portion of the file
1577 that still crashes wmaker and send it to me.
1580 New Options
1581 -----------
1583 PixmapPath was split to PixmapPath and IconPath. PixmapPath is the path
1584 for the pixmaps used as textures and IconPath is for the icons. 
1585 Don't forget to add IconPath to your current configuration file.
1587 There's also a new library in ~/GNUstep/Library/Icons. You should place
1588 your icons there, since icons are not a WindowMaker specific resource.
1591 DontConfirmKill=YES; will disable the confirmation panel for Kill
1594 --- 0.17.3
1596 Interface Changes
1597 -----------------
1599 Unhide Here in the appicon menu was changed to be the first entry.
1600 This way you can unhide the appicon with a single click without
1601 even moving the pointer.
1604 Clip Commands
1605 -------------
1607 The collect icons commands was renamed to attract icons and
1608 the attract icons options was renamed to Auto attract icons.
1610 The Remove Selected Icons was renamed to Remove Icon(s). It will
1611 act as before if some icon is selected and will remove the clicked
1612 icon (without confirmation) if it is not.
1614 Added a Keep Icon(s) command that will keep the selected icons if
1615 any is selected and the current one if none.
1617 The Move To command was renamed to Move Icon(s) To.
1620 --- 0.17.0
1622 If you have libPropList installed, you might want to reinstall it,
1623 replacing with the included libPropList. It has a small bug fix.
1625 Misc. Changes
1626 -------------
1628 Removed --with-gnome and made MWM_HINTS defined by default.
1629 This means that "GNOME support" will work with no additional
1630 flags passed to configure. 
1632 Added support for KDE, by adding a DisableWorkspaceMouseActions option.
1633 Set it to YES and run krootwm to be able to use everything in kfm.
1636 Shortcuts for Root Menu
1637 -----------------------
1639 There is now a new SHORTCUT optional keyword for the menus.
1640 For example, you can bind Control-F1 to xterm with:
1642 "XTerm" SHORTCUT Control+F1 EXEC xterm
1644 or F2 to ARRANGE_ICONS with:
1646 "Arrange Icons" SHORTCUT F2 ARRANGE_ICONS
1649 All commands allowed in the menu file accept the keyword, except for
1650 MENU and OPEN_MENU
1653 Interface Changes
1654 -----------------
1656 ** Configuration of docked applications is now done in a panel instead of
1657 in the menu. 
1659 ** Added a command menu for application icons
1661 ** Shift double-click on the application icon will unhide the app
1662 in the current workspace.
1665 Option Changes
1666 --------------
1668 NotMiniaturizable option changed to NoMiniaturizeButton
1669 NotClosable option changed to NoCloseButton
1672 Speed options values are now UltraFast, Fast, Medium, Slow or UltraSlow
1673                                               ^^^^^^
1675 Removed the Select keyboard binding. You can access it in the window
1676 commands menu.
1678 Removed the ClipMaxIcons option and made it a compile time option.
1680 Removed the ConstrainWindowSize option
1682 Renamed NoSound to DisableSound
1684 Renamed NoAutowrap to DontLinkWorkspaces
1686 Renamed NoDithering to DisableDithering
1688 Renamed NoAnimations to DisableAnimations
1690 Removed the LeftHanded option and added a SwapMenuButton option.
1691 SwapMenuButton will make the rubberband selection in the root window
1692 be bound to the right button and the root menu to the left button.
1695 New way to display temporary icons
1696 ----------------------------------
1698 The icons that are attracted by Clip, but will not be kept after the
1699 application close, are now using a different color for shading, unlike previous
1700 version that always used white. This will improve look for very different color
1701 combinations, and allow the user to control the look of the shaded icon.
1702 The color used for shading the icons is computed as follows:
1704 First a color is computed depending on the IconBack type:
1705  - for solid the color is the solid color itself.
1706  - for simple gradients the color is (from_color + to_color)/2.
1707  - for multiple gradients, the color is the first color in list.
1708  - for pixmaps, the color is the solid color specified for that pixmap.
1710 Then the color is made lighter by multiplying each red/green/blue filed with
1711 1.7 and limiting each field to 0xff in case they exceed this value.
1712 Then this new color will be used by superposing it with the icon we want to
1713 shade, using a proper alpha value.
1715 To control the color for shading is simple:
1717 - In case of multi gradients you just need to put the first color, as the color
1718 you like. WindowMaker do not use the first color in the list to directly build
1719 the gradient, but only when it needs a solid color for something (like in this
1720 case).
1722 - For pixmaps, put the needed color as the solid color the syntax for pixmaps
1723 require. This color is also not used when displaying normal icons, just when
1724 solid colors are needed (like this case).
1726 - For solid color, or simple gradients, in case the color it uses after
1727 computing is not good enough, you can always convert the solid or simple
1728 gradient to a multi gradient with the same look, and use that one. In this
1729 case is simple, just put the needed color as first color in list.
1731 Please note that this will not slow down WindowMaker, because the IconBack is
1732 read only once at startup, and then only if it is changed. After reading it WM
1733 will construct the image of the tile, and use the image instead of recomputing
1734 the gradient every time.
1736 Here are 2 examples of converting solid or simple gradient to a same looking
1737 multi gradient:
1739 IconBack = (solid, Blue);
1740 will become
1741 IconBack = (mhgradient , LightBlue, Blue, Blue);
1742 using LightBlue as color for shading.
1744 IconBack = (dgradient, "#284569", "#082420");
1745 will become
1746 IconBack = (mdgradient, "#183454", "#284569", "#082420");
1747 looking the same, but using #183454 for shading.
1750 New Sound Server Location
1751 -------------------------
1753 The sound server new URL is http://www.frontiernet.net/~southgat/wmsound
1754 Also it seems to be running on FreeBSD too (with little changes maybe).
1757 --- 0.16.1
1759 WINGs
1760 -----
1762 The path for the WINGs resource files was changed. If you don't
1763 do make install, you must move /usr/local/share/WindowMaker/Resources to
1764 /usr/local/share/WINGs
1767 New Options
1768 -----------
1770 The following new options are available:
1771 NewStyle = Yes/No; (static) Replaces --enable-newstyle
1772 DisableDock = Yes/No; (static) Same as -nodock command line option.
1773 DisableClip = Yes/No; (static) Same as -noclip.
1774 Superfluous = Yes/No; (dynamic) Replaces --enable-superfluous.
1776 NOTES.
1777 - The static options are only read at startup. Changing them, needs to restart,
1778   so they will be accounted.
1779 - DisableDock and DisableClip have lower precedence than -nodock -noclip
1780   command line options. If both option/command line option are given, then the
1781   command line option will be accounted.
1784 Start Hidden option
1785 -------------------
1787 The start hidden option was fixed, and made to be an application wide option.
1788 It will apply to every window the application owns. Also its place in the
1789 Attribute Inspector panel, changed accordingly, to reflect this.
1790 The start miniaturized is however still applying to particular windows of an
1791 application, unless the option is set for the class.
1792 Start miniaturized, will override start hidden if both set.
1794 IMPORTANT NOTE.
1795 Because of the way Netscape Communicator is implemented, it is NOT possible
1796 to set the start hidden or miniatirized flags for it. This is because Netscape
1797 chooses to send a second map event to the window it maps. This makes the
1798 window to receive a second map request and to be unhidden or maximized back,
1799 immediately after it was hidden or miniaturized by WindowMaker at startup.
1803 --- 0.16.0
1805 Misc. Changes
1806 -------------
1808 The NextMenuBehaviour option was renamed to WrapMenus
1809 The WorkspaceTiedMiniwindows option was renamed to StickyIcons
1811 The .tif files were renamed to .tiff
1814 Selecting Mini Windows
1815 ----------------------
1817 Now miniaturized windows can be selected as well as normal windows.
1818 You can do this by Shift-Click-ing them. They will be marked, and will follow
1819 you through workspaces like normal selected windows do.
1820 Miniaturizing a window will no longer deselect the window, but will place the
1821 icon and mark it as selected.
1822 The only difference between miniaturized and normal window selection is that
1823 for the moment the rubber-band selecting method works only for normal windows.
1826 Icon Selection Panel in Attributes Editor
1827 -----------------------------------------
1829 Now, selecting icons is as easy as clicking in the file name in a list.
1832 Simplified Options
1833 ------------------
1835 IconSlideStep, IconSlideSlowDown and IconSlideDelay were merged to 
1836 IconSlideSpeed
1838 MenuScrollStep and MenuScrollDelay were merged to MenuScrollSpeed
1840 ShadeStep and ShadeDelay were merged to ShadeSpeed
1843 Valid values for them are: Fast, Normal, Slow or UltraSlow
1845 If you want to fine tune the values, they can be changed in wconfig.h
1846 Send me your set of values with an indication of how fast is your hardware,
1847 so that I can make the default values more adequate.
1850 New Window Attributes
1851 ---------------------
1853 Added StartMiniaturized and StartHidden as window attributes and
1854 removed the previous implementation. Also removed the dock menu entries.
1855 They are now settable in the Attributes Panel.
1857 Also added DontSaveSession attribute. This way, you won't end up with multiple
1858 unwanted copies of the same app after the previous session is restored.
1859 I start X with a xterm in .xinitrc instead of wmaker, wich will cause the
1860 xterm restored by wmaker be duplicate. Just add -name something to the
1861 xterm started form .xinitrc and mark DontSaveSession=YES for that window.
1865 User Specifiable Visual IDs
1866 ---------------------------
1868 wmaker now supports different visuals than the default one. It isn't of much
1869 use for most people, but can be usefull for lucky SGI users who want it
1870 to use TrueColor instead of the default PseudoColor.
1872 wmaker -visualid VISUAL_ID
1874 where VISUAL_ID is the hex code for the visual you want.
1876 Note: I don't have an SGI box and haven't tested it...
1880 Starting Workspace
1881 ------------------
1883 The starting workspace is identified in the following order:
1884 1. If the app is omnipresent will be mapped on the current workspace.
1885 2. Else if the application have a StartWorkspace option set as attribute
1886    then this one will be used.
1887 3. Else, if the application was started from Clip, the workspace on which
1888    the Clip from where it was started is used.
1889 4. Else the current workspace is used.
1891 Restoring saved sessions will always use the saved workspace, no matter
1892 what other options are, except onmipresent.
1896 --- 0.15.1
1898 Workspace specific mini windows
1899 -------------------------------
1901 The minimized windows can be workspace specific, being more consistent with
1902 the rest. This is because minimized window represents just another state of a
1903 window (like normal or shaded), which all are workspace specific.
1904 This (or the old "present anywhere") behavior can be set using an option in
1905 the WindowMaker database: WorkspaceTiedMiniWindows = Yes/No;
1907 New way to animate the blowing icons
1908 ------------------------------------
1910 There is now a compile time option that allows one to set how the icons are
1911 animated when detaching from dock/clip in superfluous mode.
1912 By default the classic "Falling pieces" animation is used.
1913 If SPREAD_ICON is #define-ed in wconfig.h, then a "Spread in four directions"
1914 animation is used instead. Take a look at the section where this is described
1915 in src/wconfig.h
1916 By default there is #undef SPREAD_ICON to select "Falling pieces" animation.
1918 Auto Colapse for Clip
1919 ---------------------
1921 The clip now supports an option named "Auto Collapse" which can be set from
1922 the clip main menu. When set, clip will stay collapsed, and will show itself
1923 when the mouse moves over it. While the mouse is over it, or over any of the
1924 icons attached to the clip, the clip will stay uncollapsed, letting you to
1925 access the attached icons. This is not true for applications like asclock, or
1926 applets of that kind, because the icon window do not belongs to WindowMaker,
1927 but to the application itself. For such icons you must keep the mouse over the
1928 icon groundplate, else it will collapse back. But usually these type of icons
1929 will not stay in a collapsed clip, since one needs to see what they show.
1930 When the clip is leaved it will collapse back after a delay of 1 second, unless
1931 the mouse is moved back to the clip area. The delay can be set modifying
1932 AUTO_COLLAPSE_DELAY in wconfig.h. Default is 1000 (ms) which means 1 second.
1937 --- 0.15.0
1939 Changed name from Fiend to Clip
1940 -----------------------------------
1942 All occurrences of word Fiend with or without capital F were replaced with
1943 the corresponding Clip (same capital).
1944 This affects all configuration files under ~/GNUstep that contain this word.
1945 It can be refered as "Workspace Dock" too.
1948 New option in Clip menu, and extended Clip behavior
1949 ---------------------------------------------------
1951 The following new items are available in the dock menu:
1953 1. Attract Icons
1954 2. Keep Attracted Icons
1955 3. Collect Icons
1956 4. (Un)select All Icons
1957 5. Remove Selected Icons
1958 6. Move To
1959 7. Start miniaturized    (also available for regular dock)
1960 8. Start hidden          (also available for regular dock)
1961 9. Selected
1962 10. Set icon...          (also available for regular dock)
1965 Here is what they do:
1967 1. "Attract Icons" will let the Clip to attract and attach any new appicon that
1968    is created when an application starts. It will not do this if the Clip is
1969    full. If the Clip is Collapsed then the appicon will be hidden after it is
1970    attached.
1971 2. "Keep Attracted Icons" will tell the Clip to keep the attracted appicons,
1972    after the application is closed. Without this the appicons will vanish,
1973    leaving the Clip in the original state. If you move an appicon that was
1974    attracted from Clip to regular Dock, it will be kept when closed, no matter
1975    what "Keep Attracted Icons" is set to in Clip.
1976 3. "Collect Icons" will collect all appicons that are not yet attached to Dock
1977    or Clip, and attach them to the current workspace Clip. The value of
1978    "Keep Attracted Icons" will apply when applications close. If Clip is
1979    collapsed, the appicons will be hidden.
1980 4. "(Un)select All Icons" will select all icons in the clip if none is
1981    selected, or it will deselect all selected ones. The selected icons are
1982    marked using a small triangle in the bottom right corner of the appicon.
1983    The color of the mark is set using SClipColor in WindowMaker domain
1984    database.
1985 5. "Remove Selected Icons" will remove from Clip all selected icons. The ones
1986    that still run, will be detached, all the others will vanish.
1987 6. "Move To" will transfer all selected icons to another workspace and attach
1988    them to the Clip in that workspace. If none is selected, only the one the
1989    mouse was pressed on will be moved.
1990 7. "Start miniaturized" will launch (or autolaunch if set) the application in
1991    a miniaturized state.
1992 8. "Start hidden" will launch (or autolaunch if set) the application in a
1993    hidden state. Note that only one of the two can be set at a time.
1994 9. "Selected" can be used to toggle the selected state of the appicon
1995    individually. The same can be achieved using Shift-LeftClick on the appicon.
1996    In fact the intended way of toggling the selected state is by using
1997    the Shift-LeftClick on icon. The menu entry is just another way to do the
1998    same.
1999 10. "Set icon..." will allow one to set the image for the appicon. The image
2000    will be updated without restart, and also all appicons in the same
2001    instance.class as the one we set for, will be updated.
2003 So a simple way of avoiding the screen to be filled up with appicons is to set
2004 the "Attract Icons" in the Clip. Also the "Keep Attracted Icons" can be set to
2005 No, so the attracted icons will be deleted when application exits, thus leaving
2006 the Clip clean. If also one to not want to see the appicons that keep filling
2007 the Clip, he can set the Clip to be Collapsed.
2009 Getting rid of unneeded icons in Clip is as simple as selecting them
2010 individually using Shift-LeftClick, and then using the "Remove selected Icons"
2011 entry in menu.
2014 Support for different visuals.
2015 ------------------------------
2017 WindowMaker is now able to support any visual, except DirectColor, in any
2018 depth from 1bpp to 32bpp.
2020 One can start the X server with different visuals, by passing the X server the
2021 right option. For XFree 3.3.x is -cc <id>.
2022 WindowMaker is not yet able to choose a different visual from the Default one
2023 on a given screen, but can use any default visual it finds, except the direct
2024 color visual.
2025 For example starting X like (for XFree 3.3.x, and if the driver for the
2026 card supports this. Read the man page for your X server):
2027 startx -- -bpp 8 -cc 0 will give you the StaticGray visual.
2028 startx -- -bpp 8 -cc 1 will give the GrayScale visual
2029 and so on.
2031 Wrlib code is now generic, and will support any visual except DirectColor in
2032 any depth. Programs written with wrlib can work on different visuals from
2033 the default visual for a given screen.
2034 Behavior in different visuals can be tested using the testgrad program in
2035 wrlib subdirectory in distribution.
2036 testgrad -h will show the usage.
2038 Multidiagonal gradients are also implemented now in wrlib, and a new algorithm
2039 is used to speed up the generation of diagonal gradients.
2042 New arrangement of the directory structure under ~/GNUstep/
2043 ---------------------------------------------------------------
2045 To better adapt to theme support the directory structure changed under
2046 ~/GNUstep/Library/WindowMaker
2048 1. Style directory moved to Styles.
2049 2. Added the following directories: Backgrounds, IconSets, Pixmaps, Sounds and
2050    Themes.
2051 3. The .style files no longer get copied in the user's Styles directory.
2052    Instead they are read from the global /usr/local/share/WindowMaker/Styles
2053    directory.
2055 Under ~/GNUstep/Defaults the following changes occurred:
2057 1. A default WMState is installed by wmaker.inst.
2058    It contains the dockit program assigned to the top icon of the dock, and
2059    the wmsetbg program assigned for the drop command on both dock's and clip's
2060    main icon.
2061    Double clicking the dock's main icon will bring up dockit that will let you
2062    dock any application that do not have an application icon.
2063    Dropping an image on dock's or clip's main icon, from an Offix DND aware
2064    application, will put the image on the background tiled, and will update
2065    WindowMaker domain database file.
2066 2. Syntax of WMState changed a little. The old position will not be restored
2067    when you will first start the new version, but after that it will be
2068    normally remembered. This is because now the main clip icons is only saved
2069    once, not for every workspace.
2070    You should replace Fiend with Clip in any place where it appears, if you
2071    want to keep the old WMState file, else it will not work.
2072 3. At compile time, it will detect if you have support for tif, and will
2073    install a WMWindowAttributes with corresponding image name extension
2074    (.tif or .xpm). This is true only for pixmaps that come with the source
2075    distribution and get installed under /usr/local/share/WindowMaker/Pixmaps
2077 The menu file changed a lot. Old menu file will *not* work with new theme
2078 support, so please upgrade.
2081 New behavior of OPEN_MENU command
2082 ---------------------------------
2084 The OPEN_MENU command now supports the following syntax:
2085 1. File menu handling.
2086    // opens file.menu which must contain a valid menu file and inserts
2087    // it in current position
2088    OPEN_MENU file.menu
2089 2. Pipe menu handling.
2090    // opens command and uses it's stdout to construct menu.
2091    // Command's output must be a valid menu description.
2092    OPEN_MENU | command
2093 3. Directory handling.
2094    // Opens one or more directories and construct a menu with all
2095    // the subdirectories and executable files in them sorted alphabetically.
2096    OPEN_MENU /some/dir [/some/other/dir ...]
2097 4. Directory handling with command.
2098    // Opens one or more directories and construct menu with all
2099    // subdirectories and readable files in them sorted alphabetically,
2100    // preceding each of them with command.
2101    // WITH is a required keyword!!!
2102    OPEN_MENU /some/dir [/some/other/dir ...] WITH command -options
2104 Please note that because of the 'WITH' keyword old menu files no longer work
2105 for the OPEN_MENU with a command.
2108 Theme support
2109 -------------
2111 Theme support is now as easy as untar-ing a tarball in the right place.
2112 Because of the way OPEN_MENU works, they can be installed on a global
2113 shareable basis, or for personal user use.
2114 Themes installed under ~/GNUstep will be available only for a user, but
2115 if if they are installed under /usr/local/share/WindowMaker they will be seen
2116 by all users. This is also true for style files, background images, pixmaps,
2117 etc that get installed under /usr/local/share/WindowMaker.
2118 Themes can be saved or loaded using the Appereance menu.
2120 Also support for different IconSets is available. You can save or load a new
2121 IconSet using the Appereance menu.
2123 Setting background images is now as simple as putting the images in the right
2124 place (~/GNUstep/Library/WindowMaker/Backgrounds or
2125 /usr/local/share/WindowMaker/Backgrounds, or any other place in your
2126 PixmapPath). Then use the Appereance menu. They will be instantly available
2127 since they are opened by a OPEN_MENU command. Also the image do not need to
2128 have a .jpg or any other extension. It will be recognized anyhow.
2129 As an example please see the OpenStep theme supplied with WindowMaker.
2130 The OpenStep image is a jpeg file without extension.
2132 Please keep in mind that anything under /usr/local/share/WindowMaker will be
2133 available for all users.
2136 New options for wmsetbg and getstyle
2137 ------------------------------------
2139 wmsetbg now accepts the following options:
2140 usage: wmsetbg [-options] image
2141 options:
2142  -d             dither image
2143  -m             match  colors
2144  -t             tile   image
2145  -s             scale  image (default)
2146  -u             update WindowMaker domain database
2147  -D <domain>    update <domain> database
2148  -c <cpc>       colors per channel to use
2150 By default, it will try to guess if dithering is needed or not and proceed
2151 accordingly.
2152 Using -d or -m will force it to dither or match colors.
2154 Dithering for more than 15bpp is generally not needed, and will only result
2155 in a slower processing.
2156 Don't use dithering except when needed, because it is slower. Else rely on
2157 wmsetbg which will detect if dithering is needed and use it.
2159 -u will update the WorkspaceBack in the default database domain file in
2160    ~/GNUstep/Defaults/WindowMaker, and let WindowMaker refresh the screen.
2161    Please note that this option only works under WindowMaker, and will have no
2162    effect under other window managers, since it rely on WindowMaker to update
2163    the image after it reads the updated defaults database.
2165 -D <domain> is same as above, but will update the domain <domain> instead of
2166    the default WindowMaker domain.
2168 -c <cpc> will set the color per channel to use. Only needed for PseudoColor
2169    visuals. WindowMaker will automatically pass the value read from the
2170    WindowMaker domain database.
2173 getstyle now have the -t option, that instructs it to read all options
2174 related to theme. Without -t getstyle will read only style options that
2175 means it will not read WorkspaceBack and IconBack.
2176 Use -t when you want to make a theme and need all theme options to be saved.
2177 Else it will extract just a style file.
2180 Session management support
2181 --------------------------
2183 Two new commands are available for use in menus:
2185 SAVE_SESSION and CLEAR_SESSION.
2187 SAVE_SESSION:
2188 will take a snapshot of all running applications, and their current hints
2189 (shaded, hidden, minimized, geometry and workspace they are on),
2190 and save it inside the WMState file. Also the current workspace we are on is
2191 saved. The applications that are running and were started from dock or clip are
2192 marked, so they will be attached to the corresponding dock/clip when restored.
2193 This state is restored every next session, until a new one is saved or
2194 CLEAR_SESSION is used.
2196 CLEAR_SESSION:
2197 will clear any previous saved session.
2199 There is also a run time option named SaveSessionOnExit = Yes/No; that allows
2200 one to automatically save the state of desktop when leaving WindowMaker.
2201 This way next session, the state of the desktop before last exit is restored.
2203 Please note that if this option is set to Yes, than any manual saving of the
2204 state, or any clearing of the state will be overridden when exiting
2205 WindowMaker.
2207 These options are available under the "Workspace" menu.
2210 User WindowMaker configuration files are now merged with global ones
2211 --------------------------------------------------------------------
2213 When starts WindowMaker will look for database domain files under
2214 $GNUSTEP_USER_ROOT/Defaults or ~/GNUstep/Deafults to be read. (In this order).
2216 If they are not available then it will scan for them in
2217 $GNUSTEP_LOCAL_ROOT/Defaults, $GNUSTEP_SYSTEM_ROOT/Defaults or
2218 /usr/local/GNUstep/Defaults (in this order).
2220 Even if the file was found or not, it will always load the corresponding domain
2221 file under /usr/local/share/WindowMaker/Defaults.
2223 Then if the user file was found it will merge it over the global file, else
2224 the global file will be used.
2226 This way any settings that are set by the system administrator in the shared
2227 file will be available for users that do not have them in their config files.
2228 Any option the user have in his config file will override the one in the
2229 shared domain file.
2231 So any new runtime options that appear in WindowMaker domain, do not need to
2232 be set in all user files, except the ones the user wants a different behavior
2233 from the default set for all users in the shared file.
2235 Also it is possible for the user to not have any personal domain databases, and
2236 the global shared ones will be used, but it still needs to have the directory
2237 structure, so WMState gets written on session exit.
2238 So all it needs to have is ~/GNUstep/Defaults directory available.
2241 New behavior of the Slide Icons
2242 -------------------------------
2244 Animation constants are now runtime.
2245 They are:
2246 IconSlideDelay = 0;
2247 IconSlideStep = 5;
2248 IconSlideSlowDown = 50;
2250 To better adapt both slow and fast machines the behavior of sliding icons
2251 changed in the following manner:
2253 Old one was to keep moving the icon with a constant step (default 5 pixels)
2254 until it reached the destination.
2256 Now it will use a new parameter named IconSlideSlowDown to speed up or slow
2257 down the moving.
2259 Instead of moving it with a constant step it will use IconSlideSlowDown to
2260 divide the distance to the destination, and use this value as the first step.
2261 Then is will compute the remaining distance and will again use
2262 IconSlideSlowDown to divide it and get the new step. And so on.
2263 When the step to move becomes smaller than IconSlideStep, IconSlideStep will
2264 be used further until the destination is reached.
2266 This way a nice deceleration effect is achieved, since while the icon
2267 approaches destination, it will use smaller steps, gibing the illusion that
2268 the icons is moving slower.
2270 IconSlideDelay will give the pause between steps, and is expressed in ms.
2272 Giving large values to IconSlideSlowDown (>1024 for 1024x768 screen) will
2273 result in the old "constant step advance" behavior, since the computed step
2274 will always be smaller than IconSlideStep, and the last will be used instead.
2276 Making IconSlideSlowDown = 0 or 1, will result in an instant jump to the
2277 destination without any animation.
2280 Attribute editor
2281 ----------------
2283 Because the icon images on screen automatically update after any change in
2284 WMWindowAttributes domain file, the use of both Save and Apply buttons is no
2285 longer needed. If one wants to just apply the setting to the current window
2286 only, he will only use the Apply button.
2287 If he wants them saved for all applications in the same instance and/or class
2288 the using the Save button will write them to disk, and automatically
2289 WindowMaker will update all the icons that need to be updated on screen.
2292 Sound support
2293 -------------
2295 Some basic sound support is now part of WindowMaker. The sound server is not
2296 yet part of WindowMaker distribution, so you need to download it separately.
2297 This is because is linux specific, and need some changes before it can be
2298 included.
2299 Until them if you have a linux system and want to use sound, use the
2300 wmsound-0.5 available at http://www.geocities.com/SiliconValley/Bay/7874
2301 Download that package, and only build the sound server there.
2302 DO NO APPLY ANY PATCHES FROM THERE!, because they are already applied.
2303 Just build the sound and copy the executable in /usr/local/bin
2304 Follow the rest of the install steps described there, except the patch-ing
2305 procedure.
2307 To enable sound for WindowMaker pass --enable-sound to configure.
2309 Also use NoSound = Yes/No; to enable/disable sound at runtime without killing
2310 the sound server.
2312 If you cannot set the sound to work yet, then is not for you.
2313 Wait until the sound server will be fixed and will be part of WindowMaker.
2316 New entries in WindowMaker domain database
2317 ------------------------------------------
2319 The following entries have been added to the runtime options:
2321   SaveSessionOnExit = No;
2323 will autosave (or not) the session state on exit.
2325   WindowPlaceOrigin = "64, 64";
2327 will offset all windows in auto or cascade placement mode with the value
2328 (in pixels) before placing them on screen. First is horizontal direction and
2329 second is vertical.
2330 This do not apply to windows that request a specific position on screen.
2331 This is useful if you want your Clip on the top left corner to not be
2332 overlapped by mapping windows.
2333 It will let it to have a row and a column of docked appicons near the screen
2334 edge, that will not be overlapped by windows.
2335 If you set it to "128, 128" it will have 2 rows and 2 columns not overlapped.
2338   NoSound = No;
2340 Enable/disable sound at runtime without the need of killing the sound server.
2343   MenuScrollDelay = 10;
2344   MenuScrollStep = 5;
2346 Constants for the menu scrolling animation.
2348   IconSlideDelay = 0;
2349   IconSlideStep = 5;
2350   IconSlideSlowDown = 50;
2352 Constants for the icons sliding on screen. Explained above.
2354   ShadeDelay = 0;
2355   ShadeSteps = 15;
2357 Animation parameters for shading a window. How many steps it will take, and the
2358 delay between steps in ms.
2360   DoubleClickTime = 250;
2362 The time for the double click to be considered so. Expressed in ms.
2364   SClipColor = "#6f8ae2";
2366 Color for selected icons in Clip.
2368 All delays are expressed in ms.
2372 --- 0.14.1
2375 *** Enhanced fiend clone.
2377 Here are the new fiend features:
2378 1. Keys for raising/lowering the fiend, and their default values:
2379    FiendLowerKey = None;
2380    FiendRaiseKey = None;
2381    FiendRaiseLowerKey = None;
2383    All reside in WindowMaker configuration file.
2385 2. Added posibility to launch the workspace menu with button1 click on the
2386    idle indicator of fiend, or with button3 click on workspace name on the
2387    fiend.
2389 3. Added Control-button1-click on fiend's idle indicator, to create a new
2390    workspace and move to it. Same action as New item in Workspace menu.
2392 4. Fiend's idle indicator do have a color that reflects its normal/collapsed
2393    state.
2395 5. The delay between changing workspaces from fiend is now a runtime option:
2397    WorkspaceChangeDelay = 700;
2399    in WindowMaker configuration file.
2401 6. Application icons can be moved between dock and fiend now.
2403 7. The way workspaces are changed is controlled now by two runtime options:
2405    AdvanceToNewWorkspace=Yes/No;
2406    CycleWorkspaces=Yes/No;
2408    Both apply to either fiend navigating buttons or to next/prev worksapace
2409    keybindings. Both default to No, and are in WindowMaker configuration file.
2411 8. Also added posibility to advance to new workspace, no matter what value
2412    AdvanceToNewWorkspace have, with Control-button1-click on "next workspace"
2413    fiend button.
2416 *** Theme support ***
2418 Spixmap and tpixmap now work. Their syntax is:
2420 SomeStyleOption = (spixmap, file, color);
2421 SomeStyleOption = (tpixmap, file, color);
2423 - spixmap means scaled pixmap, so the image in the file will be scaled to
2424 adapt to the destination's size.
2425 - tpixmap means tiled pixmap, and the image from file will be tiled in the
2426 destination.
2428 file is searched in the PixmapPath, but can be a full path name.
2430 Color is used depending on which Style option is applied.
2431 For example in case of titlebars, color is used for miniwindows titles color.
2432 You are not restricted in selecting that color, but is better to put one
2433 that matches the overall color of the image.
2435 Currently they apply to all the options that accept (solid, color), or any
2436 type of gradient.
2437 This means they also apply to WorkspaceBack and IconBack, which allows theme
2438 support with the simple use of the setstyle and getstyle utilities.
2439 There is no need for an extra theme manager, just to include the needed
2440 options in the style files.
2442 In case of WorkspaceBack, color is used to be set in the background until
2443 the image gets loaded and displayed. This is to avoid the stippled screen
2444 the X server shows, in case the image is big and loads slow.
2445 There is a small utility in the util directory, named wmsetbg which is
2446 used to set the background image. This is needed for windowmaker not to
2447 freeze while loading and scaling the image.
2448 Currently it is hardcoded in windowmaker to use wmsetbg to set the background
2449 image, and is better to use it since is smaller that other image manipulation
2450 programs, and it is compiled with support for same image types as windowmaker.
2451 Since it comes and is installed with WindowMaker, there will be no need to
2452 download and use an external app, which also may not have support for the same
2453 image types as windowmaker.
2457 --- 0.14.0
2459 *** Fiend clone.
2461 The fiend clone is a dock extender, that lets you dock more than the default
2462 10-12 icons in the dock. It actually lets you dock how many icons you like,
2463 with a current default of 25 per workspace. The fiend have different docked
2464 icons on every workspace. Also the fiend main icon shows you the workspace
2465 you're on and lets you navigate through the workspaces with the small green
2466 buttons on the low right corner.
2467 To save screen space the fiend can be collapsed to the main icon either
2468 from the fiend menu (available with right click on the fiend icons), or
2469 with a double left click on the main fiend icon, which is a toggle for
2470 the collapsed/uncollapsed state.
2471 Collapsed state is marked by a different title color.
2472 Pressing on the small buttons on the low right corner, the workspaces are
2473 changed in increments of 1 to the left or right, but keeping the button
2474 pressed over them will continuously advance through workspaces until the
2475 mouse is moved away from the buttons or the button is released.
2476 The delay between workspace changes is set by FIEND_WKS_CHANGE_DELAY in
2477 src/wconfig.h, and defaults to 700 ms.
2478 Unlike the dock, fiend can hold icons in any directions, and can be placed
2479 in any position on screen.
2481 When an icons is to be docked, but the position can be either in the dock
2482 or in the fiend, the dock will be used first, and the icon will be docked
2483 there.
2485 Here are the new runtime options introduced by the fiend:
2486 Files are located in ~/GNUstep/Defaults/
2488 In WMWindowAttributes:
2489        "Logo.WMFiend" = {Icon = "Cone.xpm";};  - icon for the fiend
2491 In Windowmaker:
2492         FiendMaxIcons = 25;           - the max number of icons in fiend per
2493                                         workspace
2494         FiendTitleFont = "-*-helvetica-bold-r-normal-*-10-*-*-*-*-*-*-*";
2495                                       - the font used to show the current
2496                                         workspace
2497         FiendTitleColor = black;      - color for the uncollapsed fiend title
2498         CFiendTitleColor = "#616161"; - color for the collapsed fiend title
2499         AFiendColor = "#00ba70";      - color for the workspace changing
2500                                         buttons, when active
2501         IFiendColor = "#008000";      - color for the workspace changing
2502                                         buttons, when idle
2504 For the ones who don't want to use fiend, there is a option to wmaker named
2505 -nofiend that can be feed to the command line when starting wmaker.
2506 (This is the equivalent for -nodock, but removes fiend clone).
2508 The syntax of WMState file have changed, but you don't have to worry because
2509 WindowMaker will know to read the old format and will save it and further
2510 will use the new one. You do not need to change your file, for the new version
2511 to work.
2514 --- 0.13.1
2516 *** Enhanced Attribute editor.
2518 Now you can save defaults for all windows.
2519 Please note that only Icon, KeepInsideScree, and sometimes NoAppIcon
2520 can be useful in a normal environment. But others may have other opinion ;)
2521 If you set AlwaysUserIcon default for all windows, note that apps like
2522 asclock, wmload, wmmail, wmrack, will show that icon instead of their
2523 window.
2525 Now Attribute editor also counts for defaults saved for all windows,
2526 (not only the default "No" for all options hardcoded in WindowMaker),
2527 when saving options for some instance.class specification. This is to
2528 save disk space by saving only the options that differs from global defaults
2529 (either defaults for all windows or the hardcoded valued in WindowMaker).
2531 Attribute Editor now updates on the fly the appicon image or creates/deletes
2532 the appicon if you set that options in the Inspector panel and Apply them.
2533 Modifying Icon file, NoAppIcon or AlwaysUserIcon and Applying them will
2534 result in the image update for the app-icon.
2536 Note that if you apply but not save these options, the miniwindow image will
2537 not be updated. This is because app-icon is always on screen so it can be
2538 updated, but miniwindow image is read from the defaults database and from disk
2539 every time you minimize the window and is destroyed when you restore.
2542 --- 0.13.0
2544 *** Atribute editor is working ;).
2546 How it works is quite obvious.
2547 Anyway, here is a short description.
2549 Save   - only save the configuration in defaults database and updates
2550          WMWindowAttributes
2551 Apply  - only applies the values to the current window
2552 Revert - reverts the values from the defaults database
2554 Note that Save and Revert count for the window specification
2555 (instance & class), that are selected, and save/use the values for/from
2556 that.
2558  The Update button will show the icon who's name was typed in the textfield
2559 If the textfield is empty, will try to use the default icon.
2560 Also saving with and empty textfield for icon, uses the default icon.
2562  The Default button will use the icon in the textfield as default icon
2563 and save that value in WMWindowAttributes (Note that in this case is no
2564 need to press the Save button!). Also if the textfield is empty it will
2565 try to use the old default icon, if available.
2567 *** Now menus are saved between sessions, or over a restart.
2569  Just stick them to the desktop, and you will find them over sessions
2570 until you close them.
2571  Please note that only the root_menu, the window switch_menu and the
2572 workspaces_menu can be saved this way.
2574 *** Changed the lousy Windoze menu behaviour.
2576 This applies to 'NextMenuBehaviour = NO;'
2578  Now the items are no more automatically selected if you launch the menu
2579 and the mouse is over some item, if you use a short click to launch the
2580 menu (shorter than the default DBL click time).
2581  If you use a longer click or keep the mouse pressed, the item under mouse
2582 will be selected after that delay, and launched when you will release the
2583 mouse button.
2584  If the click was short, a second one is needed to launch the item.
2586 *** Autoarrange icons is now a runtime option
2589 AutoArrangeIcons = YES/NO;
2590 in 'WindowMaker'.
2592 *** Added configurable horizontal resize threshold
2595   HorizontalResizeThreshold = <n>;
2597 This will make the n pixels at the exterior side of the corner handle
2598 of the resize bar to restrict to horizontal only resize.
2599 Also you can use Shift-click&drag anywhere on the corner handle to
2600 restrict the resize only to horizontal.
2601 Note that the Shift-click&drag does not depend of the configured threshold
2602 and works completely independent.
2604 *** New option for OPEN_MENU (pipe from command)
2606 OPEN_MENU | /foo/bar/script
2608 will make a menu that is dinamically constructed by /foo/bar/script
2611 --- 0.12.0
2613 *** New option for OPEN_MENU
2615 OPEN_MENU /foo/bar/pics xv -root -quit
2617 will make a menu with all files in /foo/bar/pics and precede them
2618 with EXEC xv -root -quit
2620 thus, making a menu with entries like:
2623 "marble.gif" EXEC xv -root -quit marble.gif
2624 "water.jpg" EXEC xv -root -quit water.jpg
2628 *** Multicolor gradients
2630 (mhgradient, colorX, color1, color2, color3, ..., colorn)
2631 (mvgradient, colorX, color1, color2, color3, ..., colorn)
2633 You can put any number of colors >= 2. 
2635 colorX is a special color that is used as the solid color of the
2636 texture when wmaker needs a solid color (like in miniwindow title and
2637 resizebar)
2639 *** PixmapPath format changed
2641 What used to be
2643 PixmapPath = "/usr/local/share/pixmaps:~/foobar";
2645 must now be
2647 PixmapPath = ("/usr/local/share/pixmaps", "~/foobar");
2650 *** Added OffiX DND in dock
2652 Use the "Set drop arguments..." command in the menu and put a %d
2653 where the dropped object string should be substituted, like:
2655 xedit %d
2657 *** Escape thingies for menu and dock commands:
2659 %w - substitute with current selected X window ID
2660 %s - substitute with current selection
2661 %d - substitute with last dropped object
2662 %a(some text) - opens a input box with "some text" as a title. Then,
2663 the text typed will be substituted there
2665 \r, \n - substitute with corresponding characters
2668 *** The WMState file format has changed a little.
2669 The Command field for the dock application list is now a normal string,
2670 instead of a list. So, remove the parentheses and the commas for the command
2671 and join all the parts. Example:
2673 if it used to be
2675 Command = ( xterm," -geometry", "+10+10" );
2677 then make it
2679 Command = "xterm -geometry +10+10";
2682 --- 0.10.2
2684 AutoFocus = NO; disables automatic focusing of windows
2685 when they are first mapped
2688 --- 0.10.1
2690 titlebar gradients are in a single piece now
2692 the WMDock file was merged into the WMState file. You can insert this
2693 file in WMState and set it's key to Dock. For example, if your WMDock
2694 contains:
2697         Applications = { {Command = (); }};
2698         Position = "-64,0";
2699         Lowered = NO;
2702 and WMState contains:
2705         Workspaces = ( "Workspace 1" );
2708 then you can merge both and have:
2711         Workspaces = ( "Workspace 1" );
2712         Dock = {
2713                 Applications = { {Command = (); }};
2714                 Position = "-64,0";
2715                 Lowered = NO;
2716         };
2721 The configuration format has changed!! Forget everything about the old
2722 format.
2724 dockapp was removed and the old version will not work anymore. 
2726 the dialogs require tcl/tk. they will be rewritten in plain C
2729 These are some tips for people upgrading from older versions and don't want
2730 too many unused files around. There is no problem if you decide to keep 
2731 them for a while.
2733         you can  rm -r ~/gnustep if you don't want anything from there
2735         remove the files in /usr/local/share/WindowMaker before installation
2737         the /usr/local/share/pixmaps directory can be removed