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