TreeSave is an attempt to provide as Microsoft Windows™ style saving facility to the Risc OS desktop. It was developed because of the suggestion of such a feature made by Toney Tolver in Archive magazine.
Use
~~~
The program is quite simple to use, just load it in the normal Risc OS way and use your applications as normal.
When you wish to save the document just bring up the save box as normal and drag the icon to the writable icon at the bottom of the save box. This will open the main window which will allow you to select your destination more thoroughly. When you have selected your destination click on the Save icon. Hey presto the file will be saved.
You can turn this feature off, and just save by draggin to the iconbar icon, see the choices section below!
NB: The program requires a scrap directory to work, if it hasn't seen !Scrap it will use its self, this could cause problems if it is in an archive, or on a read only media, such as CD rom.
Users
~~~~~
From version 1.20 onwards the program has had the support for different users. Basically, you specify a path to save the files to, and a name to be assocaited with that path, for example on my system I have two users:
Each of these users can have specific options associated with them, for example my 'school' user opens the browser window on my schoolwork directory and then allows me to select the sub directory to save into. Whereas the 'Scrap' user just does a single save into the scrap directory and opens the filer window for that directory. This is used to quickly save files.
Choices
~~~~~~~
Since 1.20 the program has had several user settable options that control the behaviour of the program, these are accessed by selecting the 'Choices...' option from the main menu, or by clicking on the iconbar icon with SELECT.
I shall run down what each option does (NB: The description is for when the option is selected):-
Misc options
------------
Disable quit - This greys out the 'Quit' option on the main menu, this is to prevent people from accidentally quitting the program. You can still quit the program from the TaskManager display though.
'Drag to writable' causes save - This enables the filter that allows you to initiate a save by dragging to the writable icon in the save box. This filter can cause problems with a few programs. If you find programs not behaving as they should the disable this option and see if the problem goes away.
Open destination - This causes the filer window to be opened after a file has been saved.
Display holding box - This causes a tray like icon to appear to the right of the TreeSave icon on the iconbar, when a file is saved to this icon the icon changes to represent a full tray, and becomes draggable. You can then drag the icon to a filer window to save the contents of the tray!
Request user name on startup - The dialogue box to allow you to change users is opened when the program starts.
Save options
------------
Default location - This is the default save location that will be used if there are no users selected. If single save is off then this is the directory the browser will open onto, otherwise files will be saved into this directory. You can change this location by dragging a directory to this window.
Single save - This causes the file to be saved straight away to the location specified, without bringing up the browser window.
Display status box on single save - This causes a dialogue box to appear when single saving to tell you where the file is being saved to.
With confirmation - This causes the dialogue box to require confirmation to save the file. It appears with additional 'Save' and 'Cancel' buttons.
Current save location
---------------------
This box shows the current save location. If there are no users selected then this will be the same as the default location, otherwise it will point to the path of the current user.
The 'Use' button to the right causes the current save location to be copied into the defaul location, allowing you to make the current users location the default if required. The 'Default' button simply restores the default location to what it was when the options were last set.
The three buttons along the botton right of the choices window allow you to save the options, cancel any changes made since the options were last set, and set the options. The 'Set' button sets the options until the program is quit, whereas the 'Save' button sets the options and then saves them so they will become the default options used each time the program loads.
Password...
~~~~~~~~~~~
This opens a window which allows you to protect the choices window with a password, this could be desirable in a school environment for example, where you don't really want people playing with the options.
To set a password enter a password in both writable icons, it must be the same in each, although it is not case sensative, ensure the 'Protect choices' option is ticked and then click on the 'Set' button.
Note: If the choices are password protected then you will need to select the 'Choices...' option from the main menu, clicking with SELECT on the icon will not work.
Users
~~~~~
The 'Setup users' window is available by pressing the 'Users...' button in the choices window.
To add a user
-------------
Click on the 'User' writable icon and type in the name of the user you wish to add. Then press RETURN and type in the path that is to be associated with that users. Click on the 'Store' button. Due to the way the program works you will have to instert a disc into the floppy drive if the path is pointing to that drive. (I shall sort this out later!)
If you drag a directory to this window the path of that directory will be insterted into the writable icon, if you drag a file then the path of the directory containing that file will be inserted.
If you want to specify individual options for that user then set the 'Set individual options for this user' flag, and the options to the right of the window will be unshaded and settable.
To change a user
----------------
Either type in the name of the user you wish to change, or select it from the pop up menu, and then enter a new path as described above. You can also change the options for that user.
When you have finished altering the users settings click on the store button to make the program store their settings.
To remove a user
----------------
Either type in the name of the user or select them from the pop up menu and click on the remove button.
When you have finished in the users button click on the 'Cancel' button and the window will close.
To change the currently selected user
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Select the 'Change user...' option from the menu, or click with AJUST on the iconbar icon and type in the name of the user. This is case INSENSATIVE, so 'Hello', 'hello' and 'HeLLo' are all the same.
History
~~~~~~~
1.00 - First beta test version
1.01 - After a sudden flash of insperation I thought of a better way of doing it so it should work with just about everything now!
1.02 - Sprites changed to standard Acorn ones, added small app sprites and filetype sprites as well.
Fixed bug that caused text in icons to be changed if droped onto.
Fixed problem caused by an empty directory.
Added name, wherever possible files retain their correct names
Added path detection. If the save box contained a path, winsave points at root of that drive.
1.03 - Additions and bugfixes/improvements in this version:-
* Fixed problem with an incorrect path being typed into window.
* Mouse pointer is limited when the file is being saved to prevent the menu from being closed. If you moved out of the savebox and back onto the menu the save window would be closed and the file wouldn't save!
* Scrap directory is now emptied before a save and on quit.
* Option to open directory after the file is saved.
* If there is no name a default is used rather than an error being generated.
* Save action slightly changed, it **appears** to work with the filer 'copy' save box (If you are copying one file only!), as this is not really the function of the program I see little point in perfecting this feature.
* Iconbar icon now implemented, although can't save from TaskManagers Desktop boot file option. I don't think this is a fault of my program though!
* Long standing bug fixed, whereby if you drag a file from the filer to an iconbar icon, like !Edit or !StrongED then the program crashed horribly. This error has been in for ages but I have only just noticed it!
1.10 - Additions and bugfixes/improvements in this version:-
* The program no longer types the text into the writable icon, hence faster!
* If a file is dragged to the iconbar icon and there is no scrap directory present one is created, rather than an error occuring.
* Not a bugfix, an observation: You CAN now save from taskmanager to the iconbar icon!
* The up button now works correctly, ie both windows are filled. go down a few dir levels and try it to see what I mean.
* The icons have been made wider, this allows names of upto 18 chars to be listed.
1.20 - Additions and bugfixes/improvements in this version:-
* Options window added
* Image file support, images now appear as directorys
* Single save implemented, with user definable destination
* Filter system modified so you don't get nasty things like adress exeptions buggering up your computer (I hope!)
* Options allow things like disabling quit
* User system added, whereby if you single save and have logged on as a user then your file will be saved in that directory. It is possible to have several users, each with different directories.
1.21 - Additions and bugfixes/improvements in this version:-
* Close and cancel buttons renamed to cancel, also cancel is back on main window
* The options window has been redesigned and the password moved to another window
* The iconbaricon option is gone!
* The open destination options is in choices only.
* Image files now appear correctly, but not Spark DIRS as this is just not possible (easly) and even if I did implement it the program would s l o w down considerably.
* Users path and default path used all the time.
* It is possible to confirm a single save.
* A message is given if the user is not known.
* Clicking on an open directory closes it.
* You can now select FS and drive from the main window.
1.22 - Bugfixes
* Removed dirup icon in root directory if directory was empty
* Fixed someting else too, but for the life of me I can't think what it was
* The FS selection should now work with just about everything.
1.23 - Bugfixes/changes
* The main browser should open correctly every time, sometimes the right hand side window was not filled when it should have been.
* The pane windows are not opened on a single save, why the hell didn't I notice this before
* The iconbar icon can be clicked on to open the options window.
1.24 - Bugfixes
* The right hand window now doesn't disappear
* When the browser opens on the root directory the window is set up properly.
* The FS selection should now work with nore things, like SCSI. This should have worked before but it didn't. I didn't know because I don't have any other filing system, other than ADFS and IDEFS to test it with.
1.25 - Changes
* The program spent a few days untouched on my harddisc and has since developed and identity crises, it therefore refuses to be recognised by it's old name and icon and insists on just an unpronouncable symbol. So until I can think of a better icon design the program is called 'The program formally known as WinSave'
* The iconbar icon now displays the current users name, or 'WinSave' if there is no user currently selected. The icon is automatically updated width wise to reflect the change. The current users path is now also displayed in the choices box too.
* Actually in version 1.24. Adjust click on the icon allows you to change users, select opens the options (unless a password is set then you must select the 'choices' option from the main menu)
* Interactive help added for: Choices, password setting, user control info windows, also for the iconbar icon too!
1.26 - Bugfixes/Changes
* The current users path display is gone, it is now replaced by the current save location.
* The 'use current users location' option is gone, it didn't actually do anything anyway.
* The application is now called 'TreeSave', but this could change
* The FS selection from the browser tries the harddisc if the floppy is empty.
* The program doesn't now crash if it's unable to save the file, it just tells you so!
* 'PrintFS' doesn't appear on the FS menu anymore.
* If the request username on startup option is enabled, but there are no users then the box doesn't appear.
* If there are no users the menu item is greyed out.
* The iconbar icon is now widthed properly when the program loads.
1.27 - Changes
* The choices window has a button to return the defalt path to defalt. Hmm!
* It has now been Risc OS 3.5/6 ifiyed to the best of my abilitys (I don't have the new PRM so I am not 100% sure!) It uses dynamic areas for it's memory (Faster, although you wouldn't notice it!) and it saves the choices in the correct location!
* The filter can be turned off with a badly named radio icon, this is 'cause it can interfear with some programs.
* Acorn error sprites added.
1.28 - Changes
* 2D window templates added.
* Easyfied the add user window
1.29 - Bugfixes/Changes
* Added user specific options, can't decide if this needs a seperate window or not?
* Fixed bug, whereby if you changed the current users options from the users window and you are currently logged on as that user then you could end up saving to the wrong place.
1.30 - Additions
* Added DropBox
1.31 - Bugfixes
* Made dropbox work!!! Filter was interfearing with dropbox operation.
* Added 'proper' ROS 3.5+ errorboxes. also changed some text in the messages file!
1.32 - Bugfixes/Changes
* Got dropbox working properly.
* Added purge option on the (new) dropbox icon menu to allow you to empty the dropbox.
1.33 - Bugfixes
* Sometimes clicking on the 'up' icon didn't work, it should now!
* Sometime ago I wrote a proper !Help file.
1.34 - Changes
* There is a no HDs option, which disables access to HDs from the pop up menu
in the main window, when it is selected only FSs that have floppy drives
appear on the menu.
* Keypresses should be passed on from the main window now.
1.35 - Changes
* Icon from dragbox is now the correct icon for the filetype.
* Had a stab at shareFS.
1.36 - Changes/Bugfixes
* 1.35 got nadgered up 'cos I used StrongED to edit the crunched code. ShareFS menubuilding code called when no drive selected.
* Sharefs code should work better.
Planned changes:
When I can be bothered (ie, not now, it's 2:42 am) I shall make HDs selected from the menu show their name, also I MAY make the name appear on the menu, but this is probably too difficult (you have to try several ways to get the name, and deal with each way if it returns an error!)
When ShareFS is implemented the shared discs names will appear on the menu!
Licence
~~~~~~~
The TreeSave application is FREEWARE, and as such may be freely distributed so long as no charge is made for the program itself. (This does not include any charges made for distribution/media/etc.)
Right, there is no warrenty, either express or implied, and this program is not guarenteed fit for use in any situation. I (the author) take no responsability for any (mis)use of this program by you (the user) and I can accept NO responsibility for any loss or damage incurred by doing so.
Basically, if something goes wrong, it's not my fault.
The TreeSave application was written by Ian Clark, all files are copyright 1995-96 Ian Clark and may not be copied or changed. You may alter your own, private, not to be given away, copy though.
You may translate the !TreeSave.Resources.Messages file into another language if you like, and if you do please send me a copy!
And finally
~~~~~~~~~~~
If you have any bugs, suggestions, comments, etc. I can be contacted at
Ian Clark
146 York Road
Haxby
York
North Yorkshire
ENGLAND
YO3 3EL
Fax: (01904) 763549
E-mail: rooster@cat1.demon.co.uk
Packet radio: 2E1ENA@GB7CYM - With the comeing of e-mail I look at packet less and less now, so if you send a message over packet it could take some time!
