@database "Apper.guide"
@node "Main" "Main / Apper V1.17 (c)'95 by André (CPU) Seidelt"

		APPER V1.17 (20.09.95)
    
 @{" Introduction            " link "Einlei"}  Apper - whats that?
 @{" Contens                 " link "Inhalt"}  What's in this archive?
 @{" Installation            " link "Instal"}  How to do?
 @{" System requirements     " link "Anford"}  What you need...
 @{" ToolTypes               " link "ToolTypes"}  How to control Apper...
 @{" MenuFile                " link "MenuFile"}  Format of menufile...

 @{" Author                  " link "Autor"}  Who did it?
 @{" Registration            " link "Regist"}  Hey, whats that?
 @{" DISCLAIMER              " link "Rechtl"}  I disclaim everything...

 @{" History                 " link "history"}  Once upon a time...
 @{" ToDo                    " link "ToDo"}  Not much...
 @{" Blablabla...            " link "Thx"}  Things I have to say...

@endnode

@node "Einlei" "Introduction / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Introduction@{ub}
	Starting with KS2.x an eight color WB lookes quite good, but there
	were several things I missed.
	One of these things was an AppIcon thats able to delete files I
	dropped on it. After a short quest through lots of BBS I found
	TrashIcon V1.6 by Mark McPherson. I gave it a nice icon taken from
	a MagicWB-clone and was happy again for a short time. ;))
	But then I had to watch that a friend of me took an icon of a
	picture, dropped it on his "show"-dock of ToolManager and it runned
	VT to show that picture.
	Because of an aversion to ToolManagers window and memory usage I
	decided to program an AppIcon thats able to identify a file and
	then starts a matching program. Because I didn't want to increase
	the number of programs in my WBStartUp-drawer I included the
	funktions of TrashIcon and AddMenu.

@{b}Features:@{ub}
	-Uses whatis.library for identifying filetypes, so adding new
	 filetypes is very easy.
	-The program is very short and fast because of 100% assemblercode
	 (the Apper icon is bigger than the program itself).
	-Look and position of both icons could be changed like most of the
	 other configuration stuff.
@endnode

@node "Inhalt" "Inhalt / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Contens:@{ub}
    Apper package:
	apper.info
	apper/Apper
	apper/Apper.info
	apper/Install_Apper
	apper/Install_Apper.info
	apper/Apper_deu.guide
	apper/Apper_deu.guide.info
	apper/Apper_eng.guide
	apper/Apper_eng.guide.info
	apper/S
	apper/S/Apper.info
	apper/S/Apper4col.info
	apper/S/TrashIcon.info
	apper/S/TrashIcon4col.info
	apper/S/FileTypes
	apper/S/ToolsMenu
	apper/S.info

    Whatis.library package:
	apper/WhatIs
	apper/WhatIs/include
	apper/WhatIs/c
	apper/WhatIs/s
	apper/WhatIs/libs
	apper/WhatIs/InstallLib
	apper/WhatIs/InstallLib.info
	apper/WhatIs/Product-Info
	apper/WhatIs/s.info
	apper/WhatIs/WhatIsLibrary.doc
	apper/WhatIs/WhatIsLibrary.doc.info
	apper/WhatIs/AskReparse
	apper/WhatIs/env.lzx
	apper/WhatIs/include/proto
	apper/WhatIs/include/pragmas
	apper/WhatIs/include/libraries
	apper/WhatIs/include/clib
	apper/WhatIs/include/proto/whatis.h
	apper/WhatIs/include/pragmas/whatis_pragmas.h
	apper/WhatIs/include/libraries/WhatIsBase.h
	apper/WhatIs/include/clib/whatis_protos.h
	apper/WhatIs/c/WBInfo.c
	apper/WhatIs/c/WBRun
	apper/WhatIs/c/WBRun.doc
	apper/WhatIs/c/BaseName
	apper/WhatIs/c/BaseName.c
	apper/WhatIs/c/For
	apper/WhatIs/c/For.c
	apper/WhatIs/c/For.doc
	apper/WhatIs/c/TackOn
	apper/WhatIs/c/TackOn.c
	apper/WhatIs/c/tiny_For
	apper/WhatIs/c/tiny_For.c
	apper/WhatIs/c/VolName
	apper/WhatIs/c/VolName.c
	apper/WhatIs/c/WBInfo
	apper/WhatIs/c/AddIcon
	apper/WhatIs/c/AddIcon.c
	apper/WhatIs/s/FileTypes
	apper/WhatIs/s/FileTypes.info
	apper/WhatIs/libs/whatis.library
	apper/WhatIs.info
@endnode

@node "Instal" "Installation / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Installer-Script:@{ub}
	Simply doubleclick the Install_Apper-icon and follow the instructions.
	(sorry, I wanted to use the C= installer, but I was not able to find
	my documentations ;)))
	After that you have to edit the @{"ToolTypes" link "ToolTypes"} to your favourite display
	tools and then the @{"MenuFile" link "MenuFile"} to build your own tools-menu.
@endnode

@node "Anford" "Anforderungen / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}You need:@{ub}
	- At least KS2.x, if you don't have: go and boil your head!
	- whatis.library 2.x+
	- The incredible amount of 60kb memory. ;)))
@endnode

@node "ToolTypes" "ToolTypes / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}ToolTypes:@{ub}
	AppText=	: The text displayed under the AppIcon. If you let
			  the string empty, the icon will have no name
			  (Default: Apper).
	TrashText=	: The text displayed under the TrashIcon. If you let
			  the string empty, the icon will have no name
			  (Default: Trash).
	AppXPos=	: X-position of the Apper-Icon (Default: no pos.)
	AppYPos=	: Y-position of the Apper-Icon (Default: no pos.)
	TrashXPos=	: X-position of the Trash-Icon (Default: no pos.)
	TrashYPos=	: Y-position of the Trash-Icon (Default: no pos.)
	AppIconPath=	: Path and name of the icon Apper should use for it's
			  AppIcon (without ".info").
			  If nothing is specified Apper uses it's programicon
	TrashIconPath=	: Path and name of the icon Apper should use for it's
			  TrashIcon (without ".info").
			  If nothing is specified Apper uses it's programicon
	MenuFile=	: Path and name of the @{"Menufile" link "MenuFile"}.
	ErrorRequest=	: (YES/NO) Enables/disables errormessages.
	ExitRequest=	: (YES/NO) Enables/disables exitrequester when double-
			  clicking Apper's icons.
	DeleteRequest=	: (YES/NO) Enables/disables requester when deleting
			  files.
	TrashIcon=	: (YES/NO) Enables/disables the TrashIcon.
	(Default of all switches: YES)

@{b}Actions:@{ub}
	The actions are defined in the ToolTypes, too. They look like this:
		<IDString>=<program> [options] %s%s [options]

	IDString:	Is created by whatis.library (e.g. ILBM).
	Programm:	The programm to run for that filetype.
			(e.g. MultiView).
	%s%s:		Is expandet to the path (first %s) and the filename
			(second %s) of the dropped icon.
			(e.g. Pictures:Fantasy/Dragon).
	Options:	Are optionaly (is told by their name, isn't it ? ;)
			and could change from program to program.

@{b}Example:@{ub}
	A complete fileaction lookes like this:
		ILBM=MultiView %s%s SCREEN
	The Apper would now run "Multiview <filepath>/<filename> SCREEN" if
	an ILBM-picture is dropped on it's icon.
@endnode

@node "MenuFile" "MenuFile / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}MenuFile@{ub}
Structure of this file:
	At first a "#" as first char of the line to create a menuentry and
	straight after the "#" the name of the entry.
	Now you could define a command that should be executed if the entry
	is selected, this has to start with a "_" and the full commandline
	behind it. Optionaly you are able to define a directory where Apper
	should "CD" in, before the command is executed (NOTE: the CD-Path
	is only valid for the command after it !!!)
	If you don't specify a command, nothing happens if the entry is
	selected (logical, isn't it).
	This feature was added, because of creating barlabels (e.g. with "=").
	The number of command's per entry is not limited.
	Every line not starting with a "_", "." or a "#" would be ignored.

@{b}Example:@{ub}
#ED
^ creates a menuentry named "ED"
.SYS:
^ CD's into "SYS:" before running next command
_C:ED
^ runs the program "C:ED" if the entry is selected
@endnode

@node "Autor" "Author / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Author:@{ub}
	Fastnet	: CPU@SETUP
		  CPU@Orkland

	E-Mail:
		cpu@karsen.be.schule.de

	SETUP:
		Port 1 - +49 (o)3o 683 48 81  TKR 19k2
		Port 2 - +49 (o)3o 683 48 91  NN  14k4
		Port 3 - +49 (o)3o 683 45 43  NN  14k4

	Orkland:
		Port 1 - +49 (o)3o 6o6 99 73
		Port 2 - +49 (o)3o 6o6 99 74
		Port 3 - +49 (o)3o 6o6 99 75
		Port 4 - +49 (o)3o 6o6 99 76
		Port 5 - +49 (o)3o 6o6 s0 0n
	(send mails and other stuff to CPU)

@{b}Address:@{ub}
	André (CPU) Seidelt
	Holzmindener Str.1
	12347 Berlin
	Germany
@endnode

@node "Regist" "Registration / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Registration@{ub}
	The Apper is CARDWARE/MAILWARE. This means, if you like this
	program and you decide to instal it on your system, then send
	a postcard/e-mail to the address mentioned at @{"Author" link "autor"}.
	But don't forget to write your address on the postcard/e-mail,
	because I want to know where it comes from.

	If someone is interested in my bad, ugly, opaque, complicated,
	system unfriendly and not documented sourcecode, then make a remark
	on your postcard/e-mail and I think about it. ;))
@endnode

@node "Rechtl" "Disclaimer / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b} Disclaimer:@{ub}
    THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
  OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
  COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
  OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
  THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  POSSIBILITY OF SUCH DAMAGES.

  THE WHATIS.LIBRARY IS (C) 1994 BY SYLVAIN ROUGIER AND PIERRE CARRETTE.
  LOOK AT THE WHATIS DOCUMENTATION FOR FURTHER INFORMATION.
@endnode

@node "History" "History / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Idea@{ub}
	It came on my mind on 12.08.95.

@{b}History@{ub}
       <V1.00	- forget it....;)

	V1.03	- first betaversion, without TrashIcon (14.08.95)

	V1.10	- second betaversion, TrashIcon is still unable to delete
		  drawers

	V1.11	- killing drawers worked fine, until a delete-protectet file
		  appeared, causes the computer to crash

	V1.13	- first release (17.08.95)

	V1.14	- harmless bug in the put-the-commandline-together-and-run-it-
		  routine removed

	V1.15	- added ability to add entrys in WB's Tools-menu
		- second release (19.08.95)

	V1.16	- now a Tools-menu-entry is able to run several commands
		- now you can specify a drawer to "CD" in before running a
		  menu-command
		- third release (20.08.95)

	V1.17	- removed a bug, that appeared if Apper was started from CLI
		- fourth release (22.08.95)
@endnode

@node "ToDo" "ToDo / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}ToDo:@{ub}
	- enable several actions for a filetype
	- add Commoditie startup and messagehandling, so Apper could be con-
	  trolled by Exchange (I still think it's useless and would only blow
	  up the code)
	- Apper should run a own process for every appmessage recieved, so
	  it could handle those messages asynchronious.
	- who cares... (if you want to have something added, contact me)
@endnode

@node "Thx" "Danke / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Comments:@{ub}
	- Forgive me my poor English, but is't not my native language and
	  I dislike the school subject. ;))))
	- But be warned: my German isn't much better. ;))))
	- I couldn't find out the source of the icons. Apper's icon was
	  cutted out of a WB-snappshot, were it was a ToolManager-Dock
	  and the TrashIcon was painted by me, but the trashcan was cuttet
	  out of the same snapshot.
	- SMILE, there's comming something in my mind right now: you can't
	  show icons with the Apper !!! ;))))

@{b}Greetings:@{ub}
	  Benny, Bluethunder, Bunny, Crush, Curley Sue, Dr.Damage, Dude,
	  El Kamehl, Ernie, HCL, Kadetti, Kathy, Klecks, Magnetic, Maverick,
	  Mr.Sam, Nobody, Orog Ork, Panter, Phantom, Power, RAM, Reiner,
	  Relax, RoadRunner, Schlaefer, Shadow, Silja, Soulman, Tachy,
	  Thorsten, Thrawn, Thunderhawk, WingThor

@{b}Thanks:@{ub}
	- my parents, because they feed me while I was programming ;))

	- Mozart, Beethoven, Vivaldi, Brahms, Tschaikovsky, Mendelssohn,
	  Grieg, Verdi, TiamaT, Paradise Lost, Iron Maiden, Metallica,
	  Slayer, Rage against the machine, D.A.D., Skid row, AC/DC,
	  Marillion and den Toten Hosen because I enjoyed their music.

	- RoadRunner for DevPac V2.0, Markus Junginger for MegaEd V1.0,
	  Michael Sinz for Enforcer V37, Peter Stuer for DosTrace V2.13
	  and Andreas Gelhausen for Scout V37.116.

	- The Authors of whatis.library, because their developerdocumentation
	  of whatis.library is completely useless for assemblerprogrammer ,((
	  (the library is still ingenious)


@{b}and remember:@{ub}
		only AMIGA makes it posible...
@endnode
