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