Name:    WPlace
Version: 1.0
Date:    1993-07-

This software is public domain.

SHORT DESCRIPTION:
  WPlace is a windows program which lets the user position and size the
  windows before they are displayed.


WHAT IS WPLACE?
Can you remeber the last time you vere satisfied with the position and size of
a window?

Probably not.

WPlace lets you position and size windows before they are displayed. When a new
 window is created, WPlace displays a rectangle that you can move with the
 mouse and size with the arrow keys. When you are satisfied with the position
 and size of the window click the left mouse button. Note: you cannot see the
 window before you have clicked the buton.

How to move/size the rectangle:
[mouse]        Moves the window (if it is moveable) 
[left button]  Tells WPlace that you are satisfied with the position and size.
               The rectangle disappears, and the window is displayed.
[left arrow]   Makes the window become smaller.
[right arrow]  Makes the window become wider.
[up arrow]     Makes the window shorter.
[down arrow]   Makes the window taller.
'M'            Maximized the window. Note: this is done immidiatly, no clicking
               is necessary.
'I'            Minimizes (iconizes) the window. Note: this is done immidiatly,
               no clicking is necessary.

Registering the windows:
If you dont want to position the window next time the same window is created
you can direct WPlace to register it. The next time such a window is created
WPlace wil position and size it automatically.

Before I will explain how to register a window, I will tell you a bit of how
windows are organized:
(skip the section if you are a windows programmer)
Each window has a class and a title ('caption'). The class describes some basic
things about windows of this class. Severral windows can have the same class.
Eg if you has two notepad windows they will belong to the same class because
the basic behaviour of the notepad windows are the same. However, they will
probably not have the same titles. One window could have the title
"notepad - file1.txt" and the other notepad window could have the title
"notepad - untitled".

WPlace can register a window by its class, title or class and title. When you
register a window by its class all windows of this class will be positioned and
size as the window you are registering. Eg if you register a notepad window by
its class ALL notepad windows will be positioned and sized as the notepad
window you are registering.

If you register a window by its title, all windows with this title will be
positioned and size as the window you are registering.

If you register a window by its class and title only windows with the same
class and title will be positioned and size as the window you are registering.
This is usually the best thing to do because this way there should be no risk
of collision with other applications windows. If the title of window does not
change

It is also possible to tell WPlace that some windows should just be placed and
size at their default position. Messsageboxes are an example of windows which
should not be mangled. By default, all windows with titles such as "error",
"system error", "warning"... are registered to be positioned at their default
position.

Which windows should I register?
The windows you know you are usually going to move or size.

Which windows should I not register?
Windows which are "non-standard" in some way. Windows that are always icons is
an example. Windows that remeber their last position. Examples are: Program
manager, File manager, Control panel, Clock.
Care must be taken with dialogs. They all have the same class, so you should
register them by theis class AND title.

Registration keys:
'C'   The window will be registered by its class.
'T'   The window will be registered by its title.
'B'   The window will be registered by its class and title.
'-'   The window will be registered to be placed at its default position.
The registration of a windows takes places when you (1) click the left mouse
button; (2) press 'M'; (3) press 'I'; or (4) when you press '-'

EXAMPLES:
Example 1:
  You want all notepad windows be at a certain position and a certain size:
  Start notepad.
  (WPlace displays a rectangle)
  Size the rectangle using the arrow keys.
  Move the mouse positioning the rectangle.
  Press 'C' (because you want to position ALL notepad windows)
  Click the left mouse button.
  (the rectangle disappears, and a notepad window is displayed instead)
Example 2:
  You want to maximize all 'Write' windows.
  Start Write.
  (WPlace displays a rectangle)
  Press 'C' (because you want to position ALL Write windows; and the write
             windows change their title)
  Press 'M' (maximize)
  (the rectangle disappears, and a Write window is displayed instead)


BUGS:
WPlace depends heavily on some internal behaviour of Windows. Programmers have
been warned not to depend on them. However, depending on them is what makes
WPlace work.

If you experience any problems (like windows getting stuck) try this:
  1: Try to recreate the situation that caused the problem.
  2: Remove WPlace.
  3: Try to recreate the situation.
  4: If the problem does not occur after you have removed WPlace remeber the
     title of the window that caused problems to WPlace and add that window the
     WPlace's INI file (WPlace.ini is placed in your Windows directory)
WPlace has only been tested with Windows 3.1 and will probably not work under
Windows NT, Windows 4.0 or OS/2's WINOS2.