@DATABASE AutoRunNG.guide
@MASTER AutoRunNG.guide
@$VER: 1.0
@AUTHOR "Wojciech Polak ()"
@(C) "(C) 1998-99 Wojciech Polak. All Rights Reserved."

@WORDWRAP

@NODE "Main" "AutoRunNG 1.0 Documentation"
@{jcenter}
@{b}AutoRunNG 1.0@{ub}

NG  -->  The Next Generation

Copyright ©1998-99 by @{fg shine}Wojciech Polak@{fg text}
All Rights Reserved
@{jleft}@{code}
    Contents
    
    @{" Introduction                 " link "ar.intro" 0} What is AutoRunNG ?

    @{" Copyrights and Distribution  " link "ar.dist" 0} Legal Information
    @{" Requirements                 " link "ar.req" 0} System requirements...
    @{" Installation                 " link "ar.inst" 0} How to install AutoRunNG
    @{" Configuration                " link "ar.conf" 0} How to configure AutoRunNG
    @{" Technical Information        " link "ar.tech" 0} ...
    @{" Future                       " link "ar.todo" 0} What to do in the future
    @{" Known Bugs                   " link "ar.bugs" 0} Read about 101 bugs in AutoRunNG
    @{" Author                       " link "ar.author" 0} How to contact the author
    @{" History                      " link "ar.hist" 0} Changes since the last version

@ENDNODE

@NODE "ar.intro" "Introduction to AutoRunNG"

@{jcenter}@{b}Introduction to AutoRunNG@{ub}
@{jleft}
1. If you insert diskette, cd..(whatever you want) AutoRunNG will look for
   script-file "AUTORUN" and if file exists it will be executed.

	What will happen if AutoRunNG doesn't find a script-file "AUTORUN" ???

2. AutoRunNG will look for script-file "VOLUME-NAME" in drawer which you specify.

   That option is very helpful if you have cd-roms and often you are using
   programs on that compact disks.
   Just make script-file "VOLUME-NAME" and place it into drawer which you specify.

---------------------------------
 M A N Y   F E A T U R E S  !!! :
---------------------------------
- It is a commodity tool !!!
- Read script-file NOT ONLY from diskettes (DF0) but from new volumes
  (CD0,DF0,DF1...PC0...)
- You can open info-window if you want !!!
- You can configure whatever you want by ToolTypes or by Args.
- Locale library support (OS2.1+) !!!
- ScreenNotify library support !!!
- AutoRunNG can ask before execute script-file (Ask by requester,by Window,Don't ask).
- "Inactive" menu-option even if AutoRunNG is running !!!
- "HomeOnly" option : AutoRunNG won't execute script-file from new volume
  but from drawer which you specify - ONLY !!!
- Cardware !!!
- ONLY 7880 bytes !!!

@ENDNODE

@NODE "ar.dist" "Copyrights and Distribution"

Copyrights and Distribution
---------------------------

 This software is subject to the "Standard Amiga FD-Software Copyright Note".
 It is CARDWARE as defined in paragraph @{" 4c " LINK "AFD-COPYRIGHT/MAIN" 91}
 For more information please read "AFD-COPYRIGHT" (Version 1 or higher).

@ENDNODE

@NODE "ar.req" "Requirements"

@{jcenter}@{b}Requirements@{ub}
@{jleft}
	- AmigaOS 2.04+
	- AutoRunNG is a commodity tool. It requires commodities.library v37.
	- On AmigaOS 2.1+ AutoRunNG will use locale.library
	- ScreenNotify-Library support !
		ScreenNotify 1.0 - Copyright (C) 1995 Stefan Becker
		This package enables AutoRunNG to open and close window when
		Workbnch screen open or close.
@ENDNODE

@NODE "ar.inst" "Installing Instructions"

@{jcenter}@{b}Installing to the system@{ub}
@{jleft}
There is no installer script !

AutoRunNG can be started from a Shell or the Workbench.

1. AutoRunNG can be placed in WBStartup drawer.
   I think it's the best way to install AutoRunNG.

2. Copy to your path (C:). Add this lines to your Startup-sequence file:

	Run >NIL: C:AutoRunNG @{"[<arguments>]" link "ar.conf" 0}

@{code}

@{pard}
@ENDNODE

@NODE "ar.conf" "Configuration"

@{jcenter}@{b}Configuration@{ub}
@{jleft}

AutoRunNG has "Inactive" menu-option.
If you choose it AutoRunNG won't execute any file.

You can configure AutoRunNG by ToolTypes if starting from Workbench or by Arguments if starting from CLI.

@{b}I. TOOLTYPES@{ub}

@{b}CX_PRI=<-128..127>@{ub}

	All commodities tools receive input events through a prioritized queue of
	handlers. This means, the higher the CX_PRIORITY value, the sooner a tool
	will receive an event.
	(Default: 0)

@{b}CX_POPKEY=<hotkey>@{ub}

	You can invoke the AutoRunNG window with a hotkey combination.
	The default is "alt control a", which means that you need to hold
	down the [Alt] and [Ctrl] key and then press the [a] key to invoke
	the window.
	(Default: "alt control a")

@{b}CX_POPUP=<yes or no>@{ub}

	If you want AutoRunNG to open the AutoRunNG Window immediately
	when it is started, set this tooltype value to "yes". Otherwise, leave it
	as "no".
	(Default: no)

@{b}PRI=<priority of the task (-128...+127)>@{ub}
	Example: PRI=-1 , priority is -1
	(Default: 0)

@{b}DRAWER=<path to drawer which contains "virtual-autorun-file">@{ub}
	Example: DRAWER=SYS:Prefs/autorun@{b}/@{ub}
	@{b}IMPORTANT:@{ub} Backslash at the end of path !
	(Default:  S:)

What for is DRAWER tooltype ?
Example:
	You've got disk named MYDISK.
	If you insert MYDISK and AutoRunNG won't find file "AUTORUN" on that disk
	it will try to read file "MYDISK" in drawer which you specify
	e.g: SYS:Prefs/autorun/.
	Example:
		In my drawer I've got files "AMINET26","AMINET27","AMINET28"...
		Every time I insert Aminet28, AutoRunNG load and execute script-file
		in that drawer (named Aminet28).
		That file contains line like this: "PowerGuide Aminet28:Index".

@{b}HOMEONLY@{ub} - If you specify that tooltype AutoRunNG won't read file "AUTORUN" from volumes
           but only from your path (see: DRAWER tooltype).

           It can be very helpful if you afraid that some disk,cd... contains
           file "AUTORUN" with e.g. "format dh0:" !!!
           Now AutoRunNG will read only from your path and your drive will be safety.
           (Default: no)

@{b}XPOS=<horizontial position of the window>@{ub} e.g. XPOS=0 (Default: 0)
@{b}YPOS=<vertical position of the window>@{ub} e.g. YPOS=480  (Default: 0)

@{b}ASK=WINDOW | REQUESTER | NO@{ub}
	a) AutoRunNG will ask you by Window
	b) AutoRunNG will ask you by Requester
	c) AutoRunNG won't ask you anything
	(Default: NO)

@{b}This can be change (even if AutoRunNG is still running) by "Ask by..." menu-options !@{ub}


@{b}II. ARGUMENTS@{ub}

CX_PRI/N/K,CX_POPKEY/K,CX_POPUP/K,PRI/K/N,ASK/K/N,XPOS/K/N,YPOS/K/N,DRAWER/K,HOMEONLY/S,INFO/S

@{b}CX_PRI=<-128..127>@{ub}
	see: ToolTypes
	(Default: 0)

@{b}CX_POPKEY=<hotkey>@{ub}
	see: ToolTypes
	(Default: "alt control a")

@{b}CX_POPUP=<yes or no>@{ub}
	see: ToolTypes
	(Default: no)

@{b}PRI=Priority@{ub}  (Default: 0)

@{b}DRAWER=<path to drawer which contains "virtual-autorun-file">@{ub}
	@{b}IMPORTANT:@{ub} Backslash at the end of path !
	(Default:  S:)

@{b}HOMEONLY@{ub}  (see: HOMEONLY tooltype)
          (Default: no)

@{b}ASK = 0 | 1 | 2@{ub}
	a) 0 - Don't ask
	b) 1 - Ask by Requester
	c) 2 - Ask by Window (CON)
	(Default: 0)

@{b}XPOS=<horizontial position of the window>@{ub} e.g. XPOS=0  (Default: 0)
@{b}YPOS=<vertical position of the window>@{ub} e.g. YPOS=480   (Default: 0)


@{b}EXMAPLE:@{ub}

@{b}C:AutoRunNG CX_PRI=0 CX_POPUP=no PRI=-1 ASK=2 XPOS=0 YPOS=480 DRAWER=SYS:Prefs/autorun/@{ub}

@ENDNODE

@NODE "ar.tech" "Technical Informations"

@{jcenter}@{b}Technical Informations@{ub}
@{jleft}
AutoRunNG was written in C language and compiled by SAS/C v6.50 on:

 - A1200T/020
 - AmigaOS 3.1
 - 2MB Chip Ram
 - 4MB Fast Ram
 - Seagate 1,7GB
 - CD-ROM BTC 16xspeed

Original file size (AutoRunNG):  7880 bytes.

@ENDNODE

@NODE "ar.todo" "Future"

@{jcenter}@{b}Future@{ub}
@{jleft}
 - Linux, NetBSD, BeOS, MacOS version...8-)

@ENDNODE

@NODE "ar.bugs" "Bugs"

@{jcenter}@{b}Known bugs@{ub}
@{jleft}
	???

If you find any bugs or if you have any suggestions please @{" contact me " link "ar.author" 0}

@ENDNODE

@NODE "ar.author" "Contact"

@{jcenter}@{b}Contact the Author@{ub}
@{jleft}
Snail mail:
	Wojciech Polak
	ul.Sienkiewicza 101/109 m14
	90-301 Lodz
	POLAND

Electronic mail: jpolak@polbox.com

Please: emails should have a topic beginning with "AutoRunNG" !
@ENDNODE

@NODE "ar.hist" "History"

@{jcenter}@{b}History@{ub}
@{jleft}

Version 1.0 (8.5.99)	- First public release on Aminet

@ENDNODE
