@database MagicFile.guide
@author "Erno Tuomainen"
@$VER: MagicFile.guide 0.52 (28.08.93)
@font topaz.font 11
@wordwrap
@node Main "MagicFile 0.52 (28.08.93) GUIDE"


                              MagicFile V0.52 
              (Full Screen Scrolling ANSI Filelister/Tagger)
                                    By
                              Erno Tuomainen

                     Last Compilation Date 28/08/1993

                              Sysop Documents


		@{"What is it   " link intro}		
		@{"Features     " link features}

		@{"Requirements " link requires}		@{"History      " link history}
		@{"Installation " link install}		@{"Future       " link future}
		@{"LEGAL        " link legal}		@{"Contacting   " link contact}

				@{"SHAREWARE" link shareware}
@endnode

@node intro "Introduction"
What is MagicFile and Why is called Magicfile?

	This      is      Full      Screen,      ANSI-Scrolling,
	filelister/filetagger   for  Dialog  Professional  BB/OS
	ONLY!  Not for other BBS softwares, only DLG is and WILL
	be supported.

	This  really  is  something  what  should've been in DLG
	since start.  :)
@endnode

@node features "Features of MagicFile"
Features of MagicFile

	o  Moving around the list with KEYPAD. 
		Up, Down		    (2, 8)
		Page Down, Page Up	    (3, 9)
		Begin of list, End of list  (7, 1)
	o  Moving around the list with CURSORS.
		Up, Down
		Left	  =	Page Up
		Right	  =	Page Down
	o  Fast/Slow cursor mode, selectable with 'c'
	o  Filetagging/untagging with SPACE/RETURN or 't'
	o  Descriptions On/Off, selectable with 'd'
	o  Fits into your screen. (Adjusts length of filedescriptions
	   to your screen width
	o  etc... PLEASE SUGGEST!

@endnode

@node requires "Requirements"

	o  First of all, AMIGA is NEEDED :--). Any 680x0 should work.
	o  OS 2.04 and upwards. (Developed on A3000 OS3.1 System)

		   NOT tested on OS 1.3, MIGHT work!

	o  YOU REALLY NEED  DIALOG PRO! (Developed in DLG V0.999 system.)
	o  DLG Installed as it should be.

	Here  are  some  things  to be noted, you don't normally
	need  to  worry  about  them.   IF YOUR DLG is installed
	properly!

	1)   Root file directory must be FILE: (Assign)

	2)   MagicFile uses "FILE:Area.file" to get information about
             your fileareas so this file must exists and be available
             in CORRECT form.

	3)   MagicFile   uses   "FILE:xx/yy.fd"   files  for  getting
	     information about tagged files, so you need them!

	4)   Files can be spreaded around in several dirs but if your
	     files  are  in  another directories than 'FILE:xx/' then
	     the path must be told in fileareas configuration.

@endnode

@node install "Installing MagicFile"
And How do I install it?

	Easy.

	Just  copy  the  executable  into the dir where you keep
	your DLG Utilities.

	CLI 7> Copy MagicFile <Path>

	Then  create the following menuentry into your File_Main
	Menu

[ 1] Letter:                   *
[ 2] Executable: (path/name)   path:MagicFile %PORT %File_Areanumber
[ 4] Description:              MagicFile(TAG)
[ 5] Type:                     Executable
[ 6] Help File:                FILE_MAIN/1
[ 7] Lower level:              5
[ 8] Upper level:              255
[ 9] Hidden:                   NO
[10] Load type:                OVERLAY
[11] Ask user if sure:         NO
[12] Pend messages:            YES
[13] Cli mode:                 NO
[14] Pause on completion:      NO
[15] Log value:                NONE
[16] Activity string:          Using MagicFile Door!!!
[17] Priority:                 DEFAULT
[18] Edit help file

	And MagicFile should be up and running!
@endnode

@node history "History of MagicFile"
VERSION: (@{b}V0.52 28.08.1993@{ub})

	(RELD)	First Release
	( ADD)	Lots of keys/cursor movement (requested by Eric De Jong)
	( ADD)	Shareware reminders.

@endnode

@node future "Future of Magicfile"
@{b}Future@{ub}

	I'll add lots of stuff if I find a way to do them.

	For  example,  future  (@{b}maybe  only registered@{ub}) versions
	will have:

	o  Area Selecting
	o  Starting of external executables
		->  File viewer
		->  ArcHandler
	o  Maybe some file-editing for Sysops?
	o  Global/Local Search with keyword
	o  Stuff.... @{b}PLEASE SUGGEST!@{ub}

@endnode

@node legal "Copyrights & Legal mumbojumbo"

	MagicFile,  and  this  document, are copyrighted by Erno
	Tuomainen.    However,   this   archive  may  be  freely
	distributed  and  copied for NON-COMMERCIAL only.  Under
	any   circumstances  may  you  redistribute  a  modified
	version of MagicFile.  Neither may any redistribution of
	MagicFile for profit be made.

	If  you use MagicFile, you do this entirely at your VERY
	own  risk.   This  program  is  provided "AS IS" without
	warranty  of any kind.  I (author) am not responsible of
	ANY of the damages MagicFile might cause.

@endnode

@node contact "How to Contact the author?"
Snail Mail:

		Erno Tuomainen
		Toritie 14 B 23
		19600 HARTOLA
		FINLAND, Europe.

BBS:		Moonlight Sonata DLG
		+358-18-161763

Fido:		2:221/112.0

Newest  version  of  MagicFile  can  be  requested at my system with
the MAGIC Filename :

			@{b}MAGICFILE@{ub}

@endnode

@node thanks "Thanks"
Thanks must go to Following people:

	Julian Iizuka		(Is the name Correct now?-)
				for the FIRST bugreport ever
				and for new ideas.

	Eric De Jong		For the LONG list of new ideas!

	TPT			For DLG!!!

@endnode

@node shareware "MagicFile is SHAREWARE!"

	Yes! MagicFile IS SHAREWARE!

	Unregistered MagicFile is not crippled in anyway (I HATE
	Crippled  utilities)  instead I have made few irritating
	*UNREGISTERED* reminders.  But the future versions might
	include some options available just for registered users
	only.

	I  have  spent  LOTS  and LOTS of hours/nights with this
	utility.   Also  I  have  had so many problems with this
	when developing it.  So I'll release this as Shareware.

	I   decided  (hopefully  reasonable)  to  put  following
	shareware fees:

	@{b}$15 for foreigners@{ub} and
	@{b}80mk for finns@{ub}.

	You  may  use  this  for an evaluation period of 30 days
	free.  After that period, if you like it and want to use
	it, you must register.

	When  you  register,  you will get the latest version of
	REGISTERED MagicFile.

@endnode
