@DATABASE "StartupManager"
@AUTHOR David Swasbrook
@(C) Copyright (C)1995 David Swasbrook. All Rights Reserved.
@$VER: StartupManager.guide 1.2 (07.02.95)

@INDEX Index

@NODE MAIN "StartupManager (07.02.95)"

	StartupManager : Documentation Contents
	=======================================

	(C) 1995 David Swasbrook,
	   All Rights Reserved.

  @{" Disclaimer         "	LINK Disclaimer		}    Legal information

  @{" Distribution       "	LINK Distribution		}    Distibution & Freeware information

  @{" Requirements       "	LINK Requirements		}    What you needed

  @{" Introduction       "	LINK Introduction		}    Introduction to StartupManager

  @{" Installation       "	LINK Installation		}    How to install StartupManager

  @{" Usage              "	LINK Usage		}    How to use StartupManager

  @{" Special Thanks     "	LINK Thanx		}    Thanks to these people

  @{" History            "	LINK History		}    A very brief history of StartupManager

@ENDNODE

@NODE Disclaimer

	StartupManager/Disclaimer
	=========================

	I hereby reject any liability or responsibility for these or any other
	consequences from the use of StartupManager whatsoever. This includes, but
	is not limited to, damage to your equipment, to your data, personal
	injuries, financial loss or any other kinds of side effects.

	Although StartupManager has been tested thoroughly on several different
	machines, I cannot rule out the possibility that StartupManager:

	   o is somehow incompatible to your equipment

	   o has bugs that show up on your equipment

	   o does not do what it is supposed to do on your equipment

	It is your responsibility to take any precautions necessary to protect
	yourself from these or any other effects. I explicitly reject any liability
	or responsibility from the consequences of you using StartupManager.

	Swaz.

@ENDNODE


@NODE Distribution "Distribution information..."

	StartupManager/Distribution
	===========================

	StartupManager is @{b}FREEWARE@{ub}. The program may be freely distributed and
	copied, as long as the following conditions are fulfilled:

	   o The sales price must not be higher than the cost of an (empty) disk
	     plus a nominal copying fee plus costs for shipping. The total price
	     must not be higher than 5 US$.

	   o All parts of the program and the documentation must be complete. The
	     distribution of single parts or incomplete subsets of the original
	     distribution is NOT ALLOWED.

	   o StartupManager or parts of it may not be sold in combination with or
	     as part of commercial software.

	   o Program and documentation may not be changed in any way.

	   o Permission has been given for distribution through Aminet and Fred
	     Fish.

	Please contact the @{" Author " LINK Author} for further information.

@ENDNODE

@NODE Author "Contacting the author..."

	StartupManager/Author
	=====================

	I can be contacted via the following media:

	Postal:               David Swasbrook,
	                      PO Box 54134,
	                      Bucklands Beach,
	                      Auckland,
	                      New Zealand.

	Email:                swaz@iconz.co.nz

	Internet Relay Chat:  #amiga:Swaz

	World Wide Web:       http://iconz.co.nz/~msd/swaz.html

@ENDNODE

@NODE Requirements "Whats needed to run StartupManager"

	StartupManager/Requirements
	===========================

	The following are required for StartupManager to run:

	  o Kickstart V37 or higher

	  o @{" matrix.library " LINK MxLib} version 23.2103 or higher

	  o @{" WBStart-Handler " LINK WBStartHandler} version 1.4 or higher

@ENDNODE


@NODE WBStartHandler "WBStart-Handler"

	StartupManager/WBStart-Handler
	==============================

	Copyright ©1991-93 Stefan Becker.

	WBStart is a package to emulate the Workbench startup procedure. Emulating
	this method seems to be easy, because you only have to load a program, create
	a process for it and then send a Workbench startup message to it.

	But complications arise from this startup message. It contains pointers to
	memory and directory locks owned by your process and it will not be returned
	until the new created Workench process exits. So your program can't quit until
	ALL Workbench processes you created are finished and returned their startup
	messages, or the replied messages will go into nowhere land.

	WBStart solves this problem by using a handler process, which handles the
	creation of the process and then waits for the reply message. You just send a
	message to the handler port, which contains all needed information, like name
	and arguments. The handler duplicates this information, so your program can
	free its copy and exit.

@ENDNODE

@NODE MxLib "Matrix Library"

	StartupManager/matrix.library
	=============================

	Copyright ©1992-95 David Swasbrook, All Rights Reserved.

	o Yet another library to put in your LIBS: drawer.

	o Matrix.library provides general purpose routines which are commonly
	  used through out my programs. Some of the key features are the GUI,
	  preferences, and IFF routines.

	o The name "matrix" came from "The Matrix" - The computer system used
	  by the TimeLords (Re: Dr Who).

	o Please contact me if you'd like programming documentation.

@ENDNODE


@NODE Introduction

	StartupManager/Introduction
	===========================

	StartupManager is a progam to show you the programs being run at startup and
	also providing an easy means of turning off all programs in the startup
	path.

@ENDNODE


@NODE Installation

	StartupManager/Installation
	===========================

	Double click on the "install" icon.

	StartupManager will be installed in the SYS:WBStartup drawer and all the
	current programs residing in there will be moved into the startup path
	SYS:Startup.


@ENDNODE


@NODE Usage "How to use StartupManager"

	StartupManager/Usage
	====================

	If you used the install program you can find StartupManager in SYS:WBStartup.
	StartupManager will be run automatically by Workbench at Startup and it will
	then startup all the programs SYS:Startup drawer.Once all the programs have
	been started StartupManager will quit.

	If you are holding down either SHIFT keys when StartupManager runs then all
	startup programs will not be loaded.

	StartupManager can be @{" configured through tool types " LINK ToolTypes} if necessary.

	See @{" Startup Program Tool Types " LINK ToolTypesForStartupProgs} for additional tool types that are
	supported by the Startup Programs.


@ENDNODE


@NODE ToolTypes "Tool Types"

	StartupManager/Tool Types
	=========================

	StartupManager accepts the following tool types:

	@{b}PATHS@{ub}
		This is a list of directorys to read the startup programs from.
		Multiple paths may be specified by placing a "," inbetween the
		paths. Eg. PATHS="SYS:Startup,HOME:Startup".
		@{i}Default = SYS:Startup/@{ui}.

	@{b}FONT@{ub}
		The font to use to display information test in the window.
		@{i}Default = Times 18@{ui}.

	@{b}WIDTH@{ub}
		Width in pixels of the window.
		@{i}Default = Half the width of the display@{ui}.

	@{b}LEFT@{ub}
		Horizontal position of the window relative to the current display
		clip. If not provided then the window will be centered horizontally
		on your display.
		@{i}Default = No setting (Centered)@{ui}.

	@{b}TOP@{ub}
		Vertical position of the window relative to the current display
		clip. If not provided then the window will be placed vertically
		from the bottom of the display the height of the window plus a
		small border amount.
		@{i}Default = No setting (Auto position)@{ui}.

	@{b}HEIGHT@{ub}
		Width in pixels of the window. If necessary the height will
		be increased to fit all the images in the window.
		@{i}Default = 40 pixels@{ui}.

	@{b}PATHPRI@{ub}
		Set to YES to give programs in the first search path a higher
		priority than those in the second path, and those in the second
		path have priority over those in the third, etc...
		@{i}Default = NO@{ui}.


	See @{" Startup Program Tool Types " LINK ToolTypesForStartupProgs} for additional tool types that are
	supported by the Startup Programs.

@ENDNODE

@NODE ToolTypesForStartupProgs "Startup Program Tool Types"

	StartupManager/Startup Program Tool Types
	=========================================

	The following tool types may be set in the tool types of the individual
	startup programs. They are processed by StartupManager and ignored by
	the Startup Program.

	@{b}STARTPRI@{ub}
		This is the priority in the booting sequence.
		Range -128 to 127.
		@{i}Deault = 0@{ui}.

	@{b}TASKPRI@{ub}
		This is the priority thats the startup program will execute at.
		Range -128 to 127.
		@{i}Deault = 0@{ui}.

@ENDNODE



@NODE Thanx "List of contributors"

	StartupManager/Contributors
	===========================

	  Luke Chastain
	  Michael 'Mick' Hohmann
	  Sam Hulick

@ENDNODE

@NODE History

	StartupManager/History Information
	==================================

`1.2'	o Will run programs without icons as workbench processes.
	o Aminet release

`1.1'	o Arrggh, always seem to miss something out in the first release, ok
	  well I had accidentally left in kickstart version checking for V39.
	o Added LEFT and TOP tooltypes for window positioning.
	o Removed some old debug info

`1.0'	o Initial aminet release.

@ENDNODE

@NODE Index "Index..."

	StartupManager : Documentation Index
	====================================

	(C) 1995 David Swasbrook,
	   All Rights Reserved.

  @{" Author                  " LINK Author		} Contacting the author
  @{" Configuration           " LINK Config		} Configuring StartupManager
  @{" Distribution            " LINK Distribution		} Distibution rights
  @{" Disclaimer              " LINK Disclaimer		} Legal information
  @{" Email and WWW Addresses " LINK Author		} Contact addresses for Author
  @{" Freeware                " LINK Distribution		} Freeware status
  @{" Installation            " LINK Installation		} How to install StartupManager
  @{" Introduction            " LINK Introduction		} Introduction to StartupManager
  @{" History                 " LINK History		} A very brief history of StartupManager
  @{" Matrix Library          " LINK MxLib		} Yet another library
  @{" Requirements            " LINK Requirements		} Whats needed
  @{" Special Thanks          " LINK Thanx		} Thanks to these people
  @{" ToolTypes               " LINK ToolTypes		} Configuring StartupManager
  @{"   For Startup Programs  " LINK ToolTypesForStartupProgs } Startup Program additional tool types
  @{" Usage                   " LINK Usage		} How to use StartupManager
  @{" WBStart-Handler         " LINK WBStartHandler	} WBStart-Handler

@ENDNODE
