name:   SamePlace v1.07
author: Kostas Proitsakis (GUS/Arm's Tech, gusuni@otenet.gr)
size:   2042 bytes
needs:  RISC OS 3
descr.: Remembers window locations and provides sticky windows!
____________________________________________________________________________

  Files included in this directory are:
@
  More!Install...{Obey     Installs the WT SamePlace in !Boot}
  |          !Uninstall.{Obey     Uninstalls WT SamePlace from !Boot}
  |          bliaaaaah!.{BASIC    The source for the system module}
  |          SamePlace!.{BASIC    The original source (for the WT module)}
  |          SamePlace..{WTModule The tool as WT module}
  |          ~Compress..{Obey     Compresses the WT module SamePlace}
  |          ~FushPos...{BASIC    Resets the positions of windows}
  |          ~SetSticky.{BASIC    Set the sticky distance (for the RM)}
  |
  ReadMe.....{Text    This file}
  SamePlace..{Utility The tool as system module}


Introduction
============

1. It can /learn/ where you want most of the windows you are using.

2. Sticky windows! (Windows which snap to the edges of other windows
   when dragged. In order to understand what I mean, the best will be
   to have only two windows opened on screen and drag them until you
   get the idea.)

All it learns is saved when you shutdown the computer and when
when you restore a state (http://www.multimania.com/gusuki/Freeze)
then it is loaded back when SamePlace is loaded and when a state
is restored.

NOTE: SamePlace will be temporary paused when a key is pressed.


Limitations
===========

The window locator
~~~~~~~~~~~~~~~~~~
It is incompatible with any application that opens a window
more than once, like "open then resize and reopen"
where that could be "resize and open". !Edit is one of them.

The sticky windows
~~~~~~~~~~~~~~~~~~
If you change your toolsprites the new sprite sizes will be read
after the next mode change.


How to use (the WT version of SamePlace)
========================================

*SamePlace_Sticky sets the distance in OS units for
sticky windows. A value of 0 turns off the sticky windows.

Syntax: *SamePlace_Sticky <value>

Although the RM SamePlace will take advantage of Wacky-Talky (if
that is loaded), you are *strongly* recommented to use the WT version
of SamePlace because that will be updated in the future; it also uses
a much better method to claim the needed Wimp SWIs.

Make sure !WT is installed (http://www.multimania.com/gusuki/),
then just run More.!Install, that will be enough.


Technical details
=================

The window locator
~~~~~~~~~~~~~~~~~~
That is using 32 bytes/window, the current version uses a 16K workspace
and it can keep information for 512 windows max.

The workspace is accessed as a cache using the hashed pseudo CRC value
of the title data and the window sizes and colours; that makes it fast.


Acknowledgements
================

Special thanks goes to Pervect/Topix, to Stefan Bellon and to Oliver Dyas
for the testing and their ideas :)

Many kisses to my sweet girl Maria :)

----------------------------------------------------------------------------
If you want to assemble it, use the command: *Run !GLib
then run the source. (assuming that Wacky-Talky is installed :)
____________________________________________________________________________
GUS
