wmaker: removed unused constant SCROLL_STEPS in the switchpanel code
[wmaker-crm.git] / NEWS
blob889d019f1fe980d92bc18ff57214a54780af46f7
2 NEWS for veteran Window Maker users
3 -----------------------------------
5 -- 0.95.7
7 Window snapping
8 ---------------
10 You can now "snap" a window, i.e., maximize it to a side or corner of the
11 screen, by dragging it to that side or corner.  It is enabled by setting
12 "WindowSnapping = YES" in ~/GNUstep/Defaults/WindowMaker or selecting "Enable
13 window snapping" under "Expert User Preferences" in WPrefs.app.
15 Note that window snapping is automatically disabled if "Switch workspaces while
16 dragging windows" is selected under "Workspace Preferences" in WPrefs.app, or
17 if "DontLinkWorkspaces = NO" in  ~/GNUstep/Defaults/WindowMaker, as this feature
18 also involves dragging a window to one side of the screen.
21 Dragging maximized windows
22 --------------------------
23 You can now control the behavior when a maximized window is dragged by setting
24 the "DragMaximizedWindow" option in ~/GNUstep/Defaults/WindowMaker or by
25 selecting an option from the "When dragging a maximized window..." pop-up button
26 under "Window Handling Preferences" in WPrefs.app.
28 There are four choices:
29 * "Move" ("...change position (normal behavior)" in WPrefs.app) is the default
30   and traditional behavior.  A maximized window is moved when dragged and
31   remains maximized, i.e., it keeps its maximized geometry and can later be
32   unmaximized.
33 * "RestoreGeometry" ("...restore unmaximized geometry") is the behavior standard
34   in desktop environments like GNOME, Cinnamon, and Unity.  A maximized window
35   is moved when dragged and is completely unmaximized, i.e., its unmaximized
36   geometry is restored.
37 * "Unmaximize" ("...consider the window unmaximized") causes a maximized window
38   to be moved when dragged and remains partially maximized, i.e., it keeps its
39   maximized geometry, but is consider to be unmaximized.  In particular, it can
40   be immediately re-maximized.
41 * "NoMove" ("...do not move the window") prevents a maximized window from being
42   moved when dragged.
44 Note that, to accomodate this option in the "Window Handling Preferences" tab in
45 WPrefs.app, the option to "Open dialogs in the same workspace as their owners"
46 (which sets the "OpenTransientOnOwnerWorkspace" option from
47 ~/GNUstep/Defaults/WindowMaker) has been moved to "Expert User Preferences".
50 --- 0.95.6
52 More image format supported
53 ---------------------------
55 In addition to a more complete Netpbm image formats support, WindowMaker
56 can now load WebP images. It can also make use of the ImageMagick library
57 to support a lot more formats, like SVG, BMP, TGA...
60 Mini-window apercu
61 ------------------
63 A small preview of window contents can be enabled from WPrefs,
64 in Miscellaneous Ergonomic Preferences, check miniwindow apercus.
65 Apercu size can be configured using the ApercuSize variable with
67 $ wdwrite WindowMaker ApercuSize 4
69 in multiples of the icon size (in this case the apercu size will be four
70 times the icon size).
72 The default size is 2 (twice the icon size).
75 Support for up to 9-buttons mouse
76 ---------------------------------
78 The action for the newly supported buttons can be configured from WPrefs.
81 wmiv, an image viewer application
82 ---------------------------------
84 wmiv is a quick image viewer using wrlib to be run from the command line.
87 --- 0.95.5
89 Support for generated menus in proplist format
90 ----------------------------------------------
92 The root menu now supports a OPEN_PLMENU option to construct a submenu from
93 the output of a command which is proplist format. This can be used e.g. in
94 conjunction with wmmenugen like:
97     "Generated PL Submenu", OPEN_PLMENU,
98     "|| find /usr/share/applications -type f -name '*desktop' | xargs wmmenugen -parser:xdg"
102 New window placements
103 ---------------------
105 Now it is possible to maximize windows to the top/bottom halves
106 of the screen and also to the corners (top/bottom + left/right).
108 The keyboard shortcuts can be configured with WPrefs.
111 Options to configure window/menu borders
112 ----------------------------------------
114 You can now configure the width and color of window and menu borders.
115 For example, the default settings could be configured as follows:
117 $ wdwrite WindowMaker FrameBorderWidth 1
118 $ wdwrite WindowMaker FrameBorderColor black
119 $ wdwrite WindowMaker FrameSelectedBorderColor white
122 Keyboard shortcuts to move windows between workspaces
123 -----------------------------------------------------
125 You can now bind keyboard shortcuts - or use the window dropdown menus -
126 to move windows to other workspaces.  You can either move a window directly to
127 a particular workspace or to the "next" or "previous" workspace.
129 The new shortcuts can be configured in WPrefs.
132 Native support for Drawers
133 --------------------------
135 WindowMaker now supports drawers in the dock natively. You can add a dock by
136 right-clicking on a docked appicon and select "Add a drawer". You can now drag
137 appicons to this drawer.
138 You can customize how you want your drawers to auto-expand/collapse and
139 auto-raise/lower, or you can also completely disable them.
142 Improved switch panel functionality
143 -----------------------------------
145 The switch panel can be used to switch between windows of the same WM_CLASS,
146 for example between all open xterms.  If the switch panel is opened as normal
147 with either the "FocusNextKey" or "FocusPrevKey" shortcut, you can switch to
148 the next (or previous) window of the same type as the focused window with the
149 "GroupNextKey" or "GroupPrevKey" shortcut.  If the switch panel is opened with
150 the "GroupNextKey" or "GroupPrevKey" shortcut, it will show only windows of
151 the same type as the window which was focused at the time the panel was opened,
152 and no difference will be seen between the two types of window selection
153 shortcut.
155 The new shortcuts can be configured in WPrefs, where they are described as
156 allowing switching between windows of the same group.
158 To maintain consistency with other popular operating systems, the switch panel
159 is now configured so that it no longer automatically closes when the shift key
160 is pressed and released.
162 To configure the switch panel so that it does close on release of the shift
163 key, which was the traditional Window Maker behavior, run the following
164 command:
166 $ wdwrite WindowMaker StrictWindozeCycling NO
168 If you find yourself regularly opening the switch panel just to visualize open
169 windows, you can run the following command to force the first "FocusNextKey"
170 or similar shortcut to open the panel without switching to a new window.
172 $ wdwrite WindowMaker SwitchPanelOnlyOpen YES
175 --- 0.95.4
177 New window placement strategy
178 -----------------------------
180 Among the window placement algorithms has arrived the "center" placement to
181 get new windows appear at the center of the screen (unless application
182 explicitly specify a position, of course).
185 Removed dependency to CPP
186 -------------------------
188 The menu files used to be pre-processed with CPP, which can be a problem because
189 modern system do not install dev tools by default, and some compilers do not
190 provide a pre-processor anyway. WindowMaker is now autonomous.
193 --- 0.95.3
195 The references to the legacy path /usr/X11R6 have been removed because xorg
196 does not use it in favor of a standard /usr layout. Similarly, the directory
197 /etc/X11/WindowMaker is now /usr/share/WindowMaker.
200 New application Relaunching functionality
201 -----------------------------------------
203 There are now several ways to launch a new instance of an application with the
204 same command line that was originally used to start it.
206 1. By selecting Launch from the application's window menu.
207 2. By using the "Launch new instance of application" keyboard shortcut.
208 3. By clicking the application's appicon with the middle button.
209 4. By double-clicking the application's appicon while holding Control.
211 For example, if you have two xterms open, one started with "xterm" and one
212 started with "xterm -rv", using the Relaunch functionality on the first xterm
213 would run "xterm" and using it on the second would run "xterm -rv".  Thus
214 Relaunching can also be thought of as "cloning" an application.
216 Application Relaunching works by examining the window's WM_COMMAND property and
217 so will not work if it is not set.
220 Options to limit the window/menu title height
221 ---------------------------------------------
223 You can now set the minimum and maximum titlebar heights.
224 For example, to force all titlebars to 24 pixels execute
225 the following commands:
227 $ wdwrite WindowMaker WindowTitleMinHeight 24
228 $ wdwrite WindowMaker WindowTitleMaxHeight 24
229 $ wdwrite WindowMaker MenuTitleMinHeight 24
230 $ wdwrite WindowMaker MenuTitleMaxHeight 24
233 --- 0.95.2
235 New Resizing functionality
236 --------------------------
238 You can now use the mouse wheel and modifier keys to resize windows.
239 MOD+Wheel will resize windows vertically and CTRL+Wheel will resize
240 windows horizontally. MOD+CTRL+Wheel will resize both at the same time.
241 The resize step, or increment can be set in WPrefs in the "Window Handling"
242 page, or in the config file with "ResizeIncrement". If this intrudes into
243 a specific application's functionality, you can disable it on an application-
244 by-application basis by setting the "Do not bind mouse clicks" attribute in
245 "Advanced Options".
247 New Maximize functionality
248 --------------------------
250 Maximus/Maximumize. A new tiled maximization, configured with a keyboard
251 shortcut. Using it will maximize the window to the greatest area such that it
252 will not overlap any other window of the same workspace. This can be configured
253 in WPrefs in the "Keyboard Shortcuts" page, or in the config file with
254 "MaximusKey".
256 Left/right maximization. Now wmaker supports maximizing a window to the
257 left or right half of the screen, making it occupy 50% of the area. This is
258 useful on wide screen displays where you want to bring up two windows side-by-
259 side. The shortcut keys for this can be configured in WPrefs in the "Keyboard
260 Shortcuts" page, or in the config file with "LHMaximizeKey" and "RHMaximizeKey"
262 History and AutoComplete in the run dialog
263 ------------------------------------------
265 The "Run..." dialog now auto-completes executables in your path (triggered by
266 the TAB key) and records the history of past commands (last 500 by default).
267 It can also complete folder names if you start the complete with a "/"
268 To use it replace %a with %A in the "Run..." entry in your WMRootMenu file.
269 See commit 05720d97076ffc1569e5 for more details.
271 Automatic menu generator (wmgenmenu)
272 -----------------------------------
274 There is now a new utility to generate the Window Maker menu automatically,
275 called wmgenmenu. It searches from a list of pre-defined applications the
276 ones which exist in your $PATH and adds them to the corresponding submenus
277 ("Internet", "Terminals", "Editors" etc) of your WM menu. It also supports
278 localization (currently English and German). You can use it like:
280 $ wmgenmenu > WMRootMenu-new
281 $ cp WMRootMenu-new $HOME/GNUstep/Defaults/WMRootMenu
283 and WM will automatically detect the new menu file and use it without
284 restarting wmaker (made possible by the 'inotify' mechanism)
286 Automatic detection of menu changes (via inotify)
287 -------------------------------------------------
289 Window Maker now uses the 'inotify' mechanism from the Linux kernel
290 to automatically detect changes in the WMRootMenu file. So the
291 --no-polling option is now gone and Window Maker does not wake up
292 your CPU unnecessarily (0 wakeups when idle, instead of 4).
293 So if you edit the WMRootMenu file by hand (or by using 'wmgenmenu'),
294 there is no need to restart wmaker for the changes to take effect.
296 DockApp recognition
297 -------------------
299 In addition to applications with only Withdrawn windows, Window Maker
300 will now treat any application with its WM_CLASS res_class set as
301 "DockApp". This provides an easy workaround for toolkits like gtk+ that
302 do not allow creation of windows with the initial_state member of
303 XWMHints set to WithdrawnState.
306 --- 0.92.0
308 GNUstep Installation Directory
309 ------------------------------
311 WPrefs is now installed in /usr/local/bin and /usr/local/share by default.
312 If you use GNUstep and want it to install in /usr/GNUstep/Applications,
313 you may specify --with-gnustepdir=/usr/GNUstep
314 If the GNUSTEP_LOCAL_ROOT environment variable is defined when configure is
315 executed, it will be used (and you don't need to use --with-gnustepdir)
317 Cached Pixmaps Directory
318 ------------------------
320 The directory where Window Maker stores the cached application pixmaps for
321 its later use has changed from ~/GNUstep/.AppInfo/WindowMaker to
322 ~/GNUstep/Library/WindowMaker/CachedPixmaps for better compatibility with
323 the GNUstep path structure.
324 Also WPrefs now stores internal data in ~/GNUstep/Library/WindowMaker/WPrefs
325 (it was ~/GNUstep/.AppInfo/WPrefs before)
327 X Input Methods support in WINGs
328 --------------------------------
330 Preliminary support for X Input Methods was added to textfield and text
331 widgets in WINGs. Input for text in other languages than English should
332 work now (except for kanji which will most likely not work, even though
333 it wasn't tested).
336 Disabling the switch panel
337 --------------------------
339 To disable the panel shown during Alt-tabbing, you may put the following in
340 ~/GNUstep/Defaults/WindowMaker
342 SwitchPanelImages= None;
346 --- 0.91.0
348 Alt-Tab Window Switching
349 ------------------------
351 You can change the appearance of the panel shown during Alt-Tab window switching
352 with the SwitchPanelImages option:
354  (selected_icon_tile_image, background_image, width, height)
356 selected_icon_tile_image is the image used to highlight the currently selected
357 window icon. It must be 64x64 pixels.
359 background_image is the image used in the background of the panel. It must
360 be at least 64x80.
362 width and height are the width and size of the central part of the image.
363 When drawing the panel, the image will be split as:
364                            |W |
365                         +--+--+--+
366                         |  |  |  |
367                         +--+--+--+ -
368                         |  |  |  | H
369                         +--+--+--+ -
370                         |  |  |  |
371                         +--+--+--+
373 The 4 corner images will be copied in their original sizes and the rest will
374 be scaled to the final panel size.
376 background_image, width and height are optional. If you leave them out,
377 a gray panel will be used. If your machine is not very fast, you may want 
378 to use it.
381 --- 0.90.0
384 NetWM / EWMH Support
385 --------------------
387 Support for the EWMH standard has been added. Applications from GNOME 2.x and
388 KDE 3.x should now inter-operate better with Window Maker.
390 Support for the obsolete/legacy GNOME 1.x, KDE 1.x and OpenLook(!) hints was
391 wiped out for the sake of sanity.
394 Antialiased font support
395 ------------------------
397 With the addition of Xft2 support in the WINGs library, now
398 Window Maker can display antialiased text with TrueType or any scalable fonts.
400 You can pick fonts for Window Maker in the Font configuration section of 
401 WPrefs.
403 Antialiased text is enabled by default, but can be disabled by adding
405 AntialiasedText = NO; in ~/GNUstep/Defaults/WMGLOBAL
407 This will disable antialiased text for any WINGs based application. If you
408 only want to disable them for a specific application only, like WindowMaker
409 for example, then add the same option in the applications configuration file,
410 in this case ~/GNUstep/Defaults/WindowMaker
411 For WindowMaker, this can also be achieved from the Expert panel in WPrefs.
413 Note that bitmapped fonts look much better than TrueType when antialiasing is
414 disabled.
416 Global Submenus
417 ---------------
419 Global menus allow for system wide menus that are added to every users
420 application menus. They are located in /usr/etc/WindowMaker/,
421 /usr/local/etc/WindowMaker or whatever is your sysconf directory
422 for WindowMaker. There are 2 files:
424 GlobalMenu.pre, which is added to the beginning of the menu and
425 GlobalMenu.post, which is added to the end of the menu.
427 These are to be proplist format menus, for example:
429 (("Foobar", EXEC, foobar),
430  ("Blabla", EXEC, blabla))
432 or, in case you want a submenu:
434 (("Submenu", 
435         ("Foobar", EXEC, foobar),
436         ("Blabla", EXEC, blabla)))
439 UTF-8 Support
440 -------------
442 Window Maker now uses UTF-8 internally (and thus can display UTF-8 text
443 in window titles and other places). Menus and po files must now be
444 encoded in UTF-8. If your menus contain non ASCII characters, you can convert
445 them to UTF-8 with the following command:
447 iconv -f <current-file-encoding> -t utf-8 <filename> > <filename>.utf8
449 For example:
451 iconv -f iso-8859-1 -t utf-8 menu > menu.utf
452 mv menu.utf menu
455 Icon Panel for Alt-Tabbing
456 --------------------------
458 A panel with icons for the windows that you can switch to will appear
459 when you press Alt-Tab. You can navigate through the windows with Alt-Tab
460 (Alt-Shift-Tab) or with the left/right keys once the panel is shown.
464 --- 0.80.0
466 Shading/Unshading windows using mouse wheel on their titlebar
467 -------------------------------------------------------------
469 In addition to the known methods of shading/unshading a window,  one can now
470 do this by using the mouse wheel on the window's titlebar. The mouse events
471 are interpreted via a mapping in the global WINGs configuration file,
472 WMGLOBAL, by the MouseWheelUp and MouseWheelDown directives which will do
473 shading and unshading respectfully.
475 However, to avoid unwanted triggers of shading/unshading the window, two
476 consecutive mouse wheel events in the same direction are required. The
477 trigger won't occur if the events are separated by more than a double-click's 
478 worth of time, which is technically speaking like making a double-click with
479 the button that corresponds to the mouse wheel direction.
481 Practically speaking, this means that you have to move the mouse wheel up
482 or down quickly, like when you want to quickly scroll over something big.
485 Shared application icons
486 ------------------------
488 Real application icon sharing was implemented in place of the collapse
489 appicon thing. With this applications of the same instance.class will
490 have a single shared application icon and hiding will hide all windows
491 of the application attached to that appicon as if there is a single
492 application. This feature is enabled by default for all applications in
493 the global WMWindowAttributes defaults domain using:
495 "*" = {SharedAppIcon = Yes;};
497 If you're not satisfied with this or want the old behavior back you
498 can revert this (either in the global domain for all users or in your
499 personal WMWindowAttibutes domain) using SharedAppIcon = No; for "*"
500 It can also be enabled/disabled for individual applications as needed.
502 Setting this option can be done using the window's inspector panel in the
503 "Application Specific" section. You can set/unset it for all applications by
504 using the "Defaults for all windows" in the "Window Specification" section
506 Basically using this can have 2 major scenarios:
507 1. Leave it on by default, but disable it for the few specific
508    applications that do not behave well with it. (default)
509 2. Leave it off by default, and enable it for all applications for
510    which you want it enabled.
512 At this point all applications we tested work ok, some of them even
513 work better with this feature turned on: for example xmms and Corel's
514 WorkPerfect8 now only have 1 appicon (they used to have 2 without this
515 feature).
517 This feature is turned off by default for the following applications
518 because it's incompatible with them:
519 1. all GNUstep applications
520 2. applications with an application menu (wterm, Aileron, etc)
521 3. all applications with withdrawn windows only (this means all dockapps)
523 As a side note: wterm can use the shared appicon feature as long as it
524 doesn't use the appmenu (will do this by default). If you start it
525 using the appmenu (wterm -wm) it will disable the shared appicon
526 feature because apps with appmenus are incompatible with this feature.
528 If an application is a GNUstep application or if it has an appmenu, it's
529 detected automatically and the shared appicon is disabled automatically
530 without any user intervention or need to configure anything.
533 Dock/Clip stealing appicons
534 ---------------------------
536 This feature is different form the Clip's "Autoattract Icons" feature
537 as it won't attach any new icon to the dock/clip.
538 What it does, is when you start an application by other means than
539 dock/clip, like for example using the main menu or a terminal, it will
540 search the dock/clips for the presence of an appicon for that
541 application, that is not already running at that moment and will attach
542 the started application to that appicon in the dock/clip if available,
543 making it look like the dock/clip just stole the appicon for the started
544 application. There is an animation for this to offer visual feedback
545 that this happened.
549 --- 0.70.0
551 New dock option
552 ---------------
554 Copy/paste launch in dock.
555 ==========================
557 For example, put netscape %s in the Docked icon for Netscape, select an url
558 somewhere and then middle-click the icon. The command will be launched with
559 the "pasted" string.
562 Xinerama Support
563 ================
565 Supported Xinerama features:
567 - Normal maximization of windows will maximize to only one of the screens,
568 the one where the cursor pointer is.
570 - Full Maximize command in window menu
572 - Place dialogs in the middle of the head where the pointer is
574 - Try to place windows inside one head in non-manual placement modes
577 Less dependencies
578 -----------------
580 starting with 0.70.0 libPropList is no longer required to build Window
581 Maker. PropList handling code was added to WINGs being now better
582 integrated with all the rest. For more details check the Changelog and the 
583 following files:
584 ./WINGs/ChangeLog
585 ./WINGs/NEWS
586 ./WINGs/WINGs/WUtil.h
587 ./WINGs/WINGs/proplist-compat.h
591 --- 0.65.1
593 Removed FocusFollowMouse option, only SloppyFocus present now.
595 Added None option to MoveDisplay and ResizeDisplay
599 --- 0.65.0
601 Single AppIcon
602 --------------
604 Removed --single-appicon patch and replaced it with a application
605 specific collapsing option. Check inspector panel and appicon menu.
607 New options to configure the workspace mouse actions
608 ----------------------------------------------------
610 The following options were removed from the WindowMaker defaults configuration
611 file:
613 SelectWindowsMouseButton, WindowListMouseButton and ApplicationMenuMouseButton.
615 They were replaced with the following 3+1:
617 MouseLeftButtonAction, MouseMiddleButtonAction and MouseRightButtonAction plus
618 MouseWheelAction
620 In the old way because all gravitated around the workspace actions to which
621 specific mouse buttons could have been bound, it allowed one to specify in
622 the configuration file settings which would have led to weird situations
623 that also had undesirable results.
624 For example the same mouse button (for example left) could have been
625 assigned to all workspace actions: 'select windows', 'show window list menu'
626 and 'show applications menu' which of course were not only impossible to
627 accomplish while still having a properly working workspace, but they also
628 allowed one to specify some settings in the configuration file that were
629 never in fact translatable to proper workspace actions.
631 To void this kind of user interface inconsistency, the new options now
632 gravitate around the physical device (the mouse and its buttons) to which
633 specific workspace actions can be bound. This way, even if one assigns the
634 same action to all mouse buttons, that situation while gives redundant and
635 unpractical settings it will still translatable to proper workspace actions:
636 all buttons will execute the same action, but a button will execute only one
637 action at a time.
639 The new options take the following values:
640 all Mouse...ButtonAction can have one of the following values:
642 None, SelectWindows, OpenApplicationsMenu or OpenWindowListMenu
644 MouseWheelAction can be one of None or SwitchWorkspaces
646 If you had the default actions bound to mouse buttons before, then it will
647 work for you without any intervention in the configuration files.
648 Else you need to use WPrefs.app to bind the actions to the mouse buttons
649 again to your old settings. Also if you want to change the mouse wheel
650 behavior regarding workspaces you can now (use WPrefs.app to do this).
652 Client supplied icons
653 ---------------------
655 Window Maker saves the client supplied icons in 
656 ~/GNUstep/Library/WindowMaker/CachedPixmaps in XPM format for later use 
657 when the app is no longer running (to have the image to display for docked 
658 icons for example).
660 Until recently the XPM images saved by Window Maker were incorrect, but a
661 recent fix in the code to save XPM's fixed them. But with this fix, all
662 previously saved XPM's in that directory are no longer readable (they give
663 wrong images on screen or fail to load).
665 To avoid the need for the user to fix this by hand editing WMWindowAttributes 
666 and removing all references to icons in ~/GNUstep/Library/WindowMaker/CachedPixmaps 
667 which can be annoying, new code was added to Window Maker to permit the 
668 regeneration of images in ~/GNUstep/Library/WindowMaker/CachedPixmaps if they are missing.
670 With this addition, all you need to do to fix your old broken images, is to
671 delete all *.xpm files from ~/GNUstep/Library/WindowMaker/CachedPixmaps. Next time the
672 application that is supplying an icon image will start the icon will be
673 recreated if missing, but this time it will be saved with the new XPM save
674 code which produces good XPM images.
675 All the rest of the process is transparent to the user.
677 Hermes library support
678 ----------------------
680 If configure finds hermes library (an optimized pixel format conversion
681 library) installed it will use it to do the pixel format conversion in
682 the wraster library for some cases (TrueColor visuals without dithering).
683 Currently the hermes routines cannot convert to an indexed destination,
684 so we can't use hermes for PseudoColor, GrayScale and StaticGray visuals.
685 Also hermes only does dithering for just 2 combinations of source/destination
686 bits/masks none of them useful to out needs so for dithering we still
687 use out routines.
689 The Hermes library is completely optional, you can build Window Maker
690 without having it, it just speeds up the things a little for some
691 situations.
693 hermes library is available here: http://www.clanlib.org/hermes/
696 --- 0.64.0
698 No Polling of Configuration Files
699 ---------------------------------
701 Running Window Maker with one of -nopolling or --no-polling command line
702 options will make it not to poll every 3 seconds for changes in its
703 configuration files (good for laptops to let them spin disks down when idle).
705 Note:
706 For the ones used with Jim Knoble's 'no polling' patch, this is the same,
707 except that the need to #define ENABLE_NO_POLLING in wconfig.h was removed
708 and the behavior is always available if you use the command line option.
711 --- 0.63.0
714 Interwoven Gradient
715 -------------------
717 interwoven gradients rip^Winspired on blackbox. Will render a texture that
718 interweaves 2 different ones.
720 (igradient, from1, to1, thickness1, from2, to2, thickness2)
722 Will render a interwoven texture with the 2 specified gradients,
723 with each section having the specified thickness.
725 wmagnify
726 --------
728 The wmagnify utility will magnify the area on the screen where
729 your mouse pointer is located, updating it in real-time.
731 tip: maximize it horizontally, make it Omnipresent and Always at Bottom.
732 Then leave it in the bottom of the screen.
734 workspace border
735 ----------------
737 2 options (WorkspaceBorder and WorkspaceBorderSize) were added to allow one to
738 set a small (0..5 pixels) border for the workspace. This border will not be
739 covered by windows when maximizing, allowing one to easily access the clip
740 or map a menu using the mouse in the border area, even when there are
741 windows maximized in both horizontal and vertical directions.
742 WorkspaceBorder can be one of (None, LeftRight, TopBottom, AllDirections)
743 while WorkspaceBorderSize is the size in pixels of the border not to be
744 covered by windows when maximizing (usually a small amount 0..5 pixels).
746 Both options can be set using WPrefs.app in the "Miscellaneous Ergonomic
747 Preferences" section. WPrefs will always limit WorkspaceBorderSize in the
748 (0..5) range.
750 Note that if "full screen maximization" option is set for a window, that
751 window will ignore this border area, maximizing to full screen.
754 --- 0.62.0
757 Optimizations!!
758 ---------------
760 Code for converting wrlib images into X Pixmaps was optimized in many ways,
761 both in the original C code and in assembly for Pentium(tm) processors (with
762 and without MMX(tm)). Depending on the bit depth/color mode and CPU model,
763 performance increases can go up to 150%
766 Weendoze Window Cycling (alt-tab)
767 ---------------------------------
769 Window cycling was changed to weendoze style. 
772 NoBorder Window Attribute
773 --------------------------
775 The NoBorder window attribute (to be put in
776 ~/GNUstep/Defaults/WindowAttributes) was added and will remove the
777 1 pixel border around windows.
780 Removed "Keep Attracted Icons" option from Clip's menu
781 ------------------------------------------------------
783 Since this option brought more confusion than usefulness among users, and
784 since it was usable only in a very limited context, being able to fill up
785 the Clip very easily, it was removed.
786 An alternative way of gaining the same functionality is to use the "Keep icon"
787 entry in the Clip's main menu. Or select multiple icons before calling that
788 entry, to make it apply to more than one icon.
790 Note: "Keep icon", as the obsoleted "Keep Attracted Icons" had nothing to do
791       with holding icons in Clip, while the application is running. Once they
792       are attracted, they are kept until the application close. Using
793       "Keep icon", will only assure that the icon will be kept, even after the
794       application is closed.
796 Please don't ask for this option back. It's error prone, and very unintuitive.
797 Considering it's very restrictive usability, and it's very ambiguous topic, it
798 does not need a special entry in the Clip's menu, taking in count that there
799 are already better alternative ways of gaining the same functionality.
802 Removed DisplayFont Option
803 ---------------------------
805 The font for the geometry size will be controlled by the default
806 WINGs font (SystemFont in WMGLOBAL) now.
809 Others
810 ------
812 - added DONT_SCALE_ICONS compile time option
813 - added --dont-restore cmd line option. When passed to wmaker, it
814   wont restore the state saved previously.
816 --- 0.61.1
818 New libPropList
819 ---------------
821 new libPropList-0.9.1 is REQUIRED to build Window Maker 0.61.1.
822 go grab it and install it first.
825 --- 0.60.1
828 Window Edge Attraction
829 ----------------------
831 Window edge attraction was now added.
833 Attraction = YES/NO;
835 will enable/disable gravity to edge's border.
836 The strength of gravity can be controlled by modify `EdgeResistance' value
837 in WindowMaker configuration file.
840 Titlebar Draw String Plugin
841 ---------------------------
843 FTitleColor, UTitleColor, PTitleColor, MenuTitleColor can be assigned with
844 drawstring plugin instead of plain color. For example:
846     FTitleColor = (
847         function,
848         libwmfun.so,
849         drawPlainString,
850         gold,
851         black,
852         gray49
853     );
855 will invoke function drawplainstring from libwmfun.so and pass 3 colors for
856 arguments. To code new plugin, please see plugin.h for more information.
859 --- 0.60.0
862 User Menu
863 ---------
865 The user menu is now a compile time option disabled by default. 
866 Supply --enable-usermenu to configure to enable it.
869 root menu INCOMPATIBLE changes
870 ------------------------------
872 EXEC <program> will execute the named program
874 SHEXEC <command> will execute the shell command.
876 If you want to execute something like blabla > /dev/null, then use SHEXEC
878 Don't forget to update your menus.
881 New Option For setstyle
882 -----------------------
884 The --ignore flag will tell setstyle to not change the option that is
885 specified, when modifying the Window Maker configurations. For example:
887 setstyle --ignore MenuStyle sometheme.themed will cause the MenuStyle
888 option to not be changed.
890 setstyle --ignore FTitleBack --ignore UTitleBack --ignore PTitleBack bla.themed
891 will load the theme, but keep the titlebar background related options as
892 before.
895 MultiByte Text Support Changes
896 ------------------------------
898 The --enable-kanji configure option is not needed anymore and was removed.
899 To enable support for multibyte text, you must:
900 - set the LANG environment variable to the appropriate value
901 - change the font configurations to contain font sets in the appropriate
902   encodings in both ~/G/D/WindowMaker and ~/G/D/WMGLOBAL (for WPrefs)
903 - set the MultiByteText option to YES in both of the above files
906 New Options
907 -----------
909 WorkspaceNameDisplayPosition =
910 none/center/top/bottom/topleft/topright/bottomleft/bottomright
913 SmoothWorkspaceBack = YES/NO
915 will enable smoothing of scaled workspace background images.
919 Application User Menu Path Changes
920 ----------------------------------
922 Default configuration for user specific menus installed in
923 /usr/local/share/WindowMaker/UserMenus or $(datadir)/WindowMaker/UserMenus
924 and ~/GNUstep/Library/WindowMaker/UserMenus.
927 Omnipresent icons in Clip
928 -------------------------
930 Added ability to set icons docked in Clip to be omnipresent on all workspaces.
931 To set/reset this flag use the clip menu.
932 The Clip menu changed in the following way:
933  - if you bring up the menu from the Clip's main icon, it will contain as
934    before the "Rename Workspace" entry in the second position.
935  - however, if you bring up the menu from any other icon in clip, the
936    "Rename Workspace" menu entry is replaced by "Omnipresent" or
937    "Toggle Omnipresent" depending on the context.
939 This entry will work in the following way, depending on the context:
941 1. If there is no icon selected in the clip, then the menu will contain the
942    entry named "Omnipresent" which will be checked accordingly to the current
943    state of the icon (omnipresent or not), and will let you change the
944    omnipresent state of the icon you brought the menu from.
945 2. If one or more icons are already selected when the Clip menu is called, the
946    entry will be named "Toggle Omnipresent" and will apply to all selected
947    icons trying to toggle their omnipresent state. The icons which will be
948    successfully changed to their new state as requested, will be unselected,
949    while the ones that will fail for some reason to gain their new state,
950    will remain selected.
952 In both cases if there is no success in setting what user requested a panel
953 will inform user of the failure.
954 (Note: trying to set an icon to not-omnipresent will never fail. Failures can
955        be met only when trying to set omnipresent for an icon).
957 The icons set to omnipresent will be marked with a triangle in the upper left
958 corner, having the color of the IconTitleColor.
960 An icon can be set to omnipresent, only if its position is free in all the
961 workspaces, else you will be informed of the problem and asked to fix it first.
962 Also when dragging an omnipresent icon around in Clip, all the icons docked in
963 all the workspaces are shown while the dragging is done, to let one easily see
964 where are free slots in all workspaces.
966 For advanced users, there is also a shortcut to set/reset the omnipresent
967 state of an icon: just use "Shift+MiddleButton" (button2) on the icon you want
968 to change.
969 In this case only the mark in the upper left corner will appear in case of
970 success, or nothing will happen if icon cannot be made omnipresent (advanced
971 users are expected to know why the icon failed to be made omnipresent, so they
972 don't need a panel to explain them why ;) ).
974 Now before you load your gun to start a flame war because this is against your
975 principles you love so much, please sit down and think that this is a feature,
976 which, if you don't use, the old behavior of the Clip is totally preserved.
977 It just adds some extra capabilities to the Clip for people who think that this
978 is useful.
981 XDND drop on dock support
982 -------------------------
984 Support for XDE on dock is now replaced by XDND.
985 To enable, edit src/wconfig.h
989 --- 0.53.0
991 New Options
992 -----------
994 ** MenuStyle
996 MenuStyle=<style>; will change the menu texture style.
998 <style> can be:
999 normal (default): for the traditional one texture per item, with bevels in 
1000 each
1002 singleTexture: for a single texture that spans the whole menu, with bevels
1003 in each item
1005 flat: singleTexture without the bevels
1008 ** ResizebarBack
1010 ResizebarBack=<texture>;
1012 where <texture> is any of the textures you normally use in titlebars and
1013 other places.
1015 If the style file/theme does not contain a ResizebarBack option, setstyle
1016 will automatically hack it so that wmaker will make the theme work like 
1017 before.
1020 New crash dialog panel
1021 ----------------------
1023 From now on, whenever a fatal situation appears, Window Maker will display a
1024 dialog panel to the user and let him choose what to do.
1025 The options are:
1026 - Abort and leave a core file (useful for debugging and getting backtraces)
1027 - Restart Window Maker (default behavior)
1028 - Start alternate window manager (the one defined as fallback, or if not
1029   possible fvwm or twm in this order).
1031 If it will not be able to restart or start the alternate window manager, it
1032 will abort and leave the core file.
1035 Application User Menu
1036 ---------------------
1038 Applications with an appicon can have a user defined menu.
1040 This menu will emulate keyboard events, and will be sent to the applications'
1041 window(s), thus the application must accept key combinations (CTRL+N for
1042 instance).
1044 To enable this feature, #define USER_MENU in src/wconfig.h and place menu
1045 files in ~/GNUstep/Defaults/UserMenus (/usr/local/etc/WindowMaker/UserMenus
1046 globally).
1048 The user menu is in PropList format and the filename is in:
1049 <instance name>.<class name>.menu or application's main window.
1050 (Example: the menu for xcalc would be - xcalc.XCalc.menu)
1052 Example user menu syntax:
1055   "Calculator",
1056   ("Put 1", SHORTCUT, "2"),
1057   ("Functions",
1058     ("Put 2", SHORTCUT, "2"),
1059     ("Put 3,4 and 5", SHORTCUT, (3,4,5))
1060   ),
1061   ("Exit", SHORTCUT, "Control+q")
1066 --- 0.52.0
1069 Appearance Editing in WPrefs
1070 ----------------------------
1072 Added Appearance/Texture editing capability in WPrefs. Workspace background
1073 selection is not yet finished.
1076 Themes
1077 ------
1079 Removed all themes from the source tree, and moved them in a separate package.
1080 You can download the new package from the same place as this package:
1081 ftp://ftp.windowmaker.info/pub/beta/srcs/
1082 Look after WindowMaker-extra-<version-number>.tar.gz
1083 Also WindowMaker-extra pack include the old WindowMaker-data.tar.gz which only
1084 contained icons.
1085 Look for the greatest version number when you download this package.
1088 get-wraster-flags script change
1089 -------------------------------
1091 The name of the options passed to get-wraster-flags changed, to allow a better
1092 name compatibility with the naming conventions used by other software.
1093 The name change was as follows:
1094 --lflags was changed in --ldflags
1095 To allow backward compatibility, with already written software, the old
1096 --lflags option is still recognized, but you are encouraged to move the the
1097 new --ldflags.
1101 --- 0.51.2
1104 New Themes
1105 ----------
1107 Added 2 new cool themes (actually I added in 0.51.1, but forgot
1108 to put it here...) from largo (LeetWM) and BadlandZ (STEP2000).
1111 Full Screen Maximization
1112 ------------------------
1114 The FullMaximize window attribute will allow the window to
1115 be maximized to the full size of the screen (ignoring anything
1116 like titlebar, resizebar, dock, panels etc). It should be useful
1117 for programs that must use the whole screen, like games or things 
1118 like presentation programs.
1121 --- 0.51.1
1123 KDE Application Menu script
1124 ---------------------------
1126 wkdemenu.pl is a converter from KDE application menu structures to wmaker 
1127 menu that can be used as a piped menu. Look wkdemenu.sh for how to use it.
1130 Window Edge Resistance
1131 ----------------------
1133 Window edge resistance was now added. No, feature freeze hasn't been
1134 removed. Its just part of the edge resistance rewrite ;)
1137 New Theme
1138 ---------
1140 Added SteelBlueSilk theme
1142 Installation Path Changes
1143 -------------------------
1145 Default configuration data installed in /usr/local/etc/WindowMaker
1146 or $(sysconfdir)/WindowMaker
1149 --- 0.51.0
1151 Window Maker has become a GNU program (part of the GNU Project).
1153 Title text drop shadow
1154 ----------------------
1156 drop shadow option added for titlebar text. This is a compile time 
1157 option which needs to be defined in src/wconfig.h after you run
1158 configure and before you run make.
1160 New options and syntax for your WindowMaker domain file are:
1162   Shadow = yes/no;
1163   FShadowColor = <color>;  
1164   PShadowColor = <color>;
1165   UShadowColor = <color>;
1166   MShadowColor = <color>;
1168 The shadow option is dynamic (no need for a restart).
1169 MShadowColor is for the menu title text.
1171 libPropList
1172 -----------
1174 WARNING!!! libPropList was removed from the Window Maker distribution
1175 and is being distributed separately. If you don't have it installed yet,
1176 get it from ftp.windowmaker.info/pub/libs and install before building
1177 Window Maker.
1180 signal handling change
1181 ----------------------
1182 SIGHUP will exit wmaker instead of restarting it!!! This is because
1183 GNOME expects the window manager to exit instead of restarting...
1184 Complaints should go to gnome people. SIGUSR1 will restart wmaker now.
1187 script change
1188 -------------
1189 WINGs-flags was removed, and replaced by get-wraster-flags.
1190 Please remove WINGs-flags from your system, since it was obsoleted by
1191 get-wraster-flags.
1192 Continuing to use WINGs-flags can lead to hazardous effects, since is no
1193 longer updated.
1196 docklib
1197 -------
1199 docklib is a little library for making dock applets. It's in the
1200 docklib-0.0.tar.gz file. Unpack it and read the README file there.
1203 Option Changes
1204 --------------
1206 Removed OnTopTransients option
1208 Added OpenTransientOnOwnerWorkspace
1211 Olwm Hint Support
1212 -----------------
1214 OPEN LOOK(tm)/olwm hints support was added.
1216 Read the appropriate section in the README file.
1220 --- 0.50.1
1222 New option for WorkspaceBack. mpixmap is the same as spixmap, but
1223 it will scale the pixmap by keeping the aspect ratio (maximize or maxpect).
1224 The option only works for workspace backgrounds.
1226 Also added IGNORE_PPOSITION compile time flag, which is equivalent
1227 to NoPPosition from fvwm. 
1232 --- 0.50.0
1235 KDE and GNOME
1236 -------------
1238 Added full support for GNOME and KWM hints. 
1239 Read the INSTALL file to see how enable them.
1241 Everything in the so called GNOME window manager bla bla bla pseudo-spec is
1242 implemented.
1244 As for KDE stuff, it implements 90% of everything kwm does, adds some
1245 Window Maker specific extensions to it and still uses half of the memory
1246 kwm does, which should be enough to let you dump kwm ;) For details on what
1247 exactly is implemented, see comments in src/kwm.c Read the README.KDE file 
1248 for more information.
1251 WARNING: Some KDE hints are badly designed, so doing things like using
1252 kpanel's desktop switcher/pager and Window Maker's internal workspace
1253 management functions to create, destroy and rename workspaces at the same 
1254 time might cause unknown effects. To be on the safe side, only
1255 use either of them to manage workspaces. Switching workspaces is hopefully,
1256 safe, so you can switch workspaces from wherever you want.
1260 Workspace Specific Background Images
1261 ------------------------------------
1263 Use the WorkspaceSpecificBack to set background images for specific
1264 workspaces. The WorkspaceBack is used as the default background image.
1266 Example:
1268 WorkspaceSpecificBack = ((solid, red), (cpixmap, ship.jpg, gray), (), 
1269                                 (dgradient, red, blue))
1271 This will set the background image of workspace 1 to (solid, 0),
1272 2 to ship.jpg and 4 to a gradient. Workspace 3 and other workspaces
1273 will have the image defined by WorkspaceBack.
1275 Note that this uses quite some memory...
1278 setstyle/getstyle
1279 -----------------
1281 setstyle now accepts the -nofonts flag, which will load the style
1282 file ignoring all font related options.
1284 Example:
1286 setstyle -nofonts Blabla.style
1289 getstyle can be used to create theme packs. See the usage in the
1290 WindowMaker/README.themes file.
1294 New Texture Type
1295 ----------------
1297 Textured gradients will tile a texture pixmap and combine it with a gradient, 
1298 using an arbitrary opaqueness. 
1300 Syntax is (thgradient, <file>, <opaqueness>, <color1>, <color2>)
1301           (tvgradient, <file>, <opaqueness>, <color1>, <color2>)
1302           (tdgradient, <file>, <opaqueness>, <color1>, <color2>)
1303 where:
1304 <color1> and <color2> are the colors for the gradient,
1305 <file> is the texture file and
1306 <opaqueness> is the opaqueness to merge the texture with the gradient,
1307 ranging from 0 to 255.
1309 Example:
1311 (thgradient, "BlueImage.jpeg", 120, white, black)
1313 The BlackTexture style and Checker theme are examples.
1315 Hints:
1317 You can use any type of pixmap file for this, but small (like 64x32)
1318 grayscale pixmap files should get the best results (fast and low memory
1319 usage). You can use color pixmaps, but it is harder to get the desired effect
1320 with them.
1322 Be warned that this texture type is the slowest.
1326 New Options
1327 -----------
1329 IconTitleBack and IconTitleColor control the color of the
1330 miniwindow title. Both of them are colors.
1332 Example:
1333 IconTitleColor=white;
1334 IconTitleBack=black;
1337 Since this introduces an incompatibility in themes and getting flamed by the
1338 themes ppl isn't the most pleasant thing ("Whaddafuk you're thinking!? You
1339 just broke 500 themes!!!" ;) the setstyle command was hacked so that it will
1340 make old themes work as before, by trying to automatically set the above
1341 options. Note that in some cases it will not have exactly the same results as
1342 before.
1345 StartMaximized window attribute. Will maximize the window when it
1346 is mapped.
1349 AutoRaiseLower option for the Clip. This allows automatic Raise/Lower of the
1350 Clip icons when the mouse pointer enter/leave the Clip. To avoid unwanted
1351 raising/lowering there is a time threshold before raising/lowering.
1352 The thresholds can be changed in wconfig.h by changing one or both of
1353 AUTO_LOWER_DELAY and AUTO_RAISE_DELAY (expressed in milliseconds).
1354 For example if you set AUTO_RAISE_DELAY to 0, then the Clip will be raised as
1355 soon as the mouse pointer enters it's area. Setting AUTO_RAISE_DELAY to a very
1356 big value, will make the Clip to practically do not auto raise unless clicked,
1357 but to be automatically lowered after AUTO_LOWER_DELAY (ms) when leaved.
1360 New ThemePack Format
1361 --------------------
1363 Starting with this version, a new format of themes is being supported.
1364 Before you open pine and start composing your flame, rest assured that
1365 the old format is still supported. The new format is documented
1366 in the WindowMaker/README.themes file.
1369 Root Menu 
1370 ---------
1372 The -noext option for OPEN_MENU will strip whatever is after the last .
1373 in file names that appear on the opened directory. So,
1375 OPEN_MENU ~/bg WITH xv -root -quit
1377 will create a menu with all the images in ~/bg without the extension.
1381 --- 0.20.3
1384 Icon (miniwindow) stacking
1385 --------------------------
1387 If you want miniwindows to reside under normal windows, edit
1388 wconfig.h and change WNormalLevel (just grep for it) to
1389 WDesktopLevel
1392 5 Button Mouse
1393 --------------
1395 If you have a 5 button mouse and want to give some utility for
1396 the extra 2 buttons, edit the appropriate line in src/wconfig.h
1397 Clicking Button4 in the root window will switch you to the previous 
1398 workspace and Button5 will do that for the next.
1401 Option Changes
1402 --------------
1404 put NoWindowOverDock back
1406 KeepOnBottom window attribute
1409 -static command line option
1410 ---------------------------
1412 wmaker -static will start Window Maker in static mode. This will
1413 prevent wmaker from checking or making any configuration changes.
1414 That makes it possible to run wmaker before running wmaker.inst
1417 Hysteresis for menu item selection
1418 ----------------------------------
1420 Hopefully it's intelligent enough, so you won't notice it.
1422 In case you want to know what's it, it's equivalent to that
1423 (insanely long) 2 second delay present in that Windoze95 menu, 
1424 but more useful than annoying (I hope :). To see it, do the following
1425 with your current wmaker version and later with 0.20.3:
1427 - open the apps menu and stick it
1428 - click in the item for the "Workspaces" submenu and hold
1429 - drag the mouse to the 4th or bigger entry (like "Workspace 4") in a
1430 straight line, trying to select the target item before the submenu
1431 is unmapped when you dragged over other items in the main menu
1435 Window Shortcuts
1436 ----------------
1438 Window shortcuts are shortcuts to arbitrary windows. You can make up to 4
1439 shortcuts. To assign a previously bound shortcut to a window use the "Select
1440 Shortcut" submenu in the window commands menu. If the shortcut is not yet
1441 assigned for any window, you can hit the shortcut to assign it to the active
1442 window. The shortcut will do the same as clicking in an entry in the window
1443 list menu. The keys for the shortcuts are defined in the ~/G/D/WindowMaker
1444 file or in WPrefs.app
1446 Option names are:
1448 WindowShortcut1Key through WindowShortcut4Key
1451 --- 0.20.2
1454 The name of WindowMaker was changed to Window Maker.
1456 Window creation animation disabled by default.
1458 xdaliclock -shape
1459 -----------------
1461 If you use it edit src/wconfig.h and #define OPTIMIZE_SHAPE or disable the
1462 titlebar and resizebar for the window. OPTIMIZE_SHAPE will remove the
1463 flickering for xdaliclock and other programs that change their shapes often,
1464 but will increase network traffic considerably. So, if you use xdaliclock
1465 from a remote machine it can get slow.
1468 Applications Menu
1469 -----------------
1471 The applications menu will now use the shell in the SHELL environment
1472 variable to execute EXEC menu commands. If it is unset (I think it's always
1473 automatically set by the shell program) it will use /bin/sh
1476 Extra fancy icon kaboom :)
1477 --------------------------
1479 Edit src/wconfig.h and #define ICON_KABOOM_EXTRA to get
1480 more effects for the icon undocking animation.
1482 Options for superfluous stuff are even more superfluous, so this
1483 will not become run-time.
1486 XDE drag and drop support
1487 -------------------------
1489 Support for XDE drag and drop was added (by "]d" <id@maliwan.org>).
1490 To enable, edit src/wconfig.h
1491 The support works with gtk 1.1.2
1494 libPropList
1495 -----------
1497 libPropList will now be built automatically by wmaker. Which means
1498 the (simplified) building process is now:
1500 ./configure
1501 make
1502 make install
1504 instead of:
1506 tar xzf libPropList.tar.gz
1507 (cd libPropList; make)
1508 make
1509 make install
1511 You also don't need to worry about GNOME libPropList incompatibilities
1512 anymore. 
1515 Bug with focus lost in sloppy focus fixed
1516 -----------------------------------------
1518 The bug only occurs in sloppy or auto focus modes, with AutoFocus disabled
1519 and Superfluous enabled. There is no easy/clean way to fix this, so Window
1520 Maker will disable the animation of window creation if the focus mode is
1521 either sloppy or auto AND AutoFocus=NO.
1523 If you want the animation, enable AutoFocus or use manual focus mode
1524 (preferred).
1527 The NoWindowUnderDock option was removed
1528 ----------------------------------------
1529 To obtain the same result, use the "Keep Dock On Top" option in the dock menu.
1532 Persistent Program Supplied Icons
1533 ---------------------------------
1535 Application supplied icons are now stored, so that the dock will keep
1536 showing them after the app is exited. The icons are stored at
1537 ~/GNUstep/Library/WindowMaker/CachedPixmaps
1540 Sound support
1541 -------------
1543 Sound support is now on by default. Even if you don't use sound the overhead
1544 is very small, and has no impact on performance. If you still want to
1545 optimize it and remove a few hundred of bytes, then use --disable-sound or
1546 --enable-sound=no options when you configure Window Maker.
1549 --- 0.20.0
1551   
1552 Multihead support. wmaker will now manage all screens that are attached to the
1553 display. 
1554 ------------------------------------------------------------------------------
1555   
1557 It does so from a single process (instead of spawning a new process for each
1558 screen, like fvwm does). This keeps memory usage a lot lower than fvwm.
1560 State files have a suffix .n, where n is the number of the screen.
1562 Since I don't have a real multiheaded machine, it probably has bugs.
1564 Superfluous
1565 -----------
1567 Yet another useless superfluous animation. Find out what exactly it is
1568 by yourself :)
1571 exitscript
1572 ----------
1574 ~/G/L/W/exitscript will be called automatically when wmaker is exited.
1577 New runtime options
1578 -------------------
1580 1. Miniaturization animation is now selectable by a run-time option
1581 Add a line with
1583 IconificationStyle = <style>;
1585 to your WindowMaker configuration file.
1586 <style> can be one of: Zoom, Twist, Flip or None
1587 Case doesn't matter, and default is Zoom.
1590 2. Edge resistance.
1591 This can be controlled by setting:
1593 EdgeResistance = xxx;
1595 in your WindowMaker configuration file.
1596 xxx is an integer greater than 0 and represents the number of pixels of edge
1597 resistance. Setting it to 0 (default) will disable this feature.
1599 New theme
1600 ---------
1602 A new theme named Night, is available in this distribution.
1606 --- 0.19.3
1608 GIF support was added. You will need libgif 2.2 to use it.
1610 cpixmap added. Syntax is the same as tpixmap or spixmap
1613 --- 0.19.2
1615 getstyle will include IconBack info in Style files.
1617 --- 0.19.0
1619 libPropList was updated. If you have it installed, you must upgrade or
1620 WPrefs will crash because of bugs in libPropList.
1622 New options
1623 -----------
1625 Balloons!
1626 ---------
1628 WindowTitleBalloons = YES;
1629 will enable balloons for window titles that are not fully visible.
1631 MiniwindowTitleBalloons = YES;
1632 will enable balloons for miniwindow titles.
1634 AppIconBalloons = YES;
1635 for application icons (docked or not)
1638 IconPosition
1639 ------------
1641 IconPosition (the position of the icons) is specified as:
1643 IconPosition = c1c2c3;
1645 where:
1647 c1 can be t or b (meaning top or bottom)
1648 c2 can be l or r (meaning left or right)
1649 c3 can be v or h (meaning vertical or horizontal)
1651 case is insensitive.
1653 For example, 
1654 IconPosition = blh;
1656 is the old iconPosition position.
1658 IconPosition = trv;
1660 will place the icons over the Dock.
1662 New window attribute
1663 --------------------
1665 EmulateAppIcon = YES; will make the window have an application icon.
1666 Only use this option for fully specified windows (like rxvt.Rxvt).
1667 NEVER use in generic window specifications (like * or rxvt).
1668 You must restart the application for the attribute to take effect.
1671 WPrefs.app
1672 ----------
1674 Read WPrefs/README
1677 --- 0.18.1
1679 Boolean values have changed!!! YES, Y and any non-zero integer will
1680 mean TRUE and anything else (including True) will mean FALSE. This
1681 is to conform to the OpenStep values used for booleans and
1682 not cause headaches later, when GNUstep apps also starts using
1683 defaults and users will try using True which won't get recognized.
1686 --- 0.18.0
1688 Clip
1689 ----
1691 Clip button layout was changed. IT IS TEMPORARY AND THE DEFINITIVE LOOK
1692 WILL BE DIFFERENT!!!
1695 libPropList
1696 -----------
1698 More bugs were fixed in it. Upgrade the library if you have an older version
1699 installed, with the one included.
1702 Property list menus
1703 -------------------
1705 Format for property list menus has changed! The redundant array for
1706 submenus was removed, so a menu that looked like:
1708 ( Applications,
1709   ("Xterm", EXEC, "xterm"),
1710   ( 
1711     (Paint,
1712         ("Gimp", EXEC, "gimp"),
1713         ("XV", EXEC, "xv")
1714     )
1715   )
1718 must be changed to:
1720 ( Applications,
1721   ("Xterm", EXEC, "xterm"),
1722   (Paint,
1723         ("Gimp", EXEC, "gimp"),
1724         ("XV", EXEC, "xv")
1725   )
1730 Misc
1731 ----
1733 NUMLOCK_HACK is back. This time it works and is enabled by default.
1734 If you think you don't need it and promise me that you won't send 
1735 "bug" reports saying that shortcuts stop working after a while, you can
1736 disable it ;) It will save some memory and CPU.
1739 Configuration
1740 -------------
1742 Removed the SwapMenuButton option and added 3 finer grained options:
1744 SelectWindowsMouseButton
1745 WindowListMouseButton
1746 ApplicationMenuMouseButton
1748 Values that can be used are Left, Middle, Right and Button1 through Button5
1749 Left is equivalent to Button1, Middle to Button2 and Right to Button3
1752 Removed the WorkspaceChangeDelay option and corresponding action.
1753 Removed AClipColor and IClipColor
1756 Added the SelectKey back
1759 Changed default binding of Window commands menu from F10 to Control+Escape
1761 --- 0.17.4
1763 Misc
1764 -----
1766 libPropList has changed! Upgrade it before compiling wmaker.
1768 Hopefully the bugs that caused wmaker to crash if an error is found
1769 in the config files is fixed. If you do crash wmaker with a bad
1770 file, please try to find out the smallest possible portion of the file
1771 that still crashes wmaker and send it to me.
1774 New Options
1775 -----------
1777 PixmapPath was split to PixmapPath and IconPath. PixmapPath is the path
1778 for the pixmaps used as textures and IconPath is for the icons. 
1779 Don't forget to add IconPath to your current configuration file.
1781 There's also a new library in ~/GNUstep/Library/Icons. You should place
1782 your icons there, since icons are not a WindowMaker specific resource.
1785 DontConfirmKill=YES; will disable the confirmation panel for Kill
1788 --- 0.17.3
1790 Interface Changes
1791 -----------------
1793 Unhide Here in the appicon menu was changed to be the first entry.
1794 This way you can unhide the appicon with a single click without
1795 even moving the pointer.
1798 Clip Commands
1799 -------------
1801 The collect icons commands was renamed to attract icons and
1802 the attract icons options was renamed to Auto attract icons.
1804 The Remove Selected Icons was renamed to Remove Icon(s). It will
1805 act as before if some icon is selected and will remove the clicked
1806 icon (without confirmation) if it is not.
1808 Added a Keep Icon(s) command that will keep the selected icons if
1809 any is selected and the current one if none.
1811 The Move To command was renamed to Move Icon(s) To.
1814 --- 0.17.0
1816 If you have libPropList installed, you might want to re-install it,
1817 replacing with the included libPropList. It has a small bug fix.
1819 Misc. Changes
1820 -------------
1822 Removed --with-gnome and made MWM_HINTS defined by default.
1823 This means that "GNOME support" will work with no additional
1824 flags passed to configure. 
1826 Added support for KDE, by adding a DisableWorkspaceMouseActions option.
1827 Set it to YES and run krootwm to be able to use everything in kfm.
1830 Shortcuts for Root Menu
1831 -----------------------
1833 There is now a new SHORTCUT optional keyword for the menus.
1834 For example, you can bind Control-F1 to xterm with:
1836 "XTerm" SHORTCUT Control+F1 EXEC xterm
1838 or F2 to ARRANGE_ICONS with:
1840 "Arrange Icons" SHORTCUT F2 ARRANGE_ICONS
1843 All commands allowed in the menu file accept the keyword, except for
1844 MENU and OPEN_MENU
1847 Interface Changes
1848 -----------------
1850 ** Configuration of docked applications is now done in a panel instead of
1851 in the menu. 
1853 ** Added a command menu for application icons
1855 ** Shift double-click on the application icon will unhide the app
1856 in the current workspace.
1859 Option Changes
1860 --------------
1862 NotMiniaturizable option changed to NoMiniaturizeButton
1863 NotClosable option changed to NoCloseButton
1866 Speed options values are now UltraFast, Fast, Medium, Slow or UltraSlow
1867                                               ^^^^^^
1869 Removed the Select keyboard binding. You can access it in the window
1870 commands menu.
1872 Removed the ClipMaxIcons option and made it a compile time option.
1874 Removed the ConstrainWindowSize option
1876 Renamed NoSound to DisableSound
1878 Renamed NoAutowrap to DontLinkWorkspaces
1880 Renamed NoDithering to DisableDithering
1882 Renamed NoAnimations to DisableAnimations
1884 Removed the LeftHanded option and added a SwapMenuButton option.
1885 SwapMenuButton will make the rubberband selection in the root window
1886 be bound to the right button and the root menu to the left button.
1889 New way to display temporary icons
1890 ----------------------------------
1892 The icons that are attracted by Clip, but will not be kept after the
1893 application close, are now using a different color for shading, unlike previous
1894 version that always used white. This will improve look for very different color
1895 combinations, and allow the user to control the look of the shaded icon.
1896 The color used for shading the icons is computed as follows:
1898 First a color is computed depending on the IconBack type:
1899  - for solid the color is the solid color itself.
1900  - for simple gradients the color is (from_color + to_color)/2.
1901  - for multiple gradients, the color is the first color in list.
1902  - for pixmaps, the color is the solid color specified for that pixmap.
1904 Then the color is made lighter by multiplying each red/green/blue filed with
1905 1.7 and limiting each field to 0xff in case they exceed this value.
1906 Then this new color will be used by superposing it with the icon we want to
1907 shade, using a proper alpha value.
1909 To control the color for shading is simple:
1911 - In case of multi gradients you just need to put the first color, as the color
1912 you like. WindowMaker do not use the first color in the list to directly build
1913 the gradient, but only when it needs a solid color for something (like in this
1914 case).
1916 - For pixmaps, put the needed color as the solid color the syntax for pixmaps
1917 require. This color is also not used when displaying normal icons, just when
1918 solid colors are needed (like this case).
1920 - For solid color, or simple gradients, in case the color it uses after
1921 computing is not good enough, you can always convert the solid or simple
1922 gradient to a multi gradient with the same look, and use that one. In this
1923 case is simple, just put the needed color as first color in list.
1925 Please note that this will not slow down WindowMaker, because the IconBack is
1926 read only once at startup, and then only if it is changed. After reading it WM
1927 will construct the image of the tile, and use the image instead of recomputing
1928 the gradient every time.
1930 Here are 2 examples of converting solid or simple gradient to a same looking
1931 multi gradient:
1933 IconBack = (solid, Blue);
1934 will become
1935 IconBack = (mhgradient , LightBlue, Blue, Blue);
1936 using LightBlue as color for shading.
1938 IconBack = (dgradient, "#284569", "#082420");
1939 will become
1940 IconBack = (mdgradient, "#183454", "#284569", "#082420");
1941 looking the same, but using #183454 for shading.
1944 New Sound Server Location
1945 -------------------------
1947 The sound server new URL is http://www.frontiernet.net/~southgat/wmsound
1948 Also it seems to be running on FreeBSD too (with little changes maybe).
1951 --- 0.16.1
1953 WINGs
1954 -----
1956 The path for the WINGs resource files was changed. If you don't
1957 do make install, you must move /usr/local/share/WindowMaker/Resources to
1958 /usr/local/share/WINGs
1961 New Options
1962 -----------
1964 The following new options are available:
1965 NewStyle = Yes/No; (static) Replaces --enable-newstyle
1966 DisableDock = Yes/No; (static) Same as -nodock command line option.
1967 DisableClip = Yes/No; (static) Same as -noclip.
1968 Superfluous = Yes/No; (dynamic) Replaces --enable-superfluous.
1970 NOTES.
1971 - The static options are only read at startup. Changing them, needs to restart,
1972   so they will be accounted.
1973 - DisableDock and DisableClip have lower precedence than -nodock -noclip
1974   command line options. If both option/command line option are given, then the
1975   command line option will be accounted.
1978 Start Hidden option
1979 -------------------
1981 The start hidden option was fixed, and made to be an application wide option.
1982 It will apply to every window the application owns. Also its place in the
1983 Attribute Inspector panel, changed accordingly, to reflect this.
1984 The start miniaturized is however still applying to particular windows of an
1985 application, unless the option is set for the class.
1986 Start miniaturized, will override start hidden if both set.
1988 IMPORTANT NOTE.
1989 Because of the way Netscape Communicator is implemented, it is NOT possible
1990 to set the start hidden or miniaturized flags for it. This is because Netscape
1991 chooses to send a second map event to the window it maps. This makes the
1992 window to receive a second map request and to be unhidden or maximized back,
1993 immediately after it was hidden or miniaturized by WindowMaker at startup.
1997 --- 0.16.0
1999 Misc. Changes
2000 -------------
2002 The NextMenuBehaviour option was renamed to WrapMenus
2003 The WorkspaceTiedMiniwindows option was renamed to StickyIcons
2005 The .tif files were renamed to .tiff
2008 Selecting Mini Windows
2009 ----------------------
2011 Now miniaturized windows can be selected as well as normal windows.
2012 You can do this by Shift-Click-ing them. They will be marked, and will follow
2013 you through workspaces like normal selected windows do.
2014 Miniaturizing a window will no longer deselect the window, but will place the
2015 icon and mark it as selected.
2016 The only difference between miniaturized and normal window selection is that
2017 for the moment the rubber-band selecting method works only for normal windows.
2020 Icon Selection Panel in Attributes Editor
2021 -----------------------------------------
2023 Now, selecting icons is as easy as clicking in the file name in a list.
2026 Simplified Options
2027 ------------------
2029 IconSlideStep, IconSlideSlowDown and IconSlideDelay were merged to 
2030 IconSlideSpeed
2032 MenuScrollStep and MenuScrollDelay were merged to MenuScrollSpeed
2034 ShadeStep and ShadeDelay were merged to ShadeSpeed
2037 Valid values for them are: Fast, Normal, Slow or UltraSlow
2039 If you want to fine tune the values, they can be changed in wconfig.h
2040 Send me your set of values with an indication of how fast is your hardware,
2041 so that I can make the default values more adequate.
2044 New Window Attributes
2045 ---------------------
2047 Added StartMiniaturized and StartHidden as window attributes and
2048 removed the previous implementation. Also removed the dock menu entries.
2049 They are now settable in the Attributes Panel.
2051 Also added DontSaveSession attribute. This way, you won't end up with multiple
2052 unwanted copies of the same app after the previous session is restored.
2053 I start X with a xterm in .xinitrc instead of wmaker, which will cause the
2054 xterm restored by wmaker be duplicate. Just add -name something to the
2055 xterm started form .xinitrc and mark DontSaveSession=YES for that window.
2059 User Specifiable Visual IDs
2060 ---------------------------
2062 wmaker now supports different visuals than the default one. It isn't of much
2063 use for most people, but can be useful for lucky SGI users who want it
2064 to use TrueColor instead of the default PseudoColor.
2066 wmaker -visualid VISUAL_ID
2068 where VISUAL_ID is the hex code for the visual you want.
2070 Note: I don't have an SGI box and haven't tested it...
2074 Starting Workspace
2075 ------------------
2077 The starting workspace is identified in the following order:
2078 1. If the app is omnipresent will be mapped on the current workspace.
2079 2. Else if the application have a StartWorkspace option set as attribute
2080    then this one will be used.
2081 3. Else, if the application was started from Clip, the workspace on which
2082    the Clip from where it was started is used.
2083 4. Else the current workspace is used.
2085 Restoring saved sessions will always use the saved workspace, no matter
2086 what other options are, except omnipresent.
2090 --- 0.15.1
2092 Workspace specific mini windows
2093 -------------------------------
2095 The minimized windows can be workspace specific, being more consistent with
2096 the rest. This is because minimized window represents just another state of a
2097 window (like normal or shaded), which all are workspace specific.
2098 This (or the old "present anywhere") behavior can be set using an option in
2099 the WindowMaker database: WorkspaceTiedMiniWindows = Yes/No;
2101 New way to animate the blowing icons
2102 ------------------------------------
2104 There is now a compile time option that allows one to set how the icons are
2105 animated when detaching from dock/clip in superfluous mode.
2106 By default the classic "Falling pieces" animation is used.
2107 If SPREAD_ICON is #define-ed in wconfig.h, then a "Spread in four directions"
2108 animation is used instead. Take a look at the section where this is described
2109 in src/wconfig.h
2110 By default there is #undef SPREAD_ICON to select "Falling pieces" animation.
2112 Auto Collapse for Clip
2113 ----------------------
2115 The clip now supports an option named "Auto Collapse" which can be set from
2116 the clip main menu. When set, clip will stay collapsed, and will show itself
2117 when the mouse moves over it. While the mouse is over it, or over any of the
2118 icons attached to the clip, the clip will stay uncollapsed, letting you to
2119 access the attached icons. This is not true for applications like asclock, or
2120 applets of that kind, because the icon window do not belongs to WindowMaker,
2121 but to the application itself. For such icons you must keep the mouse over the
2122 icon groundplate, else it will collapse back. But usually these type of icons
2123 will not stay in a collapsed clip, since one needs to see what they show.
2124 When the clip is leaved it will collapse back after a delay of 1 second, unless
2125 the mouse is moved back to the clip area. The delay can be set modifying
2126 AUTO_COLLAPSE_DELAY in wconfig.h. Default is 1000 (ms) which means 1 second.
2131 --- 0.15.0
2133 Changed name from Fiend to Clip
2134 -----------------------------------
2136 All occurrences of word Fiend with or without capital F were replaced with
2137 the corresponding Clip (same capital).
2138 This affects all configuration files under ~/GNUstep that contain this word.
2139 It can be referred as "Workspace Dock" too.
2142 New option in Clip menu, and extended Clip behavior
2143 ---------------------------------------------------
2145 The following new items are available in the dock menu:
2147 1. Attract Icons
2148 2. Keep Attracted Icons
2149 3. Collect Icons
2150 4. (Un)select All Icons
2151 5. Remove Selected Icons
2152 6. Move To
2153 7. Start miniaturized    (also available for regular dock)
2154 8. Start hidden          (also available for regular dock)
2155 9. Selected
2156 10. Set icon...          (also available for regular dock)
2159 Here is what they do:
2161 1. "Attract Icons" will let the Clip to attract and attach any new appicon that
2162    is created when an application starts. It will not do this if the Clip is
2163    full. If the Clip is Collapsed then the appicon will be hidden after it is
2164    attached.
2165 2. "Keep Attracted Icons" will tell the Clip to keep the attracted appicons,
2166    after the application is closed. Without this the appicons will vanish,
2167    leaving the Clip in the original state. If you move an appicon that was
2168    attracted from Clip to regular Dock, it will be kept when closed, no matter
2169    what "Keep Attracted Icons" is set to in Clip.
2170 3. "Collect Icons" will collect all appicons that are not yet attached to Dock
2171    or Clip, and attach them to the current workspace Clip. The value of
2172    "Keep Attracted Icons" will apply when applications close. If Clip is
2173    collapsed, the appicons will be hidden.
2174 4. "(Un)select All Icons" will select all icons in the clip if none is
2175    selected, or it will deselect all selected ones. The selected icons are
2176    marked using a small triangle in the bottom right corner of the appicon.
2177    The color of the mark is set using SClipColor in WindowMaker domain
2178    database.
2179 5. "Remove Selected Icons" will remove from Clip all selected icons. The ones
2180    that still run, will be detached, all the others will vanish.
2181 6. "Move To" will transfer all selected icons to another workspace and attach
2182    them to the Clip in that workspace. If none is selected, only the one the
2183    mouse was pressed on will be moved.
2184 7. "Start miniaturized" will launch (or autolaunch if set) the application in
2185    a miniaturized state.
2186 8. "Start hidden" will launch (or autolaunch if set) the application in a
2187    hidden state. Note that only one of the two can be set at a time.
2188 9. "Selected" can be used to toggle the selected state of the appicon
2189    individually. The same can be achieved using Shift-LeftClick on the appicon.
2190    In fact the intended way of toggling the selected state is by using
2191    the Shift-LeftClick on icon. The menu entry is just another way to do the
2192    same.
2193 10. "Set icon..." will allow one to set the image for the appicon. The image
2194    will be updated without restart, and also all appicons in the same
2195    instance.class as the one we set for, will be updated.
2197 So a simple way of avoiding the screen to be filled up with appicons is to set
2198 the "Attract Icons" in the Clip. Also the "Keep Attracted Icons" can be set to
2199 No, so the attracted icons will be deleted when application exits, thus leaving
2200 the Clip clean. If also one to not want to see the appicons that keep filling
2201 the Clip, he can set the Clip to be Collapsed.
2203 Getting rid of unneeded icons in Clip is as simple as selecting them
2204 individually using Shift-LeftClick, and then using the "Remove selected Icons"
2205 entry in menu.
2208 Support for different visuals.
2209 ------------------------------
2211 WindowMaker is now able to support any visual, except DirectColor, in any
2212 depth from 1bpp to 32bpp.
2214 One can start the X server with different visuals, by passing the X server the
2215 right option. For XFree 3.3.x is -cc <id>.
2216 WindowMaker is not yet able to choose a different visual from the Default one
2217 on a given screen, but can use any default visual it finds, except the direct
2218 color visual.
2219 For example starting X like (for XFree 3.3.x, and if the driver for the
2220 card supports this. Read the man page for your X server):
2221 startx -- -bpp 8 -cc 0 will give you the StaticGray visual.
2222 startx -- -bpp 8 -cc 1 will give the GrayScale visual
2223 and so on.
2225 Wrlib code is now generic, and will support any visual except DirectColor in
2226 any depth. Programs written with wrlib can work on different visuals from
2227 the default visual for a given screen.
2228 Behavior in different visuals can be tested using the testgrad program in
2229 wrlib subdirectory in distribution.
2230 testgrad -h will show the usage.
2232 Multidiagonal gradients are also implemented now in wrlib, and a new algorithm
2233 is used to speed up the generation of diagonal gradients.
2236 New arrangement of the directory structure under ~/GNUstep/
2237 ---------------------------------------------------------------
2239 To better adapt to theme support the directory structure changed under
2240 ~/GNUstep/Library/WindowMaker
2242 1. Style directory moved to Styles.
2243 2. Added the following directories: Backgrounds, IconSets, Pixmaps, Sounds and
2244    Themes.
2245 3. The .style files no longer get copied in the user's Styles directory.
2246    Instead they are read from the global /usr/local/share/WindowMaker/Styles
2247    directory.
2249 Under ~/GNUstep/Defaults the following changes occurred:
2251 1. A default WMState is installed by wmaker.inst.
2252    It contains the dockit program assigned to the top icon of the dock, and
2253    the wmsetbg program assigned for the drop command on both dock's and clip's
2254    main icon.
2255    Double clicking the dock's main icon will bring up dockit that will let you
2256    dock any application that do not have an application icon.
2257    Dropping an image on dock's or clip's main icon, from an Offix DND aware
2258    application, will put the image on the background tiled, and will update
2259    WindowMaker domain database file.
2260 2. Syntax of WMState changed a little. The old position will not be restored
2261    when you will first start the new version, but after that it will be
2262    normally remembered. This is because now the main clip icons is only saved
2263    once, not for every workspace.
2264    You should replace Fiend with Clip in any place where it appears, if you
2265    want to keep the old WMState file, else it will not work.
2266 3. At compile time, it will detect if you have support for tif, and will
2267    install a WMWindowAttributes with corresponding image name extension
2268    (.tif or .xpm). This is true only for pixmaps that come with the source
2269    distribution and get installed under /usr/local/share/WindowMaker/Pixmaps
2271 The menu file changed a lot. Old menu file will *not* work with new theme
2272 support, so please upgrade.
2275 New behavior of OPEN_MENU command
2276 ---------------------------------
2278 The OPEN_MENU command now supports the following syntax:
2279 1. File menu handling.
2280    // opens file.menu which must contain a valid menu file and inserts
2281    // it in current position
2282    OPEN_MENU file.menu
2283 2. Pipe menu handling.
2284    // opens command and uses it's stdout to construct menu.
2285    // Command's output must be a valid menu description.
2286    OPEN_MENU | command
2287 3. Directory handling.
2288    // Opens one or more directories and construct a menu with all
2289    // the subdirectories and executable files in them sorted alphabetically.
2290    OPEN_MENU /some/dir [/some/other/dir ...]
2291 4. Directory handling with command.
2292    // Opens one or more directories and construct menu with all
2293    // subdirectories and readable files in them sorted alphabetically,
2294    // preceding each of them with command.
2295    // WITH is a required keyword!!!
2296    OPEN_MENU /some/dir [/some/other/dir ...] WITH command -options
2298 Please note that because of the 'WITH' keyword old menu files no longer work
2299 for the OPEN_MENU with a command.
2302 Theme support
2303 -------------
2305 Theme support is now as easy as untar-ing a tarball in the right place.
2306 Because of the way OPEN_MENU works, they can be installed on a global
2307 shareable basis, or for personal user use.
2308 Themes installed under ~/GNUstep will be available only for a user, but
2309 if if they are installed under /usr/local/share/WindowMaker they will be seen
2310 by all users. This is also true for style files, background images, pixmaps,
2311 etc that get installed under /usr/local/share/WindowMaker.
2312 Themes can be saved or loaded using the Appearance menu.
2314 Also support for different IconSets is available. You can save or load a new
2315 IconSet using the Appearance menu.
2317 Setting background images is now as simple as putting the images in the right
2318 place (~/GNUstep/Library/WindowMaker/Backgrounds or
2319 /usr/local/share/WindowMaker/Backgrounds, or any other place in your
2320 PixmapPath). Then use the Appearance menu. They will be instantly available
2321 since they are opened by a OPEN_MENU command. Also the image do not need to
2322 have a .jpg or any other extension. It will be recognized anyhow.
2323 As an example please see the OpenStep theme supplied with WindowMaker.
2324 The OpenStep image is a jpeg file without extension.
2326 Please keep in mind that anything under /usr/local/share/WindowMaker will be
2327 available for all users.
2330 New options for wmsetbg and getstyle
2331 ------------------------------------
2333 wmsetbg now accepts the following options:
2334 usage: wmsetbg [-options] image
2335 options:
2336  -d             dither image
2337  -m             match  colors
2338  -t             tile   image
2339  -s             scale  image (default)
2340  -u             update WindowMaker domain database
2341  -D <domain>    update <domain> database
2342  -c <cpc>       colors per channel to use
2344 By default, it will try to guess if dithering is needed or not and proceed
2345 accordingly.
2346 Using -d or -m will force it to dither or match colors.
2348 Dithering for more than 15bpp is generally not needed, and will only result
2349 in a slower processing.
2350 Don't use dithering except when needed, because it is slower. Else rely on
2351 wmsetbg which will detect if dithering is needed and use it.
2353 -u will update the WorkspaceBack in the default database domain file in
2354    ~/GNUstep/Defaults/WindowMaker, and let WindowMaker refresh the screen.
2355    Please note that this option only works under WindowMaker, and will have no
2356    effect under other window managers, since it rely on WindowMaker to update
2357    the image after it reads the updated defaults database.
2359 -D <domain> is same as above, but will update the domain <domain> instead of
2360    the default WindowMaker domain.
2362 -c <cpc> will set the color per channel to use. Only needed for PseudoColor
2363    visuals. WindowMaker will automatically pass the value read from the
2364    WindowMaker domain database.
2367 getstyle now have the -t option, that instructs it to read all options
2368 related to theme. Without -t getstyle will read only style options that
2369 means it will not read WorkspaceBack and IconBack.
2370 Use -t when you want to make a theme and need all theme options to be saved.
2371 Else it will extract just a style file.
2374 Session management support
2375 --------------------------
2377 Two new commands are available for use in menus:
2379 SAVE_SESSION and CLEAR_SESSION.
2381 SAVE_SESSION:
2382 will take a snapshot of all running applications, and their current hints
2383 (shaded, hidden, minimized, geometry and workspace they are on),
2384 and save it inside the WMState file. Also the current workspace we are on is
2385 saved. The applications that are running and were started from dock or clip are
2386 marked, so they will be attached to the corresponding dock/clip when restored.
2387 This state is restored every next session, until a new one is saved or
2388 CLEAR_SESSION is used.
2390 CLEAR_SESSION:
2391 will clear any previous saved session.
2393 There is also a run time option named SaveSessionOnExit = Yes/No; that allows
2394 one to automatically save the state of desktop when leaving WindowMaker.
2395 This way next session, the state of the desktop before last exit is restored.
2397 Please note that if this option is set to Yes, than any manual saving of the
2398 state, or any clearing of the state will be overridden when exiting
2399 WindowMaker.
2401 These options are available under the "Workspace" menu.
2404 User WindowMaker configuration files are now merged with global ones
2405 --------------------------------------------------------------------
2407 When starts WindowMaker will look for database domain files under
2408 $GNUSTEP_USER_ROOT/Defaults or ~/GNUstep/Defaults to be read. (In this order).
2410 If they are not available then it will scan for them in
2411 $GNUSTEP_LOCAL_ROOT/Defaults, $GNUSTEP_SYSTEM_ROOT/Defaults or
2412 /usr/local/GNUstep/Defaults (in this order).
2414 Even if the file was found or not, it will always load the corresponding domain
2415 file under /usr/local/share/WindowMaker/Defaults.
2417 Then if the user file was found it will merge it over the global file, else
2418 the global file will be used.
2420 This way any settings that are set by the system administrator in the shared
2421 file will be available for users that do not have them in their config files.
2422 Any option the user have in his config file will override the one in the
2423 shared domain file.
2425 So any new run-time options that appear in WindowMaker domain, do not need to
2426 be set in all user files, except the ones the user wants a different behavior
2427 from the default set for all users in the shared file.
2429 Also it is possible for the user to not have any personal domain databases, and
2430 the global shared ones will be used, but it still needs to have the directory
2431 structure, so WMState gets written on session exit.
2432 So all it needs to have is ~/GNUstep/Defaults directory available.
2435 New behavior of the Slide Icons
2436 -------------------------------
2438 Animation constants are now run-time.
2439 They are:
2440 IconSlideDelay = 0;
2441 IconSlideStep = 5;
2442 IconSlideSlowDown = 50;
2444 To better adapt both slow and fast machines the behavior of sliding icons
2445 changed in the following manner:
2447 Old one was to keep moving the icon with a constant step (default 5 pixels)
2448 until it reached the destination.
2450 Now it will use a new parameter named IconSlideSlowDown to speed up or slow
2451 down the moving.
2453 Instead of moving it with a constant step it will use IconSlideSlowDown to
2454 divide the distance to the destination, and use this value as the first step.
2455 Then is will compute the remaining distance and will again use
2456 IconSlideSlowDown to divide it and get the new step. And so on.
2457 When the step to move becomes smaller than IconSlideStep, IconSlideStep will
2458 be used further until the destination is reached.
2460 This way a nice deceleration effect is achieved, since while the icon
2461 approaches destination, it will use smaller steps, gibing the illusion that
2462 the icons is moving slower.
2464 IconSlideDelay will give the pause between steps, and is expressed in ms.
2466 Giving large values to IconSlideSlowDown (>1024 for 1024x768 screen) will
2467 result in the old "constant step advance" behavior, since the computed step
2468 will always be smaller than IconSlideStep, and the last will be used instead.
2470 Making IconSlideSlowDown = 0 or 1, will result in an instant jump to the
2471 destination without any animation.
2474 Attribute editor
2475 ----------------
2477 Because the icon images on screen automatically update after any change in
2478 WMWindowAttributes domain file, the use of both Save and Apply buttons is no
2479 longer needed. If one wants to just apply the setting to the current window
2480 only, he will only use the Apply button.
2481 If he wants them saved for all applications in the same instance and/or class
2482 the using the Save button will write them to disk, and automatically
2483 WindowMaker will update all the icons that need to be updated on screen.
2486 Sound support
2487 -------------
2489 Some basic sound support is now part of WindowMaker. The sound server is not
2490 yet part of WindowMaker distribution, so you need to download it separately.
2491 This is because is Linux specific, and need some changes before it can be
2492 included.
2493 Until them if you have a Linux system and want to use sound, use the
2494 wmsound-0.5 available at http://www.geocities.com/SiliconValley/Bay/7874
2495 Download that package, and only build the sound server there.
2496 DO NO APPLY ANY PATCHES FROM THERE!, because they are already applied.
2497 Just build the sound and copy the executable in /usr/local/bin
2498 Follow the rest of the install steps described there, except the patch-ing
2499 procedure.
2501 To enable sound for WindowMaker pass --enable-sound to configure.
2503 Also use NoSound = Yes/No; to enable/disable sound at run-time without killing
2504 the sound server.
2506 If you cannot set the sound to work yet, then is not for you.
2507 Wait until the sound server will be fixed and will be part of WindowMaker.
2510 New entries in WindowMaker domain database
2511 ------------------------------------------
2513 The following entries have been added to the run-time options:
2515   SaveSessionOnExit = No;
2517 will autosave (or not) the session state on exit.
2519   WindowPlaceOrigin = "64, 64";
2521 will offset all windows in auto or cascade placement mode with the value
2522 (in pixels) before placing them on screen. First is horizontal direction and
2523 second is vertical.
2524 This do not apply to windows that request a specific position on screen.
2525 This is useful if you want your Clip on the top left corner to not be
2526 overlapped by mapping windows.
2527 It will let it to have a row and a column of docked appicons near the screen
2528 edge, that will not be overlapped by windows.
2529 If you set it to "128, 128" it will have 2 rows and 2 columns not overlapped.
2532   NoSound = No;
2534 Enable/disable sound at run-time without the need of killing the sound server.
2537   MenuScrollDelay = 10;
2538   MenuScrollStep = 5;
2540 Constants for the menu scrolling animation.
2542   IconSlideDelay = 0;
2543   IconSlideStep = 5;
2544   IconSlideSlowDown = 50;
2546 Constants for the icons sliding on screen. Explained above.
2548   ShadeDelay = 0;
2549   ShadeSteps = 15;
2551 Animation parameters for shading a window. How many steps it will take, and the
2552 delay between steps in ms.
2554   DoubleClickTime = 250;
2556 The time for the double click to be considered so. Expressed in ms.
2558   SClipColor = "#6f8ae2";
2560 Color for selected icons in Clip.
2562 All delays are expressed in ms.
2566 --- 0.14.1
2569 *** Enhanced fiend clone.
2571 Here are the new fiend features:
2572 1. Keys for raising/lowering the fiend, and their default values:
2573    FiendLowerKey = None;
2574    FiendRaiseKey = None;
2575    FiendRaiseLowerKey = None;
2577    All reside in WindowMaker configuration file.
2579 2. Added possibility to launch the workspace menu with button1 click on the
2580    idle indicator of fiend, or with button3 click on workspace name on the
2581    fiend.
2583 3. Added Control-button1-click on fiend's idle indicator, to create a new
2584    workspace and move to it. Same action as New item in Workspace menu.
2586 4. Fiend's idle indicator do have a color that reflects its normal/collapsed
2587    state.
2589 5. The delay between changing workspaces from fiend is now a run-time option:
2591    WorkspaceChangeDelay = 700;
2593    in WindowMaker configuration file.
2595 6. Application icons can be moved between dock and fiend now.
2597 7. The way workspaces are changed is controlled now by two run-time options:
2599    AdvanceToNewWorkspace=Yes/No;
2600    CycleWorkspaces=Yes/No;
2602    Both apply to either fiend navigating buttons or to next/prev workspace
2603    keybindings. Both default to No, and are in WindowMaker configuration file.
2605 8. Also added possibility to advance to new workspace, no matter what value
2606    AdvanceToNewWorkspace have, with Control-button1-click on "next workspace"
2607    fiend button.
2610 *** Theme support ***
2612 Spixmap and tpixmap now work. Their syntax is:
2614 SomeStyleOption = (spixmap, file, color);
2615 SomeStyleOption = (tpixmap, file, color);
2617 - spixmap means scaled pixmap, so the image in the file will be scaled to
2618 adapt to the destination's size.
2619 - tpixmap means tiled pixmap, and the image from file will be tiled in the
2620 destination.
2622 file is searched in the PixmapPath, but can be a full path name.
2624 Color is used depending on which Style option is applied.
2625 For example in case of titlebars, color is used for miniwindows titles color.
2626 You are not restricted in selecting that color, but is better to put one
2627 that matches the overall color of the image.
2629 Currently they apply to all the options that accept (solid, color), or any
2630 type of gradient.
2631 This means they also apply to WorkspaceBack and IconBack, which allows theme
2632 support with the simple use of the setstyle and getstyle utilities.
2633 There is no need for an extra theme manager, just to include the needed
2634 options in the style files.
2636 In case of WorkspaceBack, color is used to be set in the background until
2637 the image gets loaded and displayed. This is to avoid the stippled screen
2638 the X server shows, in case the image is big and loads slow.
2639 There is a small utility in the util directory, named wmsetbg which is
2640 used to set the background image. This is needed for WindowMaker not to
2641 freeze while loading and scaling the image.
2642 Currently it is hardcoded in WindowMaker to use wmsetbg to set the background
2643 image, and is better to use it since is smaller that other image manipulation
2644 programs, and it is compiled with support for same image types as WindowMaker.
2645 Since it comes and is installed with WindowMaker, there will be no need to
2646 download and use an external app, which also may not have support for the same
2647 image types as WindowMaker.
2651 --- 0.14.0
2653 *** Fiend clone.
2655 The fiend clone is a dock extender, that lets you dock more than the default
2656 10-12 icons in the dock. It actually lets you dock how many icons you like,
2657 with a current default of 25 per workspace. The fiend have different docked
2658 icons on every workspace. Also the fiend main icon shows you the workspace
2659 you're on and lets you navigate through the workspaces with the small green
2660 buttons on the low right corner.
2661 To save screen space the fiend can be collapsed to the main icon either
2662 from the fiend menu (available with right click on the fiend icons), or
2663 with a double left click on the main fiend icon, which is a toggle for
2664 the collapsed/uncollapsed state.
2665 Collapsed state is marked by a different title color.
2666 Pressing on the small buttons on the low right corner, the workspaces are
2667 changed in increments of 1 to the left or right, but keeping the button
2668 pressed over them will continuously advance through workspaces until the
2669 mouse is moved away from the buttons or the button is released.
2670 The delay between workspace changes is set by FIEND_WKS_CHANGE_DELAY in
2671 src/wconfig.h, and defaults to 700 ms.
2672 Unlike the dock, fiend can hold icons in any directions, and can be placed
2673 in any position on screen.
2675 When an icons is to be docked, but the position can be either in the dock
2676 or in the fiend, the dock will be used first, and the icon will be docked
2677 there.
2679 Here are the new run-time options introduced by the fiend:
2680 Files are located in ~/GNUstep/Defaults/
2682 In WMWindowAttributes:
2683        "Logo.WMFiend" = {Icon = "Cone.xpm";};  - icon for the fiend
2685 In WindowMaker:
2686         FiendMaxIcons = 25;           - the max number of icons in fiend per
2687                                         workspace
2688         FiendTitleFont = "-*-helvetica-bold-r-normal-*-10-*-*-*-*-*-*-*";
2689                                       - the font used to show the current
2690                                         workspace
2691         FiendTitleColor = black;      - color for the uncollapsed fiend title
2692         CFiendTitleColor = "#616161"; - color for the collapsed fiend title
2693         AFiendColor = "#00ba70";      - color for the workspace changing
2694                                         buttons, when active
2695         IFiendColor = "#008000";      - color for the workspace changing
2696                                         buttons, when idle
2698 For the ones who don't want to use fiend, there is a option to wmaker named
2699 -nofiend that can be feed to the command line when starting wmaker.
2700 (This is the equivalent for -nodock, but removes fiend clone).
2702 The syntax of WMState file have changed, but you don't have to worry because
2703 WindowMaker will know to read the old format and will save it and further
2704 will use the new one. You do not need to change your file, for the new version
2705 to work.
2708 --- 0.13.1
2710 *** Enhanced Attribute editor.
2712 Now you can save defaults for all windows.
2713 Please note that only Icon, KeepInsideScreen, and sometimes NoAppIcon
2714 can be useful in a normal environment. But others may have other opinion ;)
2715 If you set AlwaysUserIcon default for all windows, note that apps like
2716 asclock, wmload, wmmail, wmrack, will show that icon instead of their
2717 window.
2719 Now Attribute editor also counts for defaults saved for all windows,
2720 (not only the default "No" for all options hardcoded in WindowMaker),
2721 when saving options for some instance.class specification. This is to
2722 save disk space by saving only the options that differs from global defaults
2723 (either defaults for all windows or the hardcoded valued in WindowMaker).
2725 Attribute Editor now updates on the fly the appicon image or creates/deletes
2726 the appicon if you set that options in the Inspector panel and Apply them.
2727 Modifying Icon file, NoAppIcon or AlwaysUserIcon and Applying them will
2728 result in the image update for the app-icon.
2730 Note that if you apply but not save these options, the miniwindow image will
2731 not be updated. This is because app-icon is always on screen so it can be
2732 updated, but miniwindow image is read from the defaults database and from disk
2733 every time you minimize the window and is destroyed when you restore.
2736 --- 0.13.0
2738 *** Attribute editor is working ;).
2740 How it works is quite obvious.
2741 Anyway, here is a short description.
2743 Save   - only save the configuration in defaults database and updates
2744          WMWindowAttributes
2745 Apply  - only applies the values to the current window
2746 Revert - reverts the values from the defaults database
2748 Note that Save and Revert count for the window specification
2749 (instance & class), that are selected, and save/use the values for/from
2750 that.
2752  The Update button will show the icon who's name was typed in the textfield
2753 If the textfield is empty, will try to use the default icon.
2754 Also saving with and empty textfield for icon, uses the default icon.
2756  The Default button will use the icon in the textfield as default icon
2757 and save that value in WMWindowAttributes (Note that in this case is no
2758 need to press the Save button!). Also if the textfield is empty it will
2759 try to use the old default icon, if available.
2761 *** Now menus are saved between sessions, or over a restart.
2763  Just stick them to the desktop, and you will find them over sessions
2764 until you close them.
2765  Please note that only the root_menu, the window switch_menu and the
2766 workspaces_menu can be saved this way.
2768 *** Changed the lousy Windoze menu behavior.
2770 This applies to 'NextMenuBehaviour = NO;'
2772  Now the items are no more automatically selected if you launch the menu
2773 and the mouse is over some item, if you use a short click to launch the
2774 menu (shorter than the default DBL click time).
2775  If you use a longer click or keep the mouse pressed, the item under mouse
2776 will be selected after that delay, and launched when you will release the
2777 mouse button.
2778  If the click was short, a second one is needed to launch the item.
2780 *** Auto-arrange icons is now a run-time option
2783 AutoArrangeIcons = YES/NO;
2784 in 'WindowMaker'.
2786 *** Added configurable horizontal resize threshold
2789   HorizontalResizeThreshold = <n>;
2791 This will make the n pixels at the exterior side of the corner handle
2792 of the resize bar to restrict to horizontal only resize.
2793 Also you can use Shift-click&drag anywhere on the corner handle to
2794 restrict the resize only to horizontal.
2795 Note that the Shift-click&drag does not depend of the configured threshold
2796 and works completely independent.
2798 *** New option for OPEN_MENU (pipe from command)
2800 OPEN_MENU | /foo/bar/script
2802 will make a menu that is dynamically constructed by /foo/bar/script
2805 --- 0.12.0
2807 *** New option for OPEN_MENU
2809 OPEN_MENU /foo/bar/pics xv -root -quit
2811 will make a menu with all files in /foo/bar/pics and precede them
2812 with EXEC xv -root -quit
2814 thus, making a menu with entries like:
2817 "marble.gif" EXEC xv -root -quit marble.gif
2818 "water.jpg" EXEC xv -root -quit water.jpg
2822 *** Multicolor gradients
2824 (mhgradient, colorX, color1, color2, color3, ..., colorn)
2825 (mvgradient, colorX, color1, color2, color3, ..., colorn)
2827 You can put any number of colors >= 2. 
2829 colorX is a special color that is used as the solid color of the
2830 texture when wmaker needs a solid color (like in miniwindow title and
2831 resizebar)
2833 *** PixmapPath format changed
2835 What used to be
2837 PixmapPath = "/usr/local/share/pixmaps:~/foobar";
2839 must now be
2841 PixmapPath = ("/usr/local/share/pixmaps", "~/foobar");
2844 *** Added OffiX DND in dock
2846 Use the "Set drop arguments..." command in the menu and put a %d
2847 where the dropped object string should be substituted, like:
2849 xedit %d
2851 *** Escape thingies for menu and dock commands:
2853 %w - substitute with current selected X window ID
2854 %s - substitute with current selection
2855 %d - substitute with last dropped object
2856 %a(some text) - opens a input box with "some text" as a title. Then,
2857 the text typed will be substituted there
2859 \r, \n - substitute with corresponding characters
2862 *** The WMState file format has changed a little.
2863 The Command field for the dock application list is now a normal string,
2864 instead of a list. So, remove the parentheses and the commas for the command
2865 and join all the parts. Example:
2867 if it used to be
2869 Command = ( xterm," -geometry", "+10+10" );
2871 then make it
2873 Command = "xterm -geometry +10+10";
2876 --- 0.10.2
2878 AutoFocus = NO; disables automatic focusing of windows
2879 when they are first mapped
2882 --- 0.10.1
2884 titlebar gradients are in a single piece now
2886 the WMDock file was merged into the WMState file. You can insert this
2887 file in WMState and set it's key to Dock. For example, if your WMDock
2888 contains:
2891         Applications = { {Command = (); }};
2892         Position = "-64,0";
2893         Lowered = NO;
2896 and WMState contains:
2899         Workspaces = ( "Workspace 1" );
2902 then you can merge both and have:
2905         Workspaces = ( "Workspace 1" );
2906         Dock = {
2907                 Applications = { {Command = (); }};
2908                 Position = "-64,0";
2909                 Lowered = NO;
2910         };
2915 The configuration format has changed!! Forget everything about the old
2916 format.
2918 dockapp was removed and the old version will not work anymore. 
2920 the dialogs require tcl/tk. they will be rewritten in plain C
2923 These are some tips for people upgrading from older versions and don't want
2924 too many unused files around. There is no problem if you decide to keep 
2925 them for a while.
2927         you can  rm -r ~/gnustep if you don't want anything from there
2929         remove the files in /usr/local/share/WindowMaker before installation
2931         the /usr/local/share/pixmaps directory can be removed