NEWS for veteran WindowMaker users
----------------------------------

--- 0.14.1


*** Enhanced fiend clone.

Here are the new fiend features:
1. Keys for raising/lowering the fiend, and their default values:
   FiendLowerKey = None;
   FiendRaiseKey = None;
   FiendRaiseLowerKey = None;

   All reside in WindowMaker configuration file.

2. Added posibility to launch the workspace menu with button1 click on the
   idle indicator of fiend, or with button3 click on workspace name on the
   fiend.

3. Added Control-button1-click on fiend's idle indicator, to create a new
   workspace and move to it. Same action as New item in Workspace menu.

4. Fiend's idle indicator do have a color that reflects its normal/collapsed
   state.

5. The delay between changing workspaces from fiend is now a runtime option:

   WorkspaceChangeDelay = 700;

   in WindowMaker configuration file.

6. Application icons can be moved between dock and fiend now.

7. The way workspaces are changed is controlled now by two runtime options:

   AdvanceToNewWorkspace=Yes/No;
   CycleWorkspaces=Yes/No;

   Both apply to either fiend navigating buttons or to next/prev worksapace
   keybindings. Both default to No, and are in WindowMaker configuration file.

8. Also added posibility to advance to new workspace, no matter what value
   AdvanceToNewWorkspace have, with Control-button1-click on "next workspace"
   fiend button.


*** Theme support ***

Spixmap and tpixmap now work. Their syntax is:

SomeStyleOption = (spixmap, file, color);
SomeStyleOption = (tpixmap, file, color);

- spixmap means scaled pixmap, so the image in the file will be scaled to
adapt to the destination's size.
- tpixmap means tiled pixmap, and the image from file will be tiled in the
destination.

file is searched in the PixmapPath, but can be a full path name.

Color is used depending on which Style option is applied.
For example in case of titlebars, color is used for miniwindows titles color.
You are not restricted in selecting that color, but is better to put one
that matches the overall color of the image.

Currently they apply to all the options that accept (solid, color), or any
type of gradient.
This means they also apply to WorkspaceBack and IconBack, which allows theme
support with the simple use of the setstyle and getstyle utilities.
There is no need for an extra theme manager, just to include the needed
options in the style files.

In case of WorkspaceBack, color is used to be set in the background until
the image gets loaded and displayed. This is to avoid the stippled screen
the X server shows, in case the image is big and loads slow.
There is a small utility in the util directory, named wmsetbg which is
used to set the background image. This is needed for windowmaker not to
freeze while loading and scaling the image.
Currently it is hardcoded in windowmaker to use wmsetbg to set the background
image, and is better to use it since is smaller that other image manipulation
programs, and it is compiled with support for same image types as windowmaker.
Since it comes and is installed with WindowMaker, there will be no need to
download and use an external app, which also may not have support for the same
image types as windowmaker.



--- 0.14.0

*** Fiend clone.

The fiend clone is a dock extender, that lets you dock more than the default
10-12 icons in the dock. It actually lets you dock how many icons you like,
with a current default of 25 per workspace. The fiend have different docked
icons on every workspace. Also the fiend main icon shows you the workspace
you're on and lets you navigate through the workspaces with the small green
buttons on the low right corner.
To save screen space the fiend can be collapsed to the main icon either
from the fiend menu (available with right click on the fiend icons), or
with a double left click on the main fiend icon, which is a toggle for
the collapsed/uncollapsed state.
Collapsed state is marked by a different title color.
Pressing on the small buttons on the low right corner, the workspaces are
changed in increments of 1 to the left or right, but keeping the button
pressed over them will continuously advance through workspaces until the
mouse is moved away from the buttons or the button is released.
The delay between workspace changes is set by FIEND_WKS_CHANGE_DELAY in
src/wconfig.h, and defaults to 700 ms.
Unlike the dock, fiend can hold icons in any directions, and can be placed
in any position on screen.

When an icons is to be docked, but the position can be either in the dock
or in the fiend, the dock will be used first, and the icon will be docked
there.

Here are the new runtime options introduced by the fiend:
Files are located in ~/GNUstep/Defaults/

In WMWindowAttributes:
       "Logo.WMFiend" = {Icon = "Cone.xpm";};  - icon for the fiend

In Windowmaker:
	FiendMaxIcons = 25;           - the max number of icons in fiend per
        				workspace
	FiendTitleFont = "-*-helvetica-bold-r-normal-*-10-*-*-*-*-*-*-*";
				      - the font used to show the current
                                        workspace
	FiendTitleColor = black;      - color for the uncollapsed fiend title
	CFiendTitleColor = "#616161"; - color for the collapsed fiend title
	AFiendColor = "#00ba70";      - color for the workspace changing
        				buttons, when active
	IFiendColor = "#008000";      - color for the workspace changing
        				buttons, when idle

For the ones who don't want to use fiend, there is a option to wmaker named
-nofiend that can be feed to the command line when starting wmaker.
(This is the equivalent for -nodock, but removes fiend clone).

The syntax of WMState file have changed, but you don't have to worry because
WindowMaker will know to read the old format and will save it and further
will use the new one. You do not need to change your file, for the new version
to work.


--- 0.13.1

*** Enhanced Attribute editor.

Now you can save defaults for all windows.
Please note that only Icon, KeepInsideScree, and sometimes NoAppIcon
can be useful in a normal environment. But others may have other opinion ;)
If you set AlwaysUserIcon default for all windows, note that apps like
asclock, wmload, wmmail, wmrack, will show that icon instead of their
window.

Now Attribute editor also counts for defaults saved for all windows,
(not only the default "No" for all options hardcoded in WindowMaker),
when saving options for some instance.class specification. This is to
save disk space by saving only the options that differs from global defaults
(either defaults for all windows or the hardcoded valued in WindowMaker).

Attribute Editor now updates on the fly the appicon image or creates/deletes
the appicon if you set that options in the Inspector panel and Apply them.
Modifying Icon file, NoAppIcon or AlwaysUserIcon and Applying them will
result in the image update for the app-icon.

Note that if you apply but not save these options, the miniwindow image will
not be updated. This is because app-icon is always on screen so it can be
updated, but miniwindow image is read from the defaults database and from disk
every time you minimize the window and is destroyed when you restore.


--- 0.13.0

*** Atribute editor is working ;).

How it works is quite obvious.
Anyway, here is a short description.

Save   - only save the configuration in defaults database and updates
         WMWindowAttributes
Apply  - only applies the values to the current window
Revert - reverts the values from the defaults database

Note that Save and Revert count for the window specification
(instance & class), that are selected, and save/use the values for/from
that.

 The Update button will show the icon who's name was typed in the textfield
If the textfield is empty, will try to use the default icon.
Also saving with and empty textfield for icon, uses the default icon.

 The Default button will use the icon in the textfield as default icon
and save that value in WMWindowAttributes (Note that in this case is no
need to press the Save button!). Also if the textfield is empty it will
try to use the old default icon, if available.

*** Now menus are saved between sessions, or over a restart.

 Just stick them to the desktop, and you will find them over sessions
until you close them.
 Please note that only the root_menu, the window switch_menu and the
workspaces_menu can be saved this way.

*** Changed the lousy Windoze menu behaviour.

This applies to 'NextMenuBehaviour = NO;'

 Now the items are no more automatically selected if you launch the menu
and the mouse is over some item, if you use a short click to launch the
menu (shorter than the default DBL click time).
 If you use a longer click or keep the mouse pressed, the item under mouse
will be selected after that delay, and launched when you will release the
mouse button.
 If the click was short, a second one is needed to launch the item.

*** Autoarrange icons is now a runtime option

Use
AutoArrangeIcons = YES/NO;
in 'WindowMaker'.

*** Added configurable horizontal resize threshold

Use
  HorizontalResizeThreshold = <n>;

This will make the n pixels at the exterior side of the corner handle
of the resize bar to restrict to horizontal only resize.
Also you can use Shift-click&drag anywhere on the corner handle to
restrict the resize only to horizontal.
Note that the Shift-click&drag does not depend of the configured threshold
and works completely independent.

*** New option for OPEN_MENU (pipe from command)

OPEN_MENU | /foo/bar/script

will make a menu that is dinamically constructed by /foo/bar/script


--- 0.12.0

*** New option for OPEN_MENU

OPEN_MENU /foo/bar/pics xv -root -quit

will make a menu with all files in /foo/bar/pics and precede them
with EXEC xv -root -quit

thus, making a menu with entries like:


"marble.gif" EXEC xv -root -quit marble.gif
"water.jpg" EXEC xv -root -quit water.jpg
...


*** Multicolor gradients

(mhgradient, colorX, color1, color2, color3, ..., colorn)
(mvgradient, colorX, color1, color2, color3, ..., colorn)

You can put any number of colors >= 2. 

colorX is a special color that is used as the solid color of the
texture when wmaker needs a solid color (like in miniwindow title and
resizebar)

*** PixmapPath format changed

What used to be

PixmapPath = "/usr/local/share/pixmaps:~/foobar";

must now be

PixmapPath = ("/usr/local/share/pixmaps", "~/foobar");


*** Added OffiX DND in dock

Use the "Set drop arguments..." command in the menu and put a %d
where the dropped object string should be substituted, like:

xedit %d

*** Escape thingies for menu and dock commands:

%w - substitute with current selected X window ID
%s - substitute with current selection
%d - substitute with last dropped object
%a(some text) - opens a input box with "some text" as a title. Then,
the text typed will be substituted there

\r, \n - substitute with corresponding characters


*** The WMState file format has changed a little.
The Command field for the dock application list is now a normal string,
instead of a list. So, remove the parentheses and the commas for the command
and join all the parts. Example:

if it used to be

Command = ( xterm," -geometry", "+10+10" );

then make it

Command = "xterm -geometry +10+10";


--- 0.10.2

AutoFocus = NO; disables automatic focusing of windows
when they are first mapped


--- 0.10.1

titlebar gradients are in a single piece now

the WMDock file was merged into the WMState file. You can insert this
file in WMState and set it's key to Dock. For example, if your WMDock
contains:

{
	Applications = { {Command = (); }};
	Position = "-64,0";
	Lowered = NO;
}

and WMState contains:

{
	Workspaces = ( "Workspace 1" );
}

then you can merge both and have:

{
	Workspaces = ( "Workspace 1" );
	Dock = {
        	Applications = { {Command = (); }};
        	Position = "-64,0";
       	 	Lowered = NO;
	};
}



The configuration format has changed!! Forget everything about the old
format.

dockapp was removed and the old version will not work anymore. 

the dialogs require tcl/tk. they will be rewritten in plain C


These are some tips for people upgrading from older versions and don't want
too many unused files around. There is no problem if you decide to keep 
them for a while.

	you can  rm -r ~/gnustep if you don't want anything from there

	remove the files in /usr/local/share/WindowMaker before installation

	the /usr/local/share/pixmaps directory can be removed