Update Serbian translation from master branch
[wmaker-crm.git] / NEWS
1 NEWS for veteran Window Maker users
2 -----------------------------------
4 -- 0.96.0
6 Hot Corners feature
7 --------------------------
9 Screen corners can be assigned an external command to be
10 executed when the mouse pointer is entering those areas.
11 In WPrefs, "Hot Corner Shortcut Preferences" can be used
12 for configuration or by manually adding a "HotCorners" key
13 and value to "YES" in the ~/GNUstep/Defaults/WindowMaker file.
14 Hot Corners feature is disabled by default.
15 Actions are specified by the "HotCornerActions" and are defined
16 as a four entries list ("top left action", "top right action",
17 "bottom left action", "bottom right action").
18 A screen corner area is a cube shape defined by the "HotCornerEdge"
19 which is a number of pixels from 2 (by default) to 10.
20 To lower the risk of triggering that feature accidentally a
21 "HotCornerDelay" key can be used which is the time before the action
22 is triggered while the pointer is in one of the screen corner.
23 Default value is 250 ms.
26 Screenshot capture feature
27 --------------------------
29 In WPrefs "Keyboard Shortcut Preferences" tab, three new actions can
30 be configured: "Capture a portion of the screen", "Capture a window",
31 "Capture the entire screen". The file is saved in
32 ~/GNUstep/Library/WindowMaker/Screenshots directory under a filename
33 format "screenshot_%Y-%m-%d_at_%H:%M:%S" followed by the extension.
34 Which can be png or jpg based on WRaster dependencies.
37 libXRes is now an optional dependency
38 -------------------------------------
40 XRes the resource extension for the X protocol is used to find the
41 underlying processes (and PIDs) responsible for displaying the windows.
45 --------------------------------------------
47 That hint allows applications that support it to be set as fullscreen on multiple heads.
48 It depends on Xinerama extension support.
51 Keep dock on primary head
52 -------------------------
54 To keep the dock on the primary head in a multi-head setup, set the option
55 "KeepDockOnPrimaryHead" in ~/GNUstep/Defaults/WindowMaker to "YES" or click
56 "Keep dock on primary head" under the WPrefs "Expert User Preferences" tab.
59 -- 0.95.9
61 Configurable SwitchPanel
62 ------------------------
64 SwitchPanel is now more configurable: you can configure the switch panel icon
65 size by setting the "SwitchPanelIconSize" option to your preferred value in
66 ~/GNUstep/Defaults/WindowMaker. The font size used in this panel now is also
67 sensible to changes in the system font.
70 New user configuration directory environment variable
71 -----------------------------------------------------
73 In previous versions, the GNUstep directory used to store a user's Window Maker
74 configuration files was specified by the GNUSTEP_USER_ROOT environment variable,
75 which defaulted to ~/GNUstep.  However, this environment variable was deprecated
76 in gnustep-make v2.  Therefore, it has been replaced by the WMAKER_USER_ROOT
77 environment variable.
80 libXmu is now an optional dependency
81 ------------------------------------
83 If the library is not found, compilation work, the only limitation will arise
84 when trying to install the standard colormap on displays which are not TrueColor.
85 Please note that if you have the library but not the headers, configure will
86 still stop; there is no user option to explicitly disable the library use.
89 -- 0.95.8
91 Move pointer with maximized windows
92 -----------------------------------
94 Implementation for moving mouse pointer within the maximized window.
96 Mouse pointer can be now moved together with window if keyboard was used for
97 arrange maximized windows on screen. This feature can be turned on in WPrefs.app
98 in Expert tab by selecting "Move mouse pointer with half maximized windows.", or
99 setting "PointerWithHalfMaxWindows" to "Yes" on ~/GNUstep/Defaults/WindowMaker
100 file.
103 Alternative way for traverse half-maximized windows
104 ---------------------------------------------------
106 For now, there could be three possible state of the window while using
107 half-maximized feature. Unmaximized window have its state saved during that
108 process, which was use to unmaximize it. For example, if there is a window,
109 which is maximized on the half left side of the screen, and while requesting
110 left-half-maximized, it become unmaximized with size and dimension restored to
111 original state.
113 By setting "AlternativeHalfMaximized" option to "Yes"
114 ~/GNUstep/Defaults/WindowMaker config file (or by using WPrefs.app and option
115 "Alternative transitions between states for half maximized windows."), there
116 would be slightly different change in window "traverse". Given layout depicted
117 below:
119  ┌┬────────────────────┬┐
120  ├┘ ┌───────┐          ├┤
121  │  ├───────┤          ├┤
122  │  │       │          ├┤
123  │  │       │          ├┤
124  │  └───────┘          └┤
125  ├┬┐                    │
126  └┴┴────────────────────┘
128 Window can be moved using keyboard shortcut right-half-maximize:
130  ┌┬─────────┬──────────┬┐
131  ├┘         ├──────────┼┤
132  │          │          ├┤
133  │          │          ├┤
134  │          │          ├┤
135  │          │          ├┤
136  ├┬┐        └──────────┘│
137  └┴┴────────────────────┘
139 Further invoking right-half-maximize will do nothing. Note, that window always
140 can be unmaximzied using appropriate keyboard shortcut or by selecting
141 "Unmaximize" from window menu.
143 Going to opposite direction by invoking left-half-maximize, will make the window
144 maximized in both, vertical and horizontal directions:
146  ┌─────────────────────┬┐
147  ├─────────────────────┼┤
148  │                     ├┤
149  │                     ├┤
150  │                     ├┤
151  │                     ├┤
152  ├┬┬───────────────────┘│
153  └┴┴────────────────────┘
155 Further invoking left-half-maximize, will make the window maximized in half left
156 side od the screen:
158  ┌──────────┬──────────┬┐
159  ├──────────┤          ├┤
160  │          │          ├┤
161  │          │          ├┤
162  │          │          ├┤
163  │          │          └┤
164  ├┬┬────────┘           │
165  └┴┴────────────────────┘
167 And again, further invoking left-half-maximize, will do nothing in this mode.
169 This change affects all possible half-maximized window state also quarters.
170 Issuing bottom-left-corner will take lower left quarter of the screen (nothing
171 is new so far):
173  ┌┬────────────────────┬┐
174  ├┘                    ├┤
175  │                     ├┤
176  ├──────────┐          ├┤
177  ├──────────┤          ├┤
178  │          │          └┤
179  ├┬┬────────┘           │
180  └┴┴────────────────────┘
182 Issuing bottom-right-corner again will change window state to bottom half
183 maximized:
185  ┌┬────────────────────┬┐
186  ├┘                    ├┤
187  │                     ├┤
188  ├─────────────────────┼┤
189  ├─────────────────────┼┤
190  │                     ├┤
191  ├┬┬───────────────────┘│
192  └┴┴────────────────────┘
194 Invoking bottom-right-corner again:
196  ┌┬────────────────────┬┐
197  ├┘                    ├┤
198  │                     ├┤
199  │          ┌──────────┼┤
200  │          ├──────────┼┤
201  │          │          ├┤
202  ├┬┐        └──────────┘│
203  └┴┴────────────────────┘
205 Issuing bottom-right-corner again will have no effect.
208 Move half-maximized windows between the screens
209 -----------------------------------------------
211 New option was introduced to allow change of behaviour of half-maximize windows
212 in multiple displays environment. In such environment it is more natural that
213 half maximized windows would travel from one screen to another. Now it is
214 possible to make that happen by setting an option
215 "MoveHalfMaximizedWindowsBetweenScreens" to "Yes" in
216 ~/GNUstep/Defaults/WindowMaker config file, or by checking "Allow move
217 half-maximized windows between multiple screens." in 'Expert User Preferences"
218 tab in WPrefs.app.
220 For example, given there are two screens in layout where one display is on the
221 left and second display is on the right with window on first screen:
223  ┌┬────────────────┬─────────────────┬┐
224  ├┘ ┌───────┐      │                 ├┤
225  │  ├───────┤      │                 ├┤
226  │  │       │      │                 ├┤
227  │  │       │      │                 ├┤
228  │  └───────┘      │                 └┤
229  ├┬┐               ├┬┬┐               │
230  └┴┴───────────────┴┴┴┴───────────────┘
232 It can be right-half-maximized (using previously defined key combination), so it
233 become:
235  ┌┬───────┬────────┬─────────────────┬┐
236  ├┘       ├────────┤                 ├┤
237  │        │        │                 ├┤
238  │        │        │                 ├┤
239  │        │        │                 ├┤
240  │        │        │                 └┤
241  ├┬┐      └────────┼┬┬┐               │
242  └┴┴───────────────┴┴┴┴───────────────┘
244 In this example there is an assumption that WindowMaker is configured, that
245 maximized windows wont cover mini icons nor dock.
247 Without setting new option to true, issuing another right-half-maximize will
248 restore window dimensions and position to the original state (like on the first
249 figure). With new option set to true it will move window to second screen like:
251  ┌┬────────────────┬────────┬────────┬┐
252  ├┘                ├────────┤        ├┤
253  │                 │        │        ├┤
254  │                 │        │        ├┤
255  │                 │        │        ├┤
256  │                 │        │        └┤
257  ├┬┐               ├┬┬┬─────┘         │
258  └┴┴───────────────┴┴┴┴───────────────┘
260 Another activation of right-half-maxmimize:
262  ┌┬────────────────┬────────┬────────┬┐
263  ├┘                │        ├────────┼┤
264  │                 │        │        ├┤
265  │                 │        │        ├┤
266  │                 │        │        ├┤
267  │                 │        │        ├┤
268  ├┬┐               ├┬┬┐     └────────┘│
269  └┴┴───────────────┴┴┴┴───────────────┘
271 And final activation of right-half-maxmimize:
273  ┌┬────────────────┬───────┬─────────┬┐
274  ├┘                ├───────┤         ├┤
275  │                 │       │         ├┤
276  │                 │       │         ├┤
277  │                 ├───────┘         ├┤
278  │                 │                 └┤
279  ├┬┐               ├┬┬┐               │
280  └┴┴───────────────┴┴┴┴───────────────┘
282 Where window is restored its size (but not position, since it it on different
283 head now). Moving window in directions like left-half-maximize,
284 top-half-maximize and bottom-half-maximize will behave in similar way depending
285 on the layout of displays.
287 Note, that only windows that are half-maximized vertically or horizontally can
288 be moved to another screen due to the fact, that direction of movement of
289 quarter-maximized windows is ambiguous. As for vertical/horizontal-maximize,
290 since doesn't move the window but only stretch it vertically/horizontally this
291 feature also doesn't apply.
294 Snapping a window to the top
295 ----------------------------
297 You can now choose whether snapping a window to the top edge of the screen
298 maximizes it to the top half (the previous and default behavior) or to the
299 full screen by setting "SnapToTopMaximizesFullscreen" to "NO" or "YES",
300 respectively.  This setting can also be changed by unchecking or checking
301 "Snapping a window to the top maximizes it to the full screen" in the
302 "Expert User Preferences" tab in WPrefs.app.
304 Global defaults directory configuration
305 ---------------------------------------
307 You can now configure the global defaults directory, where the system
308 WindowMaker, WMRootMenu, etc. files are stored, by running
309     ./configure --with-defsdatadir=/path/to/defaults
310 at build time.  The previous method, which only partially worked, involved
311 defining the GLOBAL_DEFAULTS_SUBDIR macro.  This is no longer available.
312 Note that the default location is ${sysconfdir}/WindowMaker.
314 -- 0.95.7
316 Window snapping
317 ---------------
319 You can now "snap" a window, i.e., maximize it to a side or corner of the
320 screen, by dragging it to that side or corner.  It is enabled by setting
321 "WindowSnapping = YES" in ~/GNUstep/Defaults/WindowMaker or selecting "Maximize
322 (snap) a window to edge or corner by dragging." under "Expert User Preferences"
323 in WPrefs.app.
325 Note that if "Switch workspaces while dragging windows" is selected under
326 "Workspace Preferences" in WPrefs.app, or if "DontLinkWorkspaces = NO" in
327 ~/GNUstep/Defaults/WindowMaker, then you may only snap a window to the top or
328 bottom of the screen.
330 You may set the distance (in pixels) from the edge or corner of the screen at
331 which a window will begin snapping using "SnapEdgeDetect" and "SnapCornerDetect"
332 in ~/GNUstep/Defaults/WindowMaker or setting "Distance from edge/corner to begin
333 window snap." under "Expert User Preferences" in WPrefs.app.  (The defaults are
334 1 pixel and 10 pixels, respectively).
337 Dragging maximized windows
338 --------------------------
339 You can now control the behavior when a maximized window is dragged by setting
340 the "DragMaximizedWindow" option in ~/GNUstep/Defaults/WindowMaker or by
341 selecting an option from the "When dragging a maximized window..." pop-up button
342 under "Window Handling Preferences" in WPrefs.app.
344 There are four choices:
345 * "Move" ("...change position (normal behavior)" in WPrefs.app) is the default
346   and traditional behavior.  A maximized window is moved when dragged and
347   remains maximized, i.e., it keeps its maximized geometry and can later be
348   unmaximized.
349 * "RestoreGeometry" ("...restore unmaximized geometry") is the behavior standard
350   in desktop environments like GNOME, Cinnamon, and Unity.  A maximized window
351   is moved when dragged and is completely unmaximized, i.e., its unmaximized
352   geometry is restored.
353 * "Unmaximize" ("...consider the window unmaximized") causes a maximized window
354   to be moved when dragged and remains partially maximized, i.e., it keeps its
355   maximized geometry, but is consider to be unmaximized.  In particular, it can
356   be immediately re-maximized.
357 * "NoMove" ("...do not move the window") prevents a maximized window from being
358   moved when dragged.
360 Note that, to accomodate this option in the "Window Handling Preferences" tab in
361 WPrefs.app, the option to "Open dialogs in the same workspace as their owners"
362 (which sets the "OpenTransientOnOwnerWorkspace" option from
363 ~/GNUstep/Defaults/WindowMaker) has been moved to "Expert User Preferences".
366 Mini-Previews instead of Apercus
367 --------------------------------
369 Since the original name was not really clear because it is a French word that
370 is rarely used by British people, it was decided to change it to the more usual
371 Mini-Preview name. The setting is configurable with WPrefs in the Icon
372 Preferences tab, the size is now expressed in pixels directly.
375 Ignore Decoration Hints from GNOME applications
376 -----------------------------------------------
378 The GNOME applications ask Window Maker to get no title bar and no resize bar to
379 their windows by using "Hints". You can re-add them using the Attribute dialog
380 in the Window menu, but if you are using many GNOME applications you may want to
381 tell Window Maker to just ignore them. This is done with the new setting called
382 "IgnoreGtkHints", which is available in the "Expert" panel in WPrefs.
385 Cooperative Window Manager Replacement
386 --------------------------------------
388 The ICCCM defines a protocol for window managers to ask to replace the currently
389 running one; Window Maker now supports it. You can ask Window Maker to take the
390 place of current one by running "wmaker --replace", or any other window manager
391 can ask Window Maker to leave the place for them when started the same way.
392 Please note that this feature must be explicitely enabled at compile time because
393 by default it is not compiled in ("configure --enable-wmreplace").
396 --- 0.95.6
398 More image format supported
399 ---------------------------
401 In addition to a more complete Netpbm image formats support, WindowMaker
402 can now load WebP images. It can also make use of the ImageMagick library
403 to support a lot more formats, like SVG, BMP, TGA...
406 Mini-window apercu
407 ------------------
409 A small preview of window contents can be enabled from WPrefs,
410 in Miscellaneous Ergonomic Preferences, check miniwindow apercus.
411 Apercu size can be configured using the ApercuSize variable with
413 $ wdwrite WindowMaker ApercuSize 4
415 in multiples of the icon size (in this case the apercu size will be four
416 times the icon size).
418 The default size is 2 (twice the icon size).
421 Support for up to 9-buttons mouse
422 ---------------------------------
424 The action for the newly supported buttons can be configured from WPrefs.
427 wmiv, an image viewer application
428 ---------------------------------
430 wmiv is a quick image viewer using wrlib to be run from the command line.
433 --- 0.95.5
435 Support for generated menus in proplist format
436 ----------------------------------------------
438 The root menu now supports a OPEN_PLMENU option to construct a submenu from
439 the output of a command which is proplist format. This can be used e.g. in
440 conjunction with wmmenugen like:
443     "Generated PL Submenu", OPEN_PLMENU,
444     "|| find /usr/share/applications -type f -name '*desktop' | xargs wmmenugen -parser:xdg"
448 New window placements
449 ---------------------
451 Now it is possible to maximize windows to the top/bottom halves
452 of the screen and also to the corners (top/bottom + left/right).
454 The keyboard shortcuts can be configured with WPrefs.
457 Options to configure window/menu borders
458 ----------------------------------------
460 You can now configure the width and color of window and menu borders.
461 For example, the default settings could be configured as follows:
463 $ wdwrite WindowMaker FrameBorderWidth 1
464 $ wdwrite WindowMaker FrameBorderColor black
465 $ wdwrite WindowMaker FrameSelectedBorderColor white
468 Keyboard shortcuts to move windows between workspaces
469 -----------------------------------------------------
471 You can now bind keyboard shortcuts - or use the window dropdown menus -
472 to move windows to other workspaces.  You can either move a window directly to
473 a particular workspace or to the "next" or "previous" workspace.
475 The new shortcuts can be configured in WPrefs.
478 Native support for Drawers
479 --------------------------
481 WindowMaker now supports drawers in the dock natively. You can add a dock by
482 right-clicking on a docked appicon and select "Add a drawer". You can now drag
483 appicons to this drawer.
484 You can customize how you want your drawers to auto-expand/collapse and
485 auto-raise/lower, or you can also completely disable them.
488 Improved switch panel functionality
489 -----------------------------------
491 The switch panel can be used to switch between windows of the same WM_CLASS,
492 for example between all open xterms.  If the switch panel is opened as normal
493 with either the "FocusNextKey" or "FocusPrevKey" shortcut, you can switch to
494 the next (or previous) window of the same type as the focused window with the
495 "GroupNextKey" or "GroupPrevKey" shortcut.  If the switch panel is opened with
496 the "GroupNextKey" or "GroupPrevKey" shortcut, it will show only windows of
497 the same type as the window which was focused at the time the panel was opened,
498 and no difference will be seen between the two types of window selection
499 shortcut.
501 The new shortcuts can be configured in WPrefs, where they are described as
502 allowing switching between windows of the same group.
504 To maintain consistency with other popular operating systems, the switch panel
505 is now configured so that it no longer automatically closes when the shift key
506 is pressed and released.
508 To configure the switch panel so that it does close on release of the shift
509 key, which was the traditional Window Maker behavior, run the following
510 command:
512 $ wdwrite WindowMaker StrictWindozeCycling NO
514 If you find yourself regularly opening the switch panel just to visualize open
515 windows, you can run the following command to force the first "FocusNextKey"
516 or similar shortcut to open the panel without switching to a new window.
518 $ wdwrite WindowMaker SwitchPanelOnlyOpen YES
521 --- 0.95.4
523 New window placement strategy
524 -----------------------------
526 Among the window placement algorithms has arrived the "center" placement to
527 get new windows appear at the center of the screen (unless application
528 explicitly specify a position, of course).
531 Removed dependency to CPP
532 -------------------------
534 The menu files used to be pre-processed with CPP, which can be a problem because
535 modern system do not install dev tools by default, and some compilers do not
536 provide a pre-processor anyway. WindowMaker is now autonomous.
539 --- 0.95.3
541 The references to the legacy path /usr/X11R6 have been removed because xorg
542 does not use it in favor of a standard /usr layout. Similarly, the directory
543 /etc/X11/WindowMaker is now /usr/share/WindowMaker.
546 New application Relaunching functionality
547 -----------------------------------------
549 There are now several ways to launch a new instance of an application with the
550 same command line that was originally used to start it.
552 1. By selecting Launch from the application's window menu.
553 2. By using the "Launch new instance of application" keyboard shortcut.
554 3. By clicking the application's appicon with the middle button.
555 4. By double-clicking the application's appicon while holding Control.
557 For example, if you have two xterms open, one started with "xterm" and one
558 started with "xterm -rv", using the Relaunch functionality on the first xterm
559 would run "xterm" and using it on the second would run "xterm -rv".  Thus
560 Relaunching can also be thought of as "cloning" an application.
562 Application Relaunching works by examining the window's WM_COMMAND property and
563 so will not work if it is not set.
566 Options to limit the window/menu title height
567 ---------------------------------------------
569 You can now set the minimum and maximum titlebar heights.
570 For example, to force all titlebars to 24 pixels execute
571 the following commands:
573 $ wdwrite WindowMaker WindowTitleMinHeight 24
574 $ wdwrite WindowMaker WindowTitleMaxHeight 24
575 $ wdwrite WindowMaker MenuTitleMinHeight 24
576 $ wdwrite WindowMaker MenuTitleMaxHeight 24
579 --- 0.95.2
581 New Resizing functionality
582 --------------------------
584 You can now use the mouse wheel and modifier keys to resize windows.
585 MOD+Wheel will resize windows vertically and CTRL+Wheel will resize
586 windows horizontally. MOD+CTRL+Wheel will resize both at the same time.
587 The resize step, or increment can be set in WPrefs in the "Window Handling"
588 page, or in the config file with "ResizeIncrement". If this intrudes into
589 a specific application's functionality, you can disable it on an application-
590 by-application basis by setting the "Do not bind mouse clicks" attribute in
591 "Advanced Options".
593 New Maximize functionality
594 --------------------------
596 Maximus/Maximumize. A new tiled maximization, configured with a keyboard
597 shortcut. Using it will maximize the window to the greatest area such that it
598 will not overlap any other window of the same workspace. This can be configured
599 in WPrefs in the "Keyboard Shortcuts" page, or in the config file with
600 "MaximusKey".
602 Left/right maximization. Now wmaker supports maximizing a window to the
603 left or right half of the screen, making it occupy 50% of the area. This is
604 useful on wide screen displays where you want to bring up two windows side-by-
605 side. The shortcut keys for this can be configured in WPrefs in the "Keyboard
606 Shortcuts" page, or in the config file with "LHMaximizeKey" and "RHMaximizeKey"
608 History and AutoComplete in the run dialog
609 ------------------------------------------
611 The "Run..." dialog now auto-completes executables in your path (triggered by
612 the TAB key) and records the history of past commands (last 500 by default).
613 It can also complete folder names if you start the complete with a "/"
614 To use it replace %a with %A in the "Run..." entry in your WMRootMenu file.
615 See commit 05720d97076ffc1569e5 for more details.
617 Automatic menu generator (wmgenmenu)
618 -----------------------------------
620 There is now a new utility to generate the Window Maker menu automatically,
621 called wmgenmenu. It searches from a list of pre-defined applications the
622 ones which exist in your $PATH and adds them to the corresponding submenus
623 ("Internet", "Terminals", "Editors" etc) of your WM menu. It also supports
624 localization (currently English and German). You can use it like:
626 $ wmgenmenu > WMRootMenu-new
627 $ cp WMRootMenu-new $HOME/GNUstep/Defaults/WMRootMenu
629 and WM will automatically detect the new menu file and use it without
630 restarting wmaker (made possible by the 'inotify' mechanism)
632 Automatic detection of menu changes (via inotify)
633 -------------------------------------------------
635 Window Maker now uses the 'inotify' mechanism from the Linux kernel
636 to automatically detect changes in the WMRootMenu file. So the
637 --no-polling option is now gone and Window Maker does not wake up
638 your CPU unnecessarily (0 wakeups when idle, instead of 4).
639 So if you edit the WMRootMenu file by hand (or by using 'wmgenmenu'),
640 there is no need to restart wmaker for the changes to take effect.
642 DockApp recognition
643 -------------------
645 In addition to applications with only Withdrawn windows, Window Maker
646 will now treat any application with its WM_CLASS res_class set as
647 "DockApp". This provides an easy workaround for toolkits like gtk+ that
648 do not allow creation of windows with the initial_state member of
649 XWMHints set to WithdrawnState.
652 --- 0.92.0
654 GNUstep Installation Directory
655 ------------------------------
657 WPrefs is now installed in /usr/local/bin and /usr/local/share by default.
658 If you use GNUstep and want it to install in /usr/GNUstep/Applications,
659 you may specify --with-gnustepdir=/usr/GNUstep
660 If the GNUSTEP_LOCAL_ROOT environment variable is defined when configure is
661 executed, it will be used (and you don't need to use --with-gnustepdir)
663 Cached Pixmaps Directory
664 ------------------------
666 The directory where Window Maker stores the cached application pixmaps for
667 its later use has changed from ~/GNUstep/.AppInfo/WindowMaker to
668 ~/GNUstep/Library/WindowMaker/CachedPixmaps for better compatibility with
669 the GNUstep path structure.
670 Also WPrefs now stores internal data in ~/GNUstep/Library/WindowMaker/WPrefs
671 (it was ~/GNUstep/.AppInfo/WPrefs before)
673 X Input Methods support in WINGs
674 --------------------------------
676 Preliminary support for X Input Methods was added to textfield and text
677 widgets in WINGs. Input for text in other languages than English should
678 work now (except for kanji which will most likely not work, even though
679 it wasn't tested).
682 Disabling the switch panel
683 --------------------------
685 To disable the panel shown during Alt-tabbing, you may put the following in
686 ~/GNUstep/Defaults/WindowMaker
688 SwitchPanelImages= None;
692 --- 0.91.0
694 Alt-Tab Window Switching
695 ------------------------
697 You can change the appearance of the panel shown during Alt-Tab window switching
698 with the SwitchPanelImages option:
700  (selected_icon_tile_image, background_image, width, height)
702 selected_icon_tile_image is the image used to highlight the currently selected
703 window icon. It must be 64x64 pixels.
705 background_image is the image used in the background of the panel. It must
706 be at least 64x80.
708 width and height are the width and size of the central part of the image.
709 When drawing the panel, the image will be split as:
710                            |W |
711                         +--+--+--+
712                         |  |  |  |
713                         +--+--+--+ -
714                         |  |  |  | H
715                         +--+--+--+ -
716                         |  |  |  |
717                         +--+--+--+
719 The 4 corner images will be copied in their original sizes and the rest will
720 be scaled to the final panel size.
722 background_image, width and height are optional. If you leave them out,
723 a gray panel will be used. If your machine is not very fast, you may want
724 to use it.
727 --- 0.90.0
730 NetWM / EWMH Support
731 --------------------
733 Support for the EWMH standard has been added. Applications from GNOME 2.x and
734 KDE 3.x should now inter-operate better with Window Maker.
736 Support for the obsolete/legacy GNOME 1.x, KDE 1.x and OpenLook(!) hints was
737 wiped out for the sake of sanity.
740 Antialiased font support
741 ------------------------
743 With the addition of Xft2 support in the WINGs library, now
744 Window Maker can display antialiased text with TrueType or any scalable fonts.
746 You can pick fonts for Window Maker in the Font configuration section of
747 WPrefs.
749 Antialiased text is enabled by default, but can be disabled by adding
751 AntialiasedText = NO; in ~/GNUstep/Defaults/WMGLOBAL
753 This will disable antialiased text for any WINGs based application. If you
754 only want to disable them for a specific application only, like WindowMaker
755 for example, then add the same option in the applications configuration file,
756 in this case ~/GNUstep/Defaults/WindowMaker
757 For WindowMaker, this can also be achieved from the Expert panel in WPrefs.
759 Note that bitmapped fonts look much better than TrueType when antialiasing is
760 disabled.
762 Global Submenus
763 ---------------
765 Global menus allow for system wide menus that are added to every users
766 application menus. They are located in /usr/etc/WindowMaker/,
767 /usr/local/etc/WindowMaker or whatever is your sysconf directory
768 for WindowMaker. There are 2 files:
770 GlobalMenu.pre, which is added to the beginning of the menu and
771 GlobalMenu.post, which is added to the end of the menu.
773 These are to be proplist format menus, for example:
775 (("Foobar", EXEC, foobar),
776  ("Blabla", EXEC, blabla))
778 or, in case you want a submenu:
780 (("Submenu",
781         ("Foobar", EXEC, foobar),
782         ("Blabla", EXEC, blabla)))
785 UTF-8 Support
786 -------------
788 Window Maker now uses UTF-8 internally (and thus can display UTF-8 text
789 in window titles and other places). Menus and po files must now be
790 encoded in UTF-8. If your menus contain non ASCII characters, you can convert
791 them to UTF-8 with the following command:
793 iconv -f <current-file-encoding> -t utf-8 <filename> > <filename>.utf8
795 For example:
797 iconv -f iso-8859-1 -t utf-8 menu > menu.utf
798 mv menu.utf menu
801 Icon Panel for Alt-Tabbing
802 --------------------------
804 A panel with icons for the windows that you can switch to will appear
805 when you press Alt-Tab. You can navigate through the windows with Alt-Tab
806 (Alt-Shift-Tab) or with the left/right keys once the panel is shown.
810 --- 0.80.0
812 Shading/Unshading windows using mouse wheel on their titlebar
813 -------------------------------------------------------------
815 In addition to the known methods of shading/unshading a window,  one can now
816 do this by using the mouse wheel on the window's titlebar. The mouse events
817 are interpreted via a mapping in the global WINGs configuration file,
818 WMGLOBAL, by the MouseWheelUp and MouseWheelDown directives which will do
819 shading and unshading respectfully.
821 However, to avoid unwanted triggers of shading/unshading the window, two
822 consecutive mouse wheel events in the same direction are required. The
823 trigger won't occur if the events are separated by more than a double-click's
824 worth of time, which is technically speaking like making a double-click with
825 the button that corresponds to the mouse wheel direction.
827 Practically speaking, this means that you have to move the mouse wheel up
828 or down quickly, like when you want to quickly scroll over something big.
831 Shared application icons
832 ------------------------
834 Real application icon sharing was implemented in place of the collapse
835 appicon thing. With this applications of the same instance.class will
836 have a single shared application icon and hiding will hide all windows
837 of the application attached to that appicon as if there is a single
838 application. This feature is enabled by default for all applications in
839 the global WMWindowAttributes defaults domain using:
841 "*" = {SharedAppIcon = Yes;};
843 If you're not satisfied with this or want the old behavior back you
844 can revert this (either in the global domain for all users or in your
845 personal WMWindowAttibutes domain) using SharedAppIcon = No; for "*"
846 It can also be enabled/disabled for individual applications as needed.
848 Setting this option can be done using the window's inspector panel in the
849 "Application Specific" section. You can set/unset it for all applications by
850 using the "Defaults for all windows" in the "Window Specification" section
852 Basically using this can have 2 major scenarios:
853 1. Leave it on by default, but disable it for the few specific
854    applications that do not behave well with it. (default)
855 2. Leave it off by default, and enable it for all applications for
856    which you want it enabled.
858 At this point all applications we tested work ok, some of them even
859 work better with this feature turned on: for example xmms and Corel's
860 WorkPerfect8 now only have 1 appicon (they used to have 2 without this
861 feature).
863 This feature is turned off by default for the following applications
864 because it's incompatible with them:
865 1. all GNUstep applications
866 2. applications with an application menu (wterm, Aileron, etc)
867 3. all applications with withdrawn windows only (this means all dockapps)
869 As a side note: wterm can use the shared appicon feature as long as it
870 doesn't use the appmenu (will do this by default). If you start it
871 using the appmenu (wterm -wm) it will disable the shared appicon
872 feature because apps with appmenus are incompatible with this feature.
874 If an application is a GNUstep application or if it has an appmenu, it's
875 detected automatically and the shared appicon is disabled automatically
876 without any user intervention or need to configure anything.
879 Dock/Clip stealing appicons
880 ---------------------------
882 This feature is different form the Clip's "Autoattract Icons" feature
883 as it won't attach any new icon to the dock/clip.
884 What it does, is when you start an application by other means than
885 dock/clip, like for example using the main menu or a terminal, it will
886 search the dock/clips for the presence of an appicon for that
887 application, that is not already running at that moment and will attach
888 the started application to that appicon in the dock/clip if available,
889 making it look like the dock/clip just stole the appicon for the started
890 application. There is an animation for this to offer visual feedback
891 that this happened.
895 --- 0.70.0
897 New dock option
898 ---------------
900 Copy/paste launch in dock.
901 ==========================
903 For example, put netscape %s in the Docked icon for Netscape, select an url
904 somewhere and then middle-click the icon. The command will be launched with
905 the "pasted" string.
908 Xinerama Support
909 ================
911 Supported Xinerama features:
913 - Normal maximization of windows will maximize to only one of the screens,
914 the one where the cursor pointer is.
916 - Full Maximize command in window menu
918 - Place dialogs in the middle of the head where the pointer is
920 - Try to place windows inside one head in non-manual placement modes
923 Less dependencies
924 -----------------
926 starting with 0.70.0 libPropList is no longer required to build Window
927 Maker. PropList handling code was added to WINGs being now better
928 integrated with all the rest. For more details check the Changelog and the
929 following files:
930 ./WINGs/ChangeLog
931 ./WINGs/NEWS
932 ./WINGs/WINGs/WUtil.h
933 ./WINGs/WINGs/proplist-compat.h
937 --- 0.65.1
939 Removed FocusFollowMouse option, only SloppyFocus present now.
941 Added None option to MoveDisplay and ResizeDisplay
945 --- 0.65.0
947 Single AppIcon
948 --------------
950 Removed --single-appicon patch and replaced it with a application
951 specific collapsing option. Check inspector panel and appicon menu.
953 New options to configure the workspace mouse actions
954 ----------------------------------------------------
956 The following options were removed from the WindowMaker defaults configuration
957 file:
959 SelectWindowsMouseButton, WindowListMouseButton and ApplicationMenuMouseButton.
961 They were replaced with the following 3+1:
963 MouseLeftButtonAction, MouseMiddleButtonAction and MouseRightButtonAction plus
964 MouseWheelAction
966 In the old way because all gravitated around the workspace actions to which
967 specific mouse buttons could have been bound, it allowed one to specify in
968 the configuration file settings which would have led to weird situations
969 that also had undesirable results.
970 For example the same mouse button (for example left) could have been
971 assigned to all workspace actions: 'select windows', 'show window list menu'
972 and 'show applications menu' which of course were not only impossible to
973 accomplish while still having a properly working workspace, but they also
974 allowed one to specify some settings in the configuration file that were
975 never in fact translatable to proper workspace actions.
977 To void this kind of user interface inconsistency, the new options now
978 gravitate around the physical device (the mouse and its buttons) to which
979 specific workspace actions can be bound. This way, even if one assigns the
980 same action to all mouse buttons, that situation while gives redundant and
981 unpractical settings it will still translatable to proper workspace actions:
982 all buttons will execute the same action, but a button will execute only one
983 action at a time.
985 The new options take the following values:
986 all Mouse...ButtonAction can have one of the following values:
988 None, SelectWindows, OpenApplicationsMenu or OpenWindowListMenu
990 MouseWheelAction can be one of None or SwitchWorkspaces
992 If you had the default actions bound to mouse buttons before, then it will
993 work for you without any intervention in the configuration files.
994 Else you need to use WPrefs.app to bind the actions to the mouse buttons
995 again to your old settings. Also if you want to change the mouse wheel
996 behavior regarding workspaces you can now (use WPrefs.app to do this).
998 Client supplied icons
999 ---------------------
1001 Window Maker saves the client supplied icons in
1002 ~/GNUstep/Library/WindowMaker/CachedPixmaps in XPM format for later use
1003 when the app is no longer running (to have the image to display for docked
1004 icons for example).
1006 Until recently the XPM images saved by Window Maker were incorrect, but a
1007 recent fix in the code to save XPM's fixed them. But with this fix, all
1008 previously saved XPM's in that directory are no longer readable (they give
1009 wrong images on screen or fail to load).
1011 To avoid the need for the user to fix this by hand editing WMWindowAttributes
1012 and removing all references to icons in ~/GNUstep/Library/WindowMaker/CachedPixmaps
1013 which can be annoying, new code was added to Window Maker to permit the
1014 regeneration of images in ~/GNUstep/Library/WindowMaker/CachedPixmaps if they are missing.
1016 With this addition, all you need to do to fix your old broken images, is to
1017 delete all *.xpm files from ~/GNUstep/Library/WindowMaker/CachedPixmaps. Next time the
1018 application that is supplying an icon image will start the icon will be
1019 recreated if missing, but this time it will be saved with the new XPM save
1020 code which produces good XPM images.
1021 All the rest of the process is transparent to the user.
1023 Hermes library support
1024 ----------------------
1026 If configure finds hermes library (an optimized pixel format conversion
1027 library) installed it will use it to do the pixel format conversion in
1028 the wraster library for some cases (TrueColor visuals without dithering).
1029 Currently the hermes routines cannot convert to an indexed destination,
1030 so we can't use hermes for PseudoColor, GrayScale and StaticGray visuals.
1031 Also hermes only does dithering for just 2 combinations of source/destination
1032 bits/masks none of them useful to out needs so for dithering we still
1033 use out routines.
1035 The Hermes library is completely optional, you can build Window Maker
1036 without having it, it just speeds up the things a little for some
1037 situations.
1039 hermes library is available here: http://www.clanlib.org/hermes/
1042 --- 0.64.0
1044 No Polling of Configuration Files
1045 ---------------------------------
1047 Running Window Maker with one of -nopolling or --no-polling command line
1048 options will make it not to poll every 3 seconds for changes in its
1049 configuration files (good for laptops to let them spin disks down when idle).
1051 Note:
1052 For the ones used with Jim Knoble's 'no polling' patch, this is the same,
1053 except that the need to #define ENABLE_NO_POLLING in wconfig.h was removed
1054 and the behavior is always available if you use the command line option.
1057 --- 0.63.0
1060 Interwoven Gradient
1061 -------------------
1063 interwoven gradients rip^Winspired on blackbox. Will render a texture that
1064 interweaves 2 different ones.
1066 (igradient, from1, to1, thickness1, from2, to2, thickness2)
1068 Will render a interwoven texture with the 2 specified gradients,
1069 with each section having the specified thickness.
1071 wmagnify
1072 --------
1074 The wmagnify utility will magnify the area on the screen where
1075 your mouse pointer is located, updating it in real-time.
1077 tip: maximize it horizontally, make it Omnipresent and Always at Bottom.
1078 Then leave it in the bottom of the screen.
1080 workspace border
1081 ----------------
1083 2 options (WorkspaceBorder and WorkspaceBorderSize) were added to allow one to
1084 set a small (0..5 pixels) border for the workspace. This border will not be
1085 covered by windows when maximizing, allowing one to easily access the clip
1086 or map a menu using the mouse in the border area, even when there are
1087 windows maximized in both horizontal and vertical directions.
1088 WorkspaceBorder can be one of (None, LeftRight, TopBottom, AllDirections)
1089 while WorkspaceBorderSize is the size in pixels of the border not to be
1090 covered by windows when maximizing (usually a small amount 0..5 pixels).
1092 Both options can be set using WPrefs.app in the "Miscellaneous Ergonomic
1093 Preferences" section. WPrefs will always limit WorkspaceBorderSize in the
1094 (0..5) range.
1096 Note that if "full screen maximization" option is set for a window, that
1097 window will ignore this border area, maximizing to full screen.
1100 --- 0.62.0
1103 Optimizations!!
1104 ---------------
1106 Code for converting wrlib images into X Pixmaps was optimized in many ways,
1107 both in the original C code and in assembly for Pentium(tm) processors (with
1108 and without MMX(tm)). Depending on the bit depth/color mode and CPU model,
1109 performance increases can go up to 150%
1112 Weendoze Window Cycling (alt-tab)
1113 ---------------------------------
1115 Window cycling was changed to weendoze style.
1118 NoBorder Window Attribute
1119 --------------------------
1121 The NoBorder window attribute (to be put in
1122 ~/GNUstep/Defaults/WindowAttributes) was added and will remove the
1123 1 pixel border around windows.
1126 Removed "Keep Attracted Icons" option from Clip's menu
1127 ------------------------------------------------------
1129 Since this option brought more confusion than usefulness among users, and
1130 since it was usable only in a very limited context, being able to fill up
1131 the Clip very easily, it was removed.
1132 An alternative way of gaining the same functionality is to use the "Keep icon"
1133 entry in the Clip's main menu. Or select multiple icons before calling that
1134 entry, to make it apply to more than one icon.
1136 Note: "Keep icon", as the obsoleted "Keep Attracted Icons" had nothing to do
1137       with holding icons in Clip, while the application is running. Once they
1138       are attracted, they are kept until the application close. Using
1139       "Keep icon", will only assure that the icon will be kept, even after the
1140       application is closed.
1142 Please don't ask for this option back. It's error prone, and very unintuitive.
1143 Considering it's very restrictive usability, and it's very ambiguous topic, it
1144 does not need a special entry in the Clip's menu, taking in count that there
1145 are already better alternative ways of gaining the same functionality.
1148 Removed DisplayFont Option
1149 ---------------------------
1151 The font for the geometry size will be controlled by the default
1152 WINGs font (SystemFont in WMGLOBAL) now.
1155 Others
1156 ------
1158 - added DONT_SCALE_ICONS compile time option
1159 - added --dont-restore cmd line option. When passed to wmaker, it
1160   wont restore the state saved previously.
1162 --- 0.61.1
1164 New libPropList
1165 ---------------
1167 new libPropList-0.9.1 is REQUIRED to build Window Maker 0.61.1.
1168 go grab it and install it first.
1171 --- 0.60.1
1174 Window Edge Attraction
1175 ----------------------
1177 Window edge attraction was now added.
1179 Attraction = YES/NO;
1181 will enable/disable gravity to edge's border.
1182 The strength of gravity can be controlled by modify `EdgeResistance' value
1183 in WindowMaker configuration file.
1186 Titlebar Draw String Plugin
1187 ---------------------------
1189 FTitleColor, UTitleColor, PTitleColor, MenuTitleColor can be assigned with
1190 drawstring plugin instead of plain color. For example:
1192     FTitleColor = (
1193         function,
1194         libwmfun.so,
1195         drawPlainString,
1196         gold,
1197         black,
1198         gray49
1199     );
1201 will invoke function drawplainstring from libwmfun.so and pass 3 colors for
1202 arguments. To code new plugin, please see plugin.h for more information.
1205 --- 0.60.0
1208 User Menu
1209 ---------
1211 The user menu is now a compile time option disabled by default.
1212 Supply --enable-usermenu to configure to enable it.
1215 root menu INCOMPATIBLE changes
1216 ------------------------------
1218 EXEC <program> will execute the named program
1220 SHEXEC <command> will execute the shell command.
1222 If you want to execute something like blabla > /dev/null, then use SHEXEC
1224 Don't forget to update your menus.
1227 New Option For setstyle
1228 -----------------------
1230 The --ignore flag will tell setstyle to not change the option that is
1231 specified, when modifying the Window Maker configurations. For example:
1233 setstyle --ignore MenuStyle sometheme.themed will cause the MenuStyle
1234 option to not be changed.
1236 setstyle --ignore FTitleBack --ignore UTitleBack --ignore PTitleBack bla.themed
1237 will load the theme, but keep the titlebar background related options as
1238 before.
1241 MultiByte Text Support Changes
1242 ------------------------------
1244 The --enable-kanji configure option is not needed anymore and was removed.
1245 To enable support for multibyte text, you must:
1246 - set the LANG environment variable to the appropriate value
1247 - change the font configurations to contain font sets in the appropriate
1248   encodings in both ~/G/D/WindowMaker and ~/G/D/WMGLOBAL (for WPrefs)
1249 - set the MultiByteText option to YES in both of the above files
1252 New Options
1253 -----------
1255 WorkspaceNameDisplayPosition =
1256 none/center/top/bottom/topleft/topright/bottomleft/bottomright
1259 SmoothWorkspaceBack = YES/NO
1261 will enable smoothing of scaled workspace background images.
1265 Application User Menu Path Changes
1266 ----------------------------------
1268 Default configuration for user specific menus installed in
1269 /usr/local/share/WindowMaker/UserMenus or $(datadir)/WindowMaker/UserMenus
1270 and ~/GNUstep/Library/WindowMaker/UserMenus.
1273 Omnipresent icons in Clip
1274 -------------------------
1276 Added ability to set icons docked in Clip to be omnipresent on all workspaces.
1277 To set/reset this flag use the clip menu.
1278 The Clip menu changed in the following way:
1279  - if you bring up the menu from the Clip's main icon, it will contain as
1280    before the "Rename Workspace" entry in the second position.
1281  - however, if you bring up the menu from any other icon in clip, the
1282    "Rename Workspace" menu entry is replaced by "Omnipresent" or
1283    "Toggle Omnipresent" depending on the context.
1285 This entry will work in the following way, depending on the context:
1287 1. If there is no icon selected in the clip, then the menu will contain the
1288    entry named "Omnipresent" which will be checked accordingly to the current
1289    state of the icon (omnipresent or not), and will let you change the
1290    omnipresent state of the icon you brought the menu from.
1291 2. If one or more icons are already selected when the Clip menu is called, the
1292    entry will be named "Toggle Omnipresent" and will apply to all selected
1293    icons trying to toggle their omnipresent state. The icons which will be
1294    successfully changed to their new state as requested, will be unselected,
1295    while the ones that will fail for some reason to gain their new state,
1296    will remain selected.
1298 In both cases if there is no success in setting what user requested a panel
1299 will inform user of the failure.
1300 (Note: trying to set an icon to not-omnipresent will never fail. Failures can
1301        be met only when trying to set omnipresent for an icon).
1303 The icons set to omnipresent will be marked with a triangle in the upper left
1304 corner, having the color of the IconTitleColor.
1306 An icon can be set to omnipresent, only if its position is free in all the
1307 workspaces, else you will be informed of the problem and asked to fix it first.
1308 Also when dragging an omnipresent icon around in Clip, all the icons docked in
1309 all the workspaces are shown while the dragging is done, to let one easily see
1310 where are free slots in all workspaces.
1312 For advanced users, there is also a shortcut to set/reset the omnipresent
1313 state of an icon: just use "Shift+MiddleButton" (button2) on the icon you want
1314 to change.
1315 In this case only the mark in the upper left corner will appear in case of
1316 success, or nothing will happen if icon cannot be made omnipresent (advanced
1317 users are expected to know why the icon failed to be made omnipresent, so they
1318 don't need a panel to explain them why ;) ).
1320 Now before you load your gun to start a flame war because this is against your
1321 principles you love so much, please sit down and think that this is a feature,
1322 which, if you don't use, the old behavior of the Clip is totally preserved.
1323 It just adds some extra capabilities to the Clip for people who think that this
1324 is useful.
1327 XDND drop on dock support
1328 -------------------------
1330 Support for XDE on dock is now replaced by XDND.
1331 To enable, edit src/wconfig.h
1335 --- 0.53.0
1337 New Options
1338 -----------
1340 ** MenuStyle
1342 MenuStyle=<style>; will change the menu texture style.
1344 <style> can be:
1345 normal (default): for the traditional one texture per item, with bevels in
1346 each
1348 singleTexture: for a single texture that spans the whole menu, with bevels
1349 in each item
1351 flat: singleTexture without the bevels
1354 ** ResizebarBack
1356 ResizebarBack=<texture>;
1358 where <texture> is any of the textures you normally use in titlebars and
1359 other places.
1361 If the style file/theme does not contain a ResizebarBack option, setstyle
1362 will automatically hack it so that wmaker will make the theme work like
1363 before.
1366 New crash dialog panel
1367 ----------------------
1369 From now on, whenever a fatal situation appears, Window Maker will display a
1370 dialog panel to the user and let him choose what to do.
1371 The options are:
1372 - Abort and leave a core file (useful for debugging and getting backtraces)
1373 - Restart Window Maker (default behavior)
1374 - Start alternate window manager (the one defined as fallback, or if not
1375   possible fvwm or twm in this order).
1377 If it will not be able to restart or start the alternate window manager, it
1378 will abort and leave the core file.
1381 Application User Menu
1382 ---------------------
1384 Applications with an appicon can have a user defined menu.
1386 This menu will emulate keyboard events, and will be sent to the applications'
1387 window(s), thus the application must accept key combinations (CTRL+N for
1388 instance).
1390 To enable this feature, #define USER_MENU in src/wconfig.h and place menu
1391 files in ~/GNUstep/Defaults/UserMenus (/usr/local/etc/WindowMaker/UserMenus
1392 globally).
1394 The user menu is in PropList format and the filename is in:
1395 <instance name>.<class name>.menu or application's main window.
1396 (Example: the menu for xcalc would be - xcalc.XCalc.menu)
1398 Example user menu syntax:
1401   "Calculator",
1402   ("Put 1", SHORTCUT, "2"),
1403   ("Functions",
1404     ("Put 2", SHORTCUT, "2"),
1405     ("Put 3,4 and 5", SHORTCUT, (3,4,5))
1406   ),
1407   ("Exit", SHORTCUT, "Control+q")
1412 --- 0.52.0
1415 Appearance Editing in WPrefs
1416 ----------------------------
1418 Added Appearance/Texture editing capability in WPrefs. Workspace background
1419 selection is not yet finished.
1422 Themes
1423 ------
1425 Removed all themes from the source tree, and moved them in a separate package.
1426 You can download the new package from the same place as this package:
1427 ftp://ftp.windowmaker.info/pub/beta/srcs/
1428 Look after WindowMaker-extra-<version-number>.tar.gz
1429 Also WindowMaker-extra pack include the old WindowMaker-data.tar.gz which only
1430 contained icons.
1431 Look for the greatest version number when you download this package.
1434 get-wraster-flags script change
1435 -------------------------------
1437 The name of the options passed to get-wraster-flags changed, to allow a better
1438 name compatibility with the naming conventions used by other software.
1439 The name change was as follows:
1440 --lflags was changed in --ldflags
1441 To allow backward compatibility, with already written software, the old
1442 --lflags option is still recognized, but you are encouraged to move the the
1443 new --ldflags.
1447 --- 0.51.2
1450 New Themes
1451 ----------
1453 Added 2 new cool themes (actually I added in 0.51.1, but forgot
1454 to put it here...) from largo (LeetWM) and BadlandZ (STEP2000).
1457 Full Screen Maximization
1458 ------------------------
1460 The FullMaximize window attribute will allow the window to
1461 be maximized to the full size of the screen (ignoring anything
1462 like titlebar, resizebar, dock, panels etc). It should be useful
1463 for programs that must use the whole screen, like games or things
1464 like presentation programs.
1467 --- 0.51.1
1469 KDE Application Menu script
1470 ---------------------------
1472 wkdemenu.pl is a converter from KDE application menu structures to wmaker
1473 menu that can be used as a piped menu. Look wkdemenu.sh for how to use it.
1476 Window Edge Resistance
1477 ----------------------
1479 Window edge resistance was now added. No, feature freeze hasn't been
1480 removed. Its just part of the edge resistance rewrite ;)
1483 New Theme
1484 ---------
1486 Added SteelBlueSilk theme
1488 Installation Path Changes
1489 -------------------------
1491 Default configuration data installed in /usr/local/etc/WindowMaker
1492 or $(sysconfdir)/WindowMaker
1495 --- 0.51.0
1497 Window Maker has become a GNU program (part of the GNU Project).
1499 Title text drop shadow
1500 ----------------------
1502 drop shadow option added for titlebar text. This is a compile time
1503 option which needs to be defined in src/wconfig.h after you run
1504 configure and before you run make.
1506 New options and syntax for your WindowMaker domain file are:
1508   Shadow = yes/no;
1509   FShadowColor = <color>;
1510   PShadowColor = <color>;
1511   UShadowColor = <color>;
1512   MShadowColor = <color>;
1514 The shadow option is dynamic (no need for a restart).
1515 MShadowColor is for the menu title text.
1517 libPropList
1518 -----------
1520 WARNING!!! libPropList was removed from the Window Maker distribution
1521 and is being distributed separately. If you don't have it installed yet,
1522 get it from ftp.windowmaker.info/pub/libs and install before building
1523 Window Maker.
1526 signal handling change
1527 ----------------------
1528 SIGHUP will exit wmaker instead of restarting it!!! This is because
1529 GNOME expects the window manager to exit instead of restarting...
1530 Complaints should go to gnome people. SIGUSR1 will restart wmaker now.
1533 script change
1534 -------------
1535 WINGs-flags was removed, and replaced by get-wraster-flags.
1536 Please remove WINGs-flags from your system, since it was obsoleted by
1537 get-wraster-flags.
1538 Continuing to use WINGs-flags can lead to hazardous effects, since is no
1539 longer updated.
1542 docklib
1543 -------
1545 docklib is a little library for making dock applets. It's in the
1546 docklib-0.0.tar.gz file. Unpack it and read the README file there.
1549 Option Changes
1550 --------------
1552 Removed OnTopTransients option
1554 Added OpenTransientOnOwnerWorkspace
1557 Olwm Hint Support
1558 -----------------
1560 OPEN LOOK(tm)/olwm hints support was added.
1562 Read the appropriate section in the README file.
1566 --- 0.50.1
1568 New option for WorkspaceBack. mpixmap is the same as spixmap, but
1569 it will scale the pixmap by keeping the aspect ratio (maximize or maxpect).
1570 The option only works for workspace backgrounds.
1572 Also added IGNORE_PPOSITION compile time flag, which is equivalent
1573 to NoPPosition from fvwm.
1578 --- 0.50.0
1581 KDE and GNOME
1582 -------------
1584 Added full support for GNOME and KWM hints.
1585 Read the INSTALL file to see how enable them.
1587 Everything in the so called GNOME window manager bla bla bla pseudo-spec is
1588 implemented.
1590 As for KDE stuff, it implements 90% of everything kwm does, adds some
1591 Window Maker specific extensions to it and still uses half of the memory
1592 kwm does, which should be enough to let you dump kwm ;) For details on what
1593 exactly is implemented, see comments in src/kwm.c Read the README.KDE file
1594 for more information.
1597 WARNING: Some KDE hints are badly designed, so doing things like using
1598 kpanel's desktop switcher/pager and Window Maker's internal workspace
1599 management functions to create, destroy and rename workspaces at the same
1600 time might cause unknown effects. To be on the safe side, only
1601 use either of them to manage workspaces. Switching workspaces is hopefully,
1602 safe, so you can switch workspaces from wherever you want.
1606 Workspace Specific Background Images
1607 ------------------------------------
1609 Use the WorkspaceSpecificBack to set background images for specific
1610 workspaces. The WorkspaceBack is used as the default background image.
1612 Example:
1614 WorkspaceSpecificBack = ((solid, red), (cpixmap, ship.jpg, gray), (),
1615                                 (dgradient, red, blue))
1617 This will set the background image of workspace 1 to (solid, 0),
1618 2 to ship.jpg and 4 to a gradient. Workspace 3 and other workspaces
1619 will have the image defined by WorkspaceBack.
1621 Note that this uses quite some memory...
1624 setstyle/getstyle
1625 -----------------
1627 setstyle now accepts the -nofonts flag, which will load the style
1628 file ignoring all font related options.
1630 Example:
1632 setstyle -nofonts Blabla.style
1635 getstyle can be used to create theme packs. See the usage in the
1636 WindowMaker/README.themes file.
1640 New Texture Type
1641 ----------------
1643 Textured gradients will tile a texture pixmap and combine it with a gradient,
1644 using an arbitrary opaqueness.
1646 Syntax is (thgradient, <file>, <opaqueness>, <color1>, <color2>)
1647           (tvgradient, <file>, <opaqueness>, <color1>, <color2>)
1648           (tdgradient, <file>, <opaqueness>, <color1>, <color2>)
1649 where:
1650 <color1> and <color2> are the colors for the gradient,
1651 <file> is the texture file and
1652 <opaqueness> is the opaqueness to merge the texture with the gradient,
1653 ranging from 0 to 255.
1655 Example:
1657 (thgradient, "BlueImage.jpeg", 120, white, black)
1659 The BlackTexture style and Checker theme are examples.
1661 Hints:
1663 You can use any type of pixmap file for this, but small (like 64x32)
1664 grayscale pixmap files should get the best results (fast and low memory
1665 usage). You can use color pixmaps, but it is harder to get the desired effect
1666 with them.
1668 Be warned that this texture type is the slowest.
1672 New Options
1673 -----------
1675 IconTitleBack and IconTitleColor control the color of the
1676 miniwindow title. Both of them are colors.
1678 Example:
1679 IconTitleColor=white;
1680 IconTitleBack=black;
1683 Since this introduces an incompatibility in themes and getting flamed by the
1684 themes ppl isn't the most pleasant thing ("Whaddafuk you're thinking!? You
1685 just broke 500 themes!!!" ;) the setstyle command was hacked so that it will
1686 make old themes work as before, by trying to automatically set the above
1687 options. Note that in some cases it will not have exactly the same results as
1688 before.
1691 StartMaximized window attribute. Will maximize the window when it
1692 is mapped.
1695 AutoRaiseLower option for the Clip. This allows automatic Raise/Lower of the
1696 Clip icons when the mouse pointer enter/leave the Clip. To avoid unwanted
1697 raising/lowering there is a time threshold before raising/lowering.
1698 The thresholds can be changed in wconfig.h by changing one or both of
1699 AUTO_LOWER_DELAY and AUTO_RAISE_DELAY (expressed in milliseconds).
1700 For example if you set AUTO_RAISE_DELAY to 0, then the Clip will be raised as
1701 soon as the mouse pointer enters its area. Setting AUTO_RAISE_DELAY to a very
1702 big value, will make the Clip to practically do not auto raise unless clicked,
1703 but to be automatically lowered after AUTO_LOWER_DELAY (ms) when leaved.
1706 New ThemePack Format
1707 --------------------
1709 Starting with this version, a new format of themes is being supported.
1710 Before you open pine and start composing your flame, rest assured that
1711 the old format is still supported. The new format is documented
1712 in the WindowMaker/README.themes file.
1715 Root Menu
1716 ---------
1718 The -noext option for OPEN_MENU will strip whatever is after the last .
1719 in file names that appear on the opened directory. So,
1721 OPEN_MENU ~/bg WITH xv -root -quit
1723 will create a menu with all the images in ~/bg without the extension.
1727 --- 0.20.3
1730 Icon (miniwindow) stacking
1731 --------------------------
1733 If you want miniwindows to reside under normal windows, edit
1734 wconfig.h and change WNormalLevel (just grep for it) to
1735 WDesktopLevel
1738 5 Button Mouse
1739 --------------
1741 If you have a 5 button mouse and want to give some utility for
1742 the extra 2 buttons, edit the appropriate line in src/wconfig.h
1743 Clicking Button4 in the root window will switch you to the previous
1744 workspace and Button5 will do that for the next.
1747 Option Changes
1748 --------------
1750 put NoWindowOverDock back
1752 KeepOnBottom window attribute
1755 -static command line option
1756 ---------------------------
1758 wmaker -static will start Window Maker in static mode. This will
1759 prevent wmaker from checking or making any configuration changes.
1760 That makes it possible to run wmaker before running wmaker.inst
1763 Hysteresis for menu item selection
1764 ----------------------------------
1766 Hopefully it's intelligent enough, so you won't notice it.
1768 In case you want to know what's it, it's equivalent to that
1769 (insanely long) 2 second delay present in that Windoze95 menu,
1770 but more useful than annoying (I hope :). To see it, do the following
1771 with your current wmaker version and later with 0.20.3:
1773 - open the apps menu and stick it
1774 - click in the item for the "Workspaces" submenu and hold
1775 - drag the mouse to the 4th or bigger entry (like "Workspace 4") in a
1776 straight line, trying to select the target item before the submenu
1777 is unmapped when you dragged over other items in the main menu
1781 Window Shortcuts
1782 ----------------
1784 Window shortcuts are shortcuts to arbitrary windows. You can make up to 4
1785 shortcuts. To assign a previously bound shortcut to a window use the "Select
1786 Shortcut" submenu in the window commands menu. If the shortcut is not yet
1787 assigned for any window, you can hit the shortcut to assign it to the active
1788 window. The shortcut will do the same as clicking in an entry in the window
1789 list menu. The keys for the shortcuts are defined in the ~/G/D/WindowMaker
1790 file or in WPrefs.app
1792 Option names are:
1794 WindowShortcut1Key through WindowShortcut4Key
1797 --- 0.20.2
1800 The name of WindowMaker was changed to Window Maker.
1802 Window creation animation disabled by default.
1804 xdaliclock -shape
1805 -----------------
1807 If you use it edit src/wconfig.h and #define OPTIMIZE_SHAPE or disable the
1808 titlebar and resizebar for the window. OPTIMIZE_SHAPE will remove the
1809 flickering for xdaliclock and other programs that change their shapes often,
1810 but will increase network traffic considerably. So, if you use xdaliclock
1811 from a remote machine it can get slow.
1814 Applications Menu
1815 -----------------
1817 The applications menu will now use the shell in the SHELL environment
1818 variable to execute EXEC menu commands. If it is unset (I think it's always
1819 automatically set by the shell program) it will use /bin/sh
1822 Extra fancy icon kaboom :)
1823 --------------------------
1825 Edit src/wconfig.h and #define ICON_KABOOM_EXTRA to get
1826 more effects for the icon undocking animation.
1828 Options for superfluous stuff are even more superfluous, so this
1829 will not become run-time.
1832 XDE drag and drop support
1833 -------------------------
1835 Support for XDE drag and drop was added (by "]d" <id@maliwan.org>).
1836 To enable, edit src/wconfig.h
1837 The support works with gtk 1.1.2
1840 libPropList
1841 -----------
1843 libPropList will now be built automatically by wmaker. Which means
1844 the (simplified) building process is now:
1846 ./configure
1847 make
1848 make install
1850 instead of:
1852 tar xzf libPropList.tar.gz
1853 (cd libPropList; make)
1854 make
1855 make install
1857 You also don't need to worry about GNOME libPropList incompatibilities
1858 anymore.
1861 Bug with focus lost in sloppy focus fixed
1862 -----------------------------------------
1864 The bug only occurs in sloppy or auto focus modes, with AutoFocus disabled
1865 and Superfluous enabled. There is no easy/clean way to fix this, so Window
1866 Maker will disable the animation of window creation if the focus mode is
1867 either sloppy or auto AND AutoFocus=NO.
1869 If you want the animation, enable AutoFocus or use manual focus mode
1870 (preferred).
1873 The NoWindowUnderDock option was removed
1874 ----------------------------------------
1875 To obtain the same result, use the "Keep Dock On Top" option in the dock menu.
1878 Persistent Program Supplied Icons
1879 ---------------------------------
1881 Application supplied icons are now stored, so that the dock will keep
1882 showing them after the app is exited. The icons are stored at
1883 ~/GNUstep/Library/WindowMaker/CachedPixmaps
1886 Sound support
1887 -------------
1889 Sound support is now on by default. Even if you don't use sound the overhead
1890 is very small, and has no impact on performance. If you still want to
1891 optimize it and remove a few hundred of bytes, then use --disable-sound or
1892 --enable-sound=no options when you configure Window Maker.
1895 --- 0.20.0
1898 Multihead support. wmaker will now manage all screens that are attached to the
1899 display.
1900 ------------------------------------------------------------------------------
1903 It does so from a single process (instead of spawning a new process for each
1904 screen, like fvwm does). This keeps memory usage a lot lower than fvwm.
1906 State files have a suffix .n, where n is the number of the screen.
1908 Since I don't have a real multiheaded machine, it probably has bugs.
1910 Superfluous
1911 -----------
1913 Yet another useless superfluous animation. Find out what exactly it is
1914 by yourself :)
1917 exitscript
1918 ----------
1920 ~/G/L/W/exitscript will be called automatically when wmaker is exited.
1923 New runtime options
1924 -------------------
1926 1. Miniaturization animation is now selectable by a run-time option
1927 Add a line with
1929 IconificationStyle = <style>;
1931 to your WindowMaker configuration file.
1932 <style> can be one of: Zoom, Twist, Flip or None
1933 Case doesn't matter, and default is Zoom.
1936 2. Edge resistance.
1937 This can be controlled by setting:
1939 EdgeResistance = xxx;
1941 in your WindowMaker configuration file.
1942 xxx is an integer greater than 0 and represents the number of pixels of edge
1943 resistance. Setting it to 0 (default) will disable this feature.
1945 New theme
1946 ---------
1948 A new theme named Night, is available in this distribution.
1952 --- 0.19.3
1954 GIF support was added. You will need libgif 2.2 to use it.
1956 cpixmap added. Syntax is the same as tpixmap or spixmap
1959 --- 0.19.2
1961 getstyle will include IconBack info in Style files.
1963 --- 0.19.0
1965 libPropList was updated. If you have it installed, you must upgrade or
1966 WPrefs will crash because of bugs in libPropList.
1968 New options
1969 -----------
1971 Balloons!
1972 ---------
1974 WindowTitleBalloons = YES;
1975 will enable balloons for window titles that are not fully visible.
1977 MiniwindowTitleBalloons = YES;
1978 will enable balloons for miniwindow titles.
1980 AppIconBalloons = YES;
1981 for application icons (docked or not)
1984 IconPosition
1985 ------------
1987 IconPosition (the position of the icons) is specified as:
1989 IconPosition = c1c2c3;
1991 where:
1993 c1 can be t or b (meaning top or bottom)
1994 c2 can be l or r (meaning left or right)
1995 c3 can be v or h (meaning vertical or horizontal)
1997 case is insensitive.
1999 For example,
2000 IconPosition = blh;
2002 is the old iconPosition position.
2004 IconPosition = trv;
2006 will place the icons over the Dock.
2008 New window attribute
2009 --------------------
2011 EmulateAppIcon = YES; will make the window have an application icon.
2012 Only use this option for fully specified windows (like rxvt.Rxvt).
2013 NEVER use in generic window specifications (like * or rxvt).
2014 You must restart the application for the attribute to take effect.
2017 WPrefs.app
2018 ----------
2020 Read WPrefs/README
2023 --- 0.18.1
2025 Boolean values have changed!!! YES, Y and any non-zero integer will
2026 mean TRUE and anything else (including True) will mean FALSE. This
2027 is to conform to the OpenStep values used for booleans and
2028 not cause headaches later, when GNUstep apps also starts using
2029 defaults and users will try using True which won't get recognized.
2032 --- 0.18.0
2034 Clip
2035 ----
2037 Clip button layout was changed. IT IS TEMPORARY AND THE DEFINITIVE LOOK
2041 libPropList
2042 -----------
2044 More bugs were fixed in it. Upgrade the library if you have an older version
2045 installed, with the one included.
2048 Property list menus
2049 -------------------
2051 Format for property list menus has changed! The redundant array for
2052 submenus was removed, so a menu that looked like:
2054 ( Applications,
2055   ("Xterm", EXEC, "xterm"),
2056   (
2057     (Paint,
2058         ("Gimp", EXEC, "gimp"),
2059         ("XV", EXEC, "xv")
2060     )
2061   )
2064 must be changed to:
2066 ( Applications,
2067   ("Xterm", EXEC, "xterm"),
2068   (Paint,
2069         ("Gimp", EXEC, "gimp"),
2070         ("XV", EXEC, "xv")
2071   )
2076 Misc
2077 ----
2079 NUMLOCK_HACK is back. This time it works and is enabled by default.
2080 If you think you don't need it and promise me that you won't send
2081 "bug" reports saying that shortcuts stop working after a while, you can
2082 disable it ;) It will save some memory and CPU.
2085 Configuration
2086 -------------
2088 Removed the SwapMenuButton option and added 3 finer grained options:
2090 SelectWindowsMouseButton
2091 WindowListMouseButton
2092 ApplicationMenuMouseButton
2094 Values that can be used are Left, Middle, Right and Button1 through Button5
2095 Left is equivalent to Button1, Middle to Button2 and Right to Button3
2098 Removed the WorkspaceChangeDelay option and corresponding action.
2099 Removed AClipColor and IClipColor
2102 Added the SelectKey back
2105 Changed default binding of Window commands menu from F10 to Control+Escape
2107 --- 0.17.4
2109 Misc
2110 -----
2112 libPropList has changed! Upgrade it before compiling wmaker.
2114 Hopefully the bugs that caused wmaker to crash if an error is found
2115 in the config files is fixed. If you do crash wmaker with a bad
2116 file, please try to find out the smallest possible portion of the file
2117 that still crashes wmaker and send it to me.
2120 New Options
2121 -----------
2123 PixmapPath was split to PixmapPath and IconPath. PixmapPath is the path
2124 for the pixmaps used as textures and IconPath is for the icons.
2125 Don't forget to add IconPath to your current configuration file.
2127 There's also a new library in ~/GNUstep/Library/Icons. You should place
2128 your icons there, since icons are not a WindowMaker specific resource.
2131 DontConfirmKill=YES; will disable the confirmation panel for Kill
2134 --- 0.17.3
2136 Interface Changes
2137 -----------------
2139 Unhide Here in the appicon menu was changed to be the first entry.
2140 This way you can unhide the appicon with a single click without
2141 even moving the pointer.
2144 Clip Commands
2145 -------------
2147 The collect icons commands was renamed to attract icons and
2148 the attract icons options was renamed to Auto attract icons.
2150 The Remove Selected Icons was renamed to Remove Icon(s). It will
2151 act as before if some icon is selected and will remove the clicked
2152 icon (without confirmation) if it is not.
2154 Added a Keep Icon(s) command that will keep the selected icons if
2155 any is selected and the current one if none.
2157 The Move To command was renamed to Move Icon(s) To.
2160 --- 0.17.0
2162 If you have libPropList installed, you might want to re-install it,
2163 replacing with the included libPropList. It has a small bug fix.
2165 Misc. Changes
2166 -------------
2168 Removed --with-gnome and made MWM_HINTS defined by default.
2169 This means that "GNOME support" will work with no additional
2170 flags passed to configure.
2172 Added support for KDE, by adding a DisableWorkspaceMouseActions option.
2173 Set it to YES and run krootwm to be able to use everything in kfm.
2176 Shortcuts for Root Menu
2177 -----------------------
2179 There is now a new SHORTCUT optional keyword for the menus.
2180 For example, you can bind Control-F1 to xterm with:
2182 "XTerm" SHORTCUT Control+F1 EXEC xterm
2184 or F2 to ARRANGE_ICONS with:
2186 "Arrange Icons" SHORTCUT F2 ARRANGE_ICONS
2189 All commands allowed in the menu file accept the keyword, except for
2193 Interface Changes
2194 -----------------
2196 ** Configuration of docked applications is now done in a panel instead of
2197 in the menu.
2199 ** Added a command menu for application icons
2201 ** Shift double-click on the application icon will unhide the app
2202 in the current workspace.
2205 Option Changes
2206 --------------
2208 NotMiniaturizable option changed to NoMiniaturizeButton
2209 NotClosable option changed to NoCloseButton
2212 Speed options values are now UltraFast, Fast, Medium, Slow or UltraSlow
2213                                               ^^^^^^
2215 Removed the Select keyboard binding. You can access it in the window
2216 commands menu.
2218 Removed the ClipMaxIcons option and made it a compile time option.
2220 Removed the ConstrainWindowSize option
2222 Renamed NoSound to DisableSound
2224 Renamed NoAutowrap to DontLinkWorkspaces
2226 Renamed NoDithering to DisableDithering
2228 Renamed NoAnimations to DisableAnimations
2230 Removed the LeftHanded option and added a SwapMenuButton option.
2231 SwapMenuButton will make the rubberband selection in the root window
2232 be bound to the right button and the root menu to the left button.
2235 New way to display temporary icons
2236 ----------------------------------
2238 The icons that are attracted by Clip, but will not be kept after the
2239 application close, are now using a different color for shading, unlike previous
2240 version that always used white. This will improve look for very different color
2241 combinations, and allow the user to control the look of the shaded icon.
2242 The color used for shading the icons is computed as follows:
2244 First a color is computed depending on the IconBack type:
2245  - for solid the color is the solid color itself.
2246  - for simple gradients the color is (from_color + to_color)/2.
2247  - for multiple gradients, the color is the first color in list.
2248  - for pixmaps, the color is the solid color specified for that pixmap.
2250 Then the color is made lighter by multiplying each red/green/blue filed with
2251 1.7 and limiting each field to 0xff in case they exceed this value.
2252 Then this new color will be used by superposing it with the icon we want to
2253 shade, using a proper alpha value.
2255 To control the color for shading is simple:
2257 - In case of multi gradients you just need to put the first color, as the color
2258 you like. WindowMaker do not use the first color in the list to directly build
2259 the gradient, but only when it needs a solid color for something (like in this
2260 case).
2262 - For pixmaps, put the needed color as the solid color the syntax for pixmaps
2263 require. This color is also not used when displaying normal icons, just when
2264 solid colors are needed (like this case).
2266 - For solid color, or simple gradients, in case the color it uses after
2267 computing is not good enough, you can always convert the solid or simple
2268 gradient to a multi gradient with the same look, and use that one. In this
2269 case is simple, just put the needed color as first color in list.
2271 Please note that this will not slow down WindowMaker, because the IconBack is
2272 read only once at startup, and then only if it is changed. After reading it WM
2273 will construct the image of the tile, and use the image instead of recomputing
2274 the gradient every time.
2276 Here are 2 examples of converting solid or simple gradient to a same looking
2277 multi gradient:
2279 IconBack = (solid, Blue);
2280 will become
2281 IconBack = (mhgradient , LightBlue, Blue, Blue);
2282 using LightBlue as color for shading.
2284 IconBack = (dgradient, "#284569", "#082420");
2285 will become
2286 IconBack = (mdgradient, "#183454", "#284569", "#082420");
2287 looking the same, but using #183454 for shading.
2290 New Sound Server Location
2291 -------------------------
2293 The sound server new URL is http://www.frontiernet.net/~southgat/wmsound
2294 Also it seems to be running on FreeBSD too (with little changes maybe).
2297 --- 0.16.1
2299 WINGs
2300 -----
2302 The path for the WINGs resource files was changed. If you don't
2303 do make install, you must move /usr/local/share/WindowMaker/Resources to
2304 /usr/local/share/WINGs
2307 New Options
2308 -----------
2310 The following new options are available:
2311 NewStyle = Yes/No; (static) Replaces --enable-newstyle
2312 DisableDock = Yes/No; (static) Same as -nodock command line option.
2313 DisableClip = Yes/No; (static) Same as -noclip.
2314 Superfluous = Yes/No; (dynamic) Replaces --enable-superfluous.
2316 NOTES.
2317 - The static options are only read at startup. Changing them, needs to restart,
2318   so they will be accounted.
2319 - DisableDock and DisableClip have lower precedence than -nodock -noclip
2320   command line options. If both option/command line option are given, then the
2321   command line option will be accounted.
2324 Start Hidden option
2325 -------------------
2327 The start hidden option was fixed, and made to be an application wide option.
2328 It will apply to every window the application owns. Also its place in the
2329 Attribute Inspector panel, changed accordingly, to reflect this.
2330 The start miniaturized is however still applying to particular windows of an
2331 application, unless the option is set for the class.
2332 Start miniaturized, will override start hidden if both set.
2335 Because of the way Netscape Communicator is implemented, it is NOT possible
2336 to set the start hidden or miniaturized flags for it. This is because Netscape
2337 chooses to send a second map event to the window it maps. This makes the
2338 window to receive a second map request and to be unhidden or maximized back,
2339 immediately after it was hidden or miniaturized by WindowMaker at startup.
2343 --- 0.16.0
2345 Misc. Changes
2346 -------------
2348 The NextMenuBehaviour option was renamed to WrapMenus
2349 The WorkspaceTiedMiniwindows option was renamed to StickyIcons
2351 The .tif files were renamed to .tiff
2354 Selecting Mini Windows
2355 ----------------------
2357 Now miniaturized windows can be selected as well as normal windows.
2358 You can do this by Shift-Click-ing them. They will be marked, and will follow
2359 you through workspaces like normal selected windows do.
2360 Miniaturizing a window will no longer deselect the window, but will place the
2361 icon and mark it as selected.
2362 The only difference between miniaturized and normal window selection is that
2363 for the moment the rubber-band selecting method works only for normal windows.
2366 Icon Selection Panel in Attributes Editor
2367 -----------------------------------------
2369 Now, selecting icons is as easy as clicking in the file name in a list.
2372 Simplified Options
2373 ------------------
2375 IconSlideStep, IconSlideSlowDown and IconSlideDelay were merged to
2376 IconSlideSpeed
2378 MenuScrollStep and MenuScrollDelay were merged to MenuScrollSpeed
2380 ShadeStep and ShadeDelay were merged to ShadeSpeed
2383 Valid values for them are: Fast, Normal, Slow or UltraSlow
2385 If you want to fine tune the values, they can be changed in wconfig.h
2386 Send me your set of values with an indication of how fast is your hardware,
2387 so that I can make the default values more adequate.
2390 New Window Attributes
2391 ---------------------
2393 Added StartMiniaturized and StartHidden as window attributes and
2394 removed the previous implementation. Also removed the dock menu entries.
2395 They are now settable in the Attributes Panel.
2397 Also added DontSaveSession attribute. This way, you won't end up with multiple
2398 unwanted copies of the same app after the previous session is restored.
2399 I start X with a xterm in .xinitrc instead of wmaker, which will cause the
2400 xterm restored by wmaker be duplicate. Just add -name something to the
2401 xterm started form .xinitrc and mark DontSaveSession=YES for that window.
2405 User Specifiable Visual IDs
2406 ---------------------------
2408 wmaker now supports different visuals than the default one. It isn't of much
2409 use for most people, but can be useful for lucky SGI users who want it
2410 to use TrueColor instead of the default PseudoColor.
2412 wmaker -visualid VISUAL_ID
2414 where VISUAL_ID is the hex code for the visual you want.
2416 Note: I don't have an SGI box and haven't tested it...
2420 Starting Workspace
2421 ------------------
2423 The starting workspace is identified in the following order:
2424 1. If the app is omnipresent will be mapped on the current workspace.
2425 2. Else if the application have a StartWorkspace option set as attribute
2426    then this one will be used.
2427 3. Else, if the application was started from Clip, the workspace on which
2428    the Clip from where it was started is used.
2429 4. Else the current workspace is used.
2431 Restoring saved sessions will always use the saved workspace, no matter
2432 what other options are, except omnipresent.
2436 --- 0.15.1
2438 Workspace specific mini windows
2439 -------------------------------
2441 The minimized windows can be workspace specific, being more consistent with
2442 the rest. This is because minimized window represents just another state of a
2443 window (like normal or shaded), which all are workspace specific.
2444 This (or the old "present anywhere") behavior can be set using an option in
2445 the WindowMaker database: WorkspaceTiedMiniWindows = Yes/No;
2447 New way to animate the blowing icons
2448 ------------------------------------
2450 There is now a compile time option that allows one to set how the icons are
2451 animated when detaching from dock/clip in superfluous mode.
2452 By default the classic "Falling pieces" animation is used.
2453 If SPREAD_ICON is #define-ed in wconfig.h, then a "Spread in four directions"
2454 animation is used instead. Take a look at the section where this is described
2455 in src/wconfig.h
2456 By default there is #undef SPREAD_ICON to select "Falling pieces" animation.
2458 Auto Collapse for Clip
2459 ----------------------
2461 The clip now supports an option named "Auto Collapse" which can be set from
2462 the clip main menu. When set, clip will stay collapsed, and will show itself
2463 when the mouse moves over it. While the mouse is over it, or over any of the
2464 icons attached to the clip, the clip will stay uncollapsed, letting you to
2465 access the attached icons. This is not true for applications like asclock, or
2466 applets of that kind, because the icon window do not belongs to WindowMaker,
2467 but to the application itself. For such icons you must keep the mouse over the
2468 icon groundplate, else it will collapse back. But usually these type of icons
2469 will not stay in a collapsed clip, since one needs to see what they show.
2470 When the clip is leaved it will collapse back after a delay of 1 second, unless
2471 the mouse is moved back to the clip area. The delay can be set modifying
2472 AUTO_COLLAPSE_DELAY in wconfig.h. Default is 1000 (ms) which means 1 second.
2477 --- 0.15.0
2479 Changed name from Fiend to Clip
2480 -----------------------------------
2482 All occurrences of word Fiend with or without capital F were replaced with
2483 the corresponding Clip (same capital).
2484 This affects all configuration files under ~/GNUstep that contain this word.
2485 It can be referred as "Workspace Dock" too.
2488 New option in Clip menu, and extended Clip behavior
2489 ---------------------------------------------------
2491 The following new items are available in the dock menu:
2493 1. Attract Icons
2494 2. Keep Attracted Icons
2495 3. Collect Icons
2496 4. (Un)select All Icons
2497 5. Remove Selected Icons
2498 6. Move To
2499 7. Start miniaturized    (also available for regular dock)
2500 8. Start hidden          (also available for regular dock)
2501 9. Selected
2502 10. Set icon...          (also available for regular dock)
2505 Here is what they do:
2507 1. "Attract Icons" will let the Clip to attract and attach any new appicon that
2508    is created when an application starts. It will not do this if the Clip is
2509    full. If the Clip is Collapsed then the appicon will be hidden after it is
2510    attached.
2511 2. "Keep Attracted Icons" will tell the Clip to keep the attracted appicons,
2512    after the application is closed. Without this the appicons will vanish,
2513    leaving the Clip in the original state. If you move an appicon that was
2514    attracted from Clip to regular Dock, it will be kept when closed, no matter
2515    what "Keep Attracted Icons" is set to in Clip.
2516 3. "Collect Icons" will collect all appicons that are not yet attached to Dock
2517    or Clip, and attach them to the current workspace Clip. The value of
2518    "Keep Attracted Icons" will apply when applications close. If Clip is
2519    collapsed, the appicons will be hidden.
2520 4. "(Un)select All Icons" will select all icons in the clip if none is
2521    selected, or it will deselect all selected ones. The selected icons are
2522    marked using a small triangle in the bottom right corner of the appicon.
2523    The color of the mark is set using SClipColor in WindowMaker domain
2524    database.
2525 5. "Remove Selected Icons" will remove from Clip all selected icons. The ones
2526    that still run, will be detached, all the others will vanish.
2527 6. "Move To" will transfer all selected icons to another workspace and attach
2528    them to the Clip in that workspace. If none is selected, only the one the
2529    mouse was pressed on will be moved.
2530 7. "Start miniaturized" will launch (or autolaunch if set) the application in
2531    a miniaturized state.
2532 8. "Start hidden" will launch (or autolaunch if set) the application in a
2533    hidden state. Note that only one of the two can be set at a time.
2534 9. "Selected" can be used to toggle the selected state of the appicon
2535    individually. The same can be achieved using Shift-LeftClick on the appicon.
2536    In fact the intended way of toggling the selected state is by using
2537    the Shift-LeftClick on icon. The menu entry is just another way to do the
2538    same.
2539 10. "Set icon..." will allow one to set the image for the appicon. The image
2540    will be updated without restart, and also all appicons in the same
2541    instance.class as the one we set for, will be updated.
2543 So a simple way of avoiding the screen to be filled up with appicons is to set
2544 the "Attract Icons" in the Clip. Also the "Keep Attracted Icons" can be set to
2545 No, so the attracted icons will be deleted when application exits, thus leaving
2546 the Clip clean. If also one to not want to see the appicons that keep filling
2547 the Clip, he can set the Clip to be Collapsed.
2549 Getting rid of unneeded icons in Clip is as simple as selecting them
2550 individually using Shift-LeftClick, and then using the "Remove selected Icons"
2551 entry in menu.
2554 Support for different visuals.
2555 ------------------------------
2557 WindowMaker is now able to support any visual, except DirectColor, in any
2558 depth from 1bpp to 32bpp.
2560 One can start the X server with different visuals, by passing the X server the
2561 right option. For XFree 3.3.x is -cc <id>.
2562 WindowMaker is not yet able to choose a different visual from the Default one
2563 on a given screen, but can use any default visual it finds, except the direct
2564 color visual.
2565 For example starting X like (for XFree 3.3.x, and if the driver for the
2566 card supports this. Read the man page for your X server):
2567 startx -- -bpp 8 -cc 0 will give you the StaticGray visual.
2568 startx -- -bpp 8 -cc 1 will give the GrayScale visual
2569 and so on.
2571 Wrlib code is now generic, and will support any visual except DirectColor in
2572 any depth. Programs written with wrlib can work on different visuals from
2573 the default visual for a given screen.
2574 Behavior in different visuals can be tested using the testgrad program in
2575 wrlib subdirectory in distribution.
2576 testgrad -h will show the usage.
2578 Multidiagonal gradients are also implemented now in wrlib, and a new algorithm
2579 is used to speed up the generation of diagonal gradients.
2582 New arrangement of the directory structure under ~/GNUstep/
2583 ---------------------------------------------------------------
2585 To better adapt to theme support the directory structure changed under
2586 ~/GNUstep/Library/WindowMaker
2588 1. Style directory moved to Styles.
2589 2. Added the following directories: Backgrounds, IconSets, Pixmaps, Sounds and
2590    Themes.
2591 3. The .style files no longer get copied in the user's Styles directory.
2592    Instead they are read from the global /usr/local/share/WindowMaker/Styles
2593    directory.
2595 Under ~/GNUstep/Defaults the following changes occurred:
2597 1. A default WMState is installed by wmaker.inst.
2598    It contains the dockit program assigned to the top icon of the dock, and
2599    the wmsetbg program assigned for the drop command on both dock's and clip's
2600    main icon.
2601    Double clicking the dock's main icon will bring up dockit that will let you
2602    dock any application that do not have an application icon.
2603    Dropping an image on dock's or clip's main icon, from an Offix DND aware
2604    application, will put the image on the background tiled, and will update
2605    WindowMaker domain database file.
2606 2. Syntax of WMState changed a little. The old position will not be restored
2607    when you will first start the new version, but after that it will be
2608    normally remembered. This is because now the main clip icons is only saved
2609    once, not for every workspace.
2610    You should replace Fiend with Clip in any place where it appears, if you
2611    want to keep the old WMState file, else it will not work.
2612 3. At compile time, it will detect if you have support for tif, and will
2613    install a WMWindowAttributes with corresponding image name extension
2614    (.tif or .xpm). This is true only for pixmaps that come with the source
2615    distribution and get installed under /usr/local/share/WindowMaker/Pixmaps
2617 The menu file changed a lot. Old menu file will *not* work with new theme
2618 support, so please upgrade.
2621 New behavior of OPEN_MENU command
2622 ---------------------------------
2624 The OPEN_MENU command now supports the following syntax:
2625 1. File menu handling.
2626    // opens file.menu which must contain a valid menu file and inserts
2627    // it in current position
2628    OPEN_MENU file.menu
2629 2. Pipe menu handling.
2630    // opens command and uses its stdout to construct menu.
2631    // Command's output must be a valid menu description.
2632    OPEN_MENU | command
2633 3. Directory handling.
2634    // Opens one or more directories and construct a menu with all
2635    // the subdirectories and executable files in them sorted alphabetically.
2636    OPEN_MENU /some/dir [/some/other/dir ...]
2637 4. Directory handling with command.
2638    // Opens one or more directories and construct menu with all
2639    // subdirectories and readable files in them sorted alphabetically,
2640    // preceding each of them with command.
2641    // WITH is a required keyword!!!
2642    OPEN_MENU /some/dir [/some/other/dir ...] WITH command -options
2644 Please note that because of the 'WITH' keyword old menu files no longer work
2645 for the OPEN_MENU with a command.
2648 Theme support
2649 -------------
2651 Theme support is now as easy as untar-ing a tarball in the right place.
2652 Because of the way OPEN_MENU works, they can be installed on a global
2653 shareable basis, or for personal user use.
2654 Themes installed under ~/GNUstep will be available only for a user, but
2655 if if they are installed under /usr/local/share/WindowMaker they will be seen
2656 by all users. This is also true for style files, background images, pixmaps,
2657 etc that get installed under /usr/local/share/WindowMaker.
2658 Themes can be saved or loaded using the Appearance menu.
2660 Also support for different IconSets is available. You can save or load a new
2661 IconSet using the Appearance menu.
2663 Setting background images is now as simple as putting the images in the right
2664 place (~/GNUstep/Library/WindowMaker/Backgrounds or
2665 /usr/local/share/WindowMaker/Backgrounds, or any other place in your
2666 PixmapPath). Then use the Appearance menu. They will be instantly available
2667 since they are opened by a OPEN_MENU command. Also the image do not need to
2668 have a .jpg or any other extension. It will be recognized anyhow.
2669 As an example please see the OpenStep theme supplied with WindowMaker.
2670 The OpenStep image is a jpeg file without extension.
2672 Please keep in mind that anything under /usr/local/share/WindowMaker will be
2673 available for all users.
2676 New options for wmsetbg and getstyle
2677 ------------------------------------
2679 wmsetbg now accepts the following options:
2680 usage: wmsetbg [-options] image
2681 options:
2682  -d             dither image
2683  -m             match  colors
2684  -t             tile   image
2685  -s             scale  image (default)
2686  -u             update WindowMaker domain database
2687  -D <domain>    update <domain> database
2688  -c <cpc>       colors per channel to use
2690 By default, it will try to guess if dithering is needed or not and proceed
2691 accordingly.
2692 Using -d or -m will force it to dither or match colors.
2694 Dithering for more than 15bpp is generally not needed, and will only result
2695 in a slower processing.
2696 Don't use dithering except when needed, because it is slower. Else rely on
2697 wmsetbg which will detect if dithering is needed and use it.
2699 -u will update the WorkspaceBack in the default database domain file in
2700    ~/GNUstep/Defaults/WindowMaker, and let WindowMaker refresh the screen.
2701    Please note that this option only works under WindowMaker, and will have no
2702    effect under other window managers, since it rely on WindowMaker to update
2703    the image after it reads the updated defaults database.
2705 -D <domain> is same as above, but will update the domain <domain> instead of
2706    the default WindowMaker domain.
2708 -c <cpc> will set the color per channel to use. Only needed for PseudoColor
2709    visuals. WindowMaker will automatically pass the value read from the
2710    WindowMaker domain database.
2713 getstyle now have the -t option, that instructs it to read all options
2714 related to theme. Without -t getstyle will read only style options that
2715 means it will not read WorkspaceBack and IconBack.
2716 Use -t when you want to make a theme and need all theme options to be saved.
2717 Else it will extract just a style file.
2720 Session management support
2721 --------------------------
2723 Two new commands are available for use in menus:
2728 will take a snapshot of all running applications, and their current hints
2729 (shaded, hidden, minimized, geometry and workspace they are on),
2730 and save it inside the WMState file. Also the current workspace we are on is
2731 saved. The applications that are running and were started from dock or clip are
2732 marked, so they will be attached to the corresponding dock/clip when restored.
2733 This state is restored every next session, until a new one is saved or
2734 CLEAR_SESSION is used.
2737 will clear any previous saved session.
2739 There is also a run time option named SaveSessionOnExit = Yes/No; that allows
2740 one to automatically save the state of desktop when leaving WindowMaker.
2741 This way next session, the state of the desktop before last exit is restored.
2743 Please note that if this option is set to Yes, than any manual saving of the
2744 state, or any clearing of the state will be overridden when exiting
2745 WindowMaker.
2747 These options are available under the "Workspace" menu.
2750 User WindowMaker configuration files are now merged with global ones
2751 --------------------------------------------------------------------
2753 When starts WindowMaker will look for database domain files under
2754 $GNUSTEP_USER_ROOT/Defaults or ~/GNUstep/Defaults to be read. (In this order).
2756 If they are not available then it will scan for them in
2758 /usr/local/GNUstep/Defaults (in this order).
2760 Even if the file was found or not, it will always load the corresponding domain
2761 file under /usr/local/share/WindowMaker/Defaults.
2763 Then if the user file was found it will merge it over the global file, else
2764 the global file will be used.
2766 This way any settings that are set by the system administrator in the shared
2767 file will be available for users that do not have them in their config files.
2768 Any option the user have in his config file will override the one in the
2769 shared domain file.
2771 So any new run-time options that appear in WindowMaker domain, do not need to
2772 be set in all user files, except the ones the user wants a different behavior
2773 from the default set for all users in the shared file.
2775 Also it is possible for the user to not have any personal domain databases, and
2776 the global shared ones will be used, but it still needs to have the directory
2777 structure, so WMState gets written on session exit.
2778 So all it needs to have is ~/GNUstep/Defaults directory available.
2781 New behavior of the Slide Icons
2782 -------------------------------
2784 Animation constants are now run-time.
2785 They are:
2786 IconSlideDelay = 0;
2787 IconSlideStep = 5;
2788 IconSlideSlowDown = 50;
2790 To better adapt both slow and fast machines the behavior of sliding icons
2791 changed in the following manner:
2793 Old one was to keep moving the icon with a constant step (default 5 pixels)
2794 until it reached the destination.
2796 Now it will use a new parameter named IconSlideSlowDown to speed up or slow
2797 down the moving.
2799 Instead of moving it with a constant step it will use IconSlideSlowDown to
2800 divide the distance to the destination, and use this value as the first step.
2801 Then is will compute the remaining distance and will again use
2802 IconSlideSlowDown to divide it and get the new step. And so on.
2803 When the step to move becomes smaller than IconSlideStep, IconSlideStep will
2804 be used further until the destination is reached.
2806 This way a nice deceleration effect is achieved, since while the icon
2807 approaches destination, it will use smaller steps, gibing the illusion that
2808 the icons is moving slower.
2810 IconSlideDelay will give the pause between steps, and is expressed in ms.
2812 Giving large values to IconSlideSlowDown (>1024 for 1024x768 screen) will
2813 result in the old "constant step advance" behavior, since the computed step
2814 will always be smaller than IconSlideStep, and the last will be used instead.
2816 Making IconSlideSlowDown = 0 or 1, will result in an instant jump to the
2817 destination without any animation.
2820 Attribute editor
2821 ----------------
2823 Because the icon images on screen automatically update after any change in
2824 WMWindowAttributes domain file, the use of both Save and Apply buttons is no
2825 longer needed. If one wants to just apply the setting to the current window
2826 only, he will only use the Apply button.
2827 If he wants them saved for all applications in the same instance and/or class
2828 the using the Save button will write them to disk, and automatically
2829 WindowMaker will update all the icons that need to be updated on screen.
2832 Sound support
2833 -------------
2835 Some basic sound support is now part of WindowMaker. The sound server is not
2836 yet part of WindowMaker distribution, so you need to download it separately.
2837 This is because is Linux specific, and need some changes before it can be
2838 included.
2839 Until them if you have a Linux system and want to use sound, use the
2840 wmsound-0.5 available at http://www.geocities.com/SiliconValley/Bay/7874
2841 Download that package, and only build the sound server there.
2842 DO NO APPLY ANY PATCHES FROM THERE!, because they are already applied.
2843 Just build the sound and copy the executable in /usr/local/bin
2844 Follow the rest of the install steps described there, except the patch-ing
2845 procedure.
2847 To enable sound for WindowMaker pass --enable-sound to configure.
2849 Also use NoSound = Yes/No; to enable/disable sound at run-time without killing
2850 the sound server.
2852 If you cannot set the sound to work yet, then is not for you.
2853 Wait until the sound server will be fixed and will be part of WindowMaker.
2856 New entries in WindowMaker domain database
2857 ------------------------------------------
2859 The following entries have been added to the run-time options:
2861   SaveSessionOnExit = No;
2863 will autosave (or not) the session state on exit.
2865   WindowPlaceOrigin = "64, 64";
2867 will offset all windows in auto or cascade placement mode with the value
2868 (in pixels) before placing them on screen. First is horizontal direction and
2869 second is vertical.
2870 This do not apply to windows that request a specific position on screen.
2871 This is useful if you want your Clip on the top left corner to not be
2872 overlapped by mapping windows.
2873 It will let it to have a row and a column of docked appicons near the screen
2874 edge, that will not be overlapped by windows.
2875 If you set it to "128, 128" it will have 2 rows and 2 columns not overlapped.
2878   NoSound = No;
2880 Enable/disable sound at run-time without the need of killing the sound server.
2883   MenuScrollDelay = 10;
2884   MenuScrollStep = 5;
2886 Constants for the menu scrolling animation.
2888   IconSlideDelay = 0;
2889   IconSlideStep = 5;
2890   IconSlideSlowDown = 50;
2892 Constants for the icons sliding on screen. Explained above.
2894   ShadeDelay = 0;
2895   ShadeSteps = 15;
2897 Animation parameters for shading a window. How many steps it will take, and the
2898 delay between steps in ms.
2900   DoubleClickTime = 250;
2902 The time for the double click to be considered so. Expressed in ms.
2904   SClipColor = "#6f8ae2";
2906 Color for selected icons in Clip.
2908 All delays are expressed in ms.
2912 --- 0.14.1
2915 *** Enhanced fiend clone.
2917 Here are the new fiend features:
2918 1. Keys for raising/lowering the fiend, and their default values:
2919    FiendLowerKey = None;
2920    FiendRaiseKey = None;
2921    FiendRaiseLowerKey = None;
2923    All reside in WindowMaker configuration file.
2925 2. Added possibility to launch the workspace menu with button1 click on the
2926    idle indicator of fiend, or with button3 click on workspace name on the
2927    fiend.
2929 3. Added Control-button1-click on fiend's idle indicator, to create a new
2930    workspace and move to it. Same action as New item in Workspace menu.
2932 4. Fiend's idle indicator do have a color that reflects its normal/collapsed
2933    state.
2935 5. The delay between changing workspaces from fiend is now a run-time option:
2937    WorkspaceChangeDelay = 700;
2939    in WindowMaker configuration file.
2941 6. Application icons can be moved between dock and fiend now.
2943 7. The way workspaces are changed is controlled now by two run-time options:
2945    AdvanceToNewWorkspace=Yes/No;
2946    CycleWorkspaces=Yes/No;
2948    Both apply to either fiend navigating buttons or to next/prev workspace
2949    keybindings. Both default to No, and are in WindowMaker configuration file.
2951 8. Also added possibility to advance to new workspace, no matter what value
2952    AdvanceToNewWorkspace have, with Control-button1-click on "next workspace"
2953    fiend button.
2956 *** Theme support ***
2958 Spixmap and tpixmap now work. Their syntax is:
2960 SomeStyleOption = (spixmap, file, color);
2961 SomeStyleOption = (tpixmap, file, color);
2963 - spixmap means scaled pixmap, so the image in the file will be scaled to
2964 adapt to the destination's size.
2965 - tpixmap means tiled pixmap, and the image from file will be tiled in the
2966 destination.
2968 file is searched in the PixmapPath, but can be a full path name.
2970 Color is used depending on which Style option is applied.
2971 For example in case of titlebars, color is used for miniwindows titles color.
2972 You are not restricted in selecting that color, but is better to put one
2973 that matches the overall color of the image.
2975 Currently they apply to all the options that accept (solid, color), or any
2976 type of gradient.
2977 This means they also apply to WorkspaceBack and IconBack, which allows theme
2978 support with the simple use of the setstyle and getstyle utilities.
2979 There is no need for an extra theme manager, just to include the needed
2980 options in the style files.
2982 In case of WorkspaceBack, color is used to be set in the background until
2983 the image gets loaded and displayed. This is to avoid the stippled screen
2984 the X server shows, in case the image is big and loads slow.
2985 There is a small utility in the util directory, named wmsetbg which is
2986 used to set the background image. This is needed for WindowMaker not to
2987 freeze while loading and scaling the image.
2988 Currently it is hardcoded in WindowMaker to use wmsetbg to set the background
2989 image, and is better to use it since is smaller that other image manipulation
2990 programs, and it is compiled with support for same image types as WindowMaker.
2991 Since it comes and is installed with WindowMaker, there will be no need to
2992 download and use an external app, which also may not have support for the same
2993 image types as WindowMaker.
2997 --- 0.14.0
2999 *** Fiend clone.
3001 The fiend clone is a dock extender, that lets you dock more than the default
3002 10-12 icons in the dock. It actually lets you dock how many icons you like,
3003 with a current default of 25 per workspace. The fiend have different docked
3004 icons on every workspace. Also the fiend main icon shows you the workspace
3005 you're on and lets you navigate through the workspaces with the small green
3006 buttons on the low right corner.
3007 To save screen space the fiend can be collapsed to the main icon either
3008 from the fiend menu (available with right click on the fiend icons), or
3009 with a double left click on the main fiend icon, which is a toggle for
3010 the collapsed/uncollapsed state.
3011 Collapsed state is marked by a different title color.
3012 Pressing on the small buttons on the low right corner, the workspaces are
3013 changed in increments of 1 to the left or right, but keeping the button
3014 pressed over them will continuously advance through workspaces until the
3015 mouse is moved away from the buttons or the button is released.
3016 The delay between workspace changes is set by FIEND_WKS_CHANGE_DELAY in
3017 src/wconfig.h, and defaults to 700 ms.
3018 Unlike the dock, fiend can hold icons in any directions, and can be placed
3019 in any position on screen.
3021 When an icons is to be docked, but the position can be either in the dock
3022 or in the fiend, the dock will be used first, and the icon will be docked
3023 there.
3025 Here are the new run-time options introduced by the fiend:
3026 Files are located in ~/GNUstep/Defaults/
3028 In WMWindowAttributes:
3029        "Logo.WMFiend" = {Icon = "Cone.xpm";};  - icon for the fiend
3031 In WindowMaker:
3032         FiendMaxIcons = 25;           - the max number of icons in fiend per
3033                                         workspace
3034         FiendTitleFont = "-*-helvetica-bold-r-normal-*-10-*-*-*-*-*-*-*";
3035                                       - the font used to show the current
3036                                         workspace
3037         FiendTitleColor = black;      - color for the uncollapsed fiend title
3038         CFiendTitleColor = "#616161"; - color for the collapsed fiend title
3039         AFiendColor = "#00ba70";      - color for the workspace changing
3040                                         buttons, when active
3041         IFiendColor = "#008000";      - color for the workspace changing
3042                                         buttons, when idle
3044 For the ones who don't want to use fiend, there is a option to wmaker named
3045 -nofiend that can be feed to the command line when starting wmaker.
3046 (This is the equivalent for -nodock, but removes fiend clone).
3048 The syntax of WMState file have changed, but you don't have to worry because
3049 WindowMaker will know to read the old format and will save it and further
3050 will use the new one. You do not need to change your file, for the new version
3051 to work.
3054 --- 0.13.1
3056 *** Enhanced Attribute editor.
3058 Now you can save defaults for all windows.
3059 Please note that only Icon, KeepInsideScreen, and sometimes NoAppIcon
3060 can be useful in a normal environment. But others may have other opinion ;)
3061 If you set AlwaysUserIcon default for all windows, note that apps like
3062 asclock, wmload, wmmail, wmrack, will show that icon instead of their
3063 window.
3065 Now Attribute editor also counts for defaults saved for all windows,
3066 (not only the default "No" for all options hardcoded in WindowMaker),
3067 when saving options for some instance.class specification. This is to
3068 save disk space by saving only the options that differs from global defaults
3069 (either defaults for all windows or the hardcoded valued in WindowMaker).
3071 Attribute Editor now updates on the fly the appicon image or creates/deletes
3072 the appicon if you set that options in the Inspector panel and Apply them.
3073 Modifying Icon file, NoAppIcon or AlwaysUserIcon and Applying them will
3074 result in the image update for the app-icon.
3076 Note that if you apply but not save these options, the miniwindow image will
3077 not be updated. This is because app-icon is always on screen so it can be
3078 updated, but miniwindow image is read from the defaults database and from disk
3079 every time you minimize the window and is destroyed when you restore.
3082 --- 0.13.0
3084 *** Attribute editor is working ;).
3086 How it works is quite obvious.
3087 Anyway, here is a short description.
3089 Save   - only save the configuration in defaults database and updates
3090          WMWindowAttributes
3091 Apply  - only applies the values to the current window
3092 Revert - reverts the values from the defaults database
3094 Note that Save and Revert count for the window specification
3095 (instance & class), that are selected, and save/use the values for/from
3096 that.
3098  The Update button will show the icon who's name was typed in the textfield
3099 If the textfield is empty, will try to use the default icon.
3100 Also saving with and empty textfield for icon, uses the default icon.
3102  The Default button will use the icon in the textfield as default icon
3103 and save that value in WMWindowAttributes (Note that in this case is no
3104 need to press the Save button!). Also if the textfield is empty it will
3105 try to use the old default icon, if available.
3107 *** Now menus are saved between sessions, or over a restart.
3109  Just stick them to the desktop, and you will find them over sessions
3110 until you close them.
3111  Please note that only the root_menu, the window switch_menu and the
3112 workspaces_menu can be saved this way.
3114 *** Changed the lousy Windoze menu behavior.
3116 This applies to 'NextMenuBehaviour = NO;'
3118  Now the items are no more automatically selected if you launch the menu
3119 and the mouse is over some item, if you use a short click to launch the
3120 menu (shorter than the default DBL click time).
3121  If you use a longer click or keep the mouse pressed, the item under mouse
3122 will be selected after that delay, and launched when you will release the
3123 mouse button.
3124  If the click was short, a second one is needed to launch the item.
3126 *** Auto-arrange icons is now a run-time option
3129 AutoArrangeIcons = YES/NO;
3130 in 'WindowMaker'.
3132 *** Added configurable horizontal resize threshold
3135   HorizontalResizeThreshold = <n>;
3137 This will make the n pixels at the exterior side of the corner handle
3138 of the resize bar to restrict to horizontal only resize.
3139 Also you can use Shift-click&drag anywhere on the corner handle to
3140 restrict the resize only to horizontal.
3141 Note that the Shift-click&drag does not depend of the configured threshold
3142 and works completely independent.
3144 *** New option for OPEN_MENU (pipe from command)
3146 OPEN_MENU | /foo/bar/script
3148 will make a menu that is dynamically constructed by /foo/bar/script
3151 --- 0.12.0
3153 *** New option for OPEN_MENU
3155 OPEN_MENU /foo/bar/pics xv -root -quit
3157 will make a menu with all files in /foo/bar/pics and precede them
3158 with EXEC xv -root -quit
3160 thus, making a menu with entries like:
3163 "marble.gif" EXEC xv -root -quit marble.gif
3164 "water.jpg" EXEC xv -root -quit water.jpg
3168 *** Multicolor gradients
3170 (mhgradient, colorX, color1, color2, color3, ..., colorn)
3171 (mvgradient, colorX, color1, color2, color3, ..., colorn)
3173 You can put any number of colors >= 2.
3175 colorX is a special color that is used as the solid color of the
3176 texture when wmaker needs a solid color (like in miniwindow title and
3177 resizebar)
3179 *** PixmapPath format changed
3181 What used to be
3183 PixmapPath = "/usr/local/share/pixmaps:~/foobar";
3185 must now be
3187 PixmapPath = ("/usr/local/share/pixmaps", "~/foobar");
3190 *** Added OffiX DND in dock
3192 Use the "Set drop arguments..." command in the menu and put a %d
3193 where the dropped object string should be substituted, like:
3195 xedit %d
3197 *** Escape thingies for menu and dock commands:
3199 %w - substitute with current selected X window ID
3200 %s - substitute with current selection
3201 %d - substitute with last dropped object
3202 %a(some text) - opens a input box with "some text" as a title. Then,
3203 the text typed will be substituted there
3205 \r, \n - substitute with corresponding characters
3208 *** The WMState file format has changed a little.
3209 The Command field for the dock application list is now a normal string,
3210 instead of a list. So, remove the parentheses and the commas for the command
3211 and join all the parts. Example:
3213 if it used to be
3215 Command = ( xterm," -geometry", "+10+10" );
3217 then make it
3219 Command = "xterm -geometry +10+10";
3222 --- 0.10.2
3224 AutoFocus = NO; disables automatic focusing of windows
3225 when they are first mapped
3228 --- 0.10.1
3230 titlebar gradients are in a single piece now
3232 the WMDock file was merged into the WMState file. You can insert this
3233 file in WMState and set its key to Dock. For example, if your WMDock
3234 contains:
3237         Applications = { {Command = (); }};
3238         Position = "-64,0";
3239         Lowered = NO;
3242 and WMState contains:
3245         Workspaces = ( "Workspace 1" );
3248 then you can merge both and have:
3251         Workspaces = ( "Workspace 1" );
3252         Dock = {
3253                 Applications = { {Command = (); }};
3254                 Position = "-64,0";
3255                 Lowered = NO;
3256         };
3261 The configuration format has changed!! Forget everything about the old
3262 format.
3264 dockapp was removed and the old version will not work anymore.
3266 the dialogs require tcl/tk. they will be rewritten in plain C
3269 These are some tips for people upgrading from older versions and don't want
3270 too many unused files around. There is no problem if you decide to keep
3271 them for a while.
3273         you can  rm -r ~/gnustep if you don't want anything from there
3275         remove the files in /usr/local/share/WindowMaker before installation
3277         the /usr/local/share/pixmaps directory can be removed