ScrollTitle
===========

Version 1.0
Copyright ©1996 Henrik Isaksson

What is this?
=============

ScrollTitle is a little hack that lets you scroll the windows' titles, or
just change it, if that's what you want.

Installation
============

Just copy the executable, ScrollTitle, to C: for example. Done!

How to use it
=============

Usage
=====

ScrollTitle [WINDOW] <window title> [TEXT <new title>] [SCREENTITLE] [ALL]
	    [NOSCROLL] [WAITWIN] [PRIORITY <pri>] [SCAN] [AUTOSCROLL]
	    [SCREEN <public screen>] [UPDATE <update] [DELAY <time>]

WINDOW      - The title of the window(s) to change. Wildcards can be used.
TEXT        - The new window title. See 'String format' below for
              formatting codes.
SCREENTITLE - Change the screen title too.
ALL         - Don't exit when the last window is closed, wait for new
	      windows to be opened. Must be combined with SCAN to
	      work.
NOSCROLL    - Don't scroll the title.
DELAY       - The time in 1/50 seconds between each move.
	      0   = fastest.
	      5   = default.
	      500 = s l o w e s t. (10 s)
WAIT        - Wait until the requested window is opened.
	      Use this if the window has not been opened at the time
	      you run the command.
PRI         - Task priority. Don't set it higher than 0.
	      -127 = lowest.
	       -50 = default.
	       128 = highest.
SCAN        - Scan the list of windows for new windows wich matches the
              argument given in WINDOW. If you don't combine this with
	      ALL, only the active window title will be scrolled.
AUTO        - Only scroll the title if it is too long to be shown in the
              titlebar.
SCREEN      - Public screen to search for windows.
UPDATE      - The delay between each update. This is measured in in the
	      time period entered in DELAY. The default is 5 DELAYs.

String format
=============

$t	-	Total free memory
$c	-	Free chip
$f	-	Free fast
$H	-	Hours
$M	-	Minutes
$S	-	Seconds
$y	-	Year
$m	-	Month
$d	-	Day
$>	-	Original window title
$-	-	First word in original title
$[xx]	-	Environment variable xx
$$	-	A dollar sign ($).

This is the default title:
"Amiga Workbench --- Total: $t, Chip: $c, Fast: $f --- $y.$m.$d $H:$M --- "

Some examples
=============

If you want to change a window to show the default text:

RUN C:ScrollTitle <name of the window>

Here's another example that will affect all windows whose names contains
an A:

RUN C:ScrollTitle "#?A#?" TEXT "The new text!" SCAN

(SCAN tells the program to check for new windows.)
(TEXT is the new title you want to be used.)

This will make all shell windows into clocks!:
(put in the startup-sequence)

RUN C:ScrollTitle "amigashell" TEXT "$H:$M:$S" NOSCROLL ALL WAIT SCAN

Disclaimer and distribution
===========================

All the files coming with the ScrollTitle archive are provided "AS-IS";
no warranties are made. All use is at your own risk. No liability or
responsibilty is assumed.

The complete and unmodifies ScrollTitle archive, as provided by the author,
may be freely redistributed via any means wich preserves its copyrights.
The archive may not be sold for profit.

The author
==========

Send bug reports, comments or money (if have too much) to:

henriki@pluggnet.se

Henrik Isaksson
Garvarvägen 33
S-950 40 Töre
SWEDEN

Soon: http://hotspot.pluggnet.se/~henriki