@DATABASE DelAds.dopus.guide
@(C) " Copyright ® 1994 TGI-SERVICES & © RAM"
@$VER: DelAds.dopus.guide 5.0 (02.12.94)

@WIDTH 76
@NODE MAIN Contents

@{B}Contents@{UB}

@{" Description " link Description}		What is DelAds.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}DelAds.dopus 5.0.0@{UB}
Copyright © 1994 TGI-SERVICES & © RAM

Placed in the public domain. No restrictions on distribution or usage.


@ENDNODE
@NODE Description

@{B}Description@{UB}

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

DelAds keeps a config file ('S:DelAds.list') which holds a limited number
(300 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 'DelAds.dopus' to your 'REXX:' directory.

@{B}2.@{UB} Copy the file DelAds.list to your 'S:' directory.

@{B}3.@{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}4.@{UB} Create a button or menu item to call 'DelAds.dopus'.

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

@ENDNODE
@NODE Requirements

@{B}Requirements@{UB}

DelAds.dopus needs the following to operate:

 - Directory Opus V 4.12
 - LhA V 1.38+
 - MultiView (must be in 'SYS:Utilities')
 - 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 Dutch
(nederlands) and German (deutsch) catalogs are 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 DelAds.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.
DelAds.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 . After viewing the file you will be asked
again whether you want to delete it. Note that DelAds.dopus will always skip
                            'FILE_ID.DIZ'
files which are never deleted. If you make a wrong selection, just press the
"Exit"-button, and nothing happens. 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 300. You may change this number if you wish by editing the
script.

@ENDNODE
@NODE History

@{B}Revision history@{UB}

   - First public release.

Version 4.8.1 released 20-09-1994

Version 4.8.3 released 26-09-1994
Not from us, fake and buggy. Nowadays they can't even program AREXX
===========================
anymore.

Version 4.9.0 released 10-10-94
A lot faster saving of the configfile. Increase to 300 adds. 
Big pieces rewritten from scratch. Now also handles '*' and alike
files properly. Requester warning when there are too many adds. 
Removing from adds older than 28 days part is now upgraded.

Version 5.0   released 10-11-94
Some bugs fixed.
Handles "@" adds and alike files properly.


® TGI-SERVICES
@ENDNODE
@NODE Copyrights

@{B}Copyrights@{UB}

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

@ENDNODE