@DATABASE AssignListPatch.guide
@$VER: 1.0
@AUTHOR "Markus Adamski"
@(C) "14.04.1996"

@TOC "Main"

@NODE "Main" "AssignListPatch - Übersicht"
@{B}			   AssignListPatch

		 Copyright © 1996 von Markus Adamski

			    - Freeware -@{UB}

		@{"  " LINK "INTRO_WHATIS"} About AssignListPatch ?
		@{"  " LINK "INTRO_SYSREQ"} Systemrequirements
		@{"  " LINK "INTRO_INSTALL"} How to install AssignListPatch ?

		@{"  " LINK "USE_START"} Getting started
		@{"  " LINK "USE_USAGE"} Usage

		@{"  " LINK "FILE_FORMAT"} Definition-file's structure

		@{"  " LINK "HISTORY"} History
@ENDNODE

@REMARK -----------------------------------
@REMARK ---   Einführung / Übersicht	---
@REMARK -----------------------------------
@NODE "INTRO_WHATIS" "About AssignListPatch"

AssignListPatch patches some dos function-calls to intercept
"volume not mounted"-errors.
@ENDNODE

@NODE "INTRO_SYSREQ" "Systemrequirements"

OS2.04 or higher and a 68000 cpu or higher are required.

Add a feature by running @{B}AssignList@{UB} in the background.
@ENDNODE

@NODE "INTRO_INSTALL" "How to install AssignListPatch ?"

AssignListPatch will be installed along with AssignList or copy
it manually to your @{B}WBStartup@{UB} drawer.
@ENDNODE

@REMARK -----------------------------------
@REMARK ---	Benutzung		---
@REMARK -----------------------------------
@NODE "USE_START" "Getting started"
Start AssignListPatch either from workbench or shell.
If the program icon is in the same drawer from which AssignListPatch
has been started (always the case when started from workbench)
one @{B}TOOLTYPE@{UB} is supported:

@{B}CX_POPUP=<YES|NO>@{UB}	Tell the program to pop up a
			requester after starting/terminating.

@{B}DONOTWAIT@{UB}		If AssignListPatch is installed in
			the @{B}WBStartup-drawer@{UB} tell the system
			not to wait for AssignListPatch to
			terminate.
			(May be submitted always.)
			Has no further effect on program execution.

AssignListPatch is a commodity and can be aktivated, deaktivated
or terminated via for example @{B}Exchange@{UB}.
@ENDNODE

@NODE "USE_USAGE" "Usage"
If a program tries to access a device or volume via a patched
function (see startup message)that is not available a message will
pop up with two possibilities to choose from:

@{B}1. Select...@{UB}	The unavailable device/volume will be made
		available by assigning that device to a drawer which
		can now be selected.

@{B}2. Abort@{UB}	The function-call will be directly passed
		to dos.


If @{B}Select...@{UB} has been chosen, you can now select a drawer
or device. After the selection has been made another message will
pop up giving you three or four possibilities to choose from:

@{B}1. Select...@{UB}	Select another drawer.

@{B}2. Execute@{UB}	Execute assign (see message) and resume
		the calling prozess.

@{B}3. Add to list@{UB}	This button will only appear if AssignList
		is running. (ARexx must be running as well !)
		The assign will be added to the main and the
		temporary list and then the program will proceed
		as under 2.

@{B}4@{UB}(3)@{B}. Abort@{UB}	Same as above.
@ENDNODE

@NODE "FILE_FORMAT" "Format der Definitionsdatei"
You may preserve device/volume names from being intercepted by
AssignListPatch because not every program that access an
unavailable device will fail.

These names are submitted in the file @{B}"ALP_ExDev.Prefs"@{UB} which
must reside in the same drawer as AssignListPatch:

	* Each line may contain only one name.

	* Each line must start with a '#' and end with a carrige
	  return (CHR$(10)).

	* Names may not end with a ':'. This will not result in
	  an error but the name will not be recognized as
	  being prevented from interception.

	* Names are not case-sensitive.

Such a file may look like this:

#test1@{B}<CR>@{UB}
#test2@{B}<CR>@{UB}

@{B}<CR>@{UB} means to press enter.

Such a file may be created with any editor.
@ENDNODE

@NODE "HISTORY" "Programm-Geschichte"
@{B}Version		Date		Information
-------------------------------------------------------------------@{UB}
  1.00		14-Apr-96	Initial release

  1.11		15-Apr-96	Some bug fixes
@ENDNODE