@DATABASE "Bin_Nederlands.guide"
@REMARK $VER: Bin_Nederlands.guide 37.08 (02.03.94)
@NODE MAIN "Prullenbak dokumentatie"
**************************************************************************


                                The Bin 37.22
                      De prullenbak die ook echt wist !


                               SmallBin 37.02
                       Een prullenbak voor Toolmanager


                   © Copyright 1994 door Maarten ter Mors

**************************************************************************

        Inhoudsopgave :

    @{"Introductie         " LINK Introduction}  Wat is in Godsnaam The Bin ?
    @{"Systeemvereisten    " LINK System}  Wat heb ik nodig voor The Bin ?
    @{"Installatie         " LINK Installation}  Hoe The Bin te installeren

    @{"Tooltypes           " LINK Tooltypes}  Opties aanvaard door The Bin
    @{"The Bin gebruiken   " LINK Usage}  The Bin in het dagelijks gebruik

    @{"Plus : SmallBin     " LINK SmallBin}  Nog een prullenbak ??
    @{"SmallBin Installatie" LINK SmallBin_Install}  Hoe het aan het werk te  krijgen

    @{"Over de auteur      " LINK Author}  Dat ben ik ! :-)

@ENDNODE

@NODE Introduction "Introductie"
    Ooit iets snel en gemakkelijk willen wissen ?   Ooit een prullenbak
gewild, die iets meteen verwijderde, zonder een optie uit een obscuur 
Workbench-menu te hoeven kiezen ?   Heeft u zich ook al eens afgevraagd
waarom het Trashcan-ikoon niet op het Workbench-scherm geplaatst kon worden, 
zodat u niet steeds dat window hoeft te openen als u iets weg wilt gooien ?

Als u 'ja' heeft kunnen antwoorden op éen of meer van deze vragen, dan is de
redding nabij.  Redding in de vorm van The Bin, een prullenbak als commodity, 
die geheel gelocaliseerd is, onder andere in het Nederlands.  The Bin stelt u
in staat om van ongewilde bestanden af te komen op een gemakkelijke manier.  
Het is oorspronkelijk bedoeld om de 'Verwijder' optie uit het Workbench menu
te kunnen omzeilen.  De Trashcan in zijn huidige vorm is een aardig idee, 
maar hoe vaak heeft u het voor iets anders gebruikt, dan er een bestand in
werpen en meteen daarna het te verwijderen met 'Leeg prullenbak' ?  The Bin 
zal u die moeite besparen.

The Bin is vrij verspreidbaar volgens het FreeWare-principe.  Dat betekent
dat u dit programma vrij mag verspreiden, aan uw vriend(in) mag geven, op een 
Bulletin Board mag uploaden, op Public Domain diskettes mag plaatsen,
enzovoort.  Sterker nog, hoe meer u het verspreidt, hoe liever het mij is.  
De enige voorwaarden die hieraan verbonden zijn, zijn de volgende :

    1) U mag geen geld verdienen aan The Bin zonder schriftelijke
    toestemming van de auteur (hee, dan wil ik ook wat ! :-).
    2) U mag niets veranderen aan het pakket, dus niets toevoegen,
    verwijderen, veranderen of hernoemen.  Op deze manier krijgt 
    iedereen een volledig en goed werkend geheel, dat werkt en o.a.
    deze copyright-mededelingen in zich heeft.

Mocht u suggesties hebben, een fout in het programma gevonden hebben of 
gewoon wilt zeggen : 'Hee, wat een geweldig/waardeloos programma', dan kunt u
altijd contact met @{"me" LINK Author} opnemen.
@ENDNODE

@NODE System "Systeembenodigdheden"
    U heeft geen geweldig groot systeem nodig om gebruik te maken van The 
Bin, omdat het maar een tamelijk klein programmaatje is.  Het zal maar een
paar kilobytes aan geheugen innemen, maar afhankelijk van hoeveel u nog 
overhoudt voor andere programma's, kan dat nog steeds teveel zijn.  Als u
toch al weinig geheugen hebt en niet nog meer wilt verspillen aan iets doms 
als een prullenbak, kijk dan eens naar het hoofdstuk @{"SmallBin" LINK SmallBin},
dat voor u van belang kan zijn.

De absolute minimumconfiguratie om The Bin te gebruiken is :

    * Amiga met Kickstart V37 (2.x) of hoger
    * Workbench V37 (voor localisatie in b.v. Nederlands is V38 vereist)
    * 20 kB vrije schijfruimte
      (dat zijn kilobytes, geen megabytes ; dit is MS-Windows niet ! :-)
    * 50 kB vrij RAM geheugen (kan variëren, afhankelijk van gebruikt
      ikoon en catalogi met talen)

@ENDNODE

@NODE Installation "Installatie"
    De installatie van The Bin is volledig geautomatiseerd met Commodore's 
Installer-programma.  Helaas is dit stukje software niet vrij verspreidbaar
en daarom kan ik het u niet meeleveren.  Het hoort te staan op de Install- 
schijf die u (als het goed is - sommige Nederlandse dealers doen hier niet
aan, met name bij A1200's) bij uw systeem heeft gekregen.  Om het 
installatiescript dat bij The Bin zit te kunnen gebruiken, moet het ook in
het standaard zoekpad staan (C:, bijvoorbeeld).  Als u het programma wel in 
uw bezit heeft, maar het staat niet in het pad, verander dan het Standaard
Tool (met Informatie) in <pad>:Installer.

NOTA BENE : Als u van plan bent SmallBin te installeren, kijkt u dan in
@{"SmallBin Installatie" LINK SmallBin_Install}.

Als u geen Installer heeft of hem even niet kan vinden, maakt u zich dan geen
zorgen, want installatie met de hand is ook vrij eenvoudig.  Hier is een 
stap-voor-stap handleiding om The Bin op uw systeem te installeren :

    1) Start een nieuwe Shell
    2) Ga naar de lade waarin The Bin staat, met CD "<disk>:The Bin", waarin
    <disk>: het volumelabel van de disk, b.v. RAM: of iets dergelijks.
    Natuurlijk kan dit net zo goed een pad zijn, zoals DH2:Download/.
    3) Type de volgende regels, gevolgd door <Return> :

    Copy Bin Sys:WBStartup/
    Copy Bin.info Sys:WBStartup/

Als u geen behoefte heeft aan de taal-catalogi (het programma zal standaard
zich in het Engels presenteren), dan is de installatie nu klaar.  Als u b.v.
het programma in het Nederlands wilt gebruiken, volgt u dan stap 4 en 5 ook
nog even.

    4) Verander van lade naar Locale/Catalogs met CD Locale/Catalogs
    5) Kopieer de talen die u wilt hebben naar uw Locale: assign (meestal ook
    op uw systeemdisk aanwezig), met :

    Copy <taal> all TO Locale:Catalogs/<taal>

    bijvoorbeeld :

    Copy nederlands all TO Locale:Catalogs/Nederlands

Dat is alles !  Vanaf de volgende keer dat u opstart, zal The Bin op uw
scherm staan !  (Zie ook het hoofdstuk over Tooltype startopties, getiteld 
@{"Tooltypes" LINK Tooltypes}.

@ENDNODE

@NODE Tooltypes "Tooltype startopties"

The Bin accepteert een aantal opties, die u kunt aangeven door middel van
Tooltypes.  Deze moeten ingesteld worden voordat u het programma start, vlak
na de installatie is bijvoorbeeld een goed idee.

    Geaccepteerde Tooltypes door The Bin :

        @{"ICONX      " LINK TT_ICONX}
        @{"ICONY      " LINK TT_ICONY}
        @{"ICON       " LINK TT_ICON}
        @{"ICONNAME   " LINK TT_ICONNAME}

        @{"FORCE      " LINK TT_FORCE}
        @{"CX_PRIORITY" LINK TT_PRIORITY}

    Geaccepteerd Tooltype door @{"SmallBin" LINK SmallBin} :

        @{"FORCE      " LINK TT_FORCE}
@ENDNODE

@NODE TT_ICONX "ICONX Tooltype"

Sjabloon    : ICONX/N

Gebruik        : Geeft de X-coördinaat van het Bin AppIcon op het scherm aan.

Voorbeeld    : ICONX=200
@ENDNODE

@NODE TT_ICONY "ICONY Tooltype"

Sjabloon    : ICONY/N

Gebruik        : Geeft de Y-coördinaat van het Bin AppIcon op het scherm aan.

Voorbeeld    : ICONY=50
@ENDNODE

@NODE TT_ICON "ICON Tooltype"

Sjabloon    : ICON

Gebruik        : Geef een ander ikoon voor het AppIcon op het scherm aan.
              Dit kan van pas komen als u het standaardikoon niet mooi vindt,
              maar niet het ikoon van The Bin wilt veranderen.
              U kunt een ikoon ingeven van welk type dan ook (Tool, Project,
              Lade etc.), maar zonder de '.info'-extensie.  Dus als uw ikoon
              Sys:Trashcan.info heet, gebruik dan Sys:Trashcan.

Voorbeeld    : ICON=Work:Rubbish/Icons/NewToilet
@ENDNODE

@NODE TT_ICONNAME "ICONNAME Tooltype"

Sjabloon    : ICONNAME

Gebruik        : Verandert de tekst onder het Bin-ikoon.  Als u bijvoorbeeld
              niet zo gecharmeerd bent van de standaard tekst 'Prullenbak',
              dan kunt u deze met dit Tooltype vervangen door iets anders,
              bijvoorbeeld door de naam van iemand aan wie u een gloeiende
              hekel hebt.

Example        : ICONNAME=Toilet
@ENDNODE

@NODE TT_FORCE "FORCE Tooltype"

Sjabloon    : FORCE/S

Gebruik        : Deze schakelaar geeft u de mogelijkheid om bestanden met
              gezette beschermingsvlaggen toch te verwijderen.  Het kan
              heel vervelend zijn wanneer u bij het verwijderen van een
              directory met heel veel subdirectories erin, tot de ontdekking
              komt, dat de éen of andere klungelprogrammeur alle vlaggen
              heeft gezet, die een bestand tegen verwijderen beschermen, 
              waarop u normaal gesproken ze éen voor éen zou kunnen gaan
              'onbeschermen'...

Voorbeelden    : FORCE=YES
              FORCE=NO


WAARSCHUWING : Bestanden zijn meestal niet zonder reden beschermd tegen 
verwijdering, d.w.z. ze bevatten cruciale informatie voor een bepaald
programma om te kunnen draaien.  Als u verstrooid en vermoeid raakt na een 
lange periode van werken, dan zou u de vlag zelf kunnen zetten, om te
voorkomen dat u een belangrijk bestand niet per ongeluk wist.
Als het uw gewoonte is om de verkeerde dingen per abuis te wissen, gebruik
deze vlag dan NIET !
@ENDNODE

@NODE TT_PRIORITY "CX_PRIORITY Tooltype"

Sjabloon    : CX_PRIORITY/N

Gebruik        : Dit zet de prioriteit van het programma in de commoditylijst.
              In versie 37.22 heeft deze variabele eigenlijk geen zin.  
              Aangezien The Bin geen inputhandlers gebruikt, kan deze vlag
              het beste op 0 blijven staan.

Voorbeeld    : CX_PRIORITY=0
@ENDNODE

@NODE Usage "The Bin gebruiken"
Bestanden of laden verwijderen
==============================

Dit hoofdstuk heeft betrekking tot zowel The Bin als SmallBin ; na een 
correcte installatie werken beiden op identieke wijze.

    Het gebruiken van The Bin is echt heel, heel gemakkelijk.  Na het 
opstarten van het programma kunt u ikonen laten vallen op het Prullenbak 
ikoon (naam en uiterlijk ingesteld door de @{"ICONNAME" LINK TT_ICONNAME} en 
@{"ICON" LINK TT_ICON} tooltypes).
The Bin zal een requester tonen met al de geselecteerde laden en bestanden 
(diskettes worden (nog) niet ondersteund) in een groot listview-achtig gadget 
met een scrollbalk.  Om alle namen te bekijken, beweegt u de scrollbalk en de 
lijst zal soepeltjes meebewegen.

Onderin zitten twee gadgets, Verwijder en Annuleer.  Wanneer u op Verwijder 
klikt, zal The Bin aan het werk gaan en alle bestanden zullen worden 
verwijderd van de disk.  Afhankelijk van de toestand van het @{"FORCE" LINK TT_FORCE} 
tooltype, zullen beveiligde bestanden ook worden verwijderd.
Als u Cancel kiest of het window afsluit, zal er niets gebeuren en The Bin 
zal weer terugkeren naar de 'slaapstand'.  Uw bestanden zullen niet worden 
aangetast en de ikonen blijven geselecteerd.


The Bin uit het geheugen verwijderen
====================================

Dit gedeelte slaat alleen op het Bin programma, aangezien SmallBin niet 
aanwezig blijft in het geheugen van uw Amiga.

Wanneer u genoeg heeft van The Bin, kunt u hem op drie verschillende manieren 
uit het geheugen verwijderen.  Van die twee zijn er twee eenvoudig en eentje 
is eigenlijk alleen voor noodgevallen, maar kan wel vanuit batchfiles 
gebruikt worden :

    1) Dubbelklikken op het ikoon van The Bin op het Workbench-scherm.  Het 
    programma zal een requester ter bevestiging laten zien.
    2) Door gebruik te maken van het Commodities Exchange programma, kunt u
    'Verwijder' kiezen met The Bin geselecteerd.  Er zal geen requester ver-
    schijnen en The Bin zal zichzelf stilletjes opruimen.
    3) U kunt het programma ook een Ctrl-C onderbreking sturen.  Deze optie
    heb ik er voornamelijk ingestopt als handigheidje tijdens het debuggen, 
    maar het zou nuttig kunnen zijn.  Als u niet weet hoe u een programma een
    break kan sturen, dan heeft u het waarschijnlijk toch niet nodig.
@ENDNODE

@NODE SmallBin "SmallBin documentatie"
Terwijl ik The Bin aan het testen en voltooien was op mijn A1200 met 2 MB 
geheugen, kwam het bij me op dat het best idioot was om het programma de hele 
tijd in het geheugen te hebben, alleen om nu en dan iets te kunnen weggooien.  
Dit probleem werd alleen nog maar nijpender, omdat ik de vervelende gewoonte 
heb om veel te veel dingen resident te laden bij het opstarten, zoals 
bijvoorbeeld het schitterende Toolmanager van Stefan Becker.
Echter, het was ditzelfde Toolmanager dat me op een idee bracht.  Bij gebruik 
van een AppIcon is er een programma nodig, dat op de achtergrond permanent 
aanwezig is om de berichten van het ikoon op te vangen.  Daarom was er met de 
standaard Bin geen mogelijkheid om dit op te lossen en dus moest het 
programma wel aanwezig blijven, als commodity in dit geval.
Maar met Toolmanager draaiende, is dit niet nodig, omdat Toolmanager zelf 
altijd al aanwezig is en dat kan op de berichten wachten en die doorgeven aan 
The Bin, of beter gezegd SmallBin.  Deze laatste kan dan het vuile werk 
opknappen.

De naam SmallBin heeft niets te maken met de eigenlijke grootte van het 
programma ; het verschil is maar een kilobyte of twee en intern zit het 
verschil tussen The Bin en SmallBin hem alleen in de opstartcode, die bij The 
Bin iets groter is.  Daarom biedt SmallBin alle mogelijkheden van The Bin, 
zoals localisatie, de mooie requester (al zeg ik het zelf :) enzovoort.
De naam is SmallBin vanwege het veel kleinere geheugengebruik ten opzichte 
van The Bin.  Er is alleen maar een ikoontje op de Workbench nodig en gaan 
met die banaan !  Zoals u misschien inmiddels al geraden zal hebben, is 
SmallBin alleen maar nuttig als u TM al standaard heeft draaien.  Als u het 
apart zou moeten installeren (is overigens geen gek idee - het is echt 
geweldig), verliest u meer geheugen dan u zou winnen.

Er kleeft nog éen nadeel aan het gebruik van SmallBin t.o.v. The Bin, en dat 
is dat het niet altijd in het geheugen aanwezig is.  Dit mag lijken op een 
open deur intrappen, en eigenlijk is dat het ook, maar wanneer u gebruik 
maakt van diskettes of een erg langzame harde schijf, bent u vermoedelijk 
beter af met The Bin.   Elke keer als u iets wilt verwijderen, ziet u, moet 
Toolmanager het programma in het geheugen laden en als dat op uw 
systeemschijf staat, moet u die in de drive stoppen, en meer van die 
narigheid.  Ook neemt het uiteraard iets meer tijd in beslag dan The Bin, 
maar met de snelle harde schijven van tegenwoordig betwijfel ik of u het 
verschil merkt.

Zie verder : @{"SmallBin Installatie" LINK SmallBin_Install}
@ENDNODE

@NODE SmallBin_Install "SmallBin Installation"
    De installatie van SmallBin is ietsje, maar niet veel, lastiger dan die 
van The Bin.  Een Installer-script is bijgeleverd om het op de eenvoudige 
manier te doen, maar aangezien niet iedereen beschikt over de C= Installer,
is er ook een eenvoudige manier om het met de hand te doen (beschikt u wel
over de Installer, gaat u dan meteen door naar @{"Toolmanager" LINK TM_Install}.

    1) Start een nieuwe Shell
    2) Ga naar de lade waarin The Bin staat, met CD "<disk>:The Bin", waarin
    <disk>: het volumelabel van de disk, b.v. RAM: of iets dergelijks.
    Natuurlijk kan dit net zo goed een pad zijn, zoals DH2:Download/.
    3) Type de volgende regels, gevolgd door <Return> :

    Copy SmallBin <bestemming>:
    Copy SmallBin.info <bestemming>:

Waar <bestemming>: het pad is, waar SmallBin naartoe moet.  Dit kan van alles
zijn, als u maar hetzelfde pad aanhoudt als straks in @{"Toolmanager" LINK TM_Install}.

Als u geen behoefte heeft aan de taal-catalogi (het programma zal standaard
zich in het Engels presenteren), dan is de installatie nu klaar ; gaat u door 
naar de afdeling @{"Toolmanager" LINK TM_Install}.
Als u b.v. het programma in het Nederlands wilt gebruiken, volgt u dan stap 
4 en 5 ook nog even.

    4) Verander van lade naar Locale/Catalogs met CD Locale/Catalogs
    5) Kopieer de talen die u wilt hebben naar uw Locale: assign (meestal ook
    op uw systeemdisk aanwezig), met :

    Copy <taal> all TO Locale:Catalogs/<taal>

    bijvoorbeeld :

    Copy nederlands all TO Locale:Catalogs/Nederlands


Goed, dat was dat.  Gaat u nu door naar het gedeelte over @{"Toolmanager" LINK TM_Install}.
@ENDNODE

@NODE TM_Install "Het installeren van SmallBin in Toolmanager"
Het merendeel van de informatie die u nodig heeft, kan gevonden worden in de 
Toolmanager-documentatie, die meegeleverd wordt met dat pakket.  Aangezien TM 
geen commercieel produkt is en de docs gratis zijn, zie ik niet in waarom u 
het niet zou hebben.
Om SmallBin in Toolmanager te installeren, onderneemt u de volgende stappen :

    1) Maak een Prog object aan.  Noem het voor het gemak 'SmallBin' en
    geef aan waar u het programma naartoe hebt laten kopiëren.  Let er op, 
    dat het een Workbench (WB) programma is, anders zal het NIET werken.
    U hoeft zich geen zorgen te maken over hotkeys, paden en stackgrootte ; 
    de standaardwaarden voldoen prima.
    Belangrijk : controleer of de 'Argumenten'-optie geselecteerd is.  Zo 
    niet, dan werkt SmallBin eveneens niet.

    2) Maak een Plaatje object aan.  Dit kan van alles zijn, zolang 
    Toolmanager het maar kan lezen - van animbrushes tot ikonen met twee
    afbeeldingen.  Niet echt veel in te stellen hier.

    3) Maak een Ikoon object aan.  Geef het een passende naam, een naam die
    voor u 'Afval' betekent, zoals bijvoorbeeld 'MS-DOS' ;-)  Kies dan de
    Prog en Plaatje objecten die u zojuist heeft aangemaakt en geef het
    ikoon tenslotte een plaats.  Beslis of u de naam zichtbaar wilt hebben
    (ik kan me voorstellen dat u geen 'MS-DOS' op uw scherm wilt hebben :)
    en klik op OK.

Bewaar nu uw Toolmanager instellingen en daarna zal u een prullenbak op uw 
scherm hebben.  Om te kijken of het werkt, kunt u een paar onzinbestanden op 
de Ram Disk aanmaken en die op het ikoon laten vallen.
Als alles goed is, zal de bekende The Bin requester op het scherm verschijnen 
en u om bevestiging vragen.  Als dit niet geval is, dan is er iets misgegaan 
en doet u er goed aan om het bovenstaade lijstje nog eens na te kijken, of u 
alles goed hebt gedaan.
@ENDNODE

@NODE Author "Over de auteur"
U kunt de auteur van dit programma, mij met andere woorden, op twee 
verschillende manieren bereiken.  De eerste is via gewone post, u weet wel, 
die bedoening met papier enzo.  De tweede manier, die mijn voorkeur heeft, is 
per elektronische post of email, omdat dit goedkoper, gemakkelijker en 
wellicht sneller is voor ons allebei.

Mijn thuisadres is :

Maarten ter Mors
Hendrik Vinkhof 47
2202 XJ Noordwijk
The Netherlands

Mijn email adres is : maarten.ter.mors@aobh.wlink.nl
En u kunt me ook bereiken op :

FidoNet     2:280/464.6
AmigaNet   39:151/1.6
NLA        14:102/203.6
DAN        55:100/111.6
@ENDNODE

