@DATABASE DelBBSAds.dopus.guide
@AUTHOR "Edmund Vermeulen"
@(C) "Copyright © 1993-1994 EAV Productions International"
@$VER: DelBBSAds.dopus.guide 4.8 (28.7.94)

@WIDTH 76
@NODE MAIN Contents

@{B}Contents@{UB}

@{" Description " link Description}		What is DelBBSAds.dopus?
@{" Installation " link Installation}		How to install it on your system.
@{" Requirements " link Requirements}		Programs and libraries needed.
@{" Explanation " link Explanation}		How does it work?
@{" Revision history " link History}	Changes to the program.
@{" Copyrights " link Copyrights}		Legal credits.


This is the AmigaGuide® documentation for:

@{B}DelBBSAds.dopus 4.8@{UB}

Copyright © 1993-1994 EAV Productions International
Placed in the public domain. No restrictions on distribution or usage.

Author:	Edmund Vermeulen
	Primulastraat 2
	3202 RN  Spijkenisse
	Holland
	Tel. 01880-13925

Fidonet:  2:286/407.48
Internet: edmundv@grafix.wlink.nl

Please send all bugs, problems, suggestions and new catalog translations to
the address above.

@ENDNODE
@NODE Description

@{B}Description@{UB}

DelBBSAds.dopus is an ARexx script for Directory Opus for deleting those
irritating BBS ads and '.displayme' files from LhA archives.

DelBBSAds keeps a config file ('S:BBSAds.list') which holds a limited number
(60 is the default) of BBS ads it has deleted. Which BBS ads are kept in the
config is based on the number of times they have been deleted and the last
time they were deleted.

@ENDNODE
@NODE Installation

@{B}Installation@{UB}

@{B}1.@{UB} Copy the file 'DelBBSAds.dopus' to your 'REXX:' directory.

@{B}2.@{UB} Make sure ARexx is activated.

You can activate ARexx by double clicking the 'RexxMast' icon in the
'System' drawer. If you would like ARexx activated every time you boot, you
can place the 'RexxMast' icon in the 'WBStartup' drawer or add the line
'RexxMast >NIL:' to the 'S:User-Startup' file with a text editor.

@{B}3.@{UB} Create a button or menu item to call 'DelBBSAds.dopus'.

You must set the cycle gadget to 'ARexx' and choose 'DelBBSAds.dopus' from
the file requester.

@ENDNODE
@NODE Requirements

@{B}Requirements@{UB}

DelBBSAds.dopus needs the following to operate:

 - Directory Opus
 - LhA
 - MultiView or AmigaGuide
 - ReqTools.library
 - RexxReqTools.library

If locale.library is available it will use it to adapt to different
languages, provided there is a catalog. At the moment only a Dutch
(nederlands) catalog is available. I've included the catalog description
file in the archive, so if you wish to make a new translation, go right
ahead!

@ENDNODE
@NODE Explanation

@{B}Explanation@{UB}

When you start DelBBSAds.dopus from DOpus you are asked if you would like to
delete the ads automatic or interactive.

If you choose automatic then only the '.displayme' files and the BBS ads
that are stored in the config file will be removed from the selected LhA
archives.

If you choose interactive than the same will happen as in automatic mode,
but in addition you will be asked file by file if you want to delete them.
DelBBSAds.dopus will start with the files that were added the last and will
continue until you don't want to delete anything anymore. If you are not
sure whether a certain file is a BBS ad, you can use the 'View' button which
will show the file using MultiView (or AmigaGuide if you don't have
Kickstart 3.x). After viewing the file you will be asked again whether you
want to delete it. Note that DelBBSAds.dopus will always skip 'FILE_ID.DIZ'
files which are never deleted. All deleted files are added to the automatic
list, so you won't be asked to delete any files you've deleted before. At
the end of the session a new config file will be created. Which BBS ads are
kept in the config is based on how many times they were deleted and the how
long ago they were deleted last. The default maximum number of BBS ads in
the config is 60. You may change this number if you wish by editing the
script.

@ENDNODE
@NODE History

@{B}Revision history@{UB}

Version 4.8 released 28-7-1994

   - First public release.

@ENDNODE
@NODE Copyrights

@{B}Copyrights@{UB}

Directory Opus is Copyright © 1993 Jonathan Potter/INOVAtronics
LhA is Copyright © 1991,92 Stefan Boberg
ARexx is Copyright © 1987 William S. Hawes
AmigaGuide is Copyright © 1991-93 Commodore-Amiga, Inc.
ReqTools is Copyright © 1991-1994 Nico François
RexxReqTools is Copyright © 1992-1994 Rafael D'Halleweyn

@ENDNODE