ReadMe for Task Setup Configuration Plugin v1.05 (6th May 2007)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Purpose:
~~~~~~~~
	To provide easy configuration of startup items in !Boot sequence.


Use:
~~~~
	Select from the main !Boot configuration and a window will appear,
	showing all the items in the PreDesk sequence.
	A menu button at the allows you to set the PreDesk, Tasks or
	Resources directories.
	PreDesk contains files that are loaded before the desktop is
	started.
	Tasks contains files that are loaded after the desktop is started.
	Resources contains system resources which are 'seen' when the 
	computer starts up.
	Clicking on the "Open Dir" icon will open the relevant directory,
	as will selecting the relevant menu option.
	
	Beneath the main icons at the top is a long 'Info' icon which 
	displays any help or information on the relevant file. Extra data
	can be added by editing the 'Messages' file. The format of this
	is;
		 p_ for PreDesk
		 t_ for Tasks
		 r_ for Resources
	followed by the relevant filename all in lowercase, followed by a
	colon (:) and then the relevant description/help text.
	eg.
		t_app:Example description for file called app


	Each item has a corresponding 'Disabled' tick box, which allows you
	to toggle whether or not the item is disabled. Those items that are
	disabled will not be loaded/seen next time you boot the machine.
	
	TaskSetup works by moving disabled items into a (new) 'Disabled'
	directory inside !Boot. When you re-enable an item it moves it back
	into the original location.
	
	Some items are potentially dangerous (ie. may mess up the normal
	running of the computer) so they have a 'safety catch' to prevent
	you from accidentally disabling them. A 'Lock' option on the main
	menu allows you to overwrite the safety catch and disable them
	anyway.
	N.B. The safety catch is automatically re-enabled each time you
	click an option, so that you can't forget it and locked items are
	coloured red.
	
	An additional menu option (Directory) allows you to open or close
	the relevant directories being viewed.
	
	
Adding files to the !Boot sequence
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	You can drag files to the relevant window pane in order to copy new
	files into PreDesk, Tasks or Resources.


Installation:
~~~~~~~~~~~~~
	RISC OS 5:
		To install into the RISC OS 5 !Boot sequence, simply drag
		the !Boot folder from this archive over your existing !Boot
		folder. The relevant files will then be merged.

	Pre RISC OS 5:
		You will need to manually open the !Boot folder in this
		archive, then open the Resources.Configure directory.
		Drag !TaskSetup into this directory.


Technical:
~~~~~~~~~~
	!TaskSetup creates some new directories in your !Boot sequence:-

	Boot:Disabled
	     |
	     |
	      ------------- Boot:Disabled.PreDesk
	     |
	      ------------- Boot:Disabled.Tasks
	     |
	      ------------- Boot:Disabled.Resources
	      
	which store the disabled files from "Boot:Choices.Boot.PreDesk",
	"Boot:Choices.Boot.Tasks" and "Boot:Resources" respecively.
	

To Do:
~~~~~~
I'm open to suggestions for improvement.


Version History:
~~~~~~~~~~~~~~~~
v1.05 (6th May 2007)
        a) Improve memory allocation.
        b) Increase wimpslot to 512K to prevent memory allocation errors
           when there are large numbers of files within the boot directories.
        
v1.04 (6th May 2007)
        a) Changed task name to "Task Setup" (rather than just "Task")
        b) Added some more items to the help database.
        c) Added some more item help definitions.
        d) Expanded internal memory allocations.
        
v1.03 (1st May 2007)
	a) Added 'Help/Info' line, which provides additional information
	   on files.
	b) Converted top control icons into a tool window so that it doesn't
	   scroll out of view when you scroll down.
	c) Bug fix: Files and applications are now shown in the correct
	   alphabetical order, irrespective of lower/uppercase.
	d) Added database of common applications and modules.
	e) Tested on RISC OS 6 (Select 4i2) and A9Home.
	f) Changed 'Cancel' icon text to 'Close' to avoid confusion.
	g) Added Help icon to main toolbar, for TaskSetup help.
	   
v1.02 (25th Jan 2006)
        a) Fixed occasional fatal 'abort' error (down to silly typo in
           having wrong number of icons defined in window definition).
        b) Added 'Open Dir' icon to main window - to open the relevant
           directory.
        c) Added '!Help' icons to open any associated !Help files within
           the relevant applications/utilities etc.
        d) Adjusted initial window position to be consistent with other
           Boot plugins.
        e) Made icons a more consistent size to allow for long filenames.
           
v1.01 (24th Jan 2006)
	a) Made directory selection via a menu instead of buttons.
	b) Amended wording in error warning window to say TaskSetup instead
	   of MiscSetup.
	c) Made window opening a bit more consistent.
	d) Coloured 'locked' items red.
	   
v1.00 (23rd Jan 2006)
	First version - should be all working ok.


Author:
~~~~~~~
TaskSetup is copyright Paul Vigay but may be freely copied and distributed
providing all the files remain intact and unaltered, including this one.

Email: nospam@vigay.com
  Web: http://www.vigay.com/software/
  
2006-2007 Paul Vigay
