AutoSave 1.01 (05-Dec-01)

Name:     ArtWorks AutoSave module
Purpose:  Auto save feature for ArtWorks
Author:   Martin Wrthner
Requires: RISC OS 3.1 or higher, ArtWorks 1.138 or higher
Status:   ShareWare see [5] and [6] below
WWW:      http://www.mw-software.com/

This ArtWorks module provides an auto save feature similar to that of
Impression. Its main features are:

* auto save with or without prompt at arbitrary auto save intervals
* auto save is only activated once you have actually modified the document
* the auto save status is saved with the document


1) Installation
---------------
Copy the !AutoSave application inside the !ArtWorks.Auto directory. (Shift
double-click on !ArtWorks to open it, then double-click on the 'Auto' folder.
Then drag the !AutoSave application to the Filer window showing
<something>.!ArtWorks.Auto in its title bar). This will cause ArtWorks to
load the module automatically next time it is started.

If you are not using the 'Quick start' feature of ArtWorks, then this is it
already. Otherwise (this is recognized by the fact the ArtWorks only displays
one icon 'Quick start' when starting up) you have to go on:

If the 'Quick start' option is selected in the ArtWorks choices window you
have to perform the following steps in order for ArtWorks to recognize the
new version of the module:

* Load ArtWorks
* Open the ArtWorks choices window (icon bar menu 'Choices...', then click on
  the ArtWorks icon in the ArtWorks global choices window)
* Deselect 'Quick start' and click on 'Save'
* Quit ArtWorks
* Reload ArtWorks - while loading ArtWorks shows every module it loads, this
  should include the AutoSave module. If ArtWorks displays an error message
  like "Due to lack of memory one or more modules could not be loaded ..."
  something has gone wrong and you should check whether you have correctly
  installed the module.
* Open the ArtWorks choices window again
* Select 'Quick start' and click on 'Save'

If you ever should want to deinstall the module, remove the !AutoSave directory
from the !ArtWorks.Auto directory. Then, if you are using the 'Quick start'
option, you must repeat the same steps above.


2) The AutoSave module
----------------------
2.1) How to use it
------------------
The AutoSave module does not provide a tool in the Tool Box. Instead, it
provides a new icon in the document choices window. This is obtained by
choosing "File => Choices..." from the ArtWorks main menu. The reason for its
being there is that the Auto save status is a property of each document. This
has the benefit that you can specify the auto save behaviour for each document
individually. So, you can have documents that do not auto save and others that
do, each after its own specific time interval. The auto save status is saved
with the document and is even retained if the document is edited using a copy
of ArtWorks without the AutoSave module and loaded back into a copy of ArtWorks
with the AutoSave module later.

Clicking on the Auto save icon in the document choices window opens the Auto
save choices window. This window is only available if the document has a
valid save path, i.e. if the document has already been saved at least once or
if it has been loaded from disc.

The Auto save choices window contains two option icons and an input field.

Selecting the "Enable" icon switches auto save on for the document. Once this
option is selected, the second option icon and the input field are accessible:

You can enter the auto save interval in the input field, i.e. the number of
minutes after which auto save is to take place. Please note that auto save only
takes place after you have actually modified the document and the time is
always counted from the first modification after the last time the document was
saved. So, if your auto save interval is 10 minutes, then auto save will take
place 10 minutes after the document has first been modified. If you save it
manually inbetween, the auto save interval starts again as soon as you modify
the document. Starting from this moment, so it will then take another 10
minutes before auto save takes place.

The "With prompt" option works similar to Impression. If this is switched off,
ArtWorks saves the document after the specified amount of time without asking
you. This is potentially dangerous as this might mean that the auto save
function kicks in at an inconvenient moment (e.g. after you have just
accidentially deleted most of the document and you not have managed to paste it
back). Therefore, the "With prompt" option should normally be switched on. In
this case, ArtWorks displays a window showing the file name of the document
that is about to be saved and you have to confirm this by clicking on OK. After
the document has been saved, the time for the next auto save interval starts
as soon as the document is modified again. If you click on Cancel instead, the
file is not be saved. In this case, you will be asked again after the auto save
interval has elapsed one more time.

2.2) Bugs and deficiencies
--------------------------
Unfortunately, the document choices dialogue box does not extend correctly if
more than 4 icons are displayed. So, the icons that end up in the second
row are not accessible because you cannot scroll down. If you have Arranger and
Precision installed in addition to AutoSave, then the Precision document
choices will not be accessible. Unfortunately, this seems to be a bug in CC's
code so it cannot be fixed.

You are advised not to turn on auto save in your DefDoc (the default document
that is loaded when ArtWorks starts up) because this has no save path
associated with it which can lead to some anomalies (although this should not
lead to any serious problems).


3) Contacting me
----------------
Martin Wuerthner
Mannheimer Str. 18
67655 Kaiserslautern
Germany

Phone: +49-(0)631-3608205
Fax:   +49-(0)631-3608203

e-mail: martin@mw-software.com
WWW:    http://www.mw-software.com/


4) Version history of AutoSave
------------------------------
1.01 (05-Dec-01):
- finally fixed long-standing bug that disturbed many other modules:
  * it prevented you from changing the font of text lines in all but
    the most recently opened document
  * it caused the values in the Info Bar to disappear after switching to the
    Selector temporarily using the Alt key (e.g., if you were working with the
    Rectangle tool and you had a rectangle selected and pressed Alt, then after
    releasing Alt, the Info Bar incorrectly displayed '-' in all the fields
    although the rectangle was still selected and the Rectangle tool was the
    current tool)
  Many thanks to Ian Dennison who pointed me to AutoSave as being the culprit
  causing this problem.

1.00e (28-Aug-01):
- documentation update
- added German and Dutch resources

1.00d (27-Jul-00):
- documentation update

1.00c (01-Oct-98):
- contains new AutoSave sprite for the document choices window
  many thanks to Bob Potter who contributed it
  
1.00b (10-Feb-98):
- first version released with the QuickCopy Group 1.03b


5) Copyright
------------
The AutoSave ArtWorks module including all related files is Copyright 2001,
by Martin Wrthner and is ShareWare.

This means that you may copy it freely provided that
(a) all files of this ArtWorks module are distributed together without
    modification
(b) this application is not sold for profit without my explicit written
    permission - you also have to apply for permission to distribute this
    program on a CD if it is sold for profit or to distribute it together
    with other commercial software.
I retain the copyright on all files.


6) ShareWare registration
-------------------------
You may use this software free of charge for a trial period of two weeks.
If you find it useful and decide to go on using the module, you have to
register.

Registration of AutoSave includes registration for QuickCopy and ZoomPlus.

6.1) How do I register?

Registration costs only 10 Pounds. Please enquire by mail or e-mail for site
licence prices. Please do not add VAT as I am not registered.

This price applies irrespective of whether you find only one of QuickCopy,
AutoSave or ZoomPlus useful or all of them. You have to register if you would
like to go on using at least one of the modules after the two week trial period.

In order to register, send 10 Pounds to me. I accept bank notes in any currency,
cheques drawn from British or German banks, Eurocheques (in Pounds if drawn from
a British bank, else in DM) and international postal orders.

If you have got an e-mail address, please quote it when registering. I will
then put you on my e-mail list for automatic upgrades.

And finally: Before registering, have a look at the ArtWorks tools WWW site at
http://www.mw-software.com/ because you might want to order some other modules at
the same time.

6.2) What do I get?

Do not be surprised if you do not get a reply from me.

QuickCopy, AutoSave and ZoomPlus are my second attempt at real ShareWare, i.e.
if you find the modules useful, then you have to register. There is nothing
extra you will get when registering apart from the permission to actually use
the modules.

Registered users can request updates of these three modules (and any others you
might have bought from me) by sending me a blank, Acorn formatted disc, a self-
addressed envelope (235mm by 125mm max.) and 1 Pound for postage (cash or in
stamps; German users: send 2,20 in stamps).
