Directory Opus Legalities

All software and programs and documentatioo provided herein are entirely copyright (l;)1991-1992 by Jonathan Potter, with the following exceptlcns:

I, inovarnusic.library is copyright @>1992by lNOVAtronics, lnc. inovamusic.library was written by Carl W. Moore.

2. And as specified in documentation provided on the distribution disk.

AU rl&h1B are reserved, The programs and documentation aresold "AS IS" and witbout warranties as to performance, mercllantability, or fitncss for a parricular purpose. Sale of Ibissoftware conveys a license for its useon up to two computers owned or operaredonIy by the purchaser. Copying this software or documentation by any means wbatsoever for any otber purpose ja strictly probibited.

"AmIp", "AmJaaDOS", and "Workbench" areregisteredtrademarla of Ccmmodore-Amlga Inc,

"AR.xx" is atrademark of WlshruJThlnklna DevelopmeatCorp,

DIrectory üpw Manual Version 4.0 Cnnlributers Carol Bland Eddie Cbw-cbill Cash Foley Joel Guerra Jonathan Potter

ProJectMan.... r Eddie Cbw-cbill

Manual EdItor Cash Poley

Cover DesIan ScouMartiodale

Directory OpusManual version 4.0 - Producedwith Radical Eye's Amiga1j;X with special thaoIato 1bmasRolricki.

For help, call (214)340-4992 hetweeo the bours of 10:00AM - 3:00PM CST. Inovatronics,Inc.

Suite 209B 10Europe,coniacn 8499GreenvilleAvenue loovatronics GmbH Dallas, Tx 75231-2499 USA Im Heidkamp 11 Office Pbone: 214/340-4991 W-5000 Cologne 91 Tech Support: 214!340-4992 Germany FAX: 214/340-8514 Pbooe: +49-221-875126 BBS: 214/342-1930 FAX: +49-221-8704747 ( Contents

1 A Directory Opus Walk- Through 3 1.1 What Is Direetory Opus? . 3 1.2 Files andDireetories . 4 1.2.1 Files ...... 4 1.2.2 Direetories. . . . 5 1.3 Installing Direetory Opus 6 1.4 Running Direetory Opus . 7 ( 1.4.1 Starting From Workbeneh 8 1.4.2 Starting From a CU . . . 8 1.4.3 Automatie Startup in the startup-sequence. 8 1.5 Introduetion to Using Direetory Opus 10 1.5.1 Aborting ...... 10 1.5.2 Direetory Opus Components . 10 1.5.3 Direetory Windows: 12 1.5.4 Custom Buttons .... 20 1.6 The Tiny Buttons ...... 38 1.7 The Tiny Bottom Right Buttons 41 1.8 Default Menus . . . . . 45 1.8.1 Projeet Menus . 46 1.8.2 Funetion Menu 50

( 2 Requesters & Viewers 55 2.1 Proteetion Requester . 55 2.2 Disk eopy Requester . 59 2.3 Format Requester .. 61 ii CONTENTS

2.4 Install Requester. . 63 2.5 Print dir Requester. 65 2.6 Print Requester. 67 2.7 TextViewer 72 ( 2.8 Hex Viewer .. 75

3 Opus Configuration (ConfigOpus) 77 3.1 Introduction ...... 78 3.2 ConfigOpusMain·Screen .. 79 3.3 ConfigOpusConfigureMenus 80 3.4 BUTTONS/MANAGER . . . 82 3.4.1 ButtonManagerMenus 85 3.5 BUTTONS/EDITOR. 86 3.6 CornrnandEditor.. 87 3.6.1 Edit Fields . . 88 3.6.2 Edit Menu .. 97 3.7 DRIVES/MANAGER 98 3.8 DRIVES/EDITOR . . .100 ( 3.9 FILETYPES/MANAGER .102 3.9.1 Filetypes...... 103 3.9.2 Menus ...... 105 3.9.3 Editing anexistingentry . · 105 3.10 FILETYPES/EDITOR . . . . .105 3.10.1 MouseAction Events .107 3.10.2 CornrnandEvents .107 3.11 FILE CLASS/MANAGER. . .109 3.12 FILE CLASS/EDITOR ... · 111 3.12.1 File ClassEditorCornponents. .113 3.12.2 Editing ...... 115 3.12.3 File ClassEdit Cornrnands. .115 3.12.4 Testingdirectives .. .116 3.12.5 Movernentdirectives .118 3.13 HOTKEYS/MANAGER . .120 3.13.1 Menus .... · 121 3.14 HOTKEYS/EDITOR .. .122 CONTENTS iii

3.15 MENUS/MANAGER ...... 123 3.16 MENUS/EDITOR ...... 126 3.17 OPERATIONS...... 127 ( 3.17.1 OPERATIONS/COPY 129 3.17.2 OPERATIONS/DATEFORMAT 131 3.17.3 OPERATIONS/DELETE 132 3.17.4 OPERATIONS/ERRORCHECK 133 3.17.5 OPERATIONS/GENERAL 134 3.17.6 OPERATIONS/ICONS 136 3.17.7 OPERATIONS/LISTFORMAT 137 3.17.8 OPERATIONS/UPDATE 140 3.18 SCREEN...... 143 3.18.1 SCREEN/ARROWS 144 3.18.2 SCREEN/COLORS...... 145 3.18.3 SCREEN/FONTS...... 146 3.18.4 SCREEN/GENERAL 148 3.18.5 SCREEN/PALETTE...... 149 ( 3.18.6 SCREEN/SCREENMODE ...... 150 3.19 SYSTEM 153 3.19.1 SYSTEM/AMIGADOS 155 3.19.2 SYSTEM/CLOCKS ...... 157 3.19.3 SYSTEM/DIRECTORIES 160 3.19.4 SYSTEM/HOTKEY...... 164 3.19.5 SYSTEM/ICONS ...... 165 3.19.6 SYSTEM/MODULES...... 167 3.19.7 SYSTEM/SHOWPAlTERN .. . . . 168 3.19.8 SYSTEM/STARTUP 169 3.19.9 SYSTEM/VIEW& PLAY ...... 171

4 Commands 175 4.1 SimpleArgumentFunctions ...... 261 4.2 RequesterFunctions...... 263 iv CONTENTS

5 Appendices 265 5.1 CJlossary...... 265 5.2 How we startexternalprograms .267 5.3 Wild CardPatterns...... 5.4 ShortcutKeysfor CustomButtonsandMenus . :;~~( 5.5 SimpleShortcutKeys ...... 272 ( A Note from the Author

I havebeenworkingonDirectoryOpusfor thepastthreeyears.What startedasasimpledirectoryutility (howeverrevolutionaryfor its times)hasgrowninto whatI believeto bethemostconfigurable, functionalandeasy-to-usedirectoryutility availablefor theAmiga and possiblyfor anyothercomputer.

( Much of thiswouldnothavebeenpossiblewithoutthehelpof many people.To list all thepeoplewhohavecontributedin anyway would beimpossible,butherearesomeof them:

Mel Bice,JohnCousins,PeterJackson,AdrianJones,Edward Lawford,MichaelLorant,JayMiner,RossMolden,Michael Portmann,lanRodbourn,lanSteuart,TimStrachan,Andrew Wilson

1 2 CONTENTS

Nor couldDirectoryOpus4 havebeenpossiblewithoutthevaluable andmuchappreciatedeffortsof INOVAtronics,who arelargely responsiblefortheuser-interfaceimprovementsandhundreds,ifnot thousands,ofotherchanges.ToEddieChurchill andeveryoneelseat ( INOVAtronics,to almostall of thebetatesters,andto everyoneelse who hascontributed,thankyou.

Enjoy theprogram!

JonathanPotter

( ( Chapter 1

A Directory Opus Walk-Through

( 1.1 WhatIs Directory Opus?

ThetheorybehindDirectoryOpusis quitesimple.Onthescreenthere aretwo windows.ThesearecalledDirectory Windows. Youcanread adirectoryinto eachof thesefrom anydeviceaccessiblebytheAmiga. Youcanselectfilesand/ordirectoriesin eitherof thesewindows,then manipulatethemalmostanyway youlike. Selectedentries canbe copiedto theoppositewindow,deletedorrenamed;textfiles canbe read,picturefilescanbeviewed,andsoundfilescanbeheard. DirectoryOpusoffersmuchmorethanthese"bare-bones"features,and youwilliearn morelaterin this manual.

(

3 4 CHAPTER 1. A DIRECTORYOPUSWALK-THROUGH 1.2 FilesandDirectories

TheArniga'sDOS (Disk OperatingSystem)dealswith two kindsof data-arrangement:filesanddirectories. (

Eachfile anddirectorymustbegivenauniquename;within a directoryyoucannothavetwo files,two directories,orafile anda directorywith thesamename.

1.2.1 Files

Any datayou recordon adisk is storedin afile. Filescontain information,which maybefrom adatabase,fromaword processor, from a paintingprogram,or theentirecontentsof aprogram.

Thesizeof a file is expressedinbytes,eachbytebeingequivalent ( to onecharacter.Storingthestring"Hello" in afile would usefive bytes,astheword "Hello" is five characterslong.

Whetherafile canbedisplayed,executed,deleted,edited,or consideredasascript file dependsuponattributesthatareexplainedon page55.

All files haveadatestampwhich showswhatthesystemdateand time werethelasttime thefile waswritten to.

Filesmayaisohaveacommentof up to 79charactersattachedto them.

( 1.2. FILES AND DIRECTORIES 5

1.2.2 Directories

To store information in a logical manner,disks are generally organized ( into directories, which areoften referred to asdrawers. If you picture a disk asa filing cabinet, with your programs, databasefiles and pictures asthe actual files, then directories are the drawers of the filing cabinet. Someof thesedrawers have further drawers inside them, called sub-directories,which themselvescan contain drawers, and so on, indefinitely.

The directory or sub-directory containing any given sub-directory is known asits parent directory.

The highest level of organization is the Root Directory. If the directory is a filing cabinet, then the root directory is the room it stands in. (

f = 1I1 ~' ~I Applic~ti ons Oownlo~s OirectOt'o;Opus I 1 Z I. 3 I I I """ 111 dd+ ~I 1"""··'11 Archives ~ ~ Business ArtTooIs Ustill9S LQ

Figure 1.1: Directory Tree Example ( The Directory Tree Example (Figure 1.1) demonstratesa sampie disk structure. 6 CHAPTER 1. A DIREcroRY OPUSWALK-THROUGH

The routeyou takealongadirectory tree to reachafile is calleda path. As youproceedalongthepath,eachbranchof thetreeis separatedfromthenextbranchby a/ character.Forexample,thepath of Archivesis expressedasWork:Downloads/Archives. (

To referto Picture.ARC,youusewhatis calledapathname. This consistsof afile's path,followedby thenameof thefile. Picture.ARC's pathnamewouldbeWork:Downloads/Archi ves/Picture. ARe.

The numberof files andsub-directoriesanygivendirectorycan containis limited only by theamountof spaceonthedisk.

The list belowshowsthecorrectpathto eachof thefilesin thechart.

1. Work:DirectoryOpus

2. Work:Downloads/Listings 3. Work:Downloads/Logfile (

4. Work:Applications/ToDoList 5. Work:DownloadslArchiveslPicture.ARC

6. Work:Applications/Business/BudgetManager 7. Work:Applications/LeePaint

8. Work:ApplicationslDataFiles/lstQuarter

1.3 Installing Directory Opus (

If your computerdoesnothaveaharddrive,youmaywantto run DirectoryOpusfrom thedistributiondisk; otherwiseyouneedto use 1.4. RUNNING DIRECTORY OPUS 7

theinstallationprogram,InstallOpus,whichinsertsDirectoryOpusinto your harddisk'srootdirectory.Itwill modify yourUser Startup Sequence.InstallOpusallowsyouto choosetheapproachbestsuited ( to your levelof expertise.

For thenovice,InstallOpusinsertsDirectoryOpusinto your hard disk'srootdirectoryanddoeseverythingfor you,offeringyou few choices.YoumaychoosetohavetheDirectoryOpusscreendisplayed whenyoufirst bootupyour computer,otherwiseyoumayrun DirectoryOpusfrom theWorkbenchorfrom theCLI.

At a moreambitiouslevel,InstallOpusallowsyouto selectthe directoriesintowhichDirectoryOpusis to beinstalled.

Theexpertusercantakecontrol: InstallOpusallowsyou to define everysinglechoiceavailable,andassumesthatyouknowwhatyou are doing. Youareableto modify yourstartupsequenceto YOUf needs.

( For moreinformation,useInstallOpus'built-in helpsystem.

1.4 Running Directory Opus

Therearethreecommonwaysof runningDirectoryOpus.

• FromWorkbench

• Froma Cl.I • Fromyourstartup-sequence

Eacharedescribedbelow. ( 8 CHAPTER 1. A DlRECTORY OPUSWALK-THROUGH

1.4.1 Starting From Workbench

The easiestway to run Directory Opus is from the Workbench. Double-click on the Directory Opus icon on the Workbench screenand, ( several secondslater, the Directory Opus screenwill appear.

1.4.2 Starting From a CLI

To run Directory Opus from the CU enter:

DOpus:DirectoryOpus

This assumesone of two things. Either you arerunning Directory Opus from a floppy drive containing the Directory Opus diskette, or you have it installed on a hard drive with an assignmentof DOpus: to its location. (The InstallOpus utility can createthe assignmentin your ( startup-sequence).

1.4.3 Automatie Startup in the startup-sequence

The startup-sequenceis a script file that is automatically executedwhen you first turn on the computer. It can contain instructions to do many different things, including running Directory Opus.

Either the InstallOpus utility can modify your startup-sequencefor you, or you can do it yourself. To modify your startup-sequenceyou need a text editor such asCommodore's Ed or MEmax. A highly recommendedcommercial text editor is CygnusEd Professional,by (•. ASDG-Inc. This is the text editor with which Directory Opuswas written, and is a very powerful too1.

Run your text editor, and load your startup-sequenceinto it. The 1.4. RUNNING DIRECTORY OPUS 9

startup-sequenceresidesin the S: directory of your boot disk. Pick a convenient place to put the new instruction. A good place would be the line immediately before the EndCLI instruction (at the end), but you ( can really put it anywhere. Add the line:

Assign DOpus: DHO:Tools/DOpus DOpus:DirectoryOpus -i

This assurnesyou have instaIled DirectoryOpus in a directory caIled DHO:Tools/DOpus. Of course you needto use the actual directory path.

The - i at the end of the instruction teIls Directory Opus to start up iconified, which meansthat the program will open only a little window on the Workbench screen,insteadof its own custom screen,and will sit unobtrusively in the background until needed. From the Workbench, you can add a ToolType of ICONSTART=lto the Directory Opus icon, ( for the sameeffect. If you do not want Directory Opus to start up iconified, simply remove the -i.

The more technicaIly inclined may notice that there is no RUNonthe instruction line. This is becauseDirectory Opus detachesitself, freeing up the CU and allowing it to continue with the startup-sequence(and ultimately closing).

Make sureyou savethe startup-sequenceoneeyou have modified it. If your ehangesmake sense,Direetory Opuswill be run automatieaIly when you boot up.

There is anotherftag you eanusewhen you run Direetory Opus. The -c ftag teIls Direetory Opuswhere to load the eonfiguration file from. For instanee,-cDHl : stuff / directoryopus. cfg would load ( (and subsequentlysave)the eonfiguration file from DH1:stuff/direetoryopus.efg. From Workbeneh, a ToolType of CONFIGFILE=DH1:stuff /directoryopus. cfg would have the same effeet. By default, it will look in DOpus:Modules. 10 CHAP'TER 1. A DIRECfORY OPUS WALK-TIIROUGH 1.5 Introduction to UsingDirectory Opus

This sectiongivesyou ashorttour of DirectoryOpus.It describes Directory Opusin its defaultconfiguration.Thevariousconfiguration ( optionswill bedescribedina laterchapter.

1.5.1 Aborting

Beforeusingtheprogram,it is importantto know howto abortan action.Most functionscanbeabortedoncetheyhavebegun,andthis canbe usefulif you accidentallystartdeletingthecontentsofyourhard drive.

To abort,presstheleft andtheright mousebuttonssimultaneously. This will only takeeffectif theDirectoryOpusscreenis active (i.e.,it is atthefront of thedisplay). ( Do not bealarmedif theactiondoesnotabortimmediately;some functionssuchascopy, will haveto finishthefile theyareworking uponbeforeaborting.

1.5.2 Directory Opus Components

Let's startwith abrief descriptionof themaincomponentsofthe DirectoryOpusDisplay. Title Bar TheTitle Bar is atthevery top of theDirectoryOpus display.It is usedto displayvariousstatusorerrormessages.If youareunsurewhatDirectoryOpusis doing,it is agoodideato look in thetitle barfor a hint. Thetitle bar is alsousedto ( repositiontheDirectoryOpusscreen. Clock/Memory Bar TheClock/MemoryBar is atthebottomof theDirectoryOpusdisplay.It displayscurrentmemoryandtime 1.5. INTRODUcrrON TO USINGDIRECTORYOPUS 11

(

Custom Buttons

ClockIMemory Bar

Figure 1.2:

information.

( Directory Windows A directory window allows you to display the files and sub-directoriescontained in a directory. You can select (and deselect)files and sub-directories. Directory Opus has two directory windows. The Directory Windows aredescribed in greaterdetail below.

Custom Buttons The Custom buttons perform actions which usually trigger an operation on the selectedfiles in the active directory window.

Drive Buttons The Drive buttons read the contentsof a specific directory anddisplay them in the currently active directory window. ( Custom Menus Custom menus,like Custom buttons, perform actions. NOTE: Many parts of the DirectoryOpus Interface use the Right Mouse button for alternative operations. As with DPaint, the 12 CHAPTER1. A DIRECTORYOPUSWALK-TIIROUGH

mousepointermustbepositionedonthetitle barwhentheRight Mousebuttonis clickedfor theMenuTitles to appear.

Tiny Buttons FourTiny buttons(a figureis shownlater)are positionedbetweenthetwo directorywindows,andsix Tiny ( buttonsareplacedontheClock/MemoryBar.

1.5.3 Directory Windows:

Therearetwo Directorywindows. Onewindow is activeat atime. Becausesomeactions,suchascopy,work with selectedfilesin the activeDirectory WindowandusetheinactiveDirectoryWindowasthe destination,theactivewindow is referredto astheSourceWindowand theinactivewindow is referredto astheDestinationWindow.

Selectingthe Active Directory Window

Clicking anywherein awindow with eithermousebuttonwill activatethatwindow. Unlessyouareextremelyprecisein your placementofthepointer,however,clickingwith theleft mousebutton to activateawindow mayleadto your selectinganunwantedentry. This is whenusingtheright mousebuttoncanbeuseful,asselecting entriesis a left mousebuttonfunction,but clicking with theright mousebuttoncanneverhavethateffect.

Pressingthespacebaractivatestheinactivedirectorywindow.This allowsyou to togglebetweentheactiveandinactivewindows.

Figure1.3showsthemaincomponentsoftheDirectoryWindow. 1.5. INTRODUCI10NTOUSINGDlRECIORY OPUS 13

(

Figure1.3: Directory Window

DirectoryWindowcomponents:

( • DirectoryField • DiskName • WindowArea • WindowView Sliders • NextandPreviousBufferbuttons

Directory Field ManyDirectoryOpusfunctionsrequirethatyou reada directory into theactiveDirectoryWindow.To readanydirectory,enterthe ( nameinto theDirectoryField.

Whenyouclick in a directoryfield it will be activated,andacursor will appear.PressingtheReturnkeywill activatetheDirectoryField 14 CHAP1BR1. A DIRECTORYOPUSWALK-TIiROUGH for theActive DirectoryWindow. OncetheField is activated,enterthe nameof thedirectoryyouwant.

Thereareseveraleditingfeaturesyoucanuse: (

BackspaceDeletesthecharactertotheleft of thecursor Delete Deletesthecharacterunderthecursor

Cursorkey Movesthecursoronespaceinthedirectionof thearrow Cursorkey + Shift .Movesthecursorto thebeginningor endof thestring Right Amiga + x key This is knownasAmiga-X Erasestheentire string

Right Amiga + q key This is knownasAmlga-X Restoresthe contentsof afield to thepreviousinformation.

Onceyou haveenteredthepathnameyouwish to read,pressreturn. Youwill seethedirectorywindow activate(if it is notalreadyactive), andthe directorywill read.

DiskName

The Disk Nameareaof theDirectoryWindowshowstheDisk or VolumeNamefor thecurrentlydisplayedDirectory.This areaalso displaystheamountof freespaceonthedirectory'svolume. ( 1.5. INTRODUCI10N 1'0USINGDIRECTORYOPUS 15

Window Area TheWindowAreaof theDirectoryWindow displaysthedirectory's c files andsub-directories. SeIectingFiles To selectanentry,file or sub-directory,clickon it with theleft mousebutton.If you hold downtheleft mousebuttonandmovethe mouseupor down,all entriespassedoverwill behighlighted.This is calleddrag-selectlng.Figure1.4demonstratesselectedfilesand directories. Uns@l@ct@d Dlr@ctorl@s S@l@ct@d Dlr@ctori@s c Uns@l@ct@d Fll@s S@l@chd nIes

Figure1.4: DirectoryWindow with SelectedFilesandSubDirectories

Figure1.5demonstratesstatisticswhich appearin theTitle Bar c whenyou areselectingfiles. Whenyou click on anentrywhich is alreadyselected,itwill deselectit. By drag-selectingwhenyou click on a selectedentry, already-selectedentriesthatarepassedoverwill bedeselected. 16 CHAPTER1. A DIRECTORYOPUSWALK-THROUGH

(

HUKber 01 Selected Directories HUKber 01 Selected files Total HUKber of Bytes Selected

Figure 1.5: StatusBar when selecting Files

Entering Sub-Dlrectorles ( Many directories that you read in will contain sub-directories. Instead of having to type in the name of a sub-directory, you needonly to double-click on it. This will load the sub-directory into the same Directory Window.

Opening the sub-directory in the other directory window allows you to copy files between the sub-directory and its parent. To do this, you perform a Click Move Click (Click-M-Click) with the left mouse button. Click-M-Click meansto click first on a sub-directory entry then to move the mouse pointer to the other (inactive) window and click again. This can be tricky becausethe two clicks must occur within the Amiga Configured Double-Click Time (seeAmiga Input Preferences).

An alternative method to Click-M-Click (which requireslessmouse ( pointer gymnastics), is to dick and hold on an unselectedsub-directory entry with the left mousebutton. Then, without releasing the left mousebutton, pressand releasethe right mousebutton. Without 1.5. INTRODUCTION TO USINGDIRECTORYOPUS 17

releasingtheleft mousebutton,movethemousepointerto theinactive window. As you movethemousepointer,acopyof theselected sub-directorywill follow themouse.Whenyoupositionthemouse ( pointerovertheinactivewindow,releasethemousebutton;the sub-directorywill nowbereadinto theinactivewindow,which now will becometheactiveDirectoryWindow.

A final alternative(whichrequireslessmousebuttongymnastics), is to dick andholdonanunselectedsub-directoryentrywith theleft mousebutton.Then,without releasingtheleft mousebutton,movethe mousepointerto theunselectedDirectoryWindow.Thetrick to this methodis to movethemousepointerhorizontallywithout movingup or down(thisis for thesurehandedmousegymnast).Shouldyou inadvertentlymovethemousepointeroveranentryaboveor belowthe selectedsub-directory,itwill not follow themousepointerto theother window. Whenyoudo it correctly,a copyof theselectedsub-directory will follow themousepointeroverto theinactivewindow andwill be readwhenyoureleasethemousepointer.

Moving to a Parent Directory

If thedirectorydisplayedin a DirectoryWindowis asub-directory, youmaywish to returnto its ParentDirectory.Youcouldreturnto the ParentDirectoryby editingtheDirectoryField textdirectly,but the procedureiscumbersomeanderror-prone;therearebetterways.

• ThedefaultconfigurationincludesaCustomButtonwhich returnsyouto theParentDirectory.

• EachDirectoryWindowcontainsahiddenParentbuttonon the ( outeredgeof thewindow areawhichwill moveyou to theParent Directory.Ontheleft DirectoryWindow,it is thewhite border onthefar left. Ontheright Directorywindow,it is theblack borderonthefar right. Whenyoudick theleft mousebuttonon 18 CHAPTER1. A DIRECTORYOPUSWALK-THROUGH

a hidden Parentbutton, Direetory Opus will display the direetory's parent, if it hasone. When you cliek the right mouse button on the hidden Parentbutton, Direetory Opus will display the Root direetory. (

Window View Sliders

Onee the direetory hasbeen read in, it is displayed in the direetory window. There is limited spaeeon the sereen,however, so the whole direetory may not be visible at onee. A pair of Sliders extendsyour view of the window. In the center of the two direetory windows aretwo vertieal Window View Sliders. You ean slide theseup and down, to seroll through the contentsof the direetory.

• To slide the vertical window view sliders, pressthe left mouse button on the blaek bar and,while holding down the mouse ( button, move the mouseup and down.

• Click above or below the solid bar for the slider to move one page in that direction.

• At the bottom of the two vertical Window View Sliders are arrow buttons. Thesewill move the slider one line in either direetion when elieked upon.

• Click and hold the left mousebutton on one of the arrow buttons for the direetory to scroll thraugh the window.

• Presseither the up or down cursor keys to move one line in that direction. These too will scroll when held down. ( • Pressthe up or down cursor keys in eonjunetion with either SHIFT key to move a pagein that direction. 1.5. INTRODUCI10N TO USINGDIRECTORYOPUS 19

• Pressacursorkey in eonjunetionwiththe CTRL key to display thetop or bottomof thedireetory. • Toserollquieklyto thefirst entrystartingwith aparticularletter, ( pressthatletter;thedireetorywill serollaseloseasit eangetto thefirst entry- whetherfile or direetory- startingwith thatletter. • Pressaletterin eonjunetionwitheitherSHIFf key to serollonly to thefirst file beginningwith thatletter.

Whetherornottheentiredireetoryfits in vertieally,it will definitely notfit in horizontally.Thereis moreinformationavailablefor entries thanjust thefilename.Also displayedisthesizein bytes,the proteetionbitsassignedtothatentry,thedatethatentrywaslastwritten to thedisk,andanyeommentthatmaybeassignedtothatentry.

HorizontalWindowView Sliderseanbeseenatthebottomof the direetorywindows,with arrowsattheinnerends.Thesework like the ( VertiealWindowView Sliders,ineludingthekeyboardequivalents. Youeanserollupanddown,andleft andright, by holdingtheright mousebuttonandmovingthemouse.

TheDireetoryWindowsareusuallythesamesize.If youwant to seemoreinformationthanis displayedin thewindowsyoueanstretch thedividerbetweenthemleft or right to resizethem.

Thereis ahiddensizebarbetweenthetwo verticalWindowView Sliders.Whenyoudick andhold thisbutton,thesizebarwill appear. While holdingthemousebutton,movethemouseleft or right. When youhavethewindowasyouwantit, releasethemousebutton.

Therearethreeshorteutkeysfor resizingtheDirectoryWindows: ( • - SlidestheWindowView Slidersto thefar left • \ Slidesthemto thefar right. 20 CHAPTER1. A DIRECTORYOPUSWALK-THROUGH

• = Re-centerstheWindowView Sliders

NextandPreviousBufferbuttons (

DirectoryOpusmaintainsupto 100directoryhuffers for each directorywindow.

• To movebackandforth throughthebuffers,dick oneitherthe PreviousBuffer buttonor theNext Buffer button.TheBuffer will bedisplayedwithoutre-readingthedrive. Thekeyboard equivalentalternativeisto presstheALT key in conjunctionwith theleft or right cursorkey.

• To activatethedirectoryfield, presstheReturnkey.

• To re-readthedirectory,presstheReturnkey twice.

1.5.4 CustomButtons

TherearedefaultCustombuttons,all of which haveleft mousebutton functions.Someof thebuttonsarealsoconfiguredtoperformRight Mousebuttonfunctions.

TheCustombuttonswith right mousebuttonfunctionsare indicatedby a "dog-ear"in theupperright cornerof thebutton.The All Custombutton(Figure1.6)demonstratesthedog-ear.

IMPORTANT: ( Many of theCustombuttonsperformactionsontheselectedfilesin thecurrentdirectorywindow. Beforeclicking on a Custombutton, verify that theintendeddirectorywindowis active.NoviceDirectory 1.5. INTRODUenON TO USINGDIRECTORYOPUS 21

Opus userscanbe confused when they have clicked on a Custom button in an inactive window, and it doesnothing. Of courseyou should verify that the selectedfiles and directories within the directory ( window arethe onesyou wish actedon.

Figure 1.6: Default Custom Buttons

(

( 22 CHAPTER1. A DIRECTORYOPUSWALK-THROUGH

All ( TheAll buttonselectsallentriesin thecurrentlyactivedirectory window.

~ Toggle SelectingAll with theright mousebuttonwill Toggleor reverse thestateof all entries.This causesselectedentriesto be deselectedanddeselectedentriesto beselected.

None TheNonebuttondeselectsallentriesin thecurrentlyactive ( directorywindow.

Parent The Parent buttonreadstheparentdirectoryof thedirectory openin theactivedirectorywindow. If theparentdirectoryis containedin thewindow's Buffer List, it will bedisplayed without re-readingit. Whenthecurrentdirectoryis anassignment,for exampleC:,the assignmentwill beexpanded,andthentheparentfunctionwill moveto theparentdirectoryof theassigneddirectory. ( 1.5. INTRODUCTION TO USING DIRECTORY OPUS 23

Root TheRoot buttonreadstheroot directoryof the activedirectory window.As with theParentfunction,thebuffer list will be ( searchedbeforetheparentdirectoryis re-read. Whenthecurrentdirectoryis a sub-directorytoanassigned directory,theRootfunctionwill displaytheassigneddirectory. Whenthecurrentdirectoryis anassigneddirectory,theRoot functionwill displaytheroot drive of theassigneddirectory.

Copy TheCopybuttoncopiestheselectedfileto thedestination (inactive)directory.If anydirectoriesareselectedtocopy,the sub-directoryFilterwill beusedto determinewhichfileswill be ( copied(thesub-directoryFilteris describedonpage43).

~ CopyAs TheCopyAsfunctionis similar to Copy exceptthattheentries arecopiedto thedestinationdirectoryusingnewnamesthatyou specify.Wildcards canbeusedhere;seetheWildcard discussionintheAppendices.

Move Thisfunctionwill moveall selectedentriesfrom thesource directoryto thedestinationdirectory.Theentrywill no longer existin its originalplace.If anydirectoriesareselectedtomove, thesub-directoryFilterwill beusedto determinewhichfileswill bemoved(thesub-directoryFilteris describedonpage43). 24 CHAPTER 1. A DIRECTORYOPUSWALK-TIIROUGH

(

Figure 1.7: CopyAs Requester

Be careful with this function. Directory Opus will deletethe file if you are moving it to a different device.

~ MoveAs MoveAs allows you to give eachentry a new namebefore it is moved. (

Figure 1.8: Initial RenameRequester ( 1.5. INTRODUCI10N TO USINGDIRECTORYOPUS 25

(

Figure 1.9: SubsequentRenameRequester

Rename Rename allows you to give new namesto all seleetedentries in the aetive direetory window. A requesterwill appearfor eaeh entry in turn, asking for the new name. The initial rename requesterhastwo string fields instead of one. You will usually just edit the name in the lower of the two to the new name. ( A limited type of wildcard renameis possible. Entering a * in the bottom field allows you to add prefixes or suffixes. For instanee,entering *.pie will add a .pie suffix to all seleeted entries. Entering A * will add an Aprefix. Only one * may be usedin this proeess. You eannotgive a file a namethat eontains a *. If you entera * in the top aswell asthe bottom field, you ean replaeeseetionsof the name. For example, entering *.pie in the top Field and *.iff in the bottom Field will replacethe .pie suffix in any entry that hasone with a .iff suffix. If an entry doesnot havea .pie suffix, it will be left untouehed. The * may also be embedded.For instanee,renaming FOO*BAZ asGEE*WIZ would renameFOOBARBAZ asGEEBARWIZ. Again, only one ( * may be usedin eaehof the string Fields.

~ Clone Clone allows you to make a eopy of seleetedentries in the same 26 CHAPTER1. A DIRBCTORYOPUSWALK-THROUGH

directory,butwith differentnames.A requesterwill appearfor eachentry,askingfor thenewname.

(

Delete Deletewill deleteall selectedentriesin theactivedirectory window.

Becarefulwith this,asit is easytowipe outvaluabledataif youarecareless.DirectoryOpus'sdefaultconfiguration bringsup arequesterbeforedeleting.Nevertheless,you shouldalwaysdoublechecktheselectedfilesbefore c1ickingthisbutton.

Makedir Makedir allowsyouto createanewsub-directoryintheactive directorywindow; its nameis limited to 30 characters.A configurationoption,CreateIconsWith Directories,canbeused to createanicon atthesametime. Thenameof thedirectoryis limited to 25 charactersifCreateIconsWith Directoriesis enabled.

Assign Assign allowsyou to createanAmigaDOSassignmenttothe directoryin the activewindow. TheAssignCommandgives moreexamples.(seepage182) 1.5. INfRODUCI10N TO USINGDIRECTORYOPUS 27

(

Figure 1.10: MakeDir Requester

CheckFit The Check Fit button testswhether the seleetedfile will fit on the destination drive. The Sereentitle bar will display the ( number of bytes needed,the available spaee,and the pereentage of the file which will fit on the destination drive.

GetSizes The GetSizes button eausesany seleetedsub-direetories to be seanned.The seanningproeessealeulatesthe total size, in bytes, of a11fileseontainedin the sub-direetory. Oneeseanned,the sub-direetorywill be displayed. If a sub-directory hasbeen previously scanned,it will not be re-scannedwhen you seleetthe GetSizesbutton. SeeClear Sizes below. ( The GetSizesbutton also displays in the statusbar the number of files, directories andbytes that havebeen seleetedout of the total number of files, directories and bytes. If there is enough spaee 28 CHAPTER1. A DIRBCTORYOPUSWALK-THROUGH

for thetotalselectedbyteson thedisk in thedestinationdirectory window,all selectedfileswould fit on thedestinationdiskif they werecopiedandaY will bedisplayedafterthecount.If they won't fit, aN will bedisplayed. ( If you selectanoperationwhichcausesasub-directorytobe scanned(e.g.,COPY,PROTECT,HUNT,etc.),thesizewill be displayedasthoughyouhadperformedaGetSizes.

~ ClearSizes TheClearSizesbuttonwill clearthesizesfor selected directories,butnotfor selectedfiles. If asub-directoryhasbeenscannedalready,pressingtheGet Sizesbuttonwill notwork. It is possiblethatapreviously scanneddirectory'ssizeis nolongeraccurate;anyapplication, includingDirectoryOpus,mighthavechangedthecontentsof thesub-directorysinceit waslastscanned.Tore-scana sub-directory,thesizemustbeclearedwiththeClearSizesbutton.

!... Hunt TheHunt buttonallowsyouto searchallselectedsub-directories for aspecifiedfile or files. A requesterappearsaskingfor the pattern to huntfor. Youcanusefull pattern matehingfor this search. If afile matehingthepatternis found,you areaskedif youwish to enterthedirectorycontainingit, or to continuethesearch.If you electto enterthedirectory,thedirectorywill bereadand thenall matehingentrieswill behighlighted. ( Youcanalsoselectentiredevicestohunt,usingtheDEVICE UST featurethatis describedlater. 1.5. INTRODUCIION TO USINGDlRECfORY OPUS 29

( Okay

Figure1.11:Find File Requester

Search TheSearchbuttonallowsyou to searchthecontentsof all selectedfiles,andthefileswithin selecteddirectories,for a specifiedstring.A requesterappearsaskingfor thestringpattern ( to huntfor. Again,full patternmatehingissupported.

_{j Treat upper and _j Recognise ? as _j Only Match Okay ·1 ( Figure1.12:SearchRequester

If afile containingthestringis found,youareaskedif youwish 30 CHAPTER1. A DlREcroRY OPUSWALK-THROUGH

to readthatfile, or continuethesearch.If youelectto readthe file, it will beloadedinto thetextviewer,andasearchwill automaticallybeinitiatedfor thestringyouwant. Youcanalsoselectentiredevicestosearch,usingtheDEVICE ( UST featurethatis describedlater. If anydirectoriesareselectedtosearch,thesub-directoryFilter will beusedto determinewhichfileswill besearched(the sub-directoryFilteris describedonpage43).

Run TheRun buttonallowsyouto run eachselectedfilein turn, providingthatfile is executable.It is simmilarto double-clicking on thefile's icon,or runningit from theCU arequesterwill appear,askingfor anyarguments(shouldyourequireany).

~ Execute If you selectthisbuttonwith theright mousebutton,thefileswill be"executed"asbatch files. This hasthesameeffectasrunning thebatchfile via IconX (referto AmigaDOSmanual),or executingit from theCLI.

Comment The Commentbuttonallowsyouto addcommentsto all selectedentries,or to editexistingcomments.Themaximum lengthof acommentis79 characters.If anydirectoriesare ( selectedtocomment,thesub-directoryFilterwill beusedto determinewhichfileswill becommented(thesub-directory Filter is describedonpage43). 1.5. INTRODUCI10N TO USINGDIRECTORYOPUS 31

(

Figure 1.13: Comment Requester

You will be prompted for a eomment for eaehseleetedentry. If you wish to attaehthe sameeomment to all entries, you should seleetthe All button.

Datestamp ( The Datestamp button allows you to changethe datestampof the seleetedfiles and direetories in the aetive direetory window. When you seleetdireetories, you are askedwhether you wish the files within them to have their datestampsmodified also.

Figure 1.14: DateStampRequester ( If any direetories areselectedto datestamp,the sub-directory Filter will be usedto determinewhich files will be datestamped (the sub-directory Filter is deseribedon page43). 32 CHAPTER1. A DIRECTORYOPUSWALK-THROUGH

For eaehentry,you arepresentedwitharequester.If youwish thefile to haveits datestampsetto theeurrentdateandtime, simplypressreturn.Otherwise,enterthedateandtime youwant. To setthedatestampofall seleetedentriesyoushouldseleetthe ( All buttonfrom thedatestamprequester. ChooseOkayor pressreturnto setthedatestampsonefile ata time.

Protect TheProtect buttonallowsyouto modify theprotection bits of theseleetedfilesanddireetoriesintheaetivedireetorywindow. Whenyou seleetdireetories,youareaskedwhetheryoualso wish thefileswithin themto beproteeted.Foreaehentry,youare presentedwitharequesterdisplayingtheproteetionbitseurrently setfor thatentry.This is deseribedingreaterdetailin thenext ehapter(seepage56). If anydireetoriesareseleetedtoproteet,thesub-directoryFilter will beusedto determinewhichfiles will beproteeted(the sub-directoryFilteris deseribedonpage43).

Ieon Info Theleon Info buttonbringsuptheDireetoryOpusInfo Requesterforeaehof theseleetedfiles. ( ~ Add Ieon Addleon allowsyou to addieonsto all seleetedentriesin the aetivedireetorywindow. DireetoryOpuswill automatically 1.5. INTRODUCfION TO USINGDIRBCTORYOPUS 33

(

Figure 1.15: Protect Requester

sensewhat type of file it is and add the appropriate icon (drawer, tool or project). Default icons areusedunlessyou have specified ( the name of your own icons within the configuration (described later).

Are Ext This button allows you to extract files from anArchiveFile. Directory Opus comesconfigured for ARC, ZOO, LHARC files. When you dick on this button, the files are extracted from the selectedfiles and copied into the destination window. NOTE: Directory Opus' distribution disks do not include the actual archive programsARC, ZOO, and LHA. Becausethey are ( Shareware,we arenot allowed to distribute them. They are available free on most bulletin boards. 34 CHAPTER1. A DIRECTORYOPUSWALK-THROUGH

Encrypt Haveyou everhadfiles thatyouwantedto encryptsothatonly peoplewho knewthepasswordcouldunderstandthem?This functionallowsyouto dojust that. It will encryptall selected ( files, usingthepasswordthatyouenter,with a complex algorithmthatmostpeoplewill find impossibletowork out. The resultingfiles arenotwritten overtheoriginals,but areinstead written to thedestinationdirectory.Theywill bethesamesizeas theoriginal files,soyou canensureyouhaveenoughroomin the destinationdirectory. To decryptapreviouslyencryptedfile,youshouldenterthesame passwordprecededbyaminussign.Forexample,todecryptfiles you encryptedwith thepasswordFOO,selectthefiles,choose theencryptfunctionandenter-FOOasthepassword.

( Read TheReadbuttonallowsyou to readselectedfiles.Thenameof thefile is displayedatthebottomof thescreen.Youcanusethe sliderandcursorkeysto movethroughthefile. Buttonsalongthe bottommoveup anddownby apage,moveto thetopand bottom,allow youto searchfortext,andprint thefile. Pressing theright mousebuttonor theQ key quitsthethetextviewer.For moreinformation,seetheTextVieweronpage72.

>eJ ANSI Read TheANSI ReadbuttonbringsupthesameReaderasRead exceptthatit handlesthespecialANSI controlsequences. ( 1.5. INTRODUCI10N TO USINGDIRECTORYOPUS 35

Hex Read TheHex Read buttonwill readtheselectedfilesin thesameway asREAD,exceptin hexadecimalformat.This allowsyou to ( view binaryfiles andotherfiles containingnon-textcharacters.

Figure1.16:ExampleHexReaderFormat

Figure1.16showsanexampleof theHexViewersoutput.The first valueis theoffset,displayedin hex. This is thenumberof bytesyouareinto thefile. Thenextfour valuesareeacha four-bytelongword,with theactualASCII representationatthe end.Any non-textcharactersareshownasa . character. (

Show TheShowbuttonis veryversatileindeed.It will displayIFF ILBM picturesandbrushes,animations,Workbenchiconsand fonts. If thefile is anIFF ILBM, it will bedisplayedusinginformation from thefile. DirectoryOpuswill showmostpicturesand brushes,includingoverscan,extrahaltbrite(EHB), HAM (4096 color)pictures,DynamicHiRespicturescreatedbyMacroPaint (from LakeForestLogic), andAGA 8 bit pictures'. (

lOnly whenusingOS3.0andanAGA compatibleAmiga 36 CHAPTER1. A DIRECTORYOPUSWALK-THROUGH

Thefollowing keyseanbeusedwhenviewing apietureor animation.

Tab - CycleColors Cursor Keys - Seroll MousePointer - Seroll Shift Cursor Keys - Serollby Page Ctrl Cursor Keys - Serollto End . - MousePointerOn/Off [ - displayin 4 bit format ] - displayin 8 bit format Escor Right MouseButton - Abort Q or Left MouseButton - Next Space,Help or P - Help andPrintRequester

Thesekeyseanbeusedwhenviewing anAnimation. ( S - StartsandStops N - Next Frame • - Slow Down = - SpeedUp \ - Original Speed Fl • FIO - VariousSpeeds(Flef'astest)

Theshowroutinewill alsodisplayieons.If thefile hasa .info suffix it is assumedtobeanieon. If theieonhasanalternative image,pressreturnto togglebetweenthetwo. To displaya font, you needto entertheaetualfont drawer,and seleettheSizefile (thatis, thefile 8, 12,19,ete.),NOT the.font file. ( 1.5. INTRODUCI10N TO USINGDIRECTORYOPUS 37

Play ThePlay buttonplaystheseleetedfilesassoundfiles. If thefile is an8SVX formatIFF sampledsound(of thetypegeneratedby ( AudioMaster,for instanee),thespeedandotherinformationfrom within thefile will beused.Thisbuttonwill play anyfile, though,andif thefile is not 8SVX, it will assumeaspeedof 10000samples/seeond. Usingtheinovamusie.library,thePlaybuttonalsoplays Star/Sound/Noise/Pro'Iracker,Med,OetaMed,Oetalizer,and Medwith MIDI modules. Eaehfile is playedoneeonly. To abortasoundwhile it is playing,presstheleft andright mousebuttons.

~ Loop Play If youseleetthisbuttonwith theright mousebutton,thesounds areplayedeontinuously(looped).To advaneetothenextsound, ( youmustpresstheleft mousebutton.

Edit TheEdit buttonallowsyouto edit anyseleetedfiles,usingthe texteditor(or word proeessor)specifiedin theeonfiguration. TheCustombuttoneonfigurationisexplainedlater.By default,it is eonfiguredtouseCommodore'sc: ED program.Youwill probablywantto alterthiseonfigurationtouseaneditorof your ownehoosing.

( ~ New File TheNewFile buttonpromptsyoufor a file name. If youseleetthisbuttonwith theright mousebutton,youwill be askedforafilenameto ereateanewfile. 38 CHAPTBR1. A DIRECTORYOPUSWALK-THROUGH

Print ( The Print buttonbringsup a requesterwhichallowsyoufull controlof Print formatting.Formoreinformation,seethePrint File Requesteronpage67.

1.6 TheTiny Buttons

TheDirectoryOpusscreenhasseveralbuttonsthatarenot configurable;theyactivatethemostnecessaryandusefulfunctions,and areincludedsothatthesefunctionsarealwaysavailable,whateveryour configurationsmaybe. If you hadmistakenlyconfiguredDirectory Opussothatnobuttonor menucalledtheconfigurationprogram,you ( would neverbe ableto run theconfigurationprogramto changethis!

ThesebuttonsarecalledtheTiny Buttons, astheyaremuch smallerthantheconfigurablebuttonson thescreen.Fourof themare arrangedinasquareapproximatelyatthecenterof thescreen,six othersarefoundin thebottomright-handcornerof thescreen.Theyall haveone-charactertitles.

B - Buffer list This activatesthebufferlist function. This functiondisplaysalist of all thedirectoriescontainedinDirectoryOpus'internal buffers. Youmaythendouble-dick ononeof thedisplayed bufferssoastojump to thatbuffer immediately,ratherthan ( clicking thearrowsto cyclethroughthebuffersoneby one. ~ Pressingtheright mousebuttonovertheBuffer List buttonwill activatethe Clear Buffers commandwhichclearsfrom memory 1.6. mE TINY BUTTONS 39

Ldt: Show a List of the Buffered Directories Right: rorget all the Buffered Directories ( Left : Bring up the Select Requester Right: :~~ic:s L!~~~:s !~~ents r ii,lliH '-~ Left: Bring up the RRexx Requester Right: Show all Sub-Directories of the Director~ in a Tree forftat

Figure 1.17: The Tiny Center Buttons

the contentsof all buffers except the two that are currently ( displayed.

R - Reseleet This activatesthe reselectfunction. This function will reselectall entries that were selectedbefore the last operation was initiated. The entries arereselectedonly if they still exist, and regardlessof whether the buffer containing them is currently displayed. ~ Pressingthe right mousebutton over the R - Reselect button performs the Rescanfunction on the active directory window.

S• Seleet ( This button activatesthe select function. This allows you to selectfiles and directories in the active directory window using wildcards. All standardwildcards are supported(* ,,? etc..) as well asthe AmigaDOS wildcards #? and ? 40 CHAPTER1. A DlRECI'ORY OPUSWALK-TIiROUGH

(

Figure1.18:Buffer List

}E!1 Pressingtheright mousebuttonovertheFile SelectRequester Buttonwill activatetheGetDevicesfunction(theDEVICE LIST ( function). This functionproducesalist of all devices,volumes andlogically assigneddirectoriesthatexistin thesystem.

A-ARexx This activatestheARexx function,which allowsyouto launch

(

Figure1.19:File SelectRequester 1.7. THE TINY BOITOM RIGHT BUITONS 41

(

Figure1.20:DeviceList

anARexx scriptor executeanARexx commandfromwithin ( DirectoryOpus. ~ Pressingtheright mousebuttonoverthisbuttonwill activatethe dirtreefunction(theDirectoryTreefunction). This function scansallsub-directoriesinthecurrentlydisplayeddirectory,and producesatreestructure.

1.7 The Tiny Bottom Right Buttons

Thesebuttonsareoptional;if you don't wantthemyou canmake themdisappearbyde-selectingtheBottorn-RightTiny buttonsflag on theConfigiScreen/Generalconfigurationscreen. ( ?- Help Thisbuttonactivatesthehelpfunction. Providedahelp file has beenloaded,selectinganybuttonor menuafterenablingthehelp 42 CHAPTER1. A DIRBCTORYOPUSWALK-THROUGH

(

Figure1.21:DirectoryTree

modeshouldresultin theappearanceofsomehelpfultext. Note: Thehighlightedquestionmarkindicatesthehelpmodeis active.

E . Error help This activatestheerrorhelpfunction,which givesyoumore

RMigaDOS Help Mode Start Configuration PrograM r1 CS Startup Help SysteM ?IIIrlcllfttfi Quit Opus ( Sub-Directory Filter Iconify Opus

Figure1.22:TheTiny BottomRight Buttons 1.7. THB TINY BOTTOM RIGHT BUTTONS 43

(

Figure 1.23: Help Example

information about DOS error codesthan is generally available.

(

Figure 1.24: Error Help Example

F- Sub-Directory Filter This Button activatesthe sub-directory Filter. When you dick on this button, a requesterwill askyou to enter a file filter. The filter can contain a file specification containing wildcard characters. When you dick Okay or pressreturn, the requesterwill disappear andthe F button will be highlighted. This indicates the filter is ( activated. When the filter is activated, any command which processesthe files in selectedsub-directories will only act on files which match the filter. Thesecommandsare: 44 CHAPTER1. A DIRECTORYOPUSWALK-1HROUGH

• Copy • CopyAs • Move ( • MoveAs • Hunt • Search • Protect • DateStamp • Comment

If the F button is highlighted, you can turn off the filter by clicking on it again. It will become un-highlighted.

C - Configure This activates the configure function, andwill either load into memory or invoke the configuration program.

1- Iconify This button activatesthe iconify function. It closesthe Directory Opus screen,de-allocatesasmuch memory aspossible, and then opensa small window on the Workbench screen. This allows you to haveDirectory Opusconstantly available, while using the minimum amount of memory possible.

Q - Quit This activates the quit function, which allows you to exit Directory Opus (providing there is not a print operation under ( way). If the configuration hasbeenmodified and not saved,you are askedif you wish to saveit first. 1.8. DEFAULT MENUS 45

(

Figure1.25:Quit Requester

1.8 Default Menus

DirectoryOpushas100user-definablemenus.TheFunctions chapterexplainsmoreaboutthemenus,andtheFunction Editor chapterexplainshowto configurethem.This chaptersimplygivesa brief descriptionoftheDefault Menus. All themenuscanbechanged, but theyareconfiguredinitially for certainfunctions. ( I' Fund Ion Current dir Help! Error help Configure ßbout Tech Support Version Iconify Button Iconify Quit

( Figure1.26:Main ScreenProjectMenu 46 CHAPTBR1. A DIRECTORYOPUSWALK-THROUGH

1.8.1 ProjectMenus

IProject/SetdateI ( This functionallowsyouto setthesystemtime anddate, especiallyif youdonothaveabattery-backedclock.After youhaveset thetime, theAmiga clock keepsrunningto provideanaccurate timekeeper.All files or directoriescreatedwill haveadatestampofthe currentsystemtime.TheDateStampcommandofDirectoryOpus usesthesystemtime.

1\vo requesterswillappear;thefirst containingthecurrentdate,and thesecondcontainingthecurrenttime. To changeeitherthedateor the time,deleteandenteranewone.Thedateis expectedtobeenteredin theform DD-MMM-YY. For example,22-Sep-89.Timeis expectedin theform HH:MM:SS,asin 18:30:43.Youmustincludethedashesand colonsasdemonstratedabove. (

IProject/Currentdir I This functionallowsyouto setthecurrentworkingdirectoryfor DirectoryOpus.Thecurrent directory is thedirectoryloadedwhen you activateeitherdirectoryfield, deletetheexistingpathname(ifthere is one),andpressreturnon ablankstring.

A requesterwill appear,containingthepathnameoftheactive directorywindow. If this is acceptableasthenewcurrentdirectory, pressreturn.Otherwise,editit to readasyouwish.

IProject/Help!I ( Provideda helpfile hasbeenloadedin, selectinganybutton/menu afterenablinghelpmodewith this menushouldresultin the 1.8. DEFAULT MENUS 47

(

Figure 1.27: ChangeCurrent Dir Requester

appearanceof some helpful text.

Help can be readfrom any file, although the default is S:DirectoryOpus.HLP. The file name canbe changedwith the Helpfile configuration option, describedlater.

The Help File Chapterdescribesthe help file in detail, and explains ( how you can edit it to addhelp for your own buttons and menus.

IProject/Error help I

Error help gives you information about DOS error codes. When you select this option, you are askedfor which DOS error code number you want help. Examplesof DOS error codesare 123,205 and 225. You are then presentedwith a description of that error, and information pertaining to the possiblecauseand cure of the error.

Error help is alsostored in the help file (seeabove); if the help file hasnot beenloaded,error help will not be available. Seethe help file chapterfor more information. ( IProject/Configure I

Directory Opus usesaseparateprogram to modify the 48 CHAPTER1. A DIRECTORYOPUSWALK-THROUGH

configuration. This savesabout 127K of memory, as the configuration program need only be in memory when it is being used.

If you do have plenty of memory, Directory Opus canbe configured (.. to load the configuration program on start-up. In this case,it is run • from memory eachtime the configure function is invoked, rather than loaded from disk. This can be much faster,especially if you havea ftoppy-based system.

Seethe configuration program chapterfor more detailed information.

I Project/About I

This function displays some information about the program.

IProject/Tech Support I

This menu displays information about getting Technical Support. PIeaserefer to the requesterbefore contacting INOVAtronics asthere are specific times and methodsfor getting Technical Support.

I Project/Version I

This menu displays the current version of Kickstart, Workbench and Directory Opus. This information will be necessarywhen getting Technical Support.

I Project/Iconify I ( This function closesthe Directory Opuswindow and screen, de-allocatesasmuch memory aspossible, and then opensa small window on the Workbench screen. This is known asiconifying, and 1.8. DEFAULT MENUS 49

allows you to haveDirectory Opus constantly available, while using the least amount of memory.

( The iconfied window may contain a clock, or may not be visible at all, depending on how you have setthe Iconify type configuration option (describedlater).

To determine the initial position of the iconified window (especially if you plan to start up Directory Opus in the iconified state), you should iconify Directory Opus,and position the window asyou would like it to appear.That done,re-enter Directory Opus, and savethe configuration (described later).

When iconified, you can drop Workbench Icons on the Directory Opus window. This will have the sameeffect asif you displayed the file in a Directory Opuswindow anddouble-click on it. For Example, if you drop a picture on the window, it will show it.

( To re-enter Directory Opus, click the left mousebutton in the iconified window, then pressthe right mousebutton. If you wish to quit Directory Opus without going back into it, elick the elosebutton at the far left of the iconified window.

Note that if you have the configuration option Iconify Type set to Hidden, the only way to re-enter Directory Opus is with the hotkeys. These default to CfRL-SHIFT-ALT (the CfRL key, the left SHIFT key and the left ALT key simultaneously), although this may be changedin the configuration (explained later).

I Project/Button Iconify I

( This causesa specialvariation of Directory Opus iconification. Normally iconification is setup by the ConfigOpus/System/Clocks screen,but with this command you can iconify Directory Opus into a bank of buttons on Workbench. In this mode Directory Opus allows 50 CHAPTER 1. A DIRECfORY OPUS WALK- THR0UGH youto do almostall, if not all it normallydoes.For instance,if you selecttheCopybuttonarequesterwill openaskingyou to select somethingtocopyfollowedby anotheraskingwhereto copyit. You canalsousethebankof buttonsasanAppWindowwhenrunningin { OS2.0.To showa picture,youwould simplydragtheiconof the " pictureontotheShowbutton.

Thesliderto theright of thebuttonbankallowsyou choosewhich buttonbankis shown.

To uniconify backto DirectoryOpus,presstheUniconify button abovethesliderto theright of thebank,or selecttheClosebuttonof thewindow. Theclosebuttonwill askyouif youwish to quit Directory Opusor uniconify it.

IProject/Quit I This functionwill exit DirectoryOpus(providingthereis not a print operationhappeningatthetime). If theconfigurationhasbeen modifiedandnot saved,youareaskedif youwantto saveit first.

1.8.2 Function Menu

TheFunctionMenucontainsmiscellaneousdiskoperations,and Archive adding.

IFunctioniDisk copyI

This functionbringsuparequesterwhichallowsyouto makean exactcopyof onedisk on another.Formoreinformation,seethe DiskCopyRequesteronpage59. 1.8. DEFAULT MENUS 51

(

Figure 1.28: Main ScreenFunction Menu

IFunction/Format I ( This allows you to format a new disk, All new disks need to be formatted before the computer can write files to them.

For more information, seethe Format Requesteron page 61.

When this is selected,a requesterwith severalbuttons appears. Drives DFO: through DF3: are available. Separatenamesmay be specified for eachdisk,

Verify allows you to turn Verify on or off. As with Functlon/Dlsk Copy, the processis faster with Verify turned off, but you won't be madeawareof any errors, so it's better to leave Verify turned on if you don't completely trust your disks.

( If Quick is selected,the disk will just be initialized (wiped). This provides an extremely fast way to erasean old disk, This will not work on new disks, however; only on disks that have previously been formatted. 52 CHAPTER 1. A DIRECfORY OPUSWALK-THROUGH

If No Icons is selected,the Disk.info, Trashcan.info andTrashcan directory will not be createdon the disk,

I Function!Installl (

This function brings up a requesterthat allows you to make a disk bootable. To be bootable, disks must have special information written on their first sector. For more information, seethe Install Requesteron page 63.

IFunction!RelabeI I

This function allows you to changethe name (label) of the disk that is open in the active directory window.

(

Figure 1.29: Relabel Requester

I Function!Print dir I

This function allows you to print the directory in the active directory window. You are able to choosethe information you want to print (file sizes,protection bits, datesand comments). This function is ( not started asaseparate process,unlike the print command. For more information, seethe Print Dir Requesteron page65. 1.8. DEFAULT MENUS 53

I FunetionlDisk info I

This function displays some information about the disk the active ( directory resideson, including spaceused,spacefree, datestampand number of errors on the disk.

Device DF8: NaMe Workbench2.1 Size 988896 bytes; 1758 blocks; 879K Used 811888 bytes; 1584 blocks; 792K Free 89888 bytesi 174 blocks; 87K Percent 98.1% f uII i !1. 9% fr ee Density 512 bytes/Dlock Errors 8 S.tatus Write protected Date 84-Jan-92 16:84:88 (

Figure 1.30: Disk Info Requester

IFunetion/LHA Add, Are Add, Zoo Add I

Thesefunctions allows you to createand add files to archives, using the popular archivers ARC, ZOO and LHA or LHARC (and up to three others; seethe Functions section of chapter 7 for more information).

To add files to an archive, select the files you wish to add, and select this function. You will be askedfor the nameof the archive to createor ( add to. You should have the destination directory open in the inactive window. 54 CHAPTER1. A DIRECTORYOPUSWALK-THROUGH

( ( Chapter 2

Requesters& Viewers

This chapterpresentsthemorecomplicatedrequestersandviewers. Eachof theseisassociatedwithDirectoryOpusCommandswhichare activatedbyCustomButtonsandMenus.

2.1 ProtectionRequester

TheProtectionRequester(seeFigure2.1)allowsyouto changeafile's or a sub-directory'sprotectionbits.

Theprotectionbitsareagroupof ftagsthatarestoredwith thefile, thatdeterminethecharacteristicsofthefile. Theseftagsaregivenone characternames.Theprotectionbitscurrentlyin useareHSPARWED.

(H- Hidden. If thisftagis set,thefile is not normallydisplayed. This allowsyouto markcertainfiles as"invisible", to avoid clutteringyourdirectories.Thefile canstill beaccessednormally, andnot all programsimplementthisftag.

55 56 CHAPTER2. REQUESTERS& VIEWERS

(

Figure2.1: ProtectionRequester

S- Script. A scriptfile is afile containingalist of ArnigaDOS commandstoexecute;it is like asimplecomputerprogram.This ftagindicatesthatthefile in questionisascriptfile. A scriptfile is sometimescalledabatchfile.

P- Pure. If a programfile is ftaggedaspure,it canbemadeto remainin memory,evenwhennot in use.This cansaveagreat dealof time, especiallyif theprogramis usedalot, asit doesnot haveto beloadedfrom diskeachtime.

A -Archive. This ftagindicatesthatthefile hasnotbeenchanged. If thisfile is everwritten to, theA ftagwill beturnedoff. This can beusedin aharddiskbackupprogram,to recordwhich fileshave beenbacked-up,andneednotbebacked-upagain.

R- Readable.If thisftagis set,thefile canbeaccessed.

W- Writeable.If this ftagis set,thefile canbewritten to (ie, more ( informationcanbe storedin it thanis alreadythere). 2.1. PROTECrION REQUESTER 57

E- Executeable.If a program file doesnot have this flag set, it can not be run.

D- Deleteable.If this flag is not set, the file can not be deleted. (

While AmigaDOS and other programs do not fu11ysupport a11of thesebits, DirectoryOpus gives you accessto a11documented protection bits. As AmigaDOS is enhanced,somebits, such as Writable, will becomemore useful. If you have additional questions about the usageof the bits, refer to your Amiga Documention.

There is a button for eachprotection bit along the left edgeof the requester.Clicking on eachof thesewill toggle a checkmark on and off within the button. When the checkmark is on, it meansthat the bit will be setwhen you click the Okay button.

In the middle of the requesterarefour buttons which manipulate ( multiple protection bits at a time. Thesebuttons do not causeany action to take placewithin the selectedfiles; they simply changethe stateof the protection bit buttons.

All bits Setsa11protectionbit buttons.

None Causesa11protectionbit buttons to be cleared.

Toggle ( Setsa11clearprotection bit buttons, and clears a11setprotection bit buttons. 58 CHAPTER2. REQUESTERS& VIEWERS

I_I Revert Restoresthe protection bit buttons to the settings they had when you enteredthis requester. ( On the right side of the requesterare three groups of protection bits: Old, New, and Mask. Each group contains a protection bit letter or a '-' (dash) for eachbit. The letter indicates that the associatedprotection bit is set, a dash indicates that it is clear.

The Old group indicates the original bits when you enteredthe requester.The New indicates the current statusof the protection bit buttons. Whenever you click the protection bit button, it will be refiected in this group.

Unlike the previously described Old and New groups, the Mask group bits can be changedby clicking on the associatedletter or dash. The Mask group allows you to specify protection bits which should not C·. be modified, regardlessof the protection bit buttons. When the Letter is shown, the bit will not be modified. The dashmeansthat you needto setthe bit according to the setting of the protection bit button. This is most useful when changing files within a sub-directory or using the All button (described below). For example: you want to setthe Archive bit in all files contained in a sub-directory, but you don't want to affect any of the other protection bits. Set the Archive Protection button on the left side of the requesterand set all the Archive bits in the Mask group except A. This will preserveall the file's bits with the exception of the Archive bit, which will be set.

Along the bottom of the requesterare three buttons:

Okay ( Causesthe current file (shown in the screentitle bar) to be set as indicated in the protection bit buttons (and possibly filtered according to the Mask Group). 2.2. DISK COPYREQUESTER 59

All Causesall selectedfilesto beset,without additionalprompting, asindicatedin theprotectionbit buttons(andpossiblyfiltered ( accordingtotheMaskGroup).

Cancel AbortstheProtectionfunction.

2.2 Disk copy Requester

This functionallowsyouto makeanexactcopyof onedisk on another.Whenthisfunctionis invoked,arequesterwithseveral buttonsappears. ( From ... This list containsthepossiblediskdrivesthatmaybeusedasthe source.Whenyoudick on one,it becomestheselecteddrive.

To... This list containsthepossibledestinationdriveswhich are compatiblewiththeselectedsourcedrive.Thesourcediskdrive is alwaysavailableasadestinationto allow youto makesingle drivecopies.Thisonly makessensewithremovablemediasuch asfloppy drivesasit would accomplishnothingto copyahard driveto itself.

( [lI Verify Thisbuttonallowsyouto turnoff theintegrityverificationwhen writing datato thedestinationdrive.Althoughit is faster,you probablywon't wantto dothis. 60 CHAPTER2. REQUESTERS& VIEWERS

(

(

Figure 2.2: DiskCopy Requester

1] BumpName This button allows you to changethe volume name using the samenaming convention asWorkBench's DiskCopy. (See AmigaDOS documentation for details.)

This function will not copy any protected software, or non-AmigaDOS format disks.

Selecting the DiskCopy button will start the copy. The Exlt button ( will abort without attempting a DiskCopy. 2.3. FORMAT REQUESTER 61 2.3 Format Requester

This allows you to format a new disk. All new disks need to be ( formatted before the computer can write to them.

(

Figure 2.3: Format Requester

When this is selected,a requesterwith severalbuttons appears. On the left side is a list containing the deviceswhich can be formatted using this operation. ( tID Warning! This option will destroy existing data on a disk, Be sureyou want to erasethe databefore you click Format or • Quick Format buttons. 62 CHAPTER2. REQUESTERS& VIEWERS

Thelist ontheleft sideof therequestercontainsthedeviceswhich you canformat. Theselecteddeviceis highlighted.Be surethe deviceyou intend to fonnat is the onethat is highlighted!

L:J Name This field allowsyou to givethedrive to beformattedavolume name.

[l] FastFile System This allowsyou to formatadeviceusingtheFastFile System optionof AmigaDOS.YoushouldconsultAmigaDOS documentationformoredetail. This optiondoesnotwork on fioppiesprior to OS2.0.

[l] InternationalModel This allowsfile anddirectorynamestoincludeaccented characters.

[l] DirectoryCachlng- Directorycachingmodewill decreasethecapacityof your disk but thedirectoryreadingspeedwill bemuchgreater.

[t] Put Trashcan This buttonallowsyou to put atrashcanintheroot directoryof thenewly formatteddevice.

lavailable in OS2.1andlater 2availablein OS3.0 2.4. INSTALL REQUESTER 63

11] Verffy This button allows you to disable the format verifieation. As with Function/Dlsk Copy, the proeessis faster with Verify turned off, but you won't be made aware of any errors, so it's ( better to leave Verify turned on unlessyou eompletely trust your disks (you really shouldn't).

Format This button begins the formating proeess. Be very eareful you have seleetedthe eorreetdevice. Onee a Format begins, it eanbe aborted,but datawill be lost!

Quick Format When this button is seleeted,the disk will just be initialized (wiped). This provides an extremely fast way to erasean old disk. This will not work on new disks, however; only on disks ( that have previously been formatted.

Exit This button will abort without attempting a Format.

2.4 Install Requester

This funetion allows you to make a disk bootable. To be bootable, disks must have specialinformation written on their first seetor.

( ~~::~I The list on the left eontainsthe possible devieeson whieh you

• 1\ can install a boot seetor. Seleetthe deviee you want to install on. 64 CHAPTER2. REQUESTERS& VIEWERS

(

( Figure2.4: Install Requester

Whenyou selectadevice(or insertanewdisk in thedevice), DirectoryOpuswill examinethebootsectorandinform youof the disk's currentstatus.It doesthisautomaticallywhenyoufirst bring up theInstall Requester.It will tell you oneof thefollowing:

No Disk Present This simplymeansthatyouhaven'tinsertedadiskin thedrive yet. Whenyoudoso,it will updatethisstatusmessage.

Nonnall.3 OFS bootblock This meansthediskwasintalledwith the old file systemusedbeforeversion2.0of AmigaDOS. ( Normal 2.0+FFS bootblock This meansthatthediskwasinstalled with thenewfile systemusedfor 2.0 andlaterversionsof AmigaDOS. 2.5. PRINT DIR REQUESTER 65

Non-Standard This meansthat the disk is corrupt. It may contain a virus and it would be a good idea to run a virus checker program to make sure. ( ..lJ Fast File System This button allows you to install a Fast File System bootblock.

Install This button installs the boot sector on the Disk.

No Boot This button removesthe boot sector from the Disk. This will keepthe disk from being bootable. However, you can always re-install the boot sectorby clicking the Install button.

Exit This button will abort without attempting an Install.

2.5 Print dir Requester

This function allows you to print the directory in the active directory window. If no files are selected,all files will be printed. However, if only somefiles areselected,only thosefiles will be printed.

( You can selectthe information you want to print: file sizes, protection bits, dates,comments,and file types.' Directory Opus can

3FiletypesarediscussedintheConfigurationChapteronPage102 66 CHAPTER2. REQUESTERS& VIEWERS

(

Figure 2.5: Print Dir Requester ( only print the selectedinformation when it is being displayed in the Directory Window.") Ci) Output to... By default, the output will be sent to the printer. However, you can redirect the output to a file of your choosing. Printer This option directs output to the printer. File When this option is enabled,output is directed to the file indicated in the accompanying field, f@(IC Click on the magnifying glass next to the File field to use a file requesterto find the file name; otherwise type the name directly into the File field. ( "Selecting Directory Window information is discussedin the Configuration Chapter on Page 138. 2.6. PRINT REQUESTER 67

Print Whenyou dick thisbutton,DirectoryOpuswill beginprinting theinformation.It is not startedasaseparateprocess,soyou ( mighthaveto wait while DirectoryOpuscompletesprintingthe information.

Exit Thisbuttonwill abortwithout attemptingtoprint thedirectory.

2.6 Print Requester

This Requestergivesyou full print formattingcontrolfor text files. ( NOTE:All printersarenot createdequal.Someprinterswill ignore someof theseconfigurationoptions.

NOTE:Theseconfigurationoptionswork in accordancewiththe AmigaPrinterPreferences.TheAmigaPreferencesmayoverridethese preferencesorsimplymaketheoutputlook silly. For example,you cannotusetheseoptionsto displaymorelineson apagethanis specifiedin AmigaPreferences.

Thereareseveralconfigurationitemsin theprint requester: [:]I Topmargin Thisfield containstheLine Numberwheretext shouldstart.A ( TopMarginof 1 startsonthefirst line anddoesnothaveany blanklines. 68 CHAPTER2. REQUESTERS& VIEWERS

:;~;:j t'I:äi~::4~~:ä!'~'~~~E",I~~I!:äi:ä!"""""",1,',',',',',',1,',1,',',',',',',',',',',',',',',' F tue ~ ~:-q;~~~~l=fI:~:",,~,:;~;~;mfl:~:q;l=fI::::::::::::::::::::;::::;:;;:;:::::::::::::::;:;:;::;::;;;::" Top Marg in 0 Tab s ize .rn:=J BottoM Marg in ru Pr lnt p itch Cli Pica ( Left Margin EI Qual ity Cli Draft Right Marg in .II!J v I [ject f ina l page

Cli Header I conf igurat ion III _j Tit leL-1 -" I Date

I Page no I Text sty le Cli NorMa l

Output to II• (i' Printer _j File .9:11 I ( Pr int Exn I

Figure 2.6: Print File Requester r:::JI Bottom Margin This field contains the number of printed lines on eachpage. The Top Margin Lines are not included in this value. For Example, a Top Margin of 5, and a Bottom Margin of 60 the last line will be printed on Line 65. r:::JI Left margin ( This field contains the number of charactersto skip before printing eachline. 2.6. PRINT REQUESTER 69

iD Right margin This field contains the number of printed charactersallowed on eachline. The Left Margin charactersare not included in this ( value. For example, a Left Margin of 5 and a Right Margin of 70 will result in the last printable character in column 75.

D TabSize This field contains the Number of spacesto which a tab character is equivalent. Directory Opus converts tabsto spacesand will insert the appropriate number of spacesto createcolumns based on Tab Size. For example, a Tab Size of 8 specifiesTab positons of 8, 16, 24, 32, 40, 48, 56, and 64.

:fiT Print pitch This button cycles betweenPica, Elite, and Fine. Thesevalues ( specify the size of letters to print. Your printer will determine the exactdimensions of thesevalues.

'ni Quality This button cycles betweenLetter, and Draft. Some printers can be toggled between letter and Draft quality printing.

[:lJ Eject Final Page A check in this button enablesa final Form Feedcharacter after printing the last page.

( OI configuration ... This button cycles betweenReader and Footer. The Title, Date andPageno. buttons (describedbelow) can be usedwith creating a Headeror Footer line for eachpage in the print out. When the 70 CHAPTER2. REQUESTERS& VIEWERS

configurationbuttonis Header,thesebuttonsaffecttheHeader line; otherwise,theyaffecttheFooterline. By default,Directory Opuswill not createaHeaderoraFooterline.

[iJ Title Whenthecheckmarknextto Title is on, atitle will begenerated. By default,thefilenamewill bethetitle. However,youean overridethis by puttingtext in theTitle field. Youcanhave differenttitles in theheaderandfooterlines.

[iJ Date Whentheeheckmarknextto Date is on,theeurrentdatewill printed.Usuallythisis enabledforeithertheheaderline or the footerline, but not for both.

[t] Page00. Whentheeheekmarknextto Pageno is on,thepagenumberwill printed.Usuallythis is enabledforeithertheheaderlineor the footerline, but not for both.

ifiT Text style This buttonallowsyouto modify theappeareneeofall the printedtext exeepttheheadersandfooters.(Someprintersdonot supportall of thesestyles.)CIiekingon theTextStyleCycle buttonallowsyou to choosefromthefollowing options:Normal, Bold, Italies,UnLined(UnderLined),DblStrik (DoubleStrike), andShadow.

Ci} Output to... By default,theoutputwill besentto theprinter.However,you canredireettheoutputto afile of your ehoosing. 2.6. PRINTREQUESTER 71

Printer This optiondireetsoutputto theprinter. File Whenthis optionis enabled,outputis direetedto thefile indicatedin theaeeompanyingfield. ( ~C Cliek on themagnifyingglassnextto theFile field to useafile requestertofind thefile name;otherwisetype thenamedireetlyinto theFile field. (If youleavethe field empty,theoutputwill goto theprinter.)

Print Whenyou click thisbutton,DireetoryOpuswill beginprinting theinformation. Thisfunetionwill print all seleetedfiles,oneat atime. If you seleetonlyonefile to print, theprint routinewill bestartedupas aseparateproeess,allowingyou to eontinueworkingwith DireetoryOpus.To eaneelthistypeof print, simply seleetthe ( print funetionagain.A requesterwill appearaskingif youwant to eontinuewiththeprint or halt it. This requesterwill also appearif youattempttoquit DireetoryOpuswhile aprint operationisin plaee,asyou eannotquituntil theprint has finished. Evenif youabortaprint, theprintermaynot aetuallystopfor sometime.This is beeausemostprintershavebuffers,some quitelargeones,whichstoredatafor printingandwill needto emptythemselvesbeforetheprintoutwill stop.

Exit Thisbuttonwill abortwithout attemptingtoprint. ( 72 CHAP1BR2. REQUES1BRS& V/EWERS 2.7 Text Viewer

The name of the file is displayed at the bottom of the sereen,giving the eurrent position within the file both in lines and asa pereentage,and ( also the total number of lines in the file.

(

Figure 2.7: Text File Viewer

Pressthe left mousebutton to seroll through the file. Pressthe left mouse button to turn serolling on or off. The direetion and speedof the seroll are governed by the position of the mousepointer in the window. The mouse pointer will beeomeinvisible while the text is serolling. No serolling oeeursif you have the mousein the centerof the window. (

To seroll forward, move the mousedown until the text startsto seroll (providing there is aetually more than one pageof text). The 2.7. TEXT VIEWER 73

furtherdownyoumovethemouse,thefasterthetext will scroll. This proeedureisreversedforbaekwardsserolling. ( Thebuttonsin thebottom-rightof thesereenalsoallow youto move aroundthefile. Mostbuttonswill repeatif helddownfor anylengthof time. (Eaehbuttonusestheeorrespondingletterasa shorteutkey.)

up/down arrows Move upanddownaline ata time U Movesupapageatatime

D Movesdownapageata time

T Movesto thetop of thefile B Movesto thebottomof thefile

Cursorkeys Move up anddown

( Cursorkey + Shift Movesonepageatatime Cursorkey + Ctrl Movesto thetopor bottom

Theeurrentlineandpereentagevalues(in themiddleof thebottom bar)aetashiddenbuttons:dick on themandarequesterwill allow you to specifyanewvalue.It will jump to thenewloeation.

(

Figure2.8: Jumpto Line in File 74 CHAPTBR2. REQUBSTERS& VIEWERS

(

Figure 2.9: Jump to Percentof File

Figure 2.10: Searchin Text File Viewer

S Searchesfor astring. You can usefull pattern matehing in this search.

P Prints the current file.

C key Prints only the current page. This hasno button equivalent.

X or Q or Esc Leaves the text viewer.

( ~ You can also usethe right mousebutton to exit.

If you have selectedmore than one file, the next one will be read 2.8. HEX VIEWER 75

whenyou exit. Toexit without readingthenextfile, presstheright mousebutton.

( 2.8 Hex Viewer

TheHexViewerwill readfiles in thesamewayasREAD, exceptin hexadecimalformat.This allowsyouto view binaryfiles andother filescontainingnon-textcharacters.Thefile is displayedin the following manner:

(

Figure2.11: HexFile Viewer ( Thefirst valueis theoffset,displayedin hex. This is thenumberof bytesyouareinto thefile. Thenextfour valuesareeachafour-byte 76 CHAPTER2. REQUESTERS& VIEWERS longword,with theactualASCII representationattheend.Any non-textcharactersareshownasa . character. ( Chapter 3

Opus Configuration (ConfigOpus)

(

( Figure3.1: ConfigOpusmainscreen

77 78 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS) 3.1 Introduction

TheOpusConfigurationutility is apowerfulandeasy-to-use instrumentfor customizingDirectoryOpuspreciselyto yourtastes.Do youwantto useaninterlacescreen?Eightor sixteencolors?Lots of buttons?Fancybuttons?Directoriessortedby date,in reverseorder? Instantaccesstovariousassignments?WithConfigOpus,thesearebut afew of themyriadchoicesyoucanmake.

Sophisticatedthoughit is, theConfigOpusutility is quickandeasy to use.This chapterisintendedasacompletesetof instructionsfor usersnewto DirectoryOpus,andasa convenientreferencefor experiencedusers.

Directory Opususesaseparateprogramto modify the configuration.This savesapproximately130Kof memory,asthe configurationprogramneedonly bein memorywhenit is beingused. Not only that,but theconfigurationprogramcanberun independently of Directory Opus,if you arereally shortonmemory.

If you dohaveplentyof memory,however,DirectoryOpuscanbe configuredto loadtheconfigurationprogramonstart-up.In thiscase,it is run from memoryeachtimetheConfigureprogramis invoked,rather thanloadedfrom disk. Thatcanbemuchfaster,especiallyif youhave afloppy-basedsystem.

Fromwithin DirectoryOpus,youcanstartup ConfigOpusby clicking onthesmallC buttononthelower right or selectingthe "Configure" item from theProjectMenu.

FromoutsideDirectoryOpus,youcanstartConfigOpusbyitself eitherby double-clickingontheConfigOpusiconor startingit from a CLI. 3.2. CONFIGOPUSMAIN SCRBEN 79 3.2 ConfigOpusMain Screen

( OntheConfigOpusscreen(Figure3.1 onpage77)thereareseveral itemsof interest.At thetop of thescreenyouwill seeScreenDepth andHelp buttonsandtheScreenTitleBar. Screen Depth button Allows theuserto pushthescreenbehind theotherscreensopened.

Help button Bringsuphelpinformation.Whenyouhavequestions aboutsomethingonthescreen,tryherefirst. IftheHelp button doesnotansweryourquestion,thenyoucandragout themanual.

Screen Title Bar Describesthecurrentscreen.Doublesasthe ScreenDragBar,which allowsyou to dragthescreendownand seethescreen(s)behindtheConfigOpusscreen.

Thenextsetof buttonsto look at arethesubjectbuttonsalongthe left sideof thescreen.Whenyouselectone,thescreenwill changeto showthatpartof theConfigOpus.

Buttons Configurethecustombuttons,allowingyouto launchinternal commandsandexternalprograms.

Drives Configurethecustomdrivebuttons.

( Filetypes Configurethefile classesandactionsnecessaryforfile recognition. 80 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

Hotkeys Configure the global Hotkeys, allowing you to launch programs from anywhere in the systemwhile Directory Opus is active or iconified. (

Menus Configure the custom menus,allowing you to launch internal commandsand external programs.

Operation Flags and settings that affect the way Directory Opusbehaves.

Screen Modifies the characteristicsand appearanceof the Directory Opus screenand graphicuserinterface. ( System Additional items that affect the way Directory Opus interacts with the operating system.

The last buttons on this screen(Figure 3.1 on page77) arethe Okay and Cancel buttons. These allow you to say either "OK, let's usethis setting and go back to Directory Opus", or "Oops! Forget all that, and let's get out of here!"

3.3 ConfigOpusConfigure Menus (

There arefour menu items available on most screensin ConfigOpus that allow the user to control the configuration data. You can revert to 3.3. CONFIGOPUS CONFIGURE MENUS 81

the default configuration, load a configuration file or savethe current configuration. On the ConfigOpus screenthesemenuswill allow you to affect all the configuration data. When you select the Open item, you ( load all the configuration datafrom that file, replacing any changesthat you have madewith this new data.

• • Default mD Open... mo 111111111111111111111111111111111111111111111 Saue mS Saue As... mA ( Figure 3.2: Configure Menus

On the other screensin ConfigOpus, the Open menu will only override the information specific to that screen. For instance,on the Custom Button screenonly the Custom Button banks will be loaded from a configuration file. This allows you to load banks of buttons that you have defined in advance,so asto control the NewTek Video Toaster,' for example, or someother application. Default Resetto the factory default configuration settings.

Open. .. Load configuration settings from a disk file. Thesebanks ( will be inserted at the end of the banks that you have already defined. If you areon Custom Buttons, Drives, Filetypes, Hotkeys or Menus this will only load that part of the

1NewTek and Video Toasterare Trademarks of NewTek Inc. 82 CHAPTBR3. OPUSCONFIGURATION(CONFIGOPUS)

configurationfile. As anexample,byusingthis,you canimport CustomButtonbanksfrom someoneelse'sconfigurationfile.

Save Savethecurrentconfigurationsettingsasthedefault. ( SaveAs. .. SameasSave,butthis allowsyou to specifyafilename.

3.4 BUTIONS/MANAGER

Thereare42 custombuttons,locatedatthebottomof theDirectory Opusscreen.Eachbuttoncanhavealeft and/orright mousebutton events,bringingthetotal numberof custombuttonsto 84.

(

Figure3.3: Buttons!Manager ( The custombuttonsarearrangedinbanks.Thereis only onebank of thesebuttonsby default,but theconfigurationprogramallowsyouto addor deleteasmanybanksasyouwant,which meansthatthenumber 3.4. BUTTONS/MANAGER 83

of custombuttonsis limited only by availablememoryandyour imagination. ( Thebuttonconfigurationscreen(Figure3.3)displaysthecurrent buttonbank,with theleft mousebuttoneventsatthetop andtheright mousebuttoneventsatthebottomof thescreen.

Therearetenbuttonsacrossthebottomof theButtons!Manager screen.TheCopy,SwapandDeletebuttonsstayselectedif theyhave beenselectedwiththeleft mousebutton.For instance,Copybutton will stayselectedtoremindyou thatyou arenowin copybuttonmode. Whenyouwantto leavethis mode,selectCopybuttonagain.The buttonsbelowthatwork in thisfashionare: Copy,SwapandDelete. Nextbank With thisbuttonyou cancyclethroughthebuttonbanks.The currentbanknumberis displayedin thetitle barof thescreen. ( Selectthisbuttonwith theleft mousebuttonto moveto thenext bank. ~ Selectthisbuttonwith theright mousebuttonto moveyouback to thepreviousbank.

New bank Thisbuttonallowsyouto createanewbankof buttons.If you selectthisbuttonwith theleft mousebutton,it will createan emptybankattheendof thebanklist. Thisbankwill thenbe shown. ~ If youpressthisbuttonwith theright mousebutton,thenew bankwill beinsertedbeforethecurrentbank,insteadof atthe ( endof thebanklist.

Copybank Usethisto copythecurrentlydisplayedbank.A requesterwill 84 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

appearasking you to enter the bank number to eopy the eurrent bank onto. If the bank number you enter doesnot exist then a new bank will be ereated,at the end of the bank list. The eurrent bank will be eopied there. (

Swapbank Swap bank allows you to swap the eontentsof the eurrently displayed bank with thoseof another. A requesterwill appear asking you to enter the bank number to eopy to. If the bank number you enter doesnot exist, the swap operation will be aborted.

Deletebank After asking for eonfirmation, this button will delete the eurrent bank. If the eurrent bank is also the only bank, you will be warned. ( Copy button This button allows you to eopy one eustombutton onto another. Seleetthe eustom button to be eopied, then seleeta eustom button to eopy it onto. To abort the eopy,turn off Copy mode, seleetCopy button again, or seleetthe eustombutton you are eopying again.

Swapbutton This permits you to swap two eustombuttons. It works the same way asthe Copy eustombutton exeeptthat it simply exehanges the two eustom buttons. ( Deletebutton After asking for eonfirmation, this will reset a11thedata associatedwith a eustombutton. 3.4. BUITONS/MANAGER 85

When in Copy or Swap button mode, the Next bank button is still usable andallows you to copy and swap custom buttons betweenbanks.

( 3.4.1 Button Manager Menus

The Default or Open... menu items in the Configure menu allow you to import custom button banks from either the default configuration or a configuration file from disk, Thesebanks will be inserted at the end of banks you have already defined.

There is an additional menu strip available on this screen. The Button Rows menu allows you to configure the actual number of rows of custom buttons that will be displayed at one time on the main Directory Opus screen. You can choosefrom zero (no buttons displayed), one, two, three or six rows. This will also affect the drive bank height. ( (onfigure No buttons One row Two rows Three rows ,; Six rows

( Figure 3.4: Button Rows Menu

To edit a custom button, make sure you arenot in Copy, Swap or Delete mode. Selectthe custom button, and you will be shown the 86 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

custombuttoneditorscreen.

Thelasttwo buttonsonthis screen(lowerright corner)arethe OkayandCancelbuttons.Theseallowyou to say,"OK, let's useall thesecustombuttonchangesandgobackto ConfigOpus'mainscreen", ( or "Oops! Forgetall this,andlet'sjust leave."

3.5 BUTTONS/EDITOR

At thetop of theCustomButtonEdit screenyoucanseewhatthe currentcustombuttonlookslike. Thepalettesoneithersideof the exampleallow you to selectthebutton'sforegroundandbackground colors. If you click on theexamplebuttonitself, it will highlightto showyou whattherealbuttonwill look like whenselected.

(

Figure3.5: ButtonslEditor ( 1r::J1 Name The Namefield allowsyouto modify thenamethatappearson 3.6. COMMAND EDITOR 87

the button, and is limited to 63 eharaeters.

The Shortcut key displays the keyboard equivalent for this eustom ( button.

SampIe To modify the Shorteut key, seleetthe Sampiebutton at the right of the Shorteutkey field, then any keys you press,along with any qualifier keys, will be inserted in the Shorteut key field. To turn off Sampiemode, seleetthe Sampiebutton again. ~ To remove the shorteut key, seleetthe Sampiebutton with the right mousebutton.

3.6 CommandEditor

A Command teIls Direetory Opus what to do when something happens,and eanbe attaehedto Custom Buttons, Filetype Aetions, Hotkeys and Menus. Eaehof thesehasits own configuration sereen with unique aspeets(e.g.,the title and eolors usedon a Custom Button).

The unique aspeetsof the various editors aredeseribedin their own seetions,but they all have a eommon portion, referred to asthe Command Editor, whieh allows you to edit the Command.

At the centerof the Command editor is the Command List whieh ( contains the eommandsassociatedwith this funetion. To the left of this list are four buttons that allow you to modify the order and effeetivenessof theseeommands. Newentry Adds a new Command to the list. 88 CHAPTER3. OPUSCONFIGURATION(CONFIGOPUS)

(

Figure3.6: CommandEditor

Duplicate To duplieateanexistingCommand,seleettheCommand andseleettheDuplieatebutton.TheduplieatedCommandwill beaddedtotheendof theCommandlist.

Swap To exchangethepositionof two Commands,seleetthefirst, thenseleettheSwapbutton.With theswapbuttonaetive,seleet ( theseeondCommandtoswap,To eaneeltheswapoperation, seleettheSwapbuttonagain.

Delete To deletea Commandfromthelist, seleettheCommandand seleettheDeletebutton.

To edit a Command,simplydick on it. TheCommandstringwill beeopiedto thefield belowthelist for youto edit it.

3.6.1 Edit Fields

Below theCommandlist(Fig.1.5)is agroupof editingtools.These ( toolsallow you to edit aetiveCommandentries.Whenyoudick onan entryin theCommandlistit beeomesaetive,or anemptyoneis ereated whenyou seleetNewentry. 3.6. COMMAND EDITOR 89

rol Command Type The cycle button on the left below the Command List allows you to specify which kind of Command is used. When you dick on ( this button, it will cycle through the following Command types:

• Command • Exeeutable • Workbeneh • Bateh • ARexx

Eaehof theseCommand types is deseribedbelow.

~c: When you dick on the magnifying-glass button just to the right of the CommandType button, a requesterappears allowing you to pick an appropriate entry for the seleeted ( Command type. Eaeh of the following deseriptions indicates the kind of requesterwhich will appear. Command Theseare internal Commands,built into Direetory Opus. Many of theseCommandseantakeparametersfrom buttons and menus,aswell asfrom ARexx. Internal Commandsaredoeumentedin the Commands Chapter. ~c: The magnifying-glass button brings up a list of internal eommands.

Executable Exeeutablesare launehedasif you were running them manually from the CLI. Thus, with an output window enabled,they eanreeeivekeyboard input from the user and display output on the sereen. ( ~c: The magnifying-glass button brings up a file requester. 90 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

(

Figure 3.7: Internal Command Requester

Workbench Workbench programs are also executable programs. They arelaunched,however, asif you were double-clicking on their icons from Workbench. This can be an advantage,asmany programs do not take arguments, or do not work at all if run from the CLI. If the Workbench program given is a tool (i.e., an executableprogram), Directory Opus will look for its icon file to determine the necessarystack size to give to the program. If the icon cannotbe located, the stack size defined in the button, menu or file type will be used. If the Workbench program given is a project (a non-executablefile createdby anotherprogram), Directory Opus will look for its icon file to find its Default Tool, the actual program neededto load the file. If the icon cannotbe found, or aDefault Tool can not be loaded successfully, ( Directory Opus will not launch jhe file. The project's icon 'c. is also usedto determine stack size. 3.6. COMMAND EDITOR 91

Workbenehprogramseanalsotakeargumentsfrom DireetoryOpususingthe {f} andsimilar sequenees. (Figure3.9onpage93)This eanbeveryusefulindeed. ( DeluxePaint,forinstanee,doesnot aeeeptargumentsifrun from theCL!; you wouldbeunable,therefore,toseleeta pieturefile for DeluxePainttoloadfrom DireetoryOpusif youwererunningDPaintasanExeeutable. If,however,youhavetheeommanddefinedas: DPaint{f} andhavetheCommandtypesetto Workbeneh,DeluxePaint will berun asaWorkbenehprogram.FromtheWorkbench, DeluxePaintwill acceptarguments,sothefirst file you selectedwouldbeloadedinto DPaintautomatically. ~C Themagnifying-glassbuttonbringsup afile requester. WheneverDirectoryOpusopensaCommandEditor,it createsanApplcon onWorkbench(Figure3.8). The DirectoryOpusApplconlookslike anormalIcon,but it doesnotdo anythingwhenyou double-clickon it. However,if youdropanIcon onit, DirectoryOpuswill add aWorkBenchCommandentry.

Figure3.8: WorkbenchApplcon

( Batch Batchfiles,alsocalledscriptfiles,arefiles thatyou mightrunwith theExecuteCommand,orwith theexeeute commandfromtheCLI. SelectingaCommandtypeas Batchwill causethefile to beexecutedasascriptfile. 92 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

lo..lC The magnifying-glass button brings up a file requester. This file requesteris initia11yset to S: becausethis is where batch files come from by default. ARexx This type indicates that the Command is an ARexx ( script. The script will only be launched if ARexx is active in the system. Note that the addressof the ARexx port will be set automatica11y;youdo not needto use the ARexx ADDRESS command to addressthe command to Directory Opus. ~C The magnifying-glass button brings up a file requester. This file requesteris initia11yset to Rexx: becausethis is the place ARexx files come from by default.

{} This button is located next to the Command Edit Field (Figure 3.6 on page88). This button brings up a list of the argument ( functions (Figure 3.9). Refer to the Functions section (page 261) •. of the manual for more information about this powerful feature. Function strings can contain many different command sequences to do different things with files and directories. For documentation on these,and more information on functions in general, consult the Functions section of the manual.

Flags... Below the Command list is the Flags list. This is a list of a11the flags available for custom Commands. Theseflags apply to a11 Commands in the Command list. The flags are: Auto iconify CausesDirectory Opus to enter iconified mode ( when the Commandsare launched. This could be useful in low-memory situations. It only works with Run Asynchronously enabled. 3.6. COMMAND EDITOR 93

{d} - Destination directorv naMe {f} - First selechd entry (wtth path) ( {f} - All selected entries (with paths) {tU} - First entry (path ; no unselect) {Fu} - All entries «()ath ; no unselect) {o} - First setecte~entr9 (naMe only) {O} - Rll selected entries (naMes only) {OU} - First entry (naMe; no unsetect) {Ou} - All entries (naMe i no unselect) {p} - ARexx portiPubltc screen naMe" {Rd} - Director re uester v Cancel I

Figure 3.9: Function Argument Requester

CD source If this is turned on, the current directory of the ( custom Command will be set to the current sourcedirectory (active directory window). CD destination This has a similar effect to CD source,except that the current directory of the custom Command will be set to the current destination directory (inactive directory window). Directory Opus to front Causesthe Directory Opus screen to be brought to the front when the Commandshave terminated. It is usedin conjunction with Workbench To Front. If enabledin conjunction with Run Asynchronously and Output Window, this ftag will have a slightly different effect. In that case,the output window will be opened on the Workbench screenasnormal, but the Workbench screen ( will not be brought to the front. Do all files This causesthe Commandsto act on each selected entry in turn, insteadof just the first entry. This is usedfor commandsthat do not support multiple filenames on the 94 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

command line, where {F} to sendall selectedentries, would not work. Include DOpus-StartupHas Directory Opus executea file called S:DOpus-Startupbefore any external Commandsare actuallyexecuted. This file is usedin the sameway asthe Shell-Startup file above,but it is distinct from the Shell-Startup file, and therefore allows you to put into it any Directory Opus-specific commands. Include Shell-StartupIf this option is enabled,then Directory Opus will executethe standardS:Shell-Startup file before any external Commands are actually executed. This allows you to have all your path lists, resident commands,etc. available to custom Commands. No filename quote This option enablesDirectory Opus to operatecorrectly with someolder or poorly written software. Normally, whenever Directory Opus sendsa filename to a custom Command with the {f}, {o}, etc. (Figure 3.9 on page93) flags, the filename is enclosedin quotation marks. This allows you to usefilenames containing spacewith external programs. However, some software doesnot interpret the quotation marks correctly. If you find this is the casewith any program, simply selectthe No filename quote flag. Output window Opensa window for output from these Commands. The window will open on the Directory Opus screen,unless the Workbench to front option or the Run asynchronously option is enabled. In this case,it will open on the Workbench screen,and the Workbench screenwill be brought to the front automatically. The window is openedusing the handle specified in the System!AmigaDOS section of the configuration. Output to file Redirects all output from the Commandsto a temporary file in the T: directory, which is then readvia the 3.6. COMMAND EDITOR 95

text viewer. This allowsyouto readtheoutputof a programthoroughly,andevento print it. Notethatif you aresendingoutputto afile, theCommandcannotreceive ( inputfrom thekeyboard. Recursive directories Allows theCommandaccesstofiles within sub-directories.Normally,whenevera{f} or {F} or similarsequencewouldresultin thenameof a directory beingincludedin theprogram'sparameters,DirectoryOpus wouldtreatthedirectoryin thesamewayasafile. In other words,theCommandwouldnot actrecursivelyonall files within thedirectory. If thisoptionis enabled,thenamesof all fileswithin that directory,andwithin sub-directorieswithinthedirectory, andsoon,areincludedin theprogram'sparameters.This allowstheCommandtoacton all files in thedirectoryand notjust onthedirectoryitself. ( Reload each file CausesDirectoryOpusto rescanafile after it hasbeenacteduponby aCommand,andupdatesthesize, datestamp,commentandprotectionbitsof thefile. Youcan thereforereflectchangesinsize,for instance,madeby a texteditorto afile. Rescan destination This flagmakesDirectoryOpusreload thedestinationdirectory(inactivedirectorywindow) when theCommandterminates.This,andtheaboveoption, allowsDirectoryOpusto displaycorrectlyanychanges madetoeitherdirectorywindowby externalprograms,such asarchivers. Rescan source MakesDirectoryOpusreloadthesource ( directory(activedirectorywindow)whentheCommand terminates. Run asynchronously IndicatesthattheCommandsareto be launchedasanewprocess,andDirectoryOpusis not to 96 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

wait for it to return. If this is thecase,andanoutput window is specified,theoutputwindow opensonthe Workbenchscreen. Workbench to front CausestheWorkbenchscreentobe broughtto thefront.

Threefieldsatthelower right allow you to specifystacksize, priority andoutputwindow closedelay.

.cJ Stack size (Figure3.6on page88) Thestacksizeis thesize(in bytes)thatexternalprogramswill useasstackspace.Thedefaultandminimumis 4000bytes.The documentationoftheprogramyou arerunningshouldadviseyou of thebeststacksizeto use. ( o Priority (Figure3.6 onpage88) Thepriority field allowsyouto determinethepriority atwhich theprogramswill run. Thedefaultis O.Youshouldnotnormally useanythinglowerthan-10or higherthan10,exceptfor certain programs(thedocumentationoftheprogrammayadviseyouof appropriatepriorities).

.cJ Close delay (Figure3.6 onpage88) This field is thenumberof secondsaftertheCommandshave finishedbeforetheoutputwindowcloses(if oneis specified). Thedefaultis 2,which meansthattheoutputwindowwill close two secondsaftertheCommandshaveterminated.If you setthe ( closedelayto 0, theoutputwindowwill closeimmediately.If you setit to -1, it will wait for youto presstheleft mousebutton beforeclosing. 3.6. COMMAND EDITOR 97

3.6.2 Edit Menu

If you move the mouseto the top of the sereenand pressthe right ( mousebutton, you will seethat the main Configure menu hasbeen replaeedby the Edit menu. The options in this menu operateon the eurrently displayed Command List. This includes the Flags andfields.

(

Figure 3.10: Command Edit Menus

All sereenswith a Command Editor eontain the Edit Menu with Cut, Copy, andPastefunetions. Theseallow you to swap funetion definitions betweeneustombuttons, menusand Filetypes.

Cut Copies the settingsof this Command List to the clipboard then erasesthem,resetting all fields to their default settings.

Copy Copies the settings of this Comand List to the elipboard, but ( willleave the values untouehed.

Paste. .. Displays a list of all Command Clips in the clipboard (if thereare any present). If you seleetan entry from this list, it will 98 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

bepastedintothecurrentCommand,replacinganyinformation thatwastherealready.

Erase Resetsallfieldsto theirdefaultsettings,erasingtheCommand (. List. TheCommandwill not becopiedto theclipboard. •.

Clear Clips WhenyouusetheCutandCopyEdit Menus,the Commandsarestoredin thefile t :configopus.clip. Clear Clipsdeletesthisfile, causingall previouslyclippedCommands to becleared.

3.7 DRIVES/MANAGER

TheDrivesbuttonconfigurationscreenallowsyou to configurethe drivebuttons.Thesebuttonsgiveyou quickandeasyaccesstoadevice ( or directory.Thereare30drivebuttons,arrangedinfive bankswith six buttonsin each.TheDrivesconfigurationscreendisplaysall 30drive buttonsatthetop.

Therearetenbuttonsacrossthebottomof thescreen.Someof thesebuttonsstayselectedwhenselectedwiththeleft mousebutton. For instance,Copybankwill stayselected,remindingyouthatyouare now in copybankmode.To leavethismode,selectCopybankagain. Thebuttonsbelowthatwork in this fashionare:Copybank,Swap bank,Deletebank,Sortbank,Copydrive,SwapdriveandDeletedrive.

Get drives Causesthedrive buttonsto beassignedtothenamesof all the devicesandassigneddirectories(thefirst 30)presentinyour ( system.Youwould normallyonly do thiswhenperforminga majorreconfiguration. 3.7. DRlVES/MANAGER 99

(

Figure 3.11: Drives/Manager ( Copy bank Copies one drive bank onto another. Select any drive button in the drive bank to copy, and then any drive button in the destinationbank.

Swap bank Allows you to exchangethe contentsof two drive banks. This works the sameway asthe Copy bank button.

Delete bank ( Erasesthe contentsof a drive bank. If a drive bank has no buttons defined in it, it will not be displayed on the main Directory Opus screen(ie, Directory Opus skips over unused drive banks). In fact, if you delete all the banks, the drive banks 100 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

will not evenbeshownonthemainDirectoryOpusscreen.This allowsthemaincustombuttonsto bewider.

Sort bank ( Alphabeticallysortsthecontentsofa drivebank. Selectany drive buttonin abankandthatbankwill besorted.

Copy drive Copiesonedrive buttonontoanother.Selectthedrivebuttonto becopied,thenselectadrivebuttonto copyit onto. Youcan abortthecopyby turningoff copymode,selectingCopydrive again,or selectingthecopieddrivebuttona secondtime.

Swap drive Swapstwodrivebuttons.This worksthesamewayastheCopy drivebuttonexceptthatit exchangesthetwo drivebuttons. (

Delete drive After askingfor confirrnation,resetsall thedataassociatedwitha drivebutton.

The lasttwo buttonsonthis screen(lowerright corner)arethe OkayandCancelbuttons.Theseallowyouto say"OK, let's useall thesedrivebuttonchangesandgobackto ConfigOpus'mainscreen", or "Oops! Forgetall this,andlet'sjust leave".

3.8 DRIVES/EDITOR (

Whenyou selectadrive buttonfrom oneof thebanks,theDrives 3.8. DRlVES/EDITOR 101

Editorwill appearorbeupdatedwiththatdrivebutton'sinformation. Thedriveseditorwill bedisplayeddirectlybelowthedrivebanks.

(

Figure3.12: DriveslEditor ( In themiddleof thescreenisanexampleof whatthecurrentdrive buttonwill look like. Thepalettesoneithersideof theexampleallow youto selecttheforegroundandbackgroundcolorsof thebutton. CJI Name Thisfield allowsyouto modify thenamethatappearsonthe drivebutton.TheNamefield is limited to fifteencharacters.

~c Path Thisis theactualAmigaDOSpaththatis readin wheneverthis drivebuttonis selected.ThePathfield is limited to to 256 ( characters.

Shortcut Key is a displayareafor thekeyboardequivalentfor this drivebutton. 102 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

[.::[,,):1 SampIe To modify theShortcutkey,selecttheSampiebutton.While the Sampiebuttonis selected,anykeys,alongwith anyqualifiers, you presswill beinsertedin theShortcutkeyfield. To turnoff ( Sampiemodesimply selecttheSampiebuttonagain. }E!J To removetheshortcutkeysimply selecttheSampiebuttonwith theright mousebutton.

3.9 FILETYPES/MANAGER

A file is simplystoreddata.Filescancontainexecutableprograms, IFF pietures,Iconsfor Workbench,oramultitudeof otherkindsof data.Most (butnot all) fileshaveanidentifiablestructure.Directory Opus'sFileTypessystemisdesignedtoexamineafile's structureand identify thekind (or Type)of datait contains.Youcanconfigure DirectoryOpusto understandandunlimitednumberof Filetypes.

Filetypesareaversatilefeatureof DirectoryOpus.UsingFiletypes, youcanconfigureDirectoryOpusto play animationswhentheyare double-clicked,toloada databaseprogramwhenyou attemptto "Read" adatabasefile,or to uncompressanArchivedfile whenyou dick-rn-dick on it.

This is theessenceoftheFiletypes:whenyoudosomethingtoa file, Directory Opuscanfigureoutwhatkind of file it is, andtakethe appropriateactionfor thattypeof data.

Therearetwo sectionstotheFiletypesconfiguration: Filetypes Thereis a list of Filetypeswhichis searchedwhenan actionoccurs.If thefile beingprocessedmatchesaFileType,you canconfigureDirectoryOpusto performaspecificaction. 3.9. FlLETYPES/MANAGER 103

File ClassesThere is a DataBaseof File Class definitions: each describesthe processof matehing a particular kind of File. Directory Opus comeswith more File Classesthan you will ( probably use. You can selectfrom this list when you are creating a new Filetype entry. You don't have to be an expert or know anything about the internal structure of the file to do this. The File ClassManager, describedin the next section, allows you to edit existing File Classes,or define new ones. (This can be somewhatmore complicated.)

3.9.1 Filetypes

The Filetype configuration screendisplays the list of filetypes that Directory Opus recognizes. By default, it recognizesLHA archive, ARC archive, ZOO archive, and Workbench icons. (

( Figure 3.13: Filetypes/Manager

There arefive buttons acrossthe bottom of the screen. Some of 104 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS) thesebuttons when selectedwith the left mousebutton stay selected. For instanceDeletewill stay selectedindicating that you arenow in delete mode. To leave this mode simply selectDeleteagain. Both the Deleteand Swapbuttons work in this fashion. (

New This allows you to createa new filetype entry basedon a predefined File Class. When you selectthis button a requester appearscontaining currently defined classes.To createa new entry for one of theseFile Classessimply select it andyou will be brought to the filetype action editor (describedbelow).

Swap This button allows you to exchangethe positions of two Filetypes in the list. This can be very useful or even neccessary.In the case of having two file types defined in which one is a sub-setof the ( other, e.g., 24 bit ILBM pictures vs. regular IFF ILBM pictures, you would want the 24 bit ILBM pictures to come first because they are a special caseof the regular IFF ILBM picture filetype. Otherwise, pictures (in this case) will be matchedwith the regular IFF ILBM picture filetype andwill never havea chance to match with the sub-set24 bit ILBM picture filetype. To actually perform a swap, click on the Swapbutton to enter that mode. Click on the first filetype, then on the second. Those two filetypes will exchangeplacesin the list. To exit swap mode simply pressSwapa secondtime.

Delete In this mode you can select file types to remove from the list. ( Click on the Deletebutton, then click on the entries you wish to delete. If you accidentally delete an entry, click on the Cancel button. 3.10. FlLETYPES/EDITOR 105

Okay and Cancel Thesebuttons allow you to say "OK, let's useall theseFiletypes changesandgo back to ConfigOpus' main screen", or "Oops! ( Forget all this and let's just leave".

To edit a filetype, make sureyou are not in Swap or Delete mode. Then simply selectit. You will then be taken to the Filetype Editor screen(Figure 3.14).

3.9.2 Menus

There is an additional menu on this screenwhich controls File Classes. PIeaserefer to the section on File ClassManager for information about this menu. ( 3.9.3 Editing an existingentry

To edit an entry in the list, simple dick on it and you will be taken to the filetype editor (describedbelow).

3.10 FILETYPES/EDITOR

This editor allows you to define the actions taken on a matehing Filetype. In a preceding section, you learned to configure an action ( when a custombutton is selected.Essentially, you say "When this button is clicked - Do this.". In the Filetypes editor, you say: "When I do this to this particular Filetype - Do that." The primary difference is that a custom button can only be activated by being clicked on; the 106 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS) functions available for editing Filetypes can be activated in several ways.

(

Figure 3.14: Filetypes/Editor

At the top of the Filetypes Editor is a list of Event types,which are instructions you may chooseto give Directory Opus regarding Filetypes. Each of theseEvents is associatedto either a mouse action or a Directory Opus command, so eachentry on the list is taggedeither Action or Command.An asterisk * indicates that that entry already hasan Event Command List defined for it. Clicking on an entry in the list highlights it to show that it is the Command List currently being edited. The current Command List is displayed in the editing list in the middle of the screen. The small field immediately above it describesthe Event. ( While eachof theseEvent types can be defined to do something, usually only a few are actually defined. It certainly is not necessaryto define all Events for a Filetype. 3.10. FlLETYPES/EDlTOR 107

When one of theseEvents is activated, Directory Opus does the following:

( • It first searchestheFiletypes list, starting with the first entry, and checkswhether it matchesthe entry's File Class.

• If it matches,it looks to seeif the corresponding Event is defined from this Editor. If it is defined, it performs the Command List.

• If it doesnot match the File Class,or if it matchesand does not havea Command List defined, it continues to searchthe Filetypes list. It is possible for .it to match a subsequententry that doeshave a Command List defined.

3.10.1 MouseAction Events

( Mouse Events occur when you either Double-dick on a file or perform a Click-m-click, Double-click This occurswhen you double dick on a file. A popular useof this is to examine a file (e.g., show it if it is a picture or play it if it is asound). The actual double dick speedis definedby the operating system's preferenceprogram. Click-M-Click This Event occurs when a file is clicked on then the mouseis moved to the other window and clicked. One popular useof this Event is for archive extracting. Another way this Event can happenis by using click-drag-release. With this you literally drag a file into the window and drop it there.

( 3.10.2 CommandEvents

Command Events arecalled when a file is actedupon by a Directory Opus command. For example, when a Read Command is performed 108 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS) on a file, Directory Opuswill searchfor a FileType which matchesthe File and has a Read Event defined. You could, however, haveRead do something special for an archive (i.e., list the contentsof the archive). Likewise if you have a music scoreyou could define the Play (or ( LoopPlay) to call up your player for that music score.

Each of the following Command Events is associatedwith a corresponding Directory Opus command. This allows you to redefine the specific action taken for a particular filetype. By convention you should use a command Event for something similar to its normal use, but there is nothing to stop you from giving a command Event a label that is totally irrelevant to its use. It's up to you to keep the context of the command (i.e., a Readwould be confusing if it did a Disk Format).

The following list describesthe normal usages.You can decide what you want it to meanfor any given filetype.

AnsiRead Fancy text vi ewer

HexRead Binary or Hexadecimal file viewer

LoopPlay Normally associatedwith playing soundsin loops

Play Playing sounds

Read Simple text viewer or viewing contentsof archives

Show Picture viewer

User Events The terms User1, User2, User3, and User4 may seem cryptic, but they arehere to give you flexibility. Each of the preceding commandshas an implied usage,but you may have an application which doesn't really mean any of these. In that case, Yh~ucan~elcideth~t o~e of theseUser Events means"Perform ( t IS specia operation . Directory Opus' default configuration employs User1 for extracting from archives. 3.11. FILE CIASS/MANAGER 109

Edit Class Thebuttonto thefar right of thelist allowsyouto modify this filetype'sdassdefinition. Wewill talk abouteditingFile Classes ( in theFile Classseetion(seepage109).

Belowthelist of Eventsassociatedwiththisfiletypeis afield deseribingthispartieularEvent.For instaneeyoueouldhavetheRead Eventsaysomethinglike"Readingfile... ". This messagewillappear in DireetoryOpus'Title BarwhentheEventis beingperformed.

Theremainingpartof thisrequesterisdeseribedintheCommand Editor seetion(seepage88).

3.11 FILE CLASS/MANAGER ( File Classmanagementishandledby amenuaeeessiblefromthe Filetypemanagersereen(Figure3.15onpage110)thatoffers managementtoo1sandstorageoptions: New Seleetingthismenuoptionallowsyou to ereateanewFile Class definition.

Edit Thiswill opena requestershowingyou all theeurrentlydefined File Classes.Topick oneto edit, simply seleetit; youwill then bebroughtto theFile Classeditor.To abortpresseaneel. OneeyouhavemadeafiletypeentrybasedonaFile Class definitionthenyoumustusetheEdit Classbuttonon thefiletype editorsereen.(Figure3.14onpage106) ( WhenyoumakeaFiletype,it usesaeopyof theFile Classin the aetua1filetypeentry.This hasseveralimportantresults.Oneea Filetypeis made,youeaneditits File Classdefinitionwithout ehangingtheoriginal definition.TheEdit Classbuttononthe 110 CHAPTER 3. OPUS CONFIGURATION (CONFIGOPUS)

(

Figure 3.15: File Class Menus

filetype editor allows you to do this. Selecting Edit from the ClassesMenu allows you to edit the original File Class Definition. This will not automatically updateany Filetypes ( which usedthe original definition. You can even delete the original File Class without affecting a filetype which usedit.

Duplicate This allows you to createa new File Classbasedon an already defined File Class.

Delete This will bring up a requesterallowing you to select a File Classto clear from memory. Simply selectthe File Classto delete and respondYes to the confirming requester.PressCancel to abort deleting.

Open With this you can import File Classdefinitions from a file.

Save Savethe current File Classesto their default place on disk. ( SaveAs. .. Save the current File Classesto a specific file on disk.

Clear Clear a11FileClassdefinitions from memory. 3.12. FILE CIASS/EDITOR 111 3.12 FILE CLASS/EDITOR

( SeleetingNew, Edit, or Duplieate from the Filetype managersereen (Figure 3.15 on page110) or elieking Edit class button on the Filetypes Editor (Figure 3.14 on page 106) brings up the File Class Editor.

(

Figure 3.16: File ClassEditor

This screenis the most complex section of ConfigOpus. It even looks scary,but don't worry: it is rather simple oneeyou get to know it. The bestway to describethis screenis to start at the top and go down from there. ~c File viewer The field at the top of the screenis simply a file viewer. To view afile, type its nameinto the field or dick on the magnifying-glass ( to bring up a file requester.The file selectedwill appearbelow the field. It will be displayed in Hex/ASCII format similar to the Hex Readcommandin Directory Opus itself. 112 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

(

Figure3.17: File Class- File Viewer

Youmaywonderwhy we haveafile vieweron thisscreen.We havefoundthatwhencreatinganewFile Classdefinitionit is usefulto haveaway to look atfiles, sinceyou aretrying to describetoDirectory Opusaway of identifyingfiles.

]l To theright of thefile vieweris abuttonthatcyclesfrom Decimal to Hex. This buttontellsConfigOpusinwhatformatto displaythePositionandOffsetinformationin thetwo read-only ( fieldsbelow thecyclebutton.

The simplestway to showhow this all worksis with anexample. Selectthefile "C:ED" (by eithertyping into thefield or usingthe magnifying-glassfilerequester).

Theformatof thedatain thefilevieweris asfollows: Thefirst columnis theaddressintothefile we arelooking at. Thenextfour columnsare16bytesof datafrom thefile in hexadecimalformat.The lastcolumnis simplythose16bytesin ASCII format. Wherethereis a byte that is '00' or null we displayit in ASCII asaperiod.

Positionyour mousepointeroverthe'F3' charactersandpressthe left mousebutton.A cursorwill appearandthepositionread-onlyfield ( will befilled in with '000000003'.This meansthatthecursoris positionedon the4th bytein thefile (rememberbytelocationsarezero relative,thatis, first byteis atlocationzero). If youclick thecycle 3.12. FILE CLASS/EDITOR 113

(

Figure3.18:File Class- File Viewer(showingposition)

buttonabovethepositionread-only:fieldandchangeit to Hex thenthe positionwill be:filledin with '$00000003'which is hexadecimalfor three.Youcanmovethecursoraroundin the:filewith eitherthemouse pointer(simplyselectanotherplacein the:file)or thecursorkeys.

(

Figure3.19:File Class- File Viewer(showingoffset)

Now doubledick onthose'F3' characters.Thistime thecharacters changecolors.Theyarenowthepositionfrom which offsetsare computed.Movethecursorby pressingthedownkeya few timesand youwill noticetheoffsetread-only:fieldcontainstheoffsetfrom the doubledick position.

3.12.1 File ClassEditor Components ( That'saboutit for the:fileviewerpartof theFile Classeditorscreen. Now we gooff to therealpowerhouseof DirectoryOpus. 114 CHAPTER 3. OPUS CONFIGURATION (CONFIGOPUS)

(

Figure 3.20: File ClassEditor Components o File Class The field below the file vi ewer is for the name of the File Class. (Figure 3.16 on page 111). This is for the nameof the File Class. o ClassID The Class ID will appearbeside the Filetype in the Filetype manager screenand is a shorthandway for Directory Opus to write the name of the file c1ass.

1H.. ,.1ll 1:.,',':\\1 Underneath the fields is the File Class identification definition. ""."'" This is aseries of actions that Directory Opus will perform in order to identify a file c1ass.The action may be assimple as matehing a filename to a pattern or ascomplex asscanningan IFF form looking for datain a specific IFF chunk.

Below the list is a magnifying-glass, a read-only field and an argument field. These areusedfor editing the File Class identification definition (seepage 115). (

Newentry Createsa new entry in the File Class definition script. 3.12. FILE CLASS/EDlTOR 115 i_ Duplicate DuplicatesthecurrentFile Classdefinitionscriptline. The copiedline is insertedafterthecurrentline. ( ,.. , Swap Letsyouswapthepositionsof two File Classdefinitionscript lines.

Delete Will let youdeletethecurrentline.

3.12.2 Editing

To editaline simplyclick onit, andtheread-onlyandargumentfields ( will befilled in. Tochangethecommandintheread-onlyfield, click on themagnifying-glassbuttonandalist of othercommandswill be displayed(Figure3.21onpage116).Selecttheoneyou wantor press Cancelto abort.

ThegeneralstructureoftheFile Classdefinitionscriptis thatthere is aclauseorasequenceofclausesthatdescribewhatshouldbe consideredamatehingfilefor a givenfiletype. Thereareonly two directivesthatdelimit clauses:AndandOr. Theyareusedto tell the systemwhatto doif aclausefailsor succeeds.

Whenall theclausesarefinishedandtheresultis truethenthefile is of theright type.

( 3.12.3 File ClassEdit Commands And if theprecedingclausesucceeds,thenalsodo this clause; otherwiseskipto thenextclause.If theprecedingclause 116 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

executeddidnot succeed,thenexecutionstopsandthefile does not match.

(

Figure3.21: FiletypeEdit CommandsRequester (

Or if theprecedingclausefails thendo this clause;otherwiseskipto thenextclause.

3.12.4 Testingdirectives Match Matchtext or $hex This statesthata sequenceofbytesstartingatthecurrentfile offsetmustmatchthegivenpattern.To matcha singleunknown characterwhentext is given,usethe? character.Tomatcha singleunknownbytewhen$hexis givenusetwo of them(??) You canalsouse\000 syntaxin text to specifyASCII characters ( by their decimalnumber.A \009 wouldbeatabcharacter,a . \114 would bethelowercaser. 3.12. FILE CIASS/EDITOR 117

Example:

Match$000003F3(executablesstartwith thesebytes) ( MatchFORM????ILBM(theway a IFF ILBM picturestarts) MatchHey\0090verthere("Hey" thena tabthen"Overthere")

MatchBits MatchBitsHSPARWED This teststhefile's protectionbits. To seeif abit is set,put a + beforethecharacter.Toseeif thebit is unsetusethe-.

Example:

MatchBits+RW- readwrite mustbeon,othersdon't matter MatchBits-E - executablemustbeoff, othersdon't matter MatchBits+RW-E - read,write mustbe on andno executable ( MatchComment MatchCommenttext Simplycomparethetext givenagainstthecommentof thefile. Any valid AmigaDOSwildcardpatternis usablehere.

Example:

MatchCommentSilly.Picture(file with silly -pictureasa comment) MatchComment#?eddie#?(anyfile with eddiein its comment)

MatchDate MatchDatedates ( Testthedateof thefile againstadate.For informationabout datestringsorrangesseetheSelectcommand(seepage246). 118 CHAPTER3. OPUSCONFIGURATION(CONFIGOPUS)

Example:

MatchDate08-Sept-92 MatchDate< 10-Jan-92 (

MatchName MatchNamefilename Thefilenamemustmatchthecharacterpatterngiven.Any valid AmigaDOSwildcardpatternis usablehere.

Example:

MatchName#?ilbm MatchName*.lzh

MatchSize MatchSize> or < or = integer Testthesizeof thefile againstavalue.

Example:

MatchSize> 1000

3.12.5 Movement directives MoveTo MoveToByteLocation Move to aspecificbyteoffsetfrom thebeginningof thefile. Initially you arealwaysat thebeginningof thefile, butyoumay havebeenmovedin apreviousclause,soyoumightwantto put a MoveToat thebeginningof aclausein orderto knowexactly whereyou are. 3.12. FILE CIASS/EDITOR 119

Example:

MoveTo0 (backto beginningofthe file) ( MoveTo100(moveto the 101stbyteof thefile)

Move MoveByteOffset Moveto abyterelativeto thecurrentfile offset.

Example:

Move 16(movesixteenbytesforwardinto thefile) Move-4 (movebackfour bytesfrom wherewe are)

SearchFor SearchFortextor $hex Search(startingatthecurrentfile offset)for acertainbytepattern ( thatmatchesthegivenpattern.SeetheMatchcommandforvalid optionsfor thisdirective.If thematchoccurs,thenthecurrent file positionwill bethefirst charactermatched.

Example:

SearchForCMAP(look for the'CMAP' , positionon the 'C') SearchForM.K.(searehfor'M.K.', positiononthe 'M')

A failureof anyMovementdirectivescausestheclauseto fail. Example

( Oneexampleofusageisthefile class24bitpicture.

Example: 120 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

MatchFORM????ILBM(file muststartwith thesecharacters) And (if thepreviouscauseistruethendo thefollowing) SearchForBMHD(thensearchfortheBMDH chunkID) Move 16(movesixteenbytesinto thefile) Match $18(thismustbe24 (or $18in hex)to bea 24bitpicture.) (

Wewould suggestlookingatthepredefinedFileClassestogetan ideaof thetypeof thing you candowith this system.

3.13 HOTKEYS/MANAGER

DirectoryOpuscanhaveanunlimitednumberof Hotkeysdefined. Hotkeysaresystemicglobalkeydefinitions.Thesekeysareavailable from everyapplicationyourun,aslong asDirectoryOpusis runningor iconified. If DirectoryOpusis busydoingsomethingelse(i.e.,copying files, etc.) thenthekey's operationwill startup assoonasDirectory ( Opushasfinished.Under2.0,Hotkeysareimplementedvia Commoditiesandarecontrollablevia theCommoditiesExchange program(seeAmiga 2.0 manual).

Therearesix buttonsacrossthebottomof thescreen.Someof thesebuttonsstayselectedwhenselectedwiththeleft mousebutton. For instance,Deletewill stayselectedtoremindyouthatyouarenow in deletemode.To leavethis mode,selectDeleteagain.Thebuttons below thatwork in this fashionare:Duplicate,SwapandDelete. New Hotkey Takesyouto the Hotkeyeditorsoyou candefinea newHotkey. ( Duplicate Duplicatesa Hotkey. Youcanabortthecopyby simplyturning off duplicationmode,selectingDuplicateagain. 3.13. HOTKEYS/MANAGER 121

(

Figure3.22: Hotkeys/Manager

Swap ( Allows youto swaptheorderof two Hotkeys.Rememberthat thefirst Hotkeyis seenfirst,soif youhavetwo Hotkeyentries definedto thesamekeysequence,onlythefirst onewill beseen.

Delete After askingfor confirmation,thisdeletesHotkeys.

3.13.1 Menus

TheDefaultor Open... menuitemsin theConfiguremenuallow youto importHotkeysfrom eitherthedefaultconfigurationor aconfiguration ( file from disk. To editaHotkey,makesurethatyou arenot in Duplicate,Swapor Deletemode,thensimplyselectit. Youwill thenbetakento the Hotkeyeditorscreen. 122 CHAPTER3. OPUSCONFIGURATION(CONFIGOPUS)

Thelasttwo buttonsonthis screen(Iowerright corner)arethe OkayandCancelbuttons.Theseallow youto say,"OK, let'suseall thesecustombuttonchangesandgobackto ConfigOpus'mainscreen", or "Oops! Forgetall this,andlet'sjust leave". (

3.14 HOTKEYS/EDITOR r:.:JI Name This field is simply anamefor theHotkeyandcancontain anything.DirectoryOpusonly usesthisasa labelsothatyou will know whattheHotkeydoes.

Figure3.23: Hotkeys/Editor

Hotkey is a displayareafor theHotkeysequence.Itshowsthe definedHotkeyor is emptyif onehasnotbeendefined. (

SampIe To modify theHotkey,selectthisbutton.While theSampie 3.15. MENUS/MANAGER 123

buttonis seleeted,anykeys,alongwith anyqualifiersyou press will beinsertedin theHotkeyfield. To turn off SampIemode, seleettheSampIebuttonagain. ( ~ To cleartheHotkeysequeneesimplyseleettheSampIebutton with theright mousebutton.

Theremainingpartof this requesterisdeseribedintheCommand Editor seetion(seepage88).

3.15 MENUS/MANAGER

This seetionallowsyou to eonfigurethemenus.Thereare100 eustommenuitems,arrangedasfive menusof twentyitemseaeh.The MenuConfigurationsereendisplaysthefive menus,with themenu ( titles at thetop.

(

Figure3.24: Menus/Manager 124 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

All the menu items in eaehmenu strip are not displayed at onee; beeausespaeeis limited on the sereen,only a eertain number arevisible at a time. To move through the menu items, usethe slider at the right of the sereen.

There are ten buttons aerossthe bottom of the sereen.Someof thesebuttons stay seleetedwhen seleetedwith the left mousebutton. For instanee,Delete Item will stay seleetedto remind you that you are now in Delete Item mode. To leave this mode, seleetDelete Item again. The buttons below that work in this fashion are: Copy menu, Swap menu, Delete menu, Sort menu, Insert item, Copy item, Swap item and Delete item. Copy menu Copies the eontentsof one menu to another. When you have seleetedthis option, seleeta menu item in the aetual menu you wish to eopy, and then a menu item in the menu you want to eopy the first menu to. (

Swapmenu Swapsthe eontentsof two menus. It works in the sameway as the Copy menu funetion, exeeptthat the eontentsof the seeond menu areexehangedand not replaeed.

Deletemenu Removes a11funetionsfrom one of the five menus. Seleeta menu item in the appropriate menu; a requesterwill appearto verify the operation. If you seleetOkay, the eontentsof the menuwill be deleted. ( Sort menu Sorts the eontents of eaehseleetedmenu alphabetica11ybyname. 3.15. MENUS/MANAGER 125

Insert item Allows you to insert a new item betweentwo existing items. Selectthe item in front of which you want the new item to be ( inserted.

Copy item Allows you to copy one menu item to another. When you have selectedthis option, selectthe menu item to copy, and then the menu item to copy it to.

Swap item Allows you to swap two menu items. It works in the sameway as the Copy item function, except that the seconditem is exchanged and not replaced. ( Delete item Deletesmenu items. Selectthe menu item you wish to delete. All menu items below it will be moved up to fill the empty space.

The Default or Open... menu items in the Configure menu allow you to import menusfrom either the default configuration or a configuration file from disk.

To edit a menu item, make sure you arenot in Copy menu, Swap menu, Delete menu,Sort menu, Insert item, Copy item, Swap item or Delete item mode. Then simply select it, andyou will be taken to the menu item editor screen.

( The last two buttons on this screen(lower right corner) are the Okay and Cancelbuttons. Theseallow you to say 'OK, let's use all thesecustom button changesand go back to ConfigOpus' main screen,' or 'Oops! Forget all this and let's just leave.' 126 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS) 3.16 MENUS/EDITOR

At the top of the menu item edit screenis an example of what the ( current menu item looks like. The paletteson either side of the example •• allow you to selectthe Foreground and Background colors of the menu item.

(

Figure 3.25: Menus/Editor r:=JI Name This field allows you to modify the name that appearson the menu item, and is limited to 63 characters.

Shortcut key is a display areafor the Shortcut key sequence.The Shortcut key gives the keyboard equivalent for this menu item. ( SampIe To modify the Shortcut key, selectthis button: any keys, along 3.17. OPERATIONS 127

with any qualifiers you presswill be inserted in the Shortcut key field. To turn off Sampiemode, select the Sampiebutton again. ~ To clear the Shortcut key sequencesimply selectthe Sampie ( button with the right mousebutton.

The remaining part of this requesteris describedin the Command Editor section (seepage88).

3.17 OPERATIONS

The Operation Configuration Screengives you complete control over the way eachof the listed operations is performed. You can cover any contingency by specifying precisely how you want eachoperation to be carried out in any situation that might arise. When you select one ( of the buttons to the left of the screen,requesterswill appear,asking you how to proceed.

Copy This button allows you to check the amount of spaceavailable for copying files anddirectories, and to set the archive bits once the copying is finished. You are able to choosewhich parts of the file information needto be copied. You are also given options to consider if the file being copied already exists in the destination.

'_ Date format With this button you may choosebetween the Amiga system's default or threeother formats for displaying the date. ( Delete Without the reminders that this button summons,you might lose somevery valuable information. 128 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

(

Figure 3.26: Operations

Error check You may chooseeither DOS requestersor the more ( comprehensiveDirectory Opus error requesterswhen you select this button.

General This button displays miscellaneousftags that aredetailed in the Operations/Generalsubsection.

Icons With this button you may decide whether to createa drawer icon, whether eachfile's icon undergoesevery changethat befalls its file, and whether an icon is selectedautomatically with its file. ( List Format The screensummonedby this button gives you control of the format of the lists in both screens. 3.17. OPERATIONS 129

Update Thisbuttonoffersvariousfeaturesthataredetailedin the Operations/Updatesubsection. (

3.17.1 OPERATIONS/COPY

IWhen copying files and directories ... I

~ Check destination's free spacebefore starting

(

Figure3.27: Operations/Copy

ThiscausesDirectoryOpusto checkthatthedestination directoryhasenoughfreespaceinit beforeattemptingtocopy ( selectedfilesand/ordirectories.If DirectoryOpusdoesthink that all selectedentrieswill fit in thedestinationdirectory,it will alert youwith arequester,andgiveyoutheoptionof abandoningthe copyprocess.If anyselecteddirectoriesdonot havesizes 130 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

displayed for them, Directory Opus will ask you if you wish it to perform a byte count on thesedirectories before seeingwhether or not they will fit. ( GZl Set archive bit of source after finis hing After Directory Opus copies a file, the original file will get its archive bit set to true. This meansthat the file hasbeen archived.

IAlso copy source's... I

These flags tell Directory Opus that when it copies a file, it must also copy theseparts of the file information aswell. You can have all, none, or any combination of theseselected.

GZl Datestamp

GZl Protection bits (

GZl Comment

IWhat to do when a file already exists... I

(i1 Theseflags tell Directory Opuswhat to do if a file that is being copied already exists in the destination. Only one of thesemay be selected. You have four options: Always replace files Replacesthe original file regardless. Never replace files Will never replace the original file.

ReplahcefilonlYbolde~ dfihlesReplacesthe 01riginald~fileo?lyld'f ( tee to e copie asa more recent astmo 1 cation ate. Ask before replacing Asks the userwhat to do if the file already exists. 3.17. OPERATIONS 131

3.17.2 OPERATIONS/DATE FORMAT

(IDate Format ... I

~ This teIlsDirectoryOpushowto formatdates.TheAmiga's operatingsystemusesthefirst (DD-MMM-YY) by default,but you maychoosewhicheveroneyouprefer.

(

Figure3.28: Operations/DateFormat

DD·MMM· YY (22-Sep-92) YY·MM·DD (92-09-22) MM·DD·YY (09-22-92) DD·MM· YY (22-09-92) ( 132 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

IMise. Hags.. . I

[l] Name substitution (Today, Tomorrow, ete) Causeswords like Today, Tomorrow or Tuesdayto be substituted for a date, if appropriate.

1.1 12 hour clock This aIlows you to choosewhether the clock format usedby Directory Opus be displayed in 12 hour or 24 hour format.

3.17.3 OPERATIONS/DELETE

IAsk before ... I (

[l] Commencing delete TeIls Directory Opus to check with you before actuaIly starting to delete. This is a rather useful everyday option becauseit's always better to be safethan sorry.

!l1 Deleting files Tells Directory Opus to askfor confirmation before deleting every file.

!l1 Deleting non-empty direetories ( TeIls Directory Opus to ask for confirmation before deleting directories that have items in them. 3.17. OPERATIONS 133

(

Figure3.29: Operations!Delete

IMise. Hags.. ·1 ( [i] Ignore the delete proteetion bit Whendeleting,thissetstheDeleteprotectionbit on all files that donothaveit set.This meansthatthefilesprotectedagainst deletionwill bedeletedanyway.

3.17.4 OPERATIONS/ERROR CHECK

I Enable... I

( [i] DOSrequesters DisablesAmigaDOSrequestersthatwould appearonthe DirectoryOpusscreen(diskis write protected,etc.).Instead,you 134 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

will only seean error messageappearin Directory Opus' status bar.

(

Figure 3.30: Operations/Error Check (

.l.J Opus error requesters CausesDirectory Opus to open its own error requesterwhen an error is encountered.This requestercontains more information than the standardAmigaDOS.

3.17.5 OPERATIONS/GENERAL

IMise. Hags... I ( .l.J Cliek-M-Cliek drag Drags files or directories. To drag a file you must (holding down the left mousebutton) move the mouse to the left or right of the 3.17. OPERATIONS 135

(

Figure 3.31: Operations/General

file. Do NOT move up or down until the selectedfile has "lifted" ( asthis would initiate drag-selecting. You can also pressthe right mousebutton while holding down the left to initiate dragging. If you drop the file in the other directory window it will be the same asclick-m-clicking. If you drop the file on a custom button at the bottom of the screenthat button's action will be performed.

[.tJ Display info Makes Directory Opusbehaveasit did in version 1, by displaying a file's protection bits, datestampand comment in the statusbar. Directory Opus now displays thesein the directory windows, andkeepsa count of selectedfiles, etc. in the statusbar instead. If you prefer the old-style display, turn Display info on. All file information will be displayed in the statusbar asyou ( selectentries,asweIl asin the directory windows. With this turned on, you can usethe Byte Command to view the count of selectedentries. 136 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

[.tJ File double-dick Directory Opus will interrogate a file that is double-clicked on with the left mousebutton, and will perform the default action for that Filetype. (

You may define your own Filetypes, and specify what action is to be performed on them. However, there are also several hard-codedFiletypes. TheseareIFF ILBM pictures andbrushes, icons, fonts, IFF 8SVX sounds,and executableprograms.

If a file doesnot match any of the user-definedFiletypes, it is checked to seeif it is one of the hard-codedtypes. In that case, the default action for theseFiletypes is performed. If a file does not match any Filetypes, user-definedor otherwise, it is treatedas a text file, and loaded into the text viewer. If any ANSI control sequencesaredetected,thesewill be displayed correctly. If the file contains any non-text characters,it will be read in ( hexadecimal format.

[.tJ Window slider aetivate Causesa directory window to becomeactive whenever its sliders or arrow buttons areselected. If this option is not enabled, selecting the sliders or arrow buttons of a directory will not cause it to become active.

3.17.6 OPERATIONS/ICONS

IMise. Hags... I (

[.tJ Createieonswith direetories 3.17. OPERATIONS 137

(

Figure3.32: OperationslIcons

Createsadrawericonwheneveryoucreateadirectorywith the ( MakeDir Command.

[l] Perform all aetions on icons as weil Whateverhappenstoafile will happentothatfile's icon aswell, Forinstance,ifyoudeletethefile DATA,DATA.info (if it exists) will bedeletedtoo. If yourenamethefile FROGto BUFFALO, thenFROG.info(if it exists)will berenamedasBUFFALO.info automatically.

[l] Seleetieons automatieally HassimilarresultstoPerformall actionsoniconsaswell, except thatwheneveryouselectafile, its associated.infofile (if it exists)is alsoselected. (

3.17.7 OPERATIONS/LIST FORMAT 138 CHAPTER3. OPUSCONFIGURATION(CONFIGOPUS)

IFormat oethe list in the I

']T This cycle button specifieswhich directory window you are ( modifying. This allows you to have different list formats in each window, but it doesrequire you to specify the format for each window. If you changethe format (using the buttons described below), and you want it to be the samefor both windows, don't forget to dick on this button and make the corresponding changesto the other window.

(

Figure 3.33: Operations/List Format

• Left window • Right window

IAvailable display items... I (

This list allows you to adddisplay items to the Selected display

,---L.::::JV iterns... list (Figure 3.33 on page 138) by clicking on them. An 3.17. OPERATIONS 139

item eanonly be addedonee,so if you click on an item that is alreadyin the list, nothing will happen. The available display items are: ( • File name • File size • Proteetionbits • Creation date • File eomment • File type

IDisplayedlengthsI

The fields allow you to adjust the width of someof theseitems. The adjustablelengths are: ( 11 • File name

:r=.I File comment

o File type

ISelecteddisplayitems... I

When you seleetan item from the list of Available display items... (Figure 3.33 on page 138) it appearshere. This allows you to specify exactly what to display. When you select an item ( in this list, it placesa check mark next to it. This indicates which item to sort the window list on. Clicking on the checked item unchecksit. If no items are checkedthen the directory window will not be sorted. 140 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

Reset This button eausesthe list to resetto the faetory default settings.

Clear The left mousebutton clears all entries, allowing you to start all over again. ~ The right mousebutton clears the last entry in the list, allowing you to eorreet amistake.

IEntry Separation... I

lJT This eycle button allows you to specify how direetories and files are sorted. ( • Direetories first • Files first • Mix files/direetories

[t.] ReverseSorting This specifies that the list should sort in reverseorder. For instaneeinsteadof A eoming before B, B would eomebefore A.

3.17.8 OPERATIONS/UPDATE ( IWhen processingfiles... I 3.17. OPERATIONS 141

(

Figure 3.34: Operations/Update

[t] Display progress indicator ( Makes Directory Opusopen a progressindicator window when it is processingfiles.

[t] Left-justify filename in status bar Left-justifies filenames in the statusbar rather than centering them asusual.

[t] Scroll directory window to follow operation Causesthe direetory windows to seroll, ensuring the visibility of the current entry being actedupon in an operation. The display is retumed to its original position when the operation is eomplete. ( GZJ Update free disk space Causesthefree spacedisplay in the disk name display at the top of the active direetory window to be updatedwhenever a file is 142 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

eopiedto or deletedfromthedireetory.Otherwise,thedisplayis only updatedattheendof aeompleteoperation.

I Mise. flags... I

.l] Direetory refresh using StartNotifyO 2 Setsup automatienotifieationof theeurrentlyvisible direetories. If thedireetoriesaremodifiedoutsideDireetoryOpus(i.e.,by anotherprogram),DireetoryOpuswill automaticallyre-readthe direetoryto refleettheehanges.

WARNING: While thisfeatureworksin manycireumstanees,the eurrentversionsof 2.xx and3.xx of theoperatingsystemhavea bugpreventingthisfrom beingeompletelyuseful.Currentlythe operatingsystemdoesnotnotify usto all events,butwehaveleft thisoptionin plaeesothanwhenthebugis fixedDireetoryOpus will beready.

[l] Redraw more than a quarter of a page CausesDireetoryOpusto redrawthewindow if youmovemore thanaquarterof apagein eitherdireetion.This flageangreatly speedupmovementthroughdireetories.Ordinarily,if youuse theslidersto movea direetorylessthanaeompletepagein either direetion,thedireetorywindowwill serollonefile at atime. It is only if youmoveaeompletepageor moreatoneethatthe windowwill aetuallyberedrawn.Althoughnot aspleasing aestheticaIly,redrawingis eonsiderablyfaster,especiallyin (..•• high-resolutionmodes. ..

20nly under OS2.0/0S3.0 3.18. SeRBEN 143 3.18 SCREEN

( The Screenconfiguration screenallows you to modify the appearanceof the screento suit your needsand preferences.Requesters conceming the screen'sfeatureswill appearwhen you dick on one of the buttons at the left side of the screen.

(

Figure 3.35: Screen

Arrows Allows you to specify where the arrows on the sliders usedby Directory Opuswill appear.

Colors Allows you to modify the pen colors of almost all the ( componentsof the Directory Opus screen.

Fonts Allows you to specify the fonts usedin different parts of 144 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

DirectoryOpus.

General ( Allows youto specifyvariousoptionsfor thescreen's appearance.

Palette Allows youto setthecolorsof theDirectoryOpusscreen.

Screenmode Allows you to specifythemode,sizeanddepthof theDirectory Opusscreen.

Okay and Cancel ( Theseallow you to sayeither"OK, let's usetheScreensettings andgobackto DirectoryOpus",or "Oops! Forgetall that,and let's getout of here!"

3.18.1 SCREEN/ARROWS

This screenallowsyouto specifywherethearrowson theslidersused by Directory Opuswill appear.Therearethreechoicesfor eachof the threeslidertypes.Youcanalsoadjustthesizeof thearrows.

Theeasiestwayto learnhowto usethisisjust to playwith it. Select theslider typeby clicking on it, or cyclethroughthetypesby clicking ( on the cyclebutton.Theselectedslidertypewill behighlighted. 3.18. SeRBEN 145

(

Figure 3.36: ScreenJArrows

1 Adjust size... 1 ( Thesebuttons allow to adjust the width of the arrows in the selected slider type. You cancertainly make thesehuge if you want.

3.18.2 SCREEN/COLORS

This requesterallows you to modify the pen colors of almost all the componentsof the Directory Opus screen.The number of colors to choosefrom arespecified in SCRBEN/SCRBEN MODE (seepage 151) and the color paletteis specified in SCREEN/PALETIE (see page 150).

A mock-up of the Directory Opus screenis shown, to allow you to ( seethe results of YOUf color changes.To selectthe item you want to modify, either click on it in the example box, or click the cycle button at the top of the screento advanceto the next item. 146 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

(

Figure3.37: Screen/Colors

To modify thecolorsof anitem,usetheForegroundand Backgroundpaletteboxes.NotethatunderOS1.3,youcannotmodify thecolor of someitems.

3.18.3 SCREEN/FONTS

TheScreen/Fontsrequesterallowsyouto specifythefontsusedin differentpartsof DirectoryOpus.Whenthisoptionis selectedforthe very first time,therewill beadelaywhile DirectoryOpuslooksto see which fontsexistin thesystem.

Display item... Theitemsfor which youmayconfigureafont aredisplayedin thislist. Clicking on anitem displaysthecurrentlyselectedfont andsizein theFontandSizelists. Youcanthenusetheseliststo selectthedesiredvaluesfor thedisplayitem. 3.18. seREEN 147

(

Figure3.38: Screen/Fonts

Font. .. This list containsthelist of availablefonts.Theselectedfontfor theDisplayitem is highlighted.Click on a font nameto change theselectedfont.

Size... This list containsthesizesavailablefor thecurrentlyselected font. Theselectedsizeis highlighted.Click on a font sizeto changetheselectedsize.

An exampleofthecurrentlyselectedfontandsizewill bedisplayed belowtheselists. ( SomeDisplayitemS·-S·-cceptnon-proportionalfonts,andothers only accept8-pointfonts.Thelist of availablefontswill changeto filter outunacceptablefonts. 148 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

NotethatunderOS1.3youcannotuseadifferentfont in the Pathnamefield.SettingthePathnametoalargerfont will makethe Pathnamefieldlarger,butunderOS1.3thestringfieldswill still usethe general8point font. (

3.18.4 SCREEN/GENERAL

This requesterallowsyouto specifyvariousoptionsfor thescreen's appearance.

(

Figure3.39: Screen/General

[l] Visible screen title buttons Makestheeloseanddepthbuttonsof thetitIe barvisible on DirectoryOpus'screen. ( [i] Bottom-right tiny buttons Makesthetiny buttonsin thelowerright of DirectoryOpus' screenvisible. 3.18. SeRBEN 149

Ci] Button banks sliders Makes sliders appearbeside the drive and custom button banks. Thesemake it easierto scroll through the banks. ( [i] Indicate button hasRMB function All buttons with Right Mouse button function will have a dog-earedupperright corner.

[i] New-looksllders" The sliders adopt the new style of operating system2.0.

[i] Draggablerequesters All requesterswill have awindow title bar allowing you to move it. (

3.18.5 SCREEN/PALETTE

The Screen/Paletterequesterallows you to set the colors of the Directory Opus screen.A palettebox is displayed, allowing you to select the color to modify. You can changethe color by using the sliders to adjustthe red, green andblue components. You can also enter color values directly, using the string fields.

Presets... There arealso severalpresetcolor palettesavailable, which you ( can seleetjust by clieking. The Resetentry will return the colors to the valuesthey had when you enteredthis section (an Undo

30nly under OS2.0/0S3.0 150 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

Figure 3.40: Screen/Palette

feature, basically). The Directory Opus default entry setsthe default Directory Opus palette. The Workbench default entry hasthe default Workbench colors. The Workbench current entry is the colors currently set on the Workbench screen.The other presetsare different settings which you can experiment with at your own leisure.

3.18.6 SCREEN/SCREENMODE

The Screen/ScreenMode requesterallows you to specify the mode, size and depth of the Directory Opus screen.

Display mode... Contains a list of the available Display modes. Under OS1.3this will contain High Res,High ResLaced, Workbench:Use and Workbench:Clone. Under OS2.0 the modesavailable will vary depending upon the monitors currently active in your system. 3.18. SeRBEN 151

(

Figure 3.41: Screen/ScreenMode

The characteristicsof the selectedDisplay mode are shown at the bottorn of the screen. There aretwo special iterns on the list. .. Workbench: Use CausesDirectory Opus to open a window on the Workbench screen,andnot to open a custorn screen. The width and height of this window are editable, but the number of colors is fixed at the current Workbench depth. Workbench:Clone CausesDirectory Opus to open a screen in the samemode and exactly the samesize asthe Workbench screen.The size of this screenis not editable, but you may modify the number of colors.

:1 11 Width ( This field allows you to specify the screenwidth.

[:zJ Use default When this button contains acheck, the Width field can not be changed. It will, however, display the 152 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

defaultvalueto beused.Whenyou click onthisbutton,it will allow you to changethevaluein theWidth field.

(Whenyou areusingWorkbench:Clone,theUsedefaultbutton ( cannotbedeselected.)

101Height This field allowsyou to specifythescreenHeight.

[lJ Usedefault Whenthisbuttoncontainsacheck,the Heightfield cannot bechanged.Itwill, however,display thedefaultvalueto beused.Whenyoudick on thisbutton, it will allow you to changethevaluein theHeightfield.

(Whenyou areusingWorkbench:Clone,theUsedefaultbutton cannotbedeselected.) ( [:J Colors Dependingupontheselectedscreenmode,thenumberof colors will vary from four to sixteen.Therearescreenmodeswitha maximumof lessthansixteen;if this is thecase,yourselection will belimited.

[i] Half-height screen This causestheDirectoryOpusscreentoopenathalf its normal height,andto bepositionedhalfwaydownthedisplay.With an interlacedscreen,thiswould giveyou ascreenthesizeof a normal(non-interlaced)screen,withthescreenbehindit still partially visible. ThmingontheHalf-heightscreenoptionwill ( not modify thesystem'sscreenheightsetting. 3.19. SYSTEM 153 3.19 SYSTEM

( The Systemconfiguration screenlets you tell Directory Opus how to run severaloperations.

(

Figure 3.42: System

AmigaDOS Allows you to specify how Directory Opus startsup AmigaDOS programs.

Clocks Allows you to specify how Directory Opus displays Clock information. { Directories Allows you to setvarious options for Directory operations. 154 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

Hotkey Allows youto specifytheHotkeyto activateDirectoryOpus.

Ieons Allows you to specifytheIconswhichwill becreatedwiththe iiicAddIcon command.

Modules Allows you to specifypreloadedexternalmodules.

Showpattern Allows youto specifyfilesto beshownor excludedfromthe directorylists.

Startup Allows youto specifyvariousstartupoptions.

View & Play Allows youto configureoptionsfor DirectoryOpus'viewers.

Okay and Caneel Theseallowyou to sayeither"OK, let's usetheScreensettings andgobackto DirectoryOpus",or "Oops! Forgetall that,and let's getout of here!" 3.19. SYSTEM 155

(

Figure 3.43: System/Amigados

3.19.1 SYSTEM/AMIGADOS ( This requesterallows you to specify how Directory Opus starts up AmigaDOS programs.

IRunning AmigaDOSapplications... I

~c Shell This field is the AmigaDOS commandusedto launch programs that haveoutput windows. It defaults to NewCLI. If you wish to usea shell, you could changethe default to NewShell. If you wish to usea WShell, you could changeit to NewWsh. The magnifying-glass button to the left of this field opensa requester ( to help you locate the command you wish to use. 156 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS) 1r::J1 ConsoIe This is the console under which all output windows areopened. It is also usedto open a CU by the NewCU command, andby the Run command when no files areselected. The console allows ( you to specify the size, position and title of the output window. It follows the standardAmigaDOS format, namely:

DEVI CE:LeftEdgeffopEdge/Width/Heightffitle/Options

DEVICE: This is the device you are using. It is normally CON, but under AmigaDOS 1.3 it may be NEWCON (which will open a Shell insteadof a CU). LeftEdge The left edgeof the window (x coordinate, in pixels). TopEdge The top edgeof the window (y coordinate, in (. pixels). . Width The width of the window in pixels. Height The height of the window in pixels. Title The title of the window. Options Somedevices allow you to specify optional parameters(i.e., /Close). The valid parametersvary, so consult the device's documentation for details.

An example is:

CON:20/10/600/180IDirectory Opus Output/Close ( ~c Start-Up Script This is an AmigaDOS batch script that will be performed before Directory Opus launchesany programs. 3.19. SYS1BM 157

I1 JI Priority Main priority allows you to specify the priority at which Directory Opus itself runs. The default priority is 0, which means ( that it peacefully coexistswith everything else. Setting the priority higher meansthat while Directory Opuswill not be slowed down much by other tasks,the performanceof other tasks will suffer. It is suggestedthat you setthe priority no higher than 10.

3.19.2 SYSTEM/CLOCKS

This Requesterallows you to specify how Directory Opus displays Clock information.

(

Figure 3.44: System/Clecks

( IClock/Memory bar ... I

Theseftagstell Directory Opushow to format the clock bar at the 158 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS) bottomof its screen.Youcanincludeanycombinationof theseitems, but in somefontsyoumaynot beableto seeall theitemsselected becausetheirspacemaybelimited.

[tJ Memory monitor Displaystheamountof ChipMemory,FastMemoryandthe TotalMemoryin theclockbar.

[t] CPU monitor DisplaysthepercentageofCPUtime thatis beingused.100% indicatesthatthereis not anyidle time andthatatleastone processisattemptingtorun continuously.

[tJ Date

Displaysthecurrentdatein theclockbar. 4

L:lJ Time Displaysthecurrenttimein theclockbar.

1 Show free spaceaso.. 1

~! Therearetwo groupsof buttonswith thistitle. Oneappliestothe Clock!memorybar,andtheotherappliestotheiconifiedwindow. Theyallow youto specifyhowtheMemoryMonitor, when enabled,will displaymemory.

• Bytes free Displaysall digits(thiscanbehardto readwith large values). 4TheDateFormatis specifiedin OPERATIONS/DATEFORMAT 3.19. SYSTEM 159

• Kilo/Megabytes free Displays value in either kilobytes or megabytesas applicabie. (

IText format. . . I

Ci) There are two groupsof buttons with this titie. One applies to the Clock/memory bar, and the other appliesto the iconified window. They allow you to specify how the titles for the Memory Monitor, when enabled,will be displayed. 5 The choicesare:

• CHIP: and FAST: • C: and F: (

IWhen iconified I

Thesebuttons allow you to specify how Directory Opus should actwhen Iconified. 6 Window The following ftags allow you to specify what is displayed in the window. [t] Memory monitor

Date ( CPU monitor SSeeyourAmigaDOSdocumentationforanexplanationofFastandChipMemory 6In additionto themethodsdescribed,youcanalwaysuniconify DirectoryOpus by pressingtheUniconifykeysequencedefinedin SYSTEM/HOTKEY. 160 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

[l] Time DirectoryOpuswill iconify to a smallwindow on Workbench.If thiswindowis enabled,itslastpositionis savedwhenyou savetheConfigurationfile. (

~ To un-iconify thewindow,simply activateit by clicking on it with theleft mousebuttonandthenpresstheright mouse button. No Window DirectoryOpuswill closeall windows. An AppIcon DirectoryOpuswill openaniconon WorkBench.Simplydoubledick ontheicontouniconifyit.

3.19.3 SYSTEM/DIRECTORIES

This requesterallowsyou to setvariousoptionsfor Directory operations. (

( Figure3.45: Systern/Directories 3.19. SYSTEM 161

IDirectory caches... I

( l:JI Butlers per window Allows youto specifythenumberof buffersto beallocatedto eachdirectorywindow. Youcanhaveanyvaluefrom oneto 255.

[t] A1waysmoveto empty butTer CausesDirectoryOpusto useanemptybuffer (if possible) wheneveranewdirectoryis read.A newdirectoryis read wheneveryouenterapathin thedirectoryfields,double-dick or click-m-clickon adirectoryname,or selectadrivebutton.

[t] Re-readchangedor incompletebuffers Whenabuffereddirectoryis shown,thiswill makeDirectory ( Opuscheckthedirectoryondiskto seeif it haschanged.If it has,thiswill causeare-readof thedirectory.Also, if theoriginal readingof adirectorywasinterruptedit will bere-readin.

ISearchbutlers on. . . I

ll] Parent/Rootoperation Thisoptioncausesthedirectorybuffersto besearchedforthe parentorrootdirectoryof thecurrentdirectory,wheneverthe Parentor Root Commandsarechosen.If theparentor root directoryexistsin abuffer(i.e.,it hasalreadybeenread),the ( buffereddirectoryis retrievedfrom memory.This cansavealot of needlessdiskaccess. 162 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

LtJ Double-cllck/Click-m-cllck direetory read When a directory is selectedvia Double-Click or Click-rn-click this will causeDirectory Opus to searchthe buffered directories first.

I Mise. Hags.. . I

Lt.J Auto diskehange CausesDirectory Opus to sensedisk changesin any drive. If you have the root directory open in either of the directory windows when you changethe disk, then the new disk will be read automatically. This allows you to scanthrough different disks without having to follow the usual selection procedure.

Lt.J Auto disk load This option works in a similar fashion to Auto diskchange, except that it detectsany disk being inserted,not just thosedisks currently displayed. If you insert a disk in a floppy drive with this option turned on, you will be askedwhether you wish to read the disk into the left or the right window.

Lt.J Expand pathnames This flag will causea11pathsto be expandedto their full pathnames.For example, if this flag was enabledand you entered S: in the directory field, the namemight be expandedto Workbench1.3:s/. It will also do this when you select a drive button. For instance,if you selecteda drive button marked DFO:, the actual nameof the disk would be inserted in the directory field. 3.19. SYSTEM 163

You should note that asthe Expand pathnamesfiag causesthe actualvolume name of disks to be used,the system(and you) may get confusedwhen using two disks with the samename. As ( a rule, you should avoid using identically-narned disks at the sametime.

ctJ UseExAll( ) 7 If selected,Directory Opuswill usethe ExAll( ) function to read directories, rather than the old Examine( )/ExNext() combination. ExAllO can be slightly faster than the old method. WARNING: Operating systems2.x and3.x currently have a bug that causesthem to skip directory entries when using ExAll( ) on certain devices. Somedevicesto watch out for include: CDRom, ParNet andNetworks. If you have problems, simply turn off this option. ( IShow free spaceaso.. I

(i1. Theseallow you to choosehow to measurethe free spacethat is displayed alongsidethe disk name.

• Bytes free Displays the number of free bytes. • Kilo/Megabytes free Displays the amount of free spacein either kilobytes or megabytes(dependingupon the size). ( • Blocks free Displays the number of blocks free (aswill also be shown by the AmigaDOS Info command).

70nly under OS2.0/0S3.0 164 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

• Percentage of spacefree Displays the free spaceasa percentageof the total size.

( 3.19.4 SYSTEM/HOTKEY

This requesterallows you to specify the Directory Opus activate Hotkey.

(

Figure 3.46: System!Hotkey

IUniconify/activate Hotkey I

This hotkey is really a combination of keys that you pressto do one of four things: ( • If Directory Opus is iconified, it will be uniconified.

• If the Directory Opus screenis open, but at the back of the display, it will be brought to the front. 3.19. SYSTEM 165

• If the screenhasbeenpulled down using the screendrag bar, it will be brought to the top.

• If the screenis already at the front of the display, it will be moved ( to the back.

Sampie To modify the Hotkey, select the Samplebutton at the right of the Hotkey field. While the Samplebutton is selected,any keys that you press,alongwith any qualifiers, will be insertedin the hotkey field. To turn off samplemode, select the Samplebutton again. To remove the Hotkey simply selectthe Samplebutton with the right mousebutton. The default Hotkeys are CONTROL + LSHIFT + LALT, meaning that pressingthe control key, the left shift key and the ( left Alt keys togetherwill perform the action. 11 Usemiddle mousebutton With this ftag turned on Directory Opus will also usethe middle mousebutton asweIl asthe Hotkey defined above.

3.19.5 SYSTEM/ICONS

This requesterallows you to specify the leons whieh will be ereated with the AddIcon Command.

( Addlcon's icons... This list includes threebuilt-in icon types: Drawer, Tool and Projeet. In addition, eachof the filetypes is included in this list. This systemallows you to specify your own ieons to usewith the 166 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

(

Figure 3.47: System/Icons

Addlcon Command if you do not like the default icons. Simply select the type of icon you want to change(e.g., drawer, too1, etc.), and its current icon will appearin the lower right corner. You may changethe icon by modifying the field directly below the list. The magnifying-glass button is provided to allow you to find the icon you want easily. Under OSl.3 we provide somebuilt-in icon imagesbut under OS2.0 we use the systemstandardimages.

~c Project's Default Tool. .. Allows you to modify the Default Tool of project icons added with the AddIcon Command. This only works with the built-in project icon or the default Workbench project icon; not with user-supplied icons. For example, you may setthe Default Tool to c:FullView. Then, whenever you double-dick from Workbench on an icon that you have addedto a project, FullView will be invoked. 3.19. SYSTEM 167

3.19.6 SYSTEM/MODULES

An external module is a small program which Directory Opus runs to ( perform infrequent operations. By making them external, they do not have to be in memory at all times. If you arenot concernedwith their memory usageand you don't want Directory Opus to load them each time you usethem, this requesterallows you to specify which modules you want to be preloaded.

(

Figure 3.48: System/Modules

External Supportmodules... Lists all external modules supportedby Directory Opus. If you want a module to be preloaded,select it and a checkmark will appear.Selectit again if you do not want it preloaded. Preloaded modulestake lesstime to start up but useadditional RAM.

Language... Allows you to select a languagefor Directory Opus. By default, Directory Opususesthe built-in English language,but asother 168 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

languagesbeeomeavailabletheywill appearhere.To seleetone for use,simplyclick onit.

( 3.19.7 SYSTEM/SHOW PATTERN

This requesterallowsyouto specifyfiles to showor excludefromthe direetorylists.

(

Figure3.49: System/Showpattern

I Directory list pattern... I

1] Hide fileswith hidden bit set TeIlsDireetoryOpusto takenoticeof theH bit; anyfilesthat ( havethis proteetionbit setwill notbedisplayed. 3.19. SYSTEM 169

D Show Allows awildcardpatternagainstwhichall files arechecked.If thefile matchesthispattern,it is displayed. ( D Hide Allows awildcardpatternagainstwhichall files arechecked.If thefile matchesthispattern,it is notdisplayed.

3.19.8 SYSTEM/STARTUP

This requesterallowsyouto specifyvariousstartupoptions.

(

Figure3.50: System/Startup

(IDirectories to read on startup ... I

Thesefieldsallowsyouto specifythepathnameof a directorythat is loadedautomaticallyintotheleft or right window whenever 170 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

Directory Opus starts. The magnifying-glass button to the left of these fields opens a directory requesterto help you Iocate the path you require.

~c Left This Field specifiesthe startup directory for the Left window.

~c Right This Field specifiesthe startup directory for the Right window.

IARexx scripts to executeon. . . I

These allow you to specify the namesof two ARexx scripts that are automatically run when Directory Opus starts (Startup), or when it returns from an iconified state(Uniconify).

~c Startup This ARexx script is executedwhen Directory Opusfirst starts up.

~c Uniconify The Uniconify ARexx script is executedwhen Directory Opusis uniconified.

~c efg return This ARexx script is executedwhen Directory Opusreturns from the ConfigOpus utility. 3.19. SYSTEM 171

3.19.9 SYSTEM/VIEW & PLAY

This requesterallowsyouto configureoptionsfor DirectoryOpus' ( viewers.

( Figure3.51: System/View& Play

IPicture/animation viewer (lFF ILBM! ANIM) I

[iJ Black background between pictures Thisflagcausesablankscreentobedisplayedwhileeachpicture is loading.Otherwise,theDirectoryOpusscreenwill be displayedinbetweeneachpicture.

( [iJ Start animation paused Makesanimationscomeuppaused.Thisis particularlyuseful whenananimationissimplyacollectionof picturesandnot reallyananimation. 172 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS)

Cl] 8-bits per gun color This teIlsDirectoryOpusto treatthecolor informationin IFF ILBMs ashaving8bits pergun. Picturesthathave4 bitspergun, pre-AGA,areshownalittle dimmerthanusual. (

;1 11 Showdelay Allows youto showpicturesasa simpleslideshow.If setto 0, pictureswill wait for youto presstheleft mousebuttonbefore continuing.On othersettings,thepictureswill continueto displayoneaftertheotherfor thespecifiedtimein seconds.

11... .. I Fadedelay Allows you to configurethespeedatwhichpicturesfadein and out. If it is setto 0, therewill benofadingatall. Thedefaultis 2; themaximumis 10. Thevalue,by theway,indicatesin60ths (50thsonPAL) of asecondthetimebetweeneachchangein color.

ISoundplayer (lFF 8SVX)... I

Cl] TUrn audio filter off for play Causesthehigh-passaudiofilter to betumedoff while eachIFF 8SVX soundfile is played.NotethatonA1000stheaudiofilter maynotbesoftware-selectable.

..tJ Loop on double-dick TeIlsDirectoryOpusto behaveasit did in version3.4. In that version,whenyou doubleclickedon sounds,theyplayedin a ( loopedfashion.Underversion4.0thesoundisplayedonlyonce. •.

80nly when using OS3.0and AGA 3.19. SYSTEM 173

IText viewer. . . I

( :tJ Text viewer borders TellstheTextviewerto haveasliderandfancierborders.Note thatwith thefancierbordersandslidersyoumaynotbeableto readtextfilesthatare80charactersunlessyouuseasmallerfont or wider screen.

[l] Tab size Allows youto specifythenumberof spacestowhich atab characterisequivalentintheAnsiReadCommand.Thedefault is 8, which is alsotheANSI standard.

(

( 174 CHAPTER 3. OPUSCONFIGURATION(CONFIGOPUS) ( Chapter4

Commands

This chapterlists the Directory Opus commandsin alphabetical order. Let's begin with an example of an entry's layout, with its component parts explained asthey occur:

CommandARexx only

The nameof the command comesfirst. If it is followed by the words 'ARexx only' it meansthat it is a command that can only be called from anotherprogram by using the ARexx intercommunication language. Otherwise, a command can be usedboth in a button (menu, hotkey or filtype) and asan ARexx command.

CommandThis is the syntax of the command. Elements in square bracketsare optional.

Below the syntax, its elementsare explained in turn.

( If necessary,therewill follow notespertaining to the use of the particular command.

All Directory Opuscommandswhen called from ARexx respond

175 176 CHAPTER4. COMMANDS with two variables: RC (the error statuscode) and Result. RC will always be an integer value indicating the severity of an error, 0 being no error. Result will indicate successor failure of the command, usually expressedasan integer value, or it may be data, suchasthe ( nameof a file.

AbortPrint

AbortPrint

Abort thecurrentprint process.

ARexx Results: RC= 0 Result = 0 nothingwasprinting, 1somethingwasprintingbut is nowaborted (

About

About

This commanddisplayscopyrightinformationandmailingaddresses.

ARexx Results: RC= 0 Result = undefined ( 177

ARexxOnly AddCustEntry ( AddCustEntry text [userdata] [fgpen] [bgpen] [selectable] [show] [before]

text is the text for the entry, and may be up to 256 characterslong. The dimensions of the horizontal slider are adjusted automatically to the longest entry.

userdata optional; user datafor this entry. This is not displayed but can be retrieved, defaults to nothing.

fgpen optional; pen color to display entry in or -1 for default file color, defaults to -l.

bgpen optional; background color of entry or -1 for default file background color, defaults to -I. selectable optional; indicates if entry is selectable(0 = not selectableor 1 ( = selectable),defaults to l. show optional; boolean to update directory display (0 = do not update, 1 = update), defaults to O. before optional; ordinal entry number before which to add this entry. A 0 addsthe entry to the beginning of the list; -1 addsat the end of the list, defaults to -1.

This is similar to the AddFile command, but allows for entries of up to 256 characters.Entries addedwith this command are completely user-defined, This commandwill fail if there are any normal entries already in the active window, so you should always call ClearWin before using it. By default, entries are not sorted in any way; the most recent entry will be shown asthe last. ( ARexx Results: RC= 0 ResuIt = 0 or 1 to indicate failure or success. 178 CHAPTER4. COMMANDS

ARe"" OnIy AddCustHandler (

AddCustHandler portname[win]

portname nameof handler'smessageport

win optional;window to addacustomhandierto (-1 = currentwindow,0 = Ieft or 1 = right) defaultsto -1.

This commandwill attachanARexxportnametothecurrentdirectory buffer. Whenyoumanipulatethebuffer's entries,DirectoryOpuswill pass messagestothespecifiedportname.Thiscommandisonly usedwith buffers createdusingAddCustEntry.CurrentIytheonly two actionssupportedare DoubIe-ClickandClick-M-Click. As anexample,thissystemcouldbeused to createaphonebooksystemor a NetWorkmanagerwithDirectoryOpus.

ARexx Results: RC= 0 Result = nameof old handler'smessageport(if therewasone)

( 179

AddFile ARexxOnly

AddFile namesizetypesecondscommentprotectionreservedshow

name nameof entry

size sizein bytesof entry

type typeof entry(-1 = file or 1 = dir)

secondsdatestampoffile, secondsfromJan1, 1978(datethat AmigaDOSconsidersthebeginningof time)

commentfile comment

( protection protectionbitsin ASCII form. 'RW' would meanReadable andWritable.

reservedreserved,mustbe 0 for now

show updatedirectorydisplayboolean

This commandaddsafile or directoryentryto theactivedirectory window.

ARexx Results: Re= 0 Result= Oor 1to indicatefailureor success.

( 180 CHAPTER4. COMMANDS

Addlcon ( AddIcon [name] name optional;nameof file This will addiconsto all selectedfilesanddirectoriesin theactive directorywindow. DirectoryOpusautomaticallysenseswhatsortof file it is (drawer,project,tool, etc.) andwill addtheappropriateicon.UnderOS2.0, however,weusetheWorkbenchdefaulticons.YoumayspecifyYOUf own iconsin theConfigOpusif thedefaulticonsarenot suitable.Youmayalso specifytheDefaultTool to beusedfor projecticons.If thenameisnotgiven, it will usethefirst availableselecteditemin thecurrentdirectorywindow. ARexx Results: RC= ° Result = undefined

Alarm

Alarm This commandwill soundanalarmonbothor eitherof thesound channels.Youcouldusethiscommandtowarnpeoplethattheyhaveselected a dangerouscommand.Forinstance,youcouldmodify theDELETEbutton to read: Command Alarm Command Delete

ARexx Results: ( RC= ° Result = undefined 181

All (

All

This commandselectsallfilesanddirectoriesin theactivedirectory window.

ARexx Results: RC= 0 Result= undefined

AnsiRead

AnsiRead [name]

name optional;nameof file

This commandoperatesinexactlythesamewayastheREAD command, exceptthatit displaysANSIcontrolsequences(colorsandtypestyles) properly,andalsohandlestabcharacterscorrectly.If thenameis not givenit will usethefirst availableselecteditemin thecurrentdirectorywindow.

ARexx Results: RC= 0 ( Result= undefined 182 CHAPTER4. COMMANDS

ARexx

ARexx [command]

commandoptional;commandtoexecute

This allowsyou to launchanARexx scriptor executeanyDirectoryOpus ARexx commandfromwithin DirectoryOpus.If thecommandisnotgivena requesterwill openaskingtheuserfor one.

ARexx Results: Re= 0 Result = undefined

Assign

Assign [name]

name optional;nameto assign

This commandallowsyouto assignalogical devicenametothecurrently activedirectory.The C: deviceis anexampleof a logicaldevice;it is not a physicaldisk itself, but is a directorythathasbeenassignedthenameC :. For example,asimplenamesuchasText: canbeassignedtoa longand complicatedpathnamesuchas:

DHO:Projects/Work/1989/April/Bits&Pieces/Text 183

Fromthenon,wheneveryouenterText: into adirectorybutton,youwill gostraightto thedirectoryattheendof theassignedpath,insteadof havingto gothroughall thesub-directoriesontheway. Youcanusetheassignmentin ( anyotherprogramasweIl. Logicaldevicesalwaysendwith a colon. Assignalsoallowsyouto cancelapreviouslyassignedlogicaldevice,or reassignadeviceto anotherdirectory.Todothis,presstheright mousebutton overtheS (seleet)buttonto activatetheGetDevicescommand.Seleetthe assigneddevice(s)youwish to change,andinvoketheAssigncommand.A requesterwillappear,intowhich you cantypethenewpathnametobe assignedeachdevicename.If youenterablankstring,thatlogicaldevicewill beunassigned. /dangerparWarning,ifmultiplelogicaldevicesareselectedthentheywill beunassignedaswell andyouwill bepromptedfor anewpathnamefor each selecteddevice.

ARexx Results: Re= 0 Result = undefined (

Beep

Beep

This commandwill soundabeeponbothor eitherof thesoundchannels. Youcouldusethiscommandtosignify thatacommandhasfinished.For instance,youcouldmodify theDiskcopyoptionto read:

Command DiskCopy Command Beep ( In versionsof theoperatingsystemlaterthan38 (2.1)thiscommandwill call thesystembeeproutine.Underearlierversionsit will sounditsownbeep.

ARexx Results: 184 CHAP1ER4. COMMANDS

Re= 0 Result = undefined

------( BufferList

BufferList [win]

win optional; window to seanthe buffer list into (-1 = eurrent window, 0 = left or 1 = right) defaults to -1.

This eommand displays a list of all the buffered direetories. You may then double-dick on one of the displayed buffers to jump to that buffer immediately, rather than clicking the arrows to cycle through the buffers one by one. ARexx Results: ( Re= 0 Result = undefined

ARexxOnly Busy

Busy [on Ioff]

on Ioff optional; adjust the busy pointer, defaults to on.

This eommand turns on or off the busy pointer. ARexx Results: ( Re= 0 Result = undefined 185

Buttonlconify (

ButtonIconify [rows][bank]

rows optional;numberof buttonrows. This canbe 1,2, 3 or 6. Defaultsto whateverDirectoryOpusis setto.

bank optional;banknumberto displayinitially, defaultsto 1.

This causesDirectoryOpusto openawindow on Workbenchcontaining theCustomButtons.For moredetailsseepage49 ARexx Results: RC= 0 Result= undefined (

CD

CD [path]

path optional;newcurrentdirectorypath,if pathnot givenarequesterwillopen.

This commandallowsyou to setthecurrentworking directoryfor DirectoryOpus.Thisis thedirectorythatis readif youpressreturnon an emptydirectorybutton. ( ARexx Results: RC= 0 Result= undefined 186 CHAPTER4. COMMANDS

ARe"" Only CheckAbort (

CheckAbort

This commandallowsyouto monitor,from anARexx script,whetherthe userhaspressedtheleft andright mousebuttonstogether(toabort).It also resetstheAbort flageverytime it is called.If youplanto usetheCheckAbort command,youshouldcall CheckAbortatthestartof thescript(to resetthe Abort flag),beforeactuallyusingit to checktheabortstatus.

ARcxx Results: RC= 0 Result= 0 if abortsequencehasnotbeenhit, 1 if it has

CheckFit

CheckFit [win]

win optional;windowto aCheckFiton (-1 = currentwindow,0 = left or 1 = right) defaultsto -1.

This worksin thesamewayasGetSizesdoesexceptthatits calculationis basedondiskblock sizes,andis thereforemuchmoreaccurate. The disadvantagetoCheckFitis thatit needstorecalculateeverytimethe ( destination'sblocksizechanges.Therefore,evenif all sourcedirectories alreadyhavetheir sizesshown,CheckFitmayneedtoscanthemall again. OperationslikeCopy,etc.,thatgeneratedirectorysizes,arenot suitablefor CheckFit,andsoagainCheckFitwill needto scanall selecteddirectories. 187

CheckFitdisplaysthetotal numberof bytesneededandthenumberof bytesfree(i.e.,block numbersmultipliedby theblock size),andthe percentageoffilesthatwill actuallyfit. If theywill all fit, it shows100%,if only half of themwill fit, it shows50%. TheGetSizescommandisretainedasit canbeusedquickly to providea roughguide.CheckFitcancompletelyreplacetheGetSizescommandif you don't mindit havingto rescandirectorieswhenyoumight not haveexpected it. ARexx Results: RC= 0 Result= undefined

ClearBuffers

( ClearBuffers

This commandwill clearthecontentsofall thedirectorybuffersother thanthetwo thatarecurrentlydisplayed.All unusedmemorywill be de-allocated.Thisis agoodwayto freememoryquickly if you havelots of usedbuffersandarerunningabit low on memory. ARexx Results: RC= 0 Result= undefined

ClearSizes ( ClearSizes [win]

win optional;windowto clearthesizesfrom 188 CHAPTER4.COM~S

(-1 = currentwindow,0 = left or 1 = right) defaultsto -1.

If a directory'ssizeis alreadydisplayed,thenthedirectorywill notbe ( re-scannedwhenselectednortheGetSizescommandinvoked.Thiscould meanthatthedirectorysizeis inaccurate,especiallyif anyfileshavebeen createdordeletedin it by anotherprogram.Selectingoneor moredirectories, andthenselectingtheClearSizescommand,will causethedirectorysizesto disappear.Youcanthenreselectthedirectories,invoketheGetSizes command,andthedirectorieswill bere-scannedandtheirupdatedsizes displayed.

ARexx Results: RC= 0 Result = undefined

( ClearWin

ClearWin [win]

win optional;window to clear (-1 = currentwindow,0 = left or 1 = right) defaultsto -1.

This commandwill clearthecontentsofa directorywindow.

ARexx Results: RC= 0 Result = undefined ( 189

Clone (

Clone [name][newname]

name optional;file name

newname optional;newfile name

This commanda1lowsyouto makea copyof selectedentriesin thesame directory,andrenamethem.A requesterwill appearforeachentry,askingfor thenewname. This canalsowork with a specifiedfile. If a newnameis not giventhena requesterwill appear.

ARexx Results: ( RC= 0 Result= undefined

Comment

Comment [name][comment]

name optional;file name

commentoptional;commentstring

( This commandallowsyou to changethecomment,orfilenote,of the selectedfilesanddirectoriesintheactivedirectorywindow. Whendirectories areselected,youareaskedwhetherthefiles within themareto havetheir commentsmodifiedalso. 190 CHAPTER4. COM~VVVDS

For eachentry,you arepresentedwitha requestercontainingits current comment.To changethecomment,editit andpressreturn.To retainthe comment,justpressreturn. To setthecommentof all selectedentriesyoushouldselecttheAll button ( from thecommentrequester;choosingOkayor pressingreturnwill setthe ••• commentsonefile at atime. ARexx Results: RC= 0 Result = undefined

Configure

Configure

Simply startsuptheconfigurationprogram. ARexx Results: RC= 0 Result = undefined

ContST

ContST

If thereis asongpaused,thenit startsit playingagain. ARexx Results: RC= 0 Result = undefined 191

Copy ( Copy [name][destination] name optional;file name destinationoptional;destinationdirectory This commandcopiesall selectedfilesanddirectoriesin theactive directorywindow to theinactivedirectorywindow,keepingthesamenames. If a filenameisgiventhenonly thatfile will becopied,but you mayalso specifyadestinationdirectory. ARexx Results: RC= 0 Result= undefined

CopyAs

CopyAs [name][newname] name optional;file name newname optional;newfile name This commandcopiesall selectedfilesanddirectoriesin theactive directorywindowto theinactivedirectorywindow,andallowsyouto specify a newnamefor eachfile or directory.If afilenameisgiven,thenonly thatfile will be copied. ( ARexx Results: RC= 0 Result= undefined 192 CHAPTER4.COM~S

CopyWindow (

CopyWindow [win]

win optional;window to copyfrom (-1 = currentwindow,0 = left or 1 = right) defaultsto -1.

This will copythecontentsofaspecifiedwindowor thecurrentwindow into theotherwindow.

ARexx Results: RC= 0 Result = undefined (

DateStamp

DateStamp [name][date]

name optional;file name

date optional;dateto set

This commandallowsyou to changethedatestampofselectedfilesand directoriesin theactivedirectorywindow.Whendirectoriesareselected,you areaskedwhetheryoualsowishthefileswithin themto havetheirdatestamps(' modified. ' For eachentry,you arepresentedwitharequester.If youwish thefile to haveits datestampsetto thecurrentdateandtime,simplypressreturn. Otherwise,enterthedesireddateandtime. 193

Tosetthedatestampofall seleetedentriesyoushouldseleettheAll buttonfrom thedatestamprequester;ehoosingOkaywill setthedatestampsa file ata time. ( ARexx Results: Re= 0 Result = undefined

Defaults

Defaults This eausesDireetoryOpusto resetto thehard-coded,default eonfiguration.If youhavemodifiedtheeonfigurationyourself,andhavenot yetsavedit, you areaskedif youwishto saveit first. ( ARexx Results: Re= 0 Result= undefined

Delete

Delete [name] name optional;filename This will deleteall seleetedentriesorjust thespecifiedfile in theaetive direetorywindow.Beearefulwith this, asit is easyto wipe out valuabledata. ( ARexx Results: Re= 0 Result= undefined 194 CHAPTER4. COMMANDS

DirTree ( DirTree [win] win optional;window to createadirectorytreein (-1 = currentwindow,0 = left or 1 = right) defaultsto -1. This commandwill mapout adirectorytreein theactivedirectory window,or a specifiedwindow. ARexx Results: RC= 0 Result = undefined

DiskCopy

DiskCopy [source]destination[verlty] [bump] source optional;sourcedisk destinationsdestinationdisk verity optional;diskcopywith verify on

bump optional;bumptherevisionof thedisk name,aswith Workbench This commandwill diskcopyfrom sourcetodestination,withVerify tumedon if theVerify keywordis specified.If no sourceordestinationare specified,thediskcopyrequesterisopened.If theBumpkeywordis given ( thenDirectoryOpuswill bumptherevision(Copy_oLDiskName)ofthedisk nameasWorkbenchdoes. ARexx Results: 195

RC= 0 Result= undefined

(

DiskCopyBG

DiskCopyBG sameasDiskCopy

This commandwill executediskcopyin backgroundmode.This allows youto startup adiskcopyandstill useDirectoryOpus.

ARexx Results: RC= 0 Result= undefined

DiskInfo

DiskInfo [path]

path optional;pathof adisk to getinfo about

This commanddisplayssomeinformationaboutthedisk theactive directoryresideson,includingspaceusedandfree,datestampandnumberof errorsonthedisk.

ARexx ResuIts: ( RC= 0 Result= undefined 196 CHAPTER4. COMMANDS

DisplayDir (

DisplayDir [win]

win optional;window to refresh (-1 = currentwindow,0 = left or 1 = right) defaultsto -1.

This commandwill updatethedisplayfor theactivedirectorywindow or thespecifiedwindow.

ARexx Results: RC= 0 Result = undefined (

DOpusToBack

DOpusThBack

Move theDirectoryOpusscreentotheback

ARexx Results: RC= 0 Result = undefined 197

DOpusToFront ( DOpusToFront MovetheDirectoryOpusscreentothefront ARexx Results: RC= 0 Result = undefined

Encrypt

Encrypt [name][password] ( name optional;file name password optional;passwordtouse Haveyoueverhadfilesthatyouwantedto encryptsothatonly people whoknewthepasswordcouldunderstandthem?This commandallowsyou to dojust that. It will encryptall selectedfiles,usinga passwordthatyou enter,with acomplexalgorithmthatmostpeoplewill find impossibletowork out. Theresultingfilesarenotwritten overtheoriginals,but areinstead writtento thedestinationdirectory.Theywill bethesamesizeastheoriginal files,soyoucanensureyouhaveenoughroomin thedestinationdirectory. To decryptapreviouslyencryptedfile,youshouldenterthesame passwordprecededbya minussign. For example,todecryptfilesyou encryptedwiththepasswordFOO,selectthefiles,choosetheencrypt commandandenter-FOOasthepassword. ( ARexx Results: RC= 0 Result = undefined 198 CHAPTER4.COM~S

ErrorHelp ( ErrorHelp [code]

code optional;errorcode

This commandgivesyou moreinformationaboutDOSerrorcodesthanis generallyavailable.Whenyouselectthisoption,you areaskedfortheDOS errorcodeyou wanthelpwith. ExamplesofDOSerrorcodesare123,205 and225. Youarethenpresentedwitha descriptionof thaterrorand informationpertainingto thepossiblecauseandeureof theerror.

ARexx Results: RC= 0 Result = undefined (

Execute

Execute [filename]

filename optional;nameof a file to executeasabatchfile

This commandwill attemptto executeeachselectedfilein turnor to executeaspecificfile asabatchfile. This hasthesameeffectasif youhad runthebatchfile via IconX,or via theExecutecommandfromtheCLI.

ARexx Results: RC= 0 Result = undefined 199

FileInfo AR.""Only (

Fileinfo name[separator][win]

name nameof file to give info for (mustbein theactiveor specified window)

separator optional;characterusedto separateinfo

win optional;window to getfile from (-1 = currentwindow,0 = left or 1 = right) defaultsto-1.

This commandreturnsinformationon theentrycalledname(whichmust bein theactivedirectorywindow). Theinformationreturnedisseparatedbya ( separator(defaultseparatorisspace),andconsistsof thefilename,thesizein bytes,thesizein blocks(notusedyet),thefile type(lessthan0 indicatesa file, greaterthan0 indicatesadirectory),theselectedstatus(boolean),the date(days),thedate(seconds),thecommentandtheprotectionbits. Thedateis returnedasa numberof dayssinceJanuary1st,1978,andas thenumberof secondssincemidnight.Theprotectionbitsarereturnedin the formatHSPARWED(witha- characterwherethebit is notset).

ARexx Results: Re= 0 ResuJt = informationaboutthefile

( 200 CHAPTER4. COMMANDS

Flnishßection• • • Internal OnIy (

FinishSection

TheFinishSectioncommandforcesanyprecedingprograms(AmigaDOS, Workbench,Batchor ARexx) to executingbeforecarryingon to thenext command.Thenextcommandneednotbe a DirectoryOpuscommand;itis just morelikely thatit will be. For instance,toaddabeeptotheendof theLHArc list filetypecommand, you would changethecommandlistto read:

AmigaDOS LHArc v {f} Command FinishSection Command Beep ( ARexx Results: Re= 0 Result = undefined 201

Format ( Format [drive] [verltv] [quick] [nolcons] [ffs] [inter] [cache]

drive optional;driveto format verify optional;formatwith verify on quick optional;quickformat nolcons optional;formatwith no icons ffs optional;formatfastfile system inter optional;formatin internationalmode! cache optional;formatin directorycachingmode/ This allowsyouto formatanewdisk. All newdisksneedto beformatted ( beforethecomputercanwrite to them. TheVerify fiagallowsyouto turnVerify on or off. If Verify is turnedoff, theformatprocesswill bemuchfaster,butyouwill notbemadeawareof any errorsthatoccur.If you don't completelytrustyourdisks,leaveVerify on. TheFFSoptionin Formatallowsyou to formatadiskto usetheFast Filing Systemof Kickstart2.0. If you arerunninga Kickstartlessthan2.0, youwill still beableto selectthisoptionto formatadisk. However,reading FFS-formatteddisksis impossiblewithout2.0or greater. Internationalmodeallowsfile anddirectorynamestoincludeaccented characters.Directorycachingmodewill decreasethecapacityof yourdisk but thedirectoryreadingspeedwill bemuchgreater. ARexx Results: Re= 0 ( Result= undefined

lavailablein OS2.1 2availablein OS3.0 202 CHAPTER4.COMMANDS

FormatBG (

FonnatBG sameasFormat

This commandwill executeformatin backgroundmode.This allowsyou to startup a diskcopyandstill useDirectoryOpus.

ARexx Results: RC= 0 Result = undefined

GetAll ARen OnIy

GetAII [separator][win]

separator optional;characterusedto separatenames

win optional;window to getnamesfrom (-1 = currentwindow,0 = left or 1 = right) defaultsto -1.

This commandreturns,in theRESULTvariable,thenamesofall entries in theactivedirectorywindow. If separatorisspecified,thenamesare separatedbyaseparator.Thedefaultseparatorisaspace.Youshouldbe preparedtohandlealong string. ARexx Results: ( RC= 0 Result = all theentries 203

GetDevices ( GetDevices [win]

win optional;window to putdevieelist into (-1 = eurrentwindow,0 = left or 1 = right) defaultsto -1.

This eommanddisplaysalist of all devices,volumesandassigned direetoriespresentinthesystem.Youmaythenreadin thesedevieesby double-cliekingonthem.Youeanalsoseleetentiredevicesforusewith the Hunt andSearcheommands. ARexx Results: Re= 0 Result= undefined (

ARexxOnly GetDirs

GetDirs [separator][win]

separator optional;eharaeterusedto separatedireetorynames

win optional;window to getdireetorynamesfrom (-1 = eurrentwindow,0 = left or 1 = right) defaultsto -1.

This eommandreturns,in theRESULTvariable,thenamesofall ( direetoriesintheaetivedirectorywindow.If separatorisspecified,thenames areseparatedbyaseparator.Thedefaultseparatorisaspaee.Youshouldbe preparedtohandlealong string. ARexx Results: 204 CHAPTER4. COMMANDS

Re= 0 Result = all thedirectoryentries

(

AR.xxOnly GetEntry

GetEntry num

num theentrynumberwhosenameis to bereturned

Returnsthefile or directorynameof entrynumber"num". ARexx Results: Re= 0 Result = nameof thespecifiedentry

AR.xxOnly GetFileType

GetFile1)'pe filename[type]

filename file whosefiletypeis to bereturned

type optional;form of filetypeID (0 = file dassdescriptionor1 = file dassID), defaultsto 0

Returnsthefiletype(if recognized)ofthespecifiedfile. ARexx Results: Re= 0 ( Result = filetypeID of thefile if filetypeis known 205

ARe", Only GetFiles ( GetFiles [separator][win]

separator optional;characterusedto separatefilenames

win optional;window to getfilenamesfrom (-1 = currentwindow,0 = left or 1 = right) defaultsto -1.

This commandreturns,in theRESULTvariable,thenamesof all files in theactivedirectorywindow. If separatorisspecified,thenamesareseparated by aseparator.Thedefaultseparatorisaspace.Youshouldbepreparedto handlealongstring. ARexx Results: ( Re= 0 Result= all thefile entries

ARexxOnly GetNextSelected

GetNextSelected[win]

win optional;windowto getnextselecteditemfrom (-1 = currentwindow,0 = left or 1 = right) defaultsto -1.

Thiscommandreturnsthenameof thefirst selectedentry(in theRESULT ( variable)in theactivedirectorywindow.Theentryis NOT deselected afterwardssoif youdon't deselectit yourself,thatis theonly nameyouwill evergetreturned. ARexx Results: 206 CHAPTER4. COMMANDS

Re= 0 Result = name of the entry

ARexx Only GetSelectedAlI

GetSelectedAll [separator] [win]

separator optional; characterusedto separatenames

win optional; window to get namesfrom (-1 = current window, 0 = left or 1 = right) defaults to -1.

This command returns, in the RESULT variable, the namesof all selected entries in the active directory window. If separator is specified, the namesare separatedby aseparator. The default separatoris aspace. You should be prepared to handle a long string.

ARexx Results: Re= 0 Result = all the selectedentries

ARexx Dnly GetSelectedDirs

GetSelectedDirs [separator] [win]

separator optional; character usedto separateselecteddirectory names

win optional; window to get selecteddirectory namesfrom 207

(-1 = currentwindow,0 = left or 1 = right) defaultsto -1. ( This cornrnandreturns,in theRESULTvariable,thenamesofa11selected directoriesintheactivedirectorywindow. If separatorisspecified,thenames areseparatedbyaseparator.Thedefaultseparatorisaspace.Youshouldbe preparedtohandlealongstring.

ARexx Results: RC= 0 Result= a11theselecteddirectoryentries

ARen OnIy GetSelectedFiles

GetSelectedFiles[separator][win]

separator optional;characterusedto separateselectedfilenarnes

win optional;window to getselectedfilenamesfrom (-1 = currentwindow,0 = left or 1 = right) defaultsto -1.

This commandreturns,in theRESULTvariable,thenamesof all selected filesin theactivedirectorywindow. If separatorisspecified,thenamesare separatedbyaseparator.Thedefaultseparatorisaspace.Youshouldbe preparedtohandlealongstring.

ARexx Results: RC= 0 Result= all theselectedfileentries 208 CHAPTER 4. COMMANDS

GetSizes ( GetSizes [win] win optional;window to work with. (-1 = currentwindow,0 = left or 1 = right) defaultsto -1.

This will displayin thestatusbarthesameinformationthatis displayed whenentriesareselected(namely,thenumberof selectedfiles,directories andbytes,out of thetotalnumberof files,directoriesandbytes),alongwith oneadditionalpieceof information.If theselectedentriesoccupyfewerbytes thanthefreespaceonthedisk in theoppositedirectorywindow,allowingall selectedfilesto fit on thedestinationdiskweretheyto becopied,aY will be displayedafterthecount.Otherwise,anN will bedisplayed. If anydirectoriesareselectedwhenGetSizesischosen,thedirectories thatdo not alreadyhavea sizedisplayedarescanned,andthesizeof the ( directoriesarecalculatedanddisplayed. ARexx Results: Re= 0 Result = undefined

AR."" Only GetString

GetString [message] messageoptional;text for requester ( This commandwill opena requesterfortheuserto entertextinto. If a messageisgiven,thatis usedasthepromptfor therequester. ARexx Results: 209

Re = 0 success,1cancelwaspressed Result= stringenteredbyuser

(

Help

Help

Providedahelpfile hasbeenloadedin, selectinganybuttonor menuafter enablingHelpmodewith this menushouldresultin theappearanceofsome helpful text. ToturnHelpmodeoff, selectthis commandagain.

ARexx Results: Re= 0 Result= undefined (

HexRead

HexRead [name]

name optional;nameof file

This commandwill readtheselectedfilesin thesamewayasREAD, but in hexadecimalformat.This allowsyou to view binaryandotherfiles containingnon-textcharacters.

ARexx Results: ( Re= 0 Result= undefined 210 CHAPTER4. COMMANDS

Hunt

Hunt [name][pattern]

name optional;nameof directoryto hunt

pattern optional;file patternto hunt

This commandallowsyou to searchallselecteddirectories(andtheir sub-directories)foraspecifiedfile or files. A requesterappearsaskingfor the patternto huntfor. Youcanusefull patternmatehingfor thissearch. If a file matehingthepatternis found,you areaskedif youwish to enter thedirectorycontainingit, or continuethesearch.If youelectto enterthe directory,thedirectorywill bereadandthenall matehingentrieswill be highlighted.

ARexx Results: Re= 0 Result = undefined

Iconify

Iconify

This commandclosestheDirectoryOpuswindow andscreen, de-allocatesasmuchmemoryaspossible,andthenopensasmallwindowon theWorkbenchscreen.This is knownasiconifying, andallowsyouto have Directory Opusconstantlyavailablewhile usingtheminimumamountof memory. 211

Todeterminetheinitial positionofthe iconifiedwindow,especiallyif you startup DirectoryOpusin theiconifiedstate,youshouldiconify Directory Opus,andpositionthewindow asyouwould like it to appear.Thenre-enter DirectoryOpus,andsavetheconfiguration(describedlater). ( To re-enterDirectoryOpus,simpledick theleft mousebuttonin the iconifiedwindow,thenpresstheright mousebutton.If you wish to quit DirectoryOpuswithoutgoingbackinto it, just dick theClosebuttonatthe far left of theiconifiedwindow. If youhavetheconfigurationoptionIconify type(describedlater)setto hidden,theonly wayto re-enterDirectoryOpusis with thehotkeys.These defaultto CfRL-SHIFf-ALT (theCfRL key,theleft SHIFf keyandtheleft ALT keyhelddownsimultaneously),althoughthismaybechangedinthe configuration(explainedlater). ARexx Results: Re= 0 Result= undefined

leonlnfo

IconInfo [name]

name optional;nameof icon(or file with icon)

This commandallowsyou to modify thecharacteristicsoficonssuchas Stacksize,DefaultToolandToolTypes.It operatesinasimilar fashionto the Informationmenuitemof Workbench. Tousethiscommandyoumayeitherselectthe.info files themselvesor theactualfilesor directoriestheiconsbelongto. A requesterwillappearwhenyourunthiscommandonavalid icon. The ( actualappearanceoftherequesterwillvary dependingonthetypeof icon,but in all casestheactualiconimagerywill bedisplayed.Youcandick onthis imagewith theleft mousebuttonto displaythealternativeimagery(if it exists). 212 CHAPTER4.COM~S

TheRemapcolorsbuttonwill swapcolors1 and2 of theicondisplayed. Thiscanbeusefulto remapiconsdesignedunderOS1.3for usageunder OS2.0,sineeOS2.0swappedthelight anddarkcolorsaround. The informationdisplayedfor eachicontypeis listedbelow.Oneeyou ( havemadethedesiredchangestotheicon,theSavebuttonwill savethe changestodisk. TheSkipandCancelbuttonswill exit without modifyingthe iconon disk.

Drawer icon For adrawericonyou mayedit thedrawer'sprotectionbits, comment,andtool types.Thedateof thelastmodificationof the draweris alsodisplayed.

Project icon For aprojecticonyou mayedit theproject'sstacksize, defaulttool andtool types.Also displayedarethesizeof theprojectin bytesandblocks,andthelastmodificationdate.

Tool icon Foratool iconyoumayedit thetool's protectionbits,stacksize, commentandtool types.Also displayedarethesizeof thetool in bytes andblocks,andthelastmodificationdate. ( Disk icon For a disk iconyou mayeditthedisk'sDefauItTool. Displayed arethetotal numberof blocks,andthenumberof blocksusedandfree. Theblock size,creationdateanddiskstatusarealsodisplayed.

Trashcanicon For atrashcanicontheonly informationavailableisthe lastmodificationdate.

Protectionbits (whereappropriate)aremodifiedin thesamewayaswith theProtect command,exceptthattheHiddenandPurebits arenotaceessible. Tool types(whereappropriate)aremodifiedin thesamewayasfrom Workbench.Toedit anexistingTooltype,simplyselectit, andpressreturn whenyou havemodifiedit. To createanewTool type,selecttheNewbutton. To deleteanexistingTooltype,selectit andthenselecttheDeletebutton.

ARexx Results: Re= 0 ( Result = undefined 213

Install (

Install [drive] [ffs] [noboot]

drive optional;driveto install

ffs optional;installa FFSbootblock

noboot optional;makedisk non-bootable

This commandallowsyou to makea diskbootable.All bootabledisks havespecialinformationwritten onthefirst sectorof thedisk, Withoutthis, thediskwill notboot.

ARexx Results: ( RC= 0 Result = undefined

InstallBG

InstallBG sameasInstali

This commandwill executeInstallin backgroundmode.This allowsyou to startup a diskcopyandstill useDirectoryOpus.

ARexx Results: ( RC= 0 Result = undefined 214 CHAPTER4. COMMANDS

LastSaved (

LastSaved

This commandcausesDirectoryOpusto readin thelastsaved configurationfile. If you havemodifiedtheconfiguration,andhavenot yet savedit, you areaskedfor confirmationbeforethis is done.

ARexx Results: RC= 0 Result = undefined

LoadConfig

LoadConfig name

name configurationfile to load

Loadsthespecifiedconfigurationfile.

ARexx Results: RC= 0 Result = 0 meanssuccess,1meanssomesortof failure 215

LoadStrings (

LoadStrings name

name stringfile to load

ARexx Results: RC= 0 Result= 0 meanssuccess,1meanssomesortof failure

LoopPlay

LoopPlay [name]

name optional;nameof file

Unlike thePlaycommand,theLoopPlaycommandplaysasoundfile repeatedly,requiringa mousebuttondick to proceedtothenextone.

ARen Results: RC= 0 Result= undefined ( 216 CHAPTER4. COMMANDS

MakeDir ( MakeDir [name]

name optional;nameof directory

This cornmandallowsyou to createanewsub-directoryin theactive directorywindow. ARexx Results: Re= 0 Result = undefined

Modify (

Modify namevalue

name nameof item to modify

value newvalue

This cornmandallowsyou to makequickchangesincertainconfiguration optionsfrom buttonsor menus,ratherthangoingthroughtheconfiguration program. TheModify cornmandallowschangestoatleasttwo characteristicsthe nameof theoptionto change,andthenewvalue(s)for it. Mostvaluesare actuallya combinationof Hagbits;to determinethedesiredvalue,yousimply addthevaluesof theHagbitstogether. Youcanalsoaddandsubtractbits. To dothis,specifyeachbit (or combinationofbits) thatyouwish to addor subtract,precededbythe appropriatesign(+ for addand- for subtract). The optionsyou canchangeare: 217

BankNumber allowsyou to specifythebankbeingshown. BankNumbernum

( ButtonRows correspondstoButtons/Buttonrowsmenu. ButtonRowsrows

CopyFlags correspondstoOperation/Copy CopyFlagsflags

Flags... 1 = Keeporiginal datestamp 2 = Keeporiginalprotectionbits 4 = Keeporiginal comment 8 = Setarchivebit 16 = Checkdestinationfreespace. ( DateFormat correspondstoOperation!Dateformat DateFormatflags

Flags... 1 = AmigaDOSformat(DD-MMM-YY) 2 = Internationalformat(YY-MM-DD) 4 = USA format(MM-DD-YY) 8 = English/Australianformat(DD-MM-YY) 16 = Namesubstitution(Today,Tomorrow,etc.) 32 = 12hourclock

( DefaultTool thecurrentDefaultTool for projecticonscreatedwith Addlcon. DefaultTooltoolname 218 CHAPTER4. COMMANDS

DeleteFlagscorrespondstoOperation!Delete DeleteFlagsfiags

Flags... 1 = Ask beforecommencingdelete 2 = Ask beforedeletingfiles 4 = Ask beforedeletingnon-emptydirectories 8 = Setdeleteprotectionbit

DirFlags correspondstoSystern/Directories. DirFlagsfiags

Flags... 1 = Always moveto emptybuffer 2 = UseExAlI() to readdirectories 4 = Auto diskchange 8 = Auto disk load 16 = Searchbufferson Double-click 32 = Re-readchangedorincompletebuffers 64 = Searchbufferson Parent/Rootoperation 128 = Expandpathnames

DisplayLength correspondstoOperation/Listformat'slengthfields. This setsthelengthsof someof thedirectorylist items. DisplayLengthwin typelength win is thewindow to actupon(-1 = currentwindow,0 = left or 1 = right).

Types... o = Name 1 = Comment 2 = Filetype 219

ErrorFlags correspondstoOperation/Errorcheck ErrorF1agsflags

( F1ags... 1 = DisableDOSrequesters 2 = Displayerrorrequester

FadeDelay correspondstoSystem/View& Play'sfadedelay. FadeDelaytime

Filter Adjusttheglobalfilenamefilter. If filepatternis not giventhen globalfilter will beturnedoff. Filter [filepattern]

Font correspondstoScreen/Fonts.Thistakesthreevalues;theID number of thefont to change,thenameof thenewfont, andthepoint sizeof thefont. Fontidnumberfontsize

ID Numbers... 0 = General(8point font) 1 = Directorywindow font 2 = Textviewerfont 3 = Buttons 4 = Menus 5 = Statusbar 6 = Disknames 7 = Clockbar 8 = Requesters ( 9 = Pathfields 10 = Buttoniconify 220 CHAPTER4. COMMANDS

GeneralFlags correspondstoOperation/General GeneralFlagsHags

Flags... ( 2 = Displayinfo 8 = File double-dick 64 = Windowslideractivate 128 = Click-m-click drag

HelpFile a1lowsyouto specifya helpfile to load HelpFilepathname

HidePattern correspondstoSystem/Showpattern'shidepattern HidePatternpattern ( IconFlags correspondstoOperation/Icons IconFlagsHags

Flags... 1 = Createiconswith directories 2 = Performa11actionson iconsaswell 4 = Selecticonsautomatica1ly

Iconify Flags correspondstoSystem/Clocks. lconifyFlagsHags

Flags... ( 1 = Memorymonitor 2 = CPUmonitor 4 = Date 221

8 =Time 16 = Nowindow 32 = Applcon 64 = Memoryin bytes ( 128 = C: andF:

NotethatNowindow andAppIconaremutuallyexclusive.Ifthetwo flagsarespecifiedtogethertheresultswill beunpredictable.

ListFormat correspondstoOperation/Listformat.Thevaluefor this is notacombinationofflags,but insteadalist of numbersrepresenting items. ListFormatwin items win is thewindowto actupon(-1 = currentwindow,0 = left or 1 = right). Itemsis upto five numbers,whichindicatewhatdatais to bedisplayed ( andin whatorder.

Items... o = Name 1 = Size 2 = Protection 3 = Datestamp 4 = Comment 5 = Filetype

OutputCmd correspondstoSystem/AmigaDOS/Outputcommand. OutputCmdshellcommand ( OutputWindow correspondstoSystem/AmigaDOS/Outputwindow. OutputWindowconsoledefinition 222 CHAPTER 4. COMMANDS

ReplaceFlagscorrespondstoOperation/Copy ReplaceFlagsflags

Flags... ( 1 = Always replacefiles 2 = Neverreplacefiles 4 = Replaceonlyolderfiles 8 = Ask beforereplacing

ScreenModecorrespondstoScreen/Screenmode. ScreenModemode

Modevalues... 1 = Openon Workbench'sscreen 2 = Opena cloneof Workbench'sscreen ( UnderOS2.0/0S3.0othermodeID's aresupported.Somecommon modeID's are...

32768 = High Resscreen 32772 = High ResLacedscreen 32800 = Super-HighResscreen 32804 = Super-HighResLacedscreen 233508 = Productivityscreen 233509 = ProductivityLacedscreen 266240 = A2024 10Hz screen 299008 = A2024 15Hz screen

ScrDepth correspondstoScreen/Screenmode'sdepth.Thedepthcanbe ( 2, 3 or 4 bitplanes.Thatis thesameasfour,eightor sixteencolors. ScrDepthdepth 223

ScreenFlags Correspondsto Screen/Screenmode. ScreenFlagsflags

( Flags... 1 = Use default screenwidth 2 = Use default screenheight 4 = Half-height screen

ScrClockFlags correspondsto System/Clocks. ScrQockFlags flags

Flags... 1 = Memory monitor 2 = CPU monitor 4 = Date ( 8 =Time 64 = Memory in bytes 128 = C: and F:

ScrH correspondsto Screen/Screenmode's height. ScrH height

ScrW correspondsto Screen/Screenmode's width. ScrW width

( 224 CHAPTER4. COMMANDS

SeparateMethod correspondstoOperation/Listforrnat'scyclebutton. SeparateMethodwinmethod win is thewindow to actupon(-1 = currentwindow,0 = left or 1 = ri~Q. (

Methods... o = Mix filesanddirectories 1 = Displaydirectoriesfirst 2 = Displayfilesfirst

ShowDelay correspondstoSystem/View& Play'sshowdelay. ShowDelaydelay

ShowFreeFlags correspondstoSystem/Directoryflags. ShowFreeFlagsflags ( Flags... 1 = Bytesfree 2 = Kilo/Megabytesfree 4 = Blocksfree 8 = Percentageofspacefree

Thesebitsaremutuallyexclusive.If morethanoneis specifiedata time theresultswill beunpredictable.

ShowPatBits correspondstoSystem/Showpattem'shiddenbit flag ShowPatBitsflags

Flags... ( 1 = Hide fileswith hiddenbit set. 225

ShowPattem eorrespondstoSystem/Showpattern'sshowpattern ShowPatternpattern ( SortFlags correspondstoOperation/Listformat'ssortHag SortFlagsHags

Flags... 1 = Reversesortin left window 2 = Reversesortin right window

SortMethod eorrespondstoOperation/Listformat'seheekedsortitem. SortMethodwinitem win is thewindowto aetupon(-1 = eurrentwindow,0 = left or 1 = right).

Items... o =Name ( 1 = Size 2 = Proteetion 3 = Datestarnp 4 = Comment 5 = Filetype

UpdateFlagseorrespondstoOperation/Update UpdateFlagsHags

Flags... 1 = Updatefreediskspace 2 = Serolldireetorywindowto follow operations 4 = Redrawmorethana quarterof apage 8 = DireetoryrefreshusingStartNotify() ( 16 = Left-justify filenamein statusbar 32 = Displayprogressindicator 226 CHAPTER4. COMMANDS

ViewPlayFlags correspondstoSystem/View& Play. ViewPlayFlagsflags

Flags... ( 1 = Black backgroundbetweenpictures 2 = Turn audiofilter off for 8SVX play 4 = 8-bitsperguncolor 8 = LoopPlay8SVX soundfileson double-dick 16 = Textviewerborders 32 = Startanimationspaused

WindowSize adjuststheplacementofthecenterbarof DirectoryOpus's directorywindows WindowSizeoffset

Any Modify commandthatchangedisplaycharacteristics(screensize, ( modeanddepth,list format,etc.) will not takeeffectuntil you executethe ... Redraw command.Forcommandsthatonly changedirectorydisplay characteristics,youusetheDisplayDir commandtoupdatethedirectory display.Somemodifications(like dateformat,hideandshowpatterns,etc.) will not takeeffectuntil thedirectoryis actuallyre-read(for instance,when theRescancommandisused.). For example,youcouldhavetwo buttonsconfiguredtoswitchbetweena High Resscreenwith8 colors,andaHigh ResInterlacedscreenwith4 colors. Thedefinitionsfor thesebuttonsmightbe:

LACEON - CommandModify ScreenMode 32772 CommandModify ScrDepth 2 CommandRedraw

LACEOFF- CommandModify ScreenMode 32768 ( CommandModify ScrDepth 3 CommandRedraw 227

As anotherexample,youmightwish to changetheleft window to be sortedby Date,but to leavetheright window alone.For this,you would have ( thecommand:

CommandModify SortFlags 0 3 CommandRescan 0

ARexx Results: RC= 0 Result= undefined

Move

Move [name][destination]

name optional;nameof file

destinationoptional;destinationpath

This allowsyouto moveall selectedfilesanddirectoriesfromtheactive directorywindowto theinactivewindow. Thefile or directorywill be copied to thedestination,andtheoriginalwill bedeleted.

ARexx Results: RC= 0 ( Result= undefined 228 CHAPTER4. COMMANDS

MoveAs ( MoveAs [name][newname]

name optional;nameof file

newname optional;newfile name

This commandmovesall selectedfilesanddirectoriesfromtheactive directorywindow to theinactivewindow,andallowsyou to specifya new namefor eachfile or directory.Thefile or directorywill becopiedto the destinationunderthenewname,andtheoriginalwill bedeleted.

ARexx Results: RC= 0 Result = undefined (

NewCLI

NewCU [handle]

handle optional;CLI consolehandleto use

This commandopensaCLI from within DirectoryOpus,usingtheoutput window definedin theconfiguration.ThenewCLI will beseparatefrom DirectoryOpus,soto endtheCLI you musttypeEndCLI,asusual.

ARexx Results: RC= 0 ( Result = undefined 229

NextDrives ( NextDrives This commandsimplyflips to thenextbankof drivebuttons. ARexx Results: Re= 0 Result= undefined

None

None This commanddeselectsallfilesanddirectoriesin theactivedirectory ( window. ARen Results: Re= 0 Result= undefined

OtherWindow

OtherWindow This is thesameaspressingthespacebar,andactivatestheinactive directorywindow. ( ARexx Results: Re= 0 Result= 0 left window is nowactive,1right window is 230 CHAPTER4. COMNVVVDS

Parent

Parent [win]

win optional;window to do aparentof (-1 = currentwindow,0 = left or 1 = right) defaultsto -1. This will readtheparentdirectoryof thedirectoryopenin theactiveor specifieddirectorywindow. Therearealsotwo hiddenparentbuttons;onefor eachdirectorywindow. Theyarehiddenin theoutermostborders(ontheleft of thescreenandthe right of thescreen)of thedirectorywindows. ARexx Results: RC= 0 Result = undefined

PatternMatch

PatternMatch patternstring

pattern patternstring

string stringto matchto pattern This will returnabooleanvalueto indicatewhetherthesuppliedstring matchesthesuppliedpattern(whichmayincludefull wildcards). ARexx Results: RC= 0 Result = 0 if string doesnotmatch,1 if it does 231

Play ( Play [name] name optional;nameof file Thiswill attemptto playeachselectedfile. If thefile is an8SVX format IFF sampledsound(ofthe typegeneratedbyAudioMaster,for instance),the speedandotherinformationfrom within thefile will beused.ThePlay routineplaysbothmonoandstereoIFF 8SVX files. Whenplayinga file that is notIFF 8SVX, it will assurneaspeedof 10000samples/second, Thiscommandalsoplayssongmodules.SeePlaySTfor more information. Eachfile is playedonceonly,unlike theLoopPlaycommand,whichplays eachfile continuously. If theSystem/View/Play/Tumaudiofilter off for play optionis selected, thehigh-passaudiofilter will beturnedoff while asoundis playing. ( ARexx Results: RC= 0 Result = undefined

PlayST

PlayST [name] name optional;nameof file Playasongmodule.DirectoryOpussupportsSound/Noise/Pro'Iracker, OktalizerandMED modules. ( ARexx Results: RC= 0 Result = undefined 232 CHAPTER4. COMMANDS

Print (

Print [name]

name optional; name of file

The print routine is a full-featured text formatter. You can have a headerand/or a footer printed at the top and bottom of eaehpage if you wish. Both the headerand footer can consist of the title, the eurrent date and the page number. You may seleetany eombination of Title, Date and Pagenumber you wish. If none are seleeted,the headeror footer is not printed. You mayaiso seleetthe typestyle of the headerand the footer, by clicking on the buttons that initially say Normal. These allow you to cycle through the various typestyles available: Normal, Bold, ltalics, Underline, Doublestrike ( and Shadow. Note that some printers may not have all thesetypestyles available. You may enter a title (to be used in the headerand footer) in the Title string field, Leaving this blank will eausethe name of the file to be usedasa title. The Output field allows you to specify where you want the output of the print proeessto go. This defaults to PRT : , but you may ehooseto have the output sent to a disk file. In this case,simply enter the path and the nameof the file you wish to print to. The cycle button labeled Quality allows you to specify whether all text is printed in draft mode or NLQ mode The button below that determineswhether or not the last pageof the file to be printed is followed by a formfeed eharaeter,whieh would causeit to be ejeeted. To start the print operation, seleetthe Print button. ( 233

This commandwill print a11seleetedfiles,oneatatime. If you seleetonly onefile to print, theprint routinewill bestartedupasaseparateproeess, allowingyou to eontinueworkingwith DireetoryOpus.To caneelthistypeof ( print, seleettheprint eommandagain.A requesterwill appearaskingif you wantto eontinuewiththeprint or halt it. This requesterwillalsoappearif you attemptto quit DirectoryOpuswhile a print operationis in plaee,asyou cannotquit until theprint hasfinished. To eaneelaprintjob thathasnotbeensentto theprinteryet, simply press theleft andright mousebuttonsin thenormalway. Evenif youaborta print, theprintermaynot aetuallystopfor sometime. This is becausemostprintershaveprint buffers,somequitelargeones,whieh mustemptythedatatheyhavestoredinto theprinterfirst. ARexx Results: RC= 0 Result= undefined

( PrintDir

PrintDir [win] win optional;window to scanthebuffer list into (-1 = eurrentwindow,0 = left or 1 = right) defaultsto -1. This eommandallowsyou to print thedireetoryin theaetivedirectory window. Youareableto ehoosetheinformationyouwantto print (file sizes, proteetionbits,datesandeomments).Thiseommandisnot startedasa separateproeess,unlikethePrint eommand.Printdiralsoallowsyou to specifytheoutputfile to which thedireetoryis to beprinted.This canbe PRT: (i.e.,yourprinter,thedefault)or adisk file. ( ARexx Results: RC= 0 Result= undefined 234 CHAPTER4. COMMANDS

Protect

Protect [name][bits]

name optional;nameof file

bits optional;bits to seton givenfile

The Protectcommandnowallowsyou to specifybit-masking.Thislets you masksomebits asuntouchable.Youcanselectivelyaddor remove certainbitswhile leavingotherbits in their originalstate. To selectamask,click on thecharactersfollowingtheMask: string.If a maskbit is tumedon, its characterequivalentwill bedisplayed;otherwisea hyphen(-) characterwill bedisplayed. No maskbits thataretumedonwill bemodifiedduringtheprotection operation.

ARexx Results: Re= 0 Result = undefined

Query

Query item [win]

item configurationitem to query

win optional;window argumentthatsomeitemsneed (-1 = currentwindow,0 = left or 1 = right) 235

defaults to -1.

Returnsthe current value ofa specific configuration item. Theseitems are describedin the Modify command. Any item that can be modified can be ( queried. Several of the configuration iterns need an additional window argument. Theseare ListFormat, DisplayLength, SortMethod and SeparateMethod.

ARexx Results: RC= 0 Result e current value of the specified item

Quit

Quit [force]

force optional; do not ask user for confirmation.

This commandwill exit Directory Opus (providing there is not a print operation happeningat the time). If the configuration has been modified and not saved,you are askedif you wish to saveit first.

ARexx Results: RC= 0 Resu1t= undefined 236 C~R4. COM~S

Read (

Read [name]

name optional;nameof file

This commandallowsyou to readselectedfiles.At thebottomof the sereenthenameof thefile is displayed,alongwith thecurrentpositionwithin thefile in linesandasa percentage,andalsothetotal numberof linesin the file. Themouseisusedto movethroughthefile. Presstheleft mousebuttonto turn serollingon or off. Thedirectionandspeedofthescroll aregovernedby thepositionof themousepointerin thewindow.The mousepointerwill becomeinvisiblewhile thetext is scrolling. No scrollingoccursif youhavethemouseinthecenterof thewindow.To serollforward,movethemousedownuntil thetext startsto serolI.The ( furtherdownyoumovethemouse,thefasterthetextwill seroll. This procedureisreversedforbackwardsscrolling. Thebuttonsin thebottom-rightof thescreenalsoallow you to move aroundthefile. Mostbuttonswill repeatif helddownfor anylengthof time. The up anddownarrowsmoveupanddownaline atatime. TheU andD buttonsmoveup anddowna pageatatime. TheT andB buttonsmoveto the top andbottomof thefile. You canalsousethecursorkeysto moveup anddown.As before,in conjunctionwith SHIFf thesewill movea pageatatime,andin conjunction with CTRL theywill moveto thetop andbottomof thefile. Tojump to a specifiedline,dick on thenumbershowingthecurrentline position(immediatelyto theleft of theword Lines).YoucanalsopresstheJ key. Tojump to a specifiedpercentage,dickon thenumberimmediatelyto theleft of the % sign. ( To searchfor astring, dick ontheSbuttonor presstheSkey.Youcan usefull patternmatehingin this search. To print thecurrentfile, dick onthePbutton(or pressthePkey). Toprint only thecurrentpage,presstheC key(thishasnobuttonequivalent). 237

To leave the text viewer, dick on the X button, or presseither X, Q or ESC. If more than one file was selected,the next one will be read when you ( exit. To exit without reading the next file, pressthe right mouse button. ARexx Results: Re= 0 Result = undefined

Redraw

Redraw

This commandwill completely redraw the Directory Opus screen. The screenis closed, and then re-opened. ARexx Results: ( Re= 0 Result = undefined

Relabel

Relabel [device newname]

device optional; device to relabel newnamenew nameto give to selecteddevice This command allows you to changethe name (label) of the disk that is open in the active directory window. ( ARexx Results: Re= 0 Result = undefined 238 CHAPTER4. COMMANDS

Remember (

Remember

This commandallowsyou to maketemporarychangeswiththeModify command,andthenrestoreall thesettingslater.

ARexx Results: RC= 0 Result = undefined

RemoveEntry

RemoveEntry numbershow

number numberof entryto remove

show booleanindicateswhetherto updatedisplay

Removesanentryby ordinalnumber

ARexx Results: RC= 0 Result = 0 entrywasnot found,1 entrywasfoundandremoved 239

RemoveFile (

RemoveFile nameshow

name of thefile entryto remove

show booleanindicateswhetherto updatedisplay

This commandremovesthespecifiedentryfrom theactivedirectory window,andreturnsabooleanindicatingwhethertheentrywasfoundand removed.Showis abooleanvalueindicatingwhetheryouwantthedisplay updatedornot.

ARexx Results: ( Re= 0 Result= 0 entrywasnot found,1 entrywasfoundandremoved

Rename

Rename [namenewname]

name optional;nameof file

newnamenewnametogiveto selectedfile ( Thisallowsyouto renameallselectedfilesanddirectories.Youmayuse a * to specifyapattern.If no * is used,youareaskedfor a newnamefor each individualfile. 240 CHAPTER4.COM~S

To addaprefix or asuffix (or both)to all selectedentries,usea • in the secondstringfield. For example,toaddHIRES asaprefix and.pieasasuffix to all selectedentries,enterHIRES·.pie. To changeaprefix or asuffix (or both)of all selectedentries,usea • in ( thetop stringfield. Forexample,tochangeHlRESto MEDRESasaprefix, . and.pic to .iff asasuffix, enterHlRES·.pic in thetop stringfield, and MEDRES·.iff in thebottomstringfield.

ARexx Results: RC= 0 Result = undefined

Request

Request message (

messagetext to print in therequester

Displaysrequesterwithgivenmessagetext

ARexx Results: RC= 0 Result = 0 cancelwasselected,1okaywasselected

Rescan (

Rescan [win]

win optional;window to rescan 241

(-1 = currentwindow,0 = left or 1 = right) defaultsto -1. This causesthedirectoryin theactivewindow to bere-read.This has ( exactlythesameeffectasactivatingthedirectorystringfield andpressing return,without modifyingthedirectoryname.

ARexx Results: Re= 0 Result= undefined

Reselect

Reselect This commandwill reselectallentriesthatwereselectedbeforethelast ( operationwasinitiated. ARexx Results: Re= 0 Result= undefined

Restore

Restore This commandisusedto restorethepreviouslyRememberedsettings. ( ARexx Results: Re= 0 Result= undefined 242 CHAPTER4. COMMANDS

Root

Root [win] ( win optional;window to scanthebuffer list into (-1 = currentwindow,0 = left or 1 = right) defaultsto -1. This commandreadstheroot directoryof theactiveor specifieddirectory window. Therearealsotwo hiddenrootbuttons;onefor eachdirectorywindow. Theyarehiddenin theouterrnostborders(ontheleft of thescreenandthe right of thescreen)of thedirectorywindows.With theleft mousebutton, thesebuttonsperformtheParent command;whenselectedwiththeright mousebuttontheywill loadtheroot directory. ARexx Results: RC= 0 Result = undefined

Run

Run [name] name optional;nameof file This commandallowsyouto runeachselectedfilein turn,providingthat file is executable.Thiswill havemuchthesameeffectasif you had double-clickedonthefile's icon,or run it from theCLI. A requesterwill appear,askingfor arguments(shouldtheprograrnrequireany). ARexx Results: ( RC= 0 Result = undefined 243

SaveConfig (

SaveConfig [filename]

filename optional;configurationfile to saveto

This commandsavestheconfigurationtothefile thatit wasreadfrom initially.

ARexx Results: RC= 0 Result= undefined

( ScanDir

SC8nDir path[win]

path pathto read

win optional;window to readdirectoryinto (-1 = currentwindow,0 = left or 1= right) defaultsto -1.

This commandallowsyouto reada directoryin muchthesamewayas thedrivebuttons.Forexample: ( CommandScanDir DhO:Work WouldreadtheDHO:Work directoryinto thecurrentwindow. 244 CHAPTER4. COMMANDS

Oneusageofthis allowsyouto haveanentirebankof buttonsdevotedto "drive buttons".Youeouldthensetup abuttonon everyotherbankthat would,usingtheModify eommand,jumpto thatbank. ARexx Results: ( RC= 0 Result = undefined

ScrollH

ScrollH ehars[win] chars eharaeterstoseroll

win optional;window to seroll (-1 = currentwindow,0 = left or 1 = right) defaultsto -1 ( This will serollthedireetorywindowhorizontallyby thespecifiednumber of eharaeters(eitherpositiveor negative).

ARexx Results: RC= 0 Result = newhorizontalposition

ScrollToShow

ScrollToShow entry [win] ( entry entryto makevisible. May beeitheranameorwildcard pattern,or theordinalnumberof thedesiredentry.

win optional;window to seroll 245

(-1 = eurrentwindow,0 = left or 1 = right) defaultsto-1

( This eommandwilltry to seraIlthespecifiedentryinto view. ARexx Results: RC= 0 Result = 0 if entrywasnot found,1 if it wasfound

SerollV

Scrollv lines[win]

lines linesto seroll

win optional;window to scroll (-1 = eurrentwindow,0 = left or 1 = right) defaultsto-1

This will scrollthedireetorywindowvertieallyby thespecifiednumber of lines(eitherpositiveor negative).

ARexx Results: RC= 0 Result = newverticalposition

( 246 CHAPTER4.COM~S

Search (

Search [name][pattern][ucnlc] [wild] [byword]

name optional;nameof file

pattern optional;textpatternto searchfor

ucnlc optional;uppercasecharactersdoesnotequallowercase characters.

wild optional;patterncontainswildcardcharacters

byword optional;matchonly wholewords

This cornmandallowsyou to searchallselectedfilesfor aspecifiedstring, which maycontainwildcards.If a matchis found,you aretold whichfile containsthestring,andyouaregiventheoptionto enterthetextviewerand readthefile. If you opt to dothis, asearchforthestringis automatically initiatedoncethefile hasbeenreadby thetextviewer. If anydirectoriesareselected,allthefileswithin thosedirectoriesarealso searched. The flagsucnlc, wild andbyword areoff by default.

ARexx Results: Re= 0 Result= undefined 247

Select (

Seleet [pattern][onlyflles Ionlvdlrs] [name Idate Iprotection]

pattern optional;patternto selectby

onlyflles optional;selectonly files,defaultsto bothfiles anddirectories.

onlydirs optional;selectonly directories

name optional;matchon name,(default)

date optional;matchon date

( protection optional;matchonprotectionbits Whenusedin namemode(default)thiscommandallowsyou to select files anddirectoriesintheactivedirectorywindow usingwildcards.All standardwildcardsaresupported#, ?, I,Y., (, ), [,], *, - and ' . Whenusedin datemodeyoucanselectall files anddirectoriescreatedor modifiedon acertaindateonly. Simplyenterthatdate(e.g.,28-Mar-90would selectall entrieswith datestampssetto anytime on the28thof March,1990). Youcanalsousewordslike Yesterday,Today,Tuesday,etc.If you canalso specifya specifictime. Simplyenterthetime (in theformatHH:MM:SS). If you enteratime,however,thedatestampmustmatchthattime exaetlyfor the entryto beselected.If youenteratimebut not adateit will selectfiles createdtodaythatmatchthattime. Youcanalsoselectarangeof dates.Forinstance,toselectall entries createdormodifiedbetweenthe18thof April, 1989andthe22ndof ( September,1991,youwould enter:

18-Apr-89 > 22-Sep-91 248 CHAPTER4. COMMANDS

The > eharaeterdoesnotin this easesignify"greaterthan";it simply indicatesarangeof dates.It musthaveatleastonespaceoneithersideof it. Toselectall filesfrom thebeginningof time to, for instance,the3rdof January,1990,youwould enter: (

> 3-Jan-91

To selectall filesfrom, for example,the12thof July,1983to theeurrent date(today)youwould enter:

12-Jul-83 >

Youmayalsospecifytimeswhenenteringdateranges. If usedin protectbit modeyou mayspecifyprotectionbitsthatare allowedto beset,andbits thatarenot. If abit or groupof bits is allowedto be set,precedeit with a + character.If abit or groupof bits is not allowedto be set,precedeit with a - character.Theinitial + characterisassumed.For instance,toselectall readableandwritablefiles,youwould simply enter: ( rw

Or,you couldenter:

+rw

Both thesewouldhavethesameeffect.To expanduponthis,andselect all readableandwritablefiles,butnot thosethathavethehiddenor archive bits set,you would enter:

rw-ha

Or, to seleetfilesthatdo nothavethebits SPEDset,youwouldenter

-sped 249

The Selectcornrnandisadditive;i.e.,entriesnotrnatchingthegiven patternarenotdeselected.

( ARexx Results: RC= 0 Result = undefined

SelectEntry

SelectEntry nurnber

number ordinalnurnberof entryto select ( state optional;selectionstate (-1 = toggles,0= unselectand1 = select) defaultsto -1.

show optional;booleanindicatingwhetherto updatedisplay

Selectsanentryin theactivewindow

ARexx Results: RC= 0 Result = previousselectstatusof entryor -1 if it couldnotbefound

( 250 CHAPTER4. COMNVVVDS

SelectFile ( SelectFile name[state][show] name nameof entryto select state optional;selectionstate (-1 = toggIes,0 = unselectand1 = select) defaultsto -1. show optional;booleanindicatingwhetherto updatedisplay

This commandwill selecttheentryspecifiedbyfilename,asif it hadjust beenclickedon. ARexx Results: RC= 0 Result = previousselectstatusof file or -1 if it couldnotbefound

SetWinTitle

SetWinTitle titie [win] title titie stringto use win optional;window to modify (-1 = currentwindow,0 = Ieft or 1 = right) defauitsto -1. Setstitle of activeor specifiedwindowto givenstring. ARexx Results: ( RC= 0 Result = undefined 251

Show (

Show [name]

name optional;nameof file

This commandisvery versatileindeed.It will displayIFF ILBM pictures andbrushes,Workbenchicons,andfonts. If thefile is anIFF ILBM, it will bedisplayedusinginformationfrom the file. DirectoryOpuswill correctlyshowmostpicturesandbrushes,including overscan,extrahalfbrite(EHB),HAM pictures(4096colors),andthenew AGA displaymodesoftheA4000andA1200,includingHAM8 with 262144 colorsatonce. If thepicturecontainscolorcyclinginformation,pressingTABwill ( togglecolorcyc1ingonor off. YoucanpressPto print thepicture. Shouldyouwishthemousepointerto bevisible (in orderto point at some partof thepicture,for instance),pressthe.(period)key. Theshowroutinewill alsodisplayicons.If thefile hasa .info suffix it is assumedtobeanicon. If theiconhasanalternatativeimage,pressingreturn will togglebetweenthetwo. Todisplayafont,youneedto entertheactualfont drawer,andshowthe sizefile. Thatis, thefile 8, 12,19,etc.,NOT the.fontfile. If youpresstheHELPkeywhile viewing apicture,font, or icon,a screen will appearshowinginformationaboutwhatyouwerelookingat. Youcan alsoprint whatyouwerelookingat.

ARexx Results: Re= 0 ( Result= undefined 252 CHAPTER4. COMNVVVDS

SmartRead ( SmartRead [name]

name optional;nameof tue

This commandinvokesthetext viewerin thesamewayastheRead command.However,it checksthetue for binarycharacters,andif anyare found,thefile is hexreadinstead.

ARexx Results: Re= 0 Result = undefined

Status

Status value[set newvalue]

value indicatesthetypeof statusyouwant set newvalue optional;setthestatustothespecifiedvalue

This commandreturnsthevaluefor thespecifedstatuscommand(listed below). If thesetkeywordis specified,thiscommandwill setthestatustothe specifiedvalue(if appropriateforthatstatuscommand).Moststatusvalues canbeset. Somestatuscomrnandsrequireasub-number.Anexampleofthisis status4,which returnsthetotal numberof filesin aspecifieddirectory ( window. Thedirectorywindowmaybeeither0 (for theleft-handwindow),1 . (for theright-handwindow) or -1 (for theactivewindow). Thecommand would thereforebestatus4 0 for theleft-handwindow,andstatus41 for the right-handwindow. 253

StatusvaluesareasfolIows:

1-Currentdirectory This returnsorsetsthepathnameofthecurrent ( directory. Status1[set path]

2 - VersionThis returnsthecurrentversionnumber(asastring). Status2

3-Activewindow Thisreturnsor setstheactivedirectorywindow (either0 or 1). Status3 [set win]

4 - Number0/files This returnsthetotal numberof files in thedirectory window. Status4win

( 5 - Number0/dirs This returnsthetotalnumberof directoriesin the directorywindow. Status5win

6 - Number0/ entries This returnsthetotal numberof entriesin thedirectory window. Status6win

7 - Number0/ selectedfiles This returnsthetotalnumberof selectedfilesin directorywindow. Status7win

8 - Number0/ selecteddirs This returnsthetotalnumberof selected directoriesinthedirectorywindow. ( Status8win

9 - Number0/ selectedentries Thisreturnsthetotal numberof selected entriesin thedirectorywindow. 254 CHAPTER4. COMMANDS

Status9win

10 - Totalbytes This returnsthetotalnumberof bytes(sumof thelengthsof all files) in thedirectorywindow. Status10win

11 - Totalselectedbytes This returnsthetotal numberof selectedbytes(sum of thelengthsof all selectedfiles)in thedirectorywindow. Status11win

12 - Selectpattern This returnsor setsthecurrentSelectpattern(usedin the Selectcommand). Status12[type] [set pattern]

Types... o = Name,Default 1 = Date 2 = Bits

13 - Directory name This returnsthenameof thedirectorythatis openin the specifiedwindow.Settingthisto anotherpathnamewillread thatdirectory. Status13win [set path]

14 - Disk name This returnsthenameof thedisk thatis openin thedirectory window.This cannotbeset(usetheRelabelcornmandto changethedisk name). Status14win

15 - Diskfree bytes This returnsthenumberof bytesfreeonthediskopenin thedirectorywindow. ( Status15win

16 - Disk total bytes This returnsthetotalnumberofbytes (free+used)onthe disk openin thedirectorywindow. 255

Status16win

17 - Buffereddirectoryname This returnsthepathnameofthedirectorythat ( is storedin a specificdirectorybuffer (from 0 to 255). Status17win buf

18 - BuffereddisknameThis returnsthedisknameofthedirectorystoredin a specificdirectorybuffer (from 0 to 255). Status18win buf

19 - Buffereddiskfreebytes This returnsthefreespaceonthediskwhose directoryis storedin aspecificdirectorybuffer(from 0 to 255). This datamayno longerreftecttheactualfreespaceonthat disk. Status19win buf

20 - Buffereddisktotalbytes This returnsthespaceusedonthediskwhose directoryis storedin aspecificdirectorybuffer(from 0 to 255). ( This datamayno longerreftectthespaceusedonthatdisk. Status20win buf

21 - BufferdisplayedThis returnsthenumberof thebufferthatis displayed in thedirectorywindow,anumberfrom 0 to 255.If this is set to aspecificbufferthatbufferwill betheoneshownin the directorywindow. Status21win [set buf]

24 - unusedinDirectoryOpus4.0

23 - unusedinDirectoryOpus4.0

24 - Entriesperpage This returnsthenumberof entriesthatcanbedisplayed ( perpage. Status24

25 - ConfigurationchangedThis returnsabooleanvalueto indicatewhether theconfigurationhasbeenchangedsinceit waslastsaved. 256 CHAPTER4. COMMANDS

Status25 [set state] 26 - Okaystring This returnsthenameof theOkaystringin requesters.This alsoallowsyouto selectthetext of thepositivebuttonfor the requestandgetstringcornrnands. ( Status26 [set string] 27- Cancelstring This returnsthenameof theCancelstringin requesters. This alsoallowsyou to selectthetextof thenegativebuttonfor theRequestandGetString cornrnands. Status27 [set string]

28 - Currentlyiconified ThisreturnsavalueindicatingwhetherDirectory Opusis currentlyiconfiedandif sowhattypeof iconificationit is, Thiswill return0 if not iconified,1 if iconifiedand2 if buttoniconified. Status28 29 - (unusedinDirectory Opus4.0) ( 30 - Toptextjustification This returnsavalueindicatinghowthetextin the statusbaris rendered. Status30 [set type]

Types... o = left 1 = right 2 = center

30 - (unusedinDirectory Opus4.0) 31- (unusedinDirectory Opus4.0)

32 - (unusedinDirectory Opus4.0) 33- (unusedinDirectory Opus4.0) (

34 - (unusedinDirectory Opus4.0) ARexx Results: 257

Re= 0 Result= dependsonwhich statuswasrequested)

(

StopST

StopST

Stopsplayinga songmodule.

ARen: Results: Re= 0 Result= undefined (

SwapWindow

SwapWindow

Swapsthecontentsofthetwo directorywindows.

ARexx Results: Re= 0 Result= undefined ( 258 CHAPTER4. COMMANDS

TechSupport (

TechSupport

This commanddisplayssomeinformationon howto contacttechnical support.

ARexx Results: RC= 0 Result = undefined

Toggle

Toggle

This commandreversesthestateof all files anddirectoriesintheactive directory(i.e., all selectedentriesaredeselected,andviceversa).

ARexx Results: RC= 0 Result = undefined

( 259

TopText

ThpText text

text text stringto display

Displaysgivenstringin thestatusbar.

ARexx Results: RC= 0 Result= undefined

Uniconify

Uniconify

Returnstomainprogramfrom iconifiedstate.

ARexx Results: RC= 0 ResuJt= undefined 260 CHAPTER4. COMMANDS

User!, User2,User3,User4 (

Userl, User2,User3,User4

These commandswill invoke the four user definable commands associatedwith your filetypes. In the default configuration the command Userl is defined to extract files from archives.

ARen Results: RC= 0 Result = undefined

Veriry

Verify [text]

text optional; text to display in requester

Displays "Are you sure?" requester. If this is included in a multi-command operation, Cancel will abort the rest of the commands.

ARen Results: RC= 0 Result = 0 is cancel, 1 is okay ( 4.1. SIMPLEARGUMENT FUNCI10NS 261

Version (

Version

This commanddisplaysversioninformationaboutDirectoryOpus, Kickstart,Workbenchandyour computer.

ARexx Results: Re= 0 Result= undefined

4.1 SimpleArgument Functions (

{ d} Destination directory window's path This will insert the path of the destination directory window.

{f} First selectedentry (with path) Insert the path and filename of the first selectedentry. The entry will thenbe deselected.

{F} All selectedentries (with paths) Insert the path and filenamesof the all selectedentries. The entrieswill then be deselected. AmigaDOS haslimited the length of the command line to 256 ( characters.Therefore, if the length of a command line exceeds 256 charactersbecauseof a {F} sequence(or for any reason), anothercommandline will be createdfor the next lot of file entriesuntil there are no more selectedfile entries. 262 CHAPTER4. COMNUVv.DS

{fu} First entry(with path,donot deselect) Thesameas{f} exceptthattheentryis notdeselected. {re} All entries(with paths,donot deselect) ( Thesameas{F} exceptthattheentriesarenot deselected.

{ o} First selectedentry(nameonly) Thesameas{r} exceptthatonly thenameof thefirst selected entryis used,withoutthepathname. {o} All selectedentries(namesonly) Thesameas{F} exceptthatonly thenamesoftheselected entriesareused,withoutthepathname.

{ou} First entry(nameonly,donot deselect)

Thesameas{ 0 } exceptthattheentryis notdeselectedafterit is used. {Du} All entries(namesonly,do notdeselect) Thesameas{O} exceptthattheentriesarenot deselectedafter theyareused.

{p} ARexx port/Publicscreenname This will insertthenameof therexx port for this invocationof DirectoryOpus.EveryDirectoryOpusrunningwill havea uniquerexxport name.This is thesamenameusedfor thepublic screenname.

{s} Sourcedirectorywindow'spath This will insertthepathof thesourcedirectorywindow. 4.2. REQUESTERFUNCI10NS 263 4.2 RequesterFunctions

{aarstle: Default} Direetory requester ( Default eanbe any valid pathname

{arntle: Default} File requester Default eanbe any valid pathnameor filename

{RFTitle: Default} Multi-select file requester Default eanbe any valid pathnameor filename

{seritle: Default} Font requester Default eanbe any fontname. A pointsize ean be specified with a slashfollowed by a number (ie. topaz/8) ( {RsTitle: Default} Requesterthat asksfor some text Default eanbe any text.

The Title string is the title that will appearon the requester.You ean just omit the Title string, in which easeadefault title will be used.

The Default string (preeededby a colon) is the default string that is to appearin the requester.This too eanbe omitted.

The Default string eaneontain bracketedletters. Thesetell Directory Opus where to insert additional information into the requester.The supportedbracketedletters include...

( [0] insertsthe last referred filename, only the filename

Cf] insertsthe last referred filename, both path and filename

[5] insertsthe soureedireetory window's path 264 CHAPTER4. COMMANDS

[d] inserts the destination directory window's path

For example, it would be possible to have your own custom rename ( button with the following call function: .

c:rename {f} {RsEnter new filename:Foo. Co]}

In this caseastring requesterwould open with the title "Enter new filename" and the default of the string field would be "Foo." followed by the selectedfilename.

( ( Chapter 5

Appendices

5.1 Glossary ( Someterms usedin this manual that you may needto know are:

Active (directory window) ... denotedby a highlighted disk name. This is the source directory, the directory that all commandswill act upon (seepage 12).

Buffers (directory) ... A Directory Buffer is an internal storage areafor directory information. Whenever Directory Opusreadsdirectory information from a disk, it stores the information in a Directory Buffer. By storing the directory information in a buffer, Directory Opus can avoid unnecessarilyre-reading the disk (seepage20).

( CIick-M-CIick ... this is a Directory Opus term. To dick-rn-dick is to dick oncewith the mousebutton, move the mouse to anotherpart of the screen,andpressthe mousebutton again,all within the double-dick time set frorn

265 266 CHAPTER5. APPENDICES

Preferences(seepage 16).

Directory window . .. one of the two windows on the screenin which entries are displayed (seepage 12). ( Double-dick ... an Amiga term, this meansto dick twice with the mousebutton (usually the left button, but sometimesthe right button) on an object, within a pre-determinedtime. The time is set from within Preferenees,andyou should eonsult your Amiga manual for more information on this.

Drive gadgets ... the 30 gadgets,of whieh only six arevisible at onee,that enableyou to easily read any direetory.

Entry ... either a file or a direetory.

File types ... a file type is a set of user-definedteststo seewhether a file is of a eertain type or not. Actions ean thenbe performed on the file, depending on its type.

Highlight ... highlight is the term given to the ehanging or reversal of colors, usually when an object is selected.

Inactive (direetory window) ... disk nameis not highlighted. This is the destination directory, and files may sometimesbe written here from the soureedireetory.

Menu ... a pull-down menu is like a list of gadgets.A menu is aeeessedby moving the mouseto the top of the screen and holding the right mousebutton.

Open ... a direetory that is currently displayed is said to be open. (

Requester. " a requester is usually a box that appearson the sereen,soliciting a response.Somerequestersrequire a 5.2. HOWWBSTARTEXTERNAL PROGRAMS 267

string input, others simply ask you to chooseyes or no.

RMB Button. .. a Directory Opus term. This is a button that is ( selectedwith the right mousebutton, instead of with the left.

Selected... entries are selectedwhen they arehighlighted. This is usually done by elicking on them with the left mouse button.

5.2 How westart external programs

Directory Opus usesthe small (4k) AmigaDOS program, DOpusRT, to help it launch AmigaDOS, WorkBench, Batch andARexx programs. When you start up an external program a script file is createdin the T: ( directory. This script file contains all the initialization and execution code neededto start up and manageyour programs.

The DOpusRT program is called at the end of the script file, and communicateswith Directory Opus to inform it when the script file has finished running. This is neededfor functions that are not run asynchronously.It also doubles asa wait command, which is needed for the adjustableelosedelay.

To take advantageof the current directory changing, adjustable stack, and priority you will needthe commandsCD, Stack and ChangeTaskPriin your computer's C: directory. You will also need the commandsRun, Execute,FailAt, NewCU and EndCLI. These are almost always presentin your C: directory anyway, so you should not ( needto install them.

There area couple of other points to be aware of. Becauseexternal programs arerun via a script file, they can be abortedlike any other 268 CHAPTER5. APPENDICES scriptfile by pressingCI'RL-D.This is only possibleif youhavean outputwindow selected.If thescriptfile is abortedin thisfashion,the outputwindow effectivelyturnsinto a CLI, soyoumusttypeEndCLI to removethewindow. (

Thesecondpointis thatif theprogramwasnot run asynchronously, DirectoryOpuswill befrozen,waiting for thesignalbackfrom the DOpusRTprogram.If you abortthescriptfile beforeit reaches DOpusRT,DirectoryOpuswill neverunfreeze.Youcanforce DirectoryOpusto unfreezebyactivatingtheDirectoryOpuswindow andpressingSHIFf-ESC(theshift key in conjunctionwith theescape key). This alsoallowsyouto turn anynon-asynchronousprograminto anasynchronousprogram,while theprogramis running.

NotethatwhenusingNewCLI or NewShellastheOutput command,anerrorsuchasunknowncommandwill abortthescriptfile aswell, Youshouldthereforemakesurethatall yourbuttons,filetypes, hotkeysor menusdonot try to run nonexistentprograms. (

5.3 Wild Card Patterns

DirectoryOpuscanusewild cards to makesometaskseasier.Wild cardcharactersareexpressionsthattell DirectoryOpusto match(or not match,in somecases)morethanjust onecharacter.Youmay alreadyhaveencounteredpatternmatehingin thediscussionofthe Renamecommand.

? This tokenwill matchanysinglecharacter,butdoesnotinclude none.For example,FI?E would matchFILE, FINE andFIRE but ( not FIE.

# This characterteIlsDirectoryOpusto matchthefollowing expression0or moretimes.For instance,FRE#Dwouldmatch 5.3. WIW CARDPA7TERNS 269

FRE, FRED, FREDD, FREDDD, etc. "#?" will match anything, just like "*" (seebelow).

() is in effect an or. (pi Ip21p3) will match on any one of the ( patternspI, p2 and p3. For instance, (D*G IC*T) would match DOG,CAT, DIG, COT, etc. You may include asmany patternsinside the parenthesesasyou like, separatedby vertical bars ( I).

Use this token within parenthesesto separatedifferent expressionsyou wish to match at the sametime. For example, "( abIcd)" will match any one of the items separatedby " I" (here,"ab"and "cd").

% Matches0 characters.This is always (useful in an instancelike "(foo I barI %) "). Another example: "CA (M 1%) P" will match CAMPandCAP.

* Synonym for "#?",an asteriskwill match any number of ( repetitions of any characters,including none. For instance,"F*" will match F, FR, FRE, FRED, FREDD, FREDDY, etc.

- The tilde canbe usedto negatean expression. Anything that would normally match, now will not match. For example, "F- (ROG)" will match FROMbut not FROG.,,- J*" will not match anything starting with J.

[ ] Bracketsenclosea list of characters(a "character dass") that match any of the charactersin the dass. "[abc]" teIls Directory Opusto match either "a", "b", or "c" in this position.

- A tilde at the beginning of a characterdass matchesany charactersthat arenot in the dass. For example, " [-bc]" says "match any characterexcept "b" or "c". ( - A hyphen indicates a characterrange(only within character classes).The expression" [a-z] " representsall the lowercase letters from "a" to "Z". 270 CHAPTBR5. APPENDICES

) (apostropheorsinglequote)Usethischaractertodeclarethe following charactertobealiteral character,usedasit stands insteadof asawildcard. This permitsyouto usethecharacters#, ?, I,%, (, ), [, J, *, - andevenanapostropheasthemselves ( ratherthanaspattern-rnatchingcontrolcharacters.Forinstance, • YEAR*) %will matchYEAR1989%, YEAR1990% but not YEAR1989 or YEAR1990 aswould normallybethecase,with %meaning matchon nothing.Notethatthismeansthatyoumustuse) ) to matcha apostrophe.

Note: "Expression"in theabovetablemeanseitherasingle character(ex: "#?"), or analternation(ex: "# (abIcdIef) "),or a characterclass(ex: "# [a-zA-ZJ ").

(

( 5.4. SHORTCUTKEYS 271 5.4 Shortcut Keys

( Thesearethe default shortcut keys. Each of thesecan be redefined using the ConfigOpus utility.

Command Shortcut Key Addlcon Left Shift Ctrl I All Od A Are Extract Orl E Checkfit Od F Clone Od L Comment Left Shift Od C Configure RightAmiga C Copy Od C DateStamp Orl D Delete Left Shift cer D Edit Left Shift cei E ( GetSizes cer G HexRead Od H Hunt Left Shift Od H leonify RightAmiga I leonInfo Od I MakeDir Orl M Move Left Shift Od M None Od N Parent Od P Play Od y Print Left Shift Od P Protect Od T Quit RightAmiga Q Read cer R Rename Left Shift cer R ( Root Od 0 Run Od U Seareh Left Shift Od S Show Od S 272 CHAPTER 5. APPENDICES 5.5 Simple Shortcut Keys

I Action ShortcutKey ( ToggleHelp Mode Help Aetive DireetoryField ReturnKey Max Right Window - Max Left Window \ CenterWindows = ChangeAetiveWindow spaeebar SerollWindowUp OneLine UpArrow SerollWindowDownOneLine Down Arrow SerollWindowto Top Shift Up Arrow SerollWindow to Bottom Shift DownArrow SerollWindowRightOneColumn RightArrow SerollWindowLeft OneColmun Left Arrow SerollWindowto FarRight Shift RightArrow SerollWindowto FarLeft Shift Left Arrow (

( ( Index

(unusedin Directory Opus4.0) about the prograrn,48 Status value29, 256 About, command,176 Status value 30, 256 accentedcharacters,62 Status value31, 256 action even~106 Status value32, 256 Active, 26:1 Status value33, 256 active, 10, 12 Statusvalue 34, 256 Active window ",25 Status value 3, 253 +,117 add a new command,87 -,117 add banks,82 -i,9 add comments,30 .info file, 137 add display items, 138 / character,6 add prefixesor suffixes,25 ?- Help, 41 AddCustEntry, command,177 ( unusedin Directory Opus4.0 AddCustHandler,command,178 Status value 23, 255 AddFile, command,179 Statusvalue 24,255 AddIcon's icons.•• 12hour dock ConfigOpuslist, 165 ConfigOpusbutton, 132 Addlcon, command,165,166, 180 12hour format, 132 ADDRESS,ARexx command,92 24 bit 1L8M pictures,104 advanceto next sound,37 24 hour format, 132 AGA, 35, 172 4096color, 35 Alarm, command, 8 bit pictures,35 180 All, 22 8-bits per gun color All bits, protection bit button, 57 ConfigOpusbutton, 172 All Custombutton, 20 8-point fonts, 147 8SVX, 37, 136,172,231 All, command,181 alternative image,36 A - ARexx, 40 Alwaysmoveto empty buffer A1000,172 ConfigOpusbutton, 161 abort a print, 71 Alwaysreplacefiles, 130 abort asound, 37 Amiga Input Preferences,16 abort directory print, 67 AmigaDOS,26,39, 57, 62, 64, 133,156 ( abort Format, 63 ConfigOpusbutton, 153 abort Install, 65 Info command,163 abort pic/anim view, 36 path,101 Aborting, 10 wildcard pattern, 118 An Applcon, 160 AbortPrint, command,176 And,115

273 274 INDEX

ANIM,l71 backgroundcolors,86 animat.ionviewer,171 Backgroundpalettebox, 146 animations,35, 171 Backspace,14 ANSI control sequences,34,136 backwardsscrolling,73 ANSI standard,173 bank, 185 AnsiRead,108 bank of buttons, 49 AnsiRead,command,173,181 BankNumber,217 appearance,144 banks,82 AppIcon, 91, 160 Batch, 89, 91 AppWindow, 50 Batch files,91 ARC, 33, 53, 103 batch files, 30 archive,53 batch script, 156 archivebit, 127,130 Beep,command,183 archiveextracting, 107 before,177 archivefile, 33 bgpen,177 Archive Protection button, 58 binary, 252 Archive,file protection bit, 56 Binary file viewer,108 archives,108 binary files,35, 75 ARexx, 89, 92 bits, 234 ARexx command,41 Black backgroundbetweenpictures ARexx function, 40 ConfigOpusbutton, 171 ARexx script, 41, 92 blank screen,171 ARexx scripts, 170 Blocksfree, 163 ARexx, command,182 boot sector,64 arguments,91 boot up, 7 arrowbuttons, 136 bootable,52,63, 65 ( Arrows borders,text viewer,173 ConfigOpusbutton, 143 Bottom Margin, 68 ASCII, 35, 76, 116 Bottom-right tiny buttons ASDG-lnc,8 ConfigOpusbutton, 148 Ask beforereplacing,130 brushes,35, 136 Assign,command,182 buffer, 161 assigneddirectories,98 Buffer displayed assigneddirectory,23 Status value21, 255 assignment,22,26 Buffer List, 22,40 assignmentexpansion,22 buffer list , 23 audiofilter, 172,231 buffereddirectory,161,162 AudioMaster,37, 231 Buffereddirectory name Auto disk load Statusvalue17, 255 ConfigOpusbutton, 162 Buffereddisk freebytes Auto diskchange Statusvalue19,255 ConfigOpusbutton, 162 Buffereddisk total bytes Auto iconify, 92 Statusvalue20, 255 Automatic Startup, 8 Buffereddiskname Available displayitems... , 139 Status value18, 255 availablespace,27 bufferlist function, 38 ( BufferList, command,184 B,73 Buffers,265 B - Buffer list, 38 buffers,20, 71 Backgroundcolors,126 Buffersper window INDEX 275

ConfigOpusfield, 161 Deletebank, 84, 99 buffera,directory window,161 Deletebutton, 84 bug, ExAliO function, 163 Deletedrive, 100 bug, notification, 142 Deleteitem, 125 built-in project icon, 166 Deletemenu, 124 ( bulletin boards,33 Deleting files, 132 bump, keyword,194 Deleting non-emptydirectories, 132 Busy,command,184 Directories,153 Button bankssliders Directory refreshusing ConfigOpusbutton, 149 Start.Notifyf}, 142 button configurationscreen,83 Display info, 135 Button RowsMenu, 85 Display progressindicator, 141 ButtonIconify, command,185 DOS requesters,133 ButtonRows,217 Double-click/Click-rn-clickdirectory Buttons read,162 ConfigOpusbutton, 79 Draggablerequesters,149 Buttons, ConfigOpus Drives, 79 12 hour clock, 132 Duplicate, 115,120 8-bits per gun color,172 Edit Class,109 Always moveto empty buffer, 161 Error check,128 AmigaDOS,153 Expand pathnarnes,162 Arrows, 143 File double-click,136 Auto disk load, 162 Filetypes, 79 Auto diskchange,162 Fonts, 143 Black backgroundbetweenpictures, General,128,144 ( 171 Get drives,98 Bottom-right tiny buttons, 148 Half-height screen,152 Button bankssliders,149 Hide files with hidden bit set, 168 Buttons, 79 Hotkey, 154 Checkdestination'sfree space Hotkeys,80 beforestarting, 129 Icons,128,154 Clear, 140 Ignore the deleteprotection bit, 133 Click-M-Click drag,134 Indioarebutton has RMB function, Clocks, 153 149 Colors,143 Insert item, 125 CommandType, 89 Left-justify filenamein status bar, Commencingdelete,132 141 Comment,130 List Format, 128 Copy, 127 Loop on double-click,172 Copy bank, 83, 99 Memory monit.or, 158 Copy button, 84 Menus,80 Copy drive, 100 Modules, 154 Copy item, 125 Namesubstitution (Today, Copy menu,124 Tomorrow, etc), 132 CPU monitor, 158 New, 104 ( Createiconswith directories,136 New bank, 83 Date, 158 New entry, 114 Date format, 127 New Hotkey, 120 Datestamp,130 New-lookslidera,149 Delete, 104,115,121,127 Next bank, 83 276 INDEX

Okayand Cancel,lOS, 144,154 Buttons/Manager screen,83 Operation,80 byte locations,112 Opuserror requesters,134 byte pattern, 119 Palette, 144 Byte, command,135 Parent/Root operation, 161 bytes,4 Perform all actions on iconsaswell, Bytesfree, 158,163 ( 137 bytes,selected,27 Protection bits, 130 byword,keyword,246 Re-readchangedor incomplete buffers,161 C - Configure,44 Redrawmore than a quarter of a C: and F:, 159 page,142 c:ED,37 Reset,140 cache,keyword,201 ReverseSorting,140 Cancelstring Sample,87, 102,122,126,165 Status value27, 256 Screen,80 Cancel,ConfigOpusbutton, 80 Screenmode,144 CD destination,93 Scroll directory window to follow CD source,93 operation, 141 CD, command,185 Selecticonsautomatically, 137 CDRom, 163 Set archivebit of sourceafter Cfg return finishing, 130 Config'Opusfield,170 Showpattern, 154 Cfg Return ARexx script, 170 Sort bank, 100 changecolors,145 Sort menu, 124 ChangeCurrent Dir Requester,47 Start animation paused,171 changediskname,52 ( Startup, 154 changehelpfilename,47 Swap,104,115,121 changethe datestamp,31 Swapbank, 84, 99 changethe volumename,60 Swapbutton, 84 chars,244 Swapdrive, 100 Checkdestination'sfree spacebefore Swapitem, 125 starting Swapmenu,124 ConfigOpusbutton, 129 System,80 checkspace,127 Tab size,173 CheckAbort,command,186 Text viewerborders, 173 CheckFit, command,186 Time, 158 Chip Memory,158 Turn audio filter off for play, 172 CHIP: and FAST:, 159 Update, 129 dass definirion, 109 Update free disk space,141 ClassID Usedefault, 151,152 ConfigOpusfield, 114 UseExAll( ), 163 Clear, 110 Usemiddle mousebutton, 165 ConfigOpusbutton, 140 View & Play, 154 clearall protection bits, 57 Visible screentitle buttons, 148 ClearBuffers,38 Window slider activate, 136 ClearClips, 98 ( buttons, custom,82 clearfile dass definitions, 110 buttons, protection bit, 57 clear,directory sizes,28 Buttons/Editor, 86 ClearBuffers,command,187 Buttons/Manager, 82 ClearSizes,command,187 INDEX 277

ClearWin, comrnand,188 Alarm, 180 CLl, 7,9,30,78,89-91,156 All, 181 Click-M-Click, 16, 107, 265 AnsiRead, 173, 181 Click-M-Click drag ARexx, 182 ConfigOpusbutton, 134 Assign, 182 ( clipboard, 97, 98 Beep, 183 clock, 46, 49 BufferList, clock bar, 158 184 dock format , 132 Busy, 184 Clock Information, 157 Buttonlconify, 185 Clock/Memory Bar, 10 Byte, 135 Clock/memory bar, 158,159 CD,185 Clocks CheckAbort, 186 ConfigOpusbutton, 153 CheckFit, 186 Clone, command, 189 ClearBuffers, 187 dose all windows,160 ClearSizes,187 Closebutton, 50 ClearWin, 188 closebutton, 148 Clone, 189 Closedelay Cornment, 44,189 ConfigOpusfield, 96 Configure, closewindow and screen,49 190 code, 198 ContST,190 color changes,145 Copy, 44, 191 color information, 172 CopyAs, 44, 191 color palette, 145 CopyWindow, 192 ( Colors DateStamp, 44, 46, 192 ConfigOpusbutton, 143 Defaults, 193 ConfigOpusfield, 152 Delete, 193 colors, 86,126,144, 151 DirTree, 194 pen, 143,145 DiskCopy, 194 screen,145,149 columns,69 DiskCopyBG,195 Command,89 DiskInfo, 195 command, 182 DisplayDir, 196, 226 Command Edit Field, 92 DOpusToBack, 196 Command Edit Menus 97 DOpusToFront, 197 Command Editor, 87, 88, 91 Encrypt, 197 commandevent, 106 ErrorHelp, 198 Oommandstring, 88 Execute, 91, 198 CommandType FileInfo, 199 ConfigOpusbutton, 89 FinishSection, command,ARexx, 41 200 Format, Ccmmands 201 AbortPrint, 176 FormatBG,202 About, 176 GetAll,202 ( AddCustEntry, 177 GetDevices,203 AddCustHandler, 178 GetDirs, 203 AddFile, 179 GetEntry, 204 Addlcon, 165,166, 180 GetFiles, 205 GetFileType, 204 278 INDEX

GetNextSelected,205 SaveConfi_g,243 GetSelectedAll,206 ScanDir,:l43 GetSelectedDirs,206 ScrollH,244 GetSelectedFiles,207 ScrollToShow,244 GetSizes,186,188,208 SerollV, 245 Search,44, 203,246 ( GetString, 208, 256 Select,247, 254 Help, 209 SelectEntry,249 HexRead,209 SelectFile,250 Hunt, 44, 203,210 SetWinTitle, 250 Iconify, 210 Show,251 IconInfo, 211 SmartRead,J,.252 Install, 213 Status, 25", InstallBG,213 StopST,257 LastSaved,214 SwapWindow,257 LoadConfig,214 TechSup'port,258 LoadStrings,215 Toggle,:l58 LoopPlay, 215 TopText, 259 MakeDir, 137,216 Uniconify, 259 Modify, 216, 235,238,244 User1,User2,User3,User4,260 Move, 44, 227 Verify, 260 MoveAs,44,J,. 228 Version,261 NewCLI,2",8 Commencingdelete NextDrives, 229 ConfigOpusbutton, 132 None,229 Comment OtherWindow, 229 ConfigOpusbutton, 130 Parent, 161,230, 242 comment,19,30, 52, 117,135,179,189 PattemMatch,230 CommentRequester,31 Play, 231 Comment,command,44, 189 PlayST,231 comment,max length, 30 Print, 232, 233 Commodities,120 PrintDir, 233 CommoditiesExchange,120 Commodore'sEd, 8 Protect;,.44, 212,234 Query, ,,34 CON,156 Quit , 235 CONFIGFILE, ToolType,9 Read,236, 252 ConfigOpusicon, 78 Redraw,226 237 ConfigOpusmain screen,77 Relabel,237, 254 ConfigOpus/System/Clocks,49 Configuration,78 Remember,238 Configurationchanged RemoveEntry,J,238 Status value25, 255 RemoveFil~ ,,39 Rename,2,.,9 configurationfile, 9, 81, 121,125 configurationprogram,38 Request,240, 256 configurationprogram,loading,48 Rescan,226,240 configuration,saving,49 ( Reselect,241 configuration..• , printer option, 69 Restore,241 configurebutton row number,85 Root, 161,242 configurefunction, 44 Run, 242 ConfigureMenus,81 INDEX 279

eonfigurethe drive buttons, 98 Currently ieonified eonfigurethe menus,123 Status value 28, 256 Configure,command,190 Cursor key, 14 Console Cursor key + Ctrl, 73 ConfigOpusfield, 156 Cursor key + Shift, 14, 73 ( CONTROL, 165 Cursor keys, 73 eontrol key, 165 custom button banks,149 ContST, command,190 Custom button configuration, 37 Copy,83,97 Custom Button Edit screen,86 ConfigOpusbutton, 127 Custom Buttons, 11,20,87 eopy,10, 12 Custom buttons Copybank default, 20 ConfigOpusbutton, 83, 99 custom buttons, 82, 97 Copybutton, 50 cuatommenu items, 123 ConfigOpuabutton, 84 Custom Menus,11 eopyeurrent bank, 83 custom screen,151 Copydrive Cut, 97 ConfigOpusbutton, 100 eyde button, 138 eopyfiles, 16 Cyde Colors,36 Copy item cycle through buffers,38 ConfigOpusbutton, 125 eyde through the button banks,83 Copymenu CygnusEd,8 ConfigOpusbutton, 124 eopyof disk, 50 D,73 eopyof onedisk, 59 dash,58 ( eopyof seleetedentries,25 Date, 159 eopyseleetedfile, 23 ConfigOpusbutton, 158 Copy,cornmand,44,191 date, 19, 117, 132,192 CopyAsRequester,24 Date format ConfigOpusbutton, 127 CopyAs,command,44,191 date format, 131, 158 CopyFlags,217 eopyingfiles and direetories,129 date, changing, 46 date, keyword, 247 CopyWindow,command, 192 Date, printer option, 70 CPU monitor, 159 DateFormat, 217 ConfigOpusbutton, 158 dates, 52 CPU time, 158 Datestamp ereatea new File Class,109 ConfigOpusbutton, 130 CreateIcons With Directories,26 datestamp,4, 135 Createicons with direetories DateStamp Requester, ConfigOpusbutton, 136 31 createnew button bank, 83 DateStamp,comrnand,44, 46, 192 Creation date, 139 datestrings, 117 CTRL-SHIFT-ALT, 49 Decimal,112 current date, 158 decrypt, 34 Current directory Default , 81 ( Status valueI, 253 default configuration, 10, 81, 121,125 current direetory,46 Default Custom Buttons, 21 eurrent screen,79 default Custom buttons, 20 eurrent time, 158 default Hotkeys, 165 current version,48 Default icons, 33 280 INDEX

Default Menus,45 directories,clearingsizes,28 default priority, 157 directories,selected,27 Default Tool, 90, 166,211 directory, 95, 98 default Workbenchproject icon, 166 directory buffers, 20, 161 Defaults, command,193 Directory Caching,62 DefaultTool, 217 directory entries, 163 ( definea new Hotkey, 120 Directory Field, 13 Dekte, 14,83, 88, 110 Directory Field, activating, 14 ConfigOpusbutton, 104,115,121, Directory name 127 Status value 13, 254 deleteall selectedentries,26 directory name,4 Deletebank Directory Opus Info Requester,32 ConfigOpusbutton, 84, 99 Directory Opus to front, 93 deletebanks, 82 directory pathname,startup, 169 Deletebutton Directory refreshusing Start.Notifyf} ConfigOpusbutton, 84 ConfigOpusbutton, 142 deletecornmands,88 Directory Tree, 42 Deletedrive directory tree, 6 ConfigOpusbutton, 100 Directory Tree Example,5 Deleteitem Directory Treefunction, 41 ConfigOpusbutton, 125 Directory Window, 13 Deletemenu Directory window, 266 ConfigOpusbutton, 124 directory window buffers,161 Deleteprotection bit , 133 Directory Window with SelectedFiles delete,accidental,10, 24, 26, 61 and SubDirectories,15 Delete,command, 193 Directory Windows, 3, 11 ( Deleteable,file protection bit, 57 Directory Windows,resizing,19 DeleteFlags,218 directory, current, 46 Deleting files directory, print, 52 ConfigOpusbutton, 132 DirFlags, 218 Deleting non-empty directories Dir'Iree, command,194 ConfigOpusbutton, 132 disk, 64, 162 deletion, 133 disk changes,162 DeluxePaint,91 Disk Copy,50 depth button, 148 disk drive source,59 depth, screen,144,150 Disk freebytes deselect,15 Status value15, 254 destination, 191,227 Disk icon, 212 destination drives, 59 Disk Info Requester,53 Destination Window, 12 disk Information, 53 destinations,194 disk is corrupt, 65 device,62, 98, 237 Disk Name,13, 14 DEVICE LIST, 40 Disk narne DeviceList, 41 Status value14, 254 device,format, 62 Disk Operating System,4 DEVICE:, 156 Disk total bytes ( devices,30, 63 Status value16, 254 Directories DiskCopy,60 ConfigOpusbutton, 153 DiskCopy Requester,60 directories, 4, 5, 7 DiskCopy,command,194 INDEX 281

DiskCopyBG,command,195 drive source,59 DiskInfo, command,195 Drives display a font, 36 ConfigOpusbutton, 79 display icons,36 Drives Editor, 101 ( display in 4 bit format, 36 Drives/Editor, 101 display in 8 bit format, 36 Drives/Manager,99 Display info Duplicate, 88,110,111 ConfigOpusbutton, 135 ConfigOpusbutton, 115,120 Display item•.. duplicatecommands,88 ConfigOpuslist, 146 duplicate hotkey, 120 Display mode•.• Dynarnic HiRes,35 ConfigOpuslist, 150 Display progressindicator E - Error help, 42 ConfigOpusbutton, 141 Edit, 109,111 DisplayDir, command,196,226 edit a custombutton, 85 DisplayLength,218,235 edit a filetype, 105 Do a1l files, 93 edit a Hotkey, 121 dog-ear,20, 149 edit a menuitem, 125 DOpus-Startup,94 Edit Class DOpusToBack,command,196 ConfigOpusbutton, 109 DOpusToFront,command,197 edit file dass, 109 DOS, 4, 43 editing the Directory Field text, 17 DOS error codes,47 editor, 37 DOS requesters EHB,35 ( ConfigOpusbutton 133 Eject Final Page,69 Double-click, 16, 107, 266 Elite, 69 Double-ClickTime, 16 empty buffer, 161 Double-click/Click-m-click directory read Encrypt, command,197 ConfigOpusbutton, 162 EndCLI,9 Draft,69 Englishlanguage,167 drag a file, 107 entries,3 Drag Bar, 79 deselecting,22 drag bar, 165 selecting,22 drag icon, 50 Entries per page drag-selectlng, 15, 135 Status value24, 255 Draggablerequesters entries,matching, 28 ConfigOpusbutton, 149 Entry, 266 dragging,135 entry, 244 Drawer, 165 Erase,14, 98 Drawer icon, 212 erase,51, 63 drawericon, 128,137 erasedrive bank, 100 drawers,5 Error check drive, 201,213 ConfigOpusbutton, 128 drive bank height, 85 error codes,43 ( drive banks,101,149 Error help, 47 drive button, 100,162 Error Help Example,43 Drive Buttons, 11 error help, storageof, 47 drive buttons, 98 error message,134 drive buttons, confiy;ure,79 error messages,10 Drive gadgets,266 error requesters,128 282 INDEX

ErrorFlags, 219 Name,101,122,126 errorhelpfunction, 42 Path, 101 ErrorHelp, command,198 Priority, 96, 157 Events..• Project's Oefault Too!. .. , 166 ConfigOpuslist, 106 Right, 170 exarninea file, 107 Shell,155 ( Example Hex ReaderFormat, 35 Show,169 exchangecustombuttons, 84 Showdelay,172 excludefiles, 154 Stacksize,96 Executable,89 Start-Up Script, 156 executableprograms,90, 102,136 Startup, 170 Execute,command,91, 198 Uniconify,170 Executeable,file protection bit, 57 Width,151 Exit print requesterbutton, 67 File, 66, 71 exit text viewer,74 file, 95, 102 Expand pathnames File Class,103,104,110,120 ConfigOpusbutton, 162 ConfigOpusfield, 114 ext.ernalmodule, 167 File Class- File Viewer, 112 external modules,154 File Class- File Viewer (showingoffset), External support modules... 113 ConfigOpuslist, 167 File Class- File Viewer (showing extra halfbrite, 35 position),113 extract files, 33 File Classdefinition, 109,115 File ClassEditor, 111,111 F - Sub-OirectoryFilter, 43 File ClassEditor Components, F:,159 114 File Classidentification, 114 Fadedelay File Class Menus, ConfigOpusfield, 172 110 File Classes,103 FadeOelay,219 file classes,configure,79 Fast File System,62, 65 File comment,139 Fast Memory,158 ConfigOpusfield, 139 FAST:, 159 File double-click ffs, keyword,201,213 fgpen, 177 ConfigOpusbutton, 136 File field, 66 Fields, ConfigOpus file Hags,55 Buffersper window, 161 file information, 135 Cfg return, 170 File name,139 Class10, 114 ConfigOpusfield, 139 Closedelay,96 file path, 6 Colors,152 File ProtectionBits Console,156 Archive,56 Fadedelay,172 Oeleteable, File Class,114 57 Executeable, File comment,139 57 File name,139 Hidde~ 55 Pure, File type, 139 :;,6 ( Readable, File viewer,111 56 Script,56 Height, 152 Writeable,56 Hide, 169 file recognition,79 Left, 170 INDEX 283

File SelectRequester,40 floppy drives, 59 File size,139 floppy-basedsystem,48, 18 file sizes,52, 129 Font,219 File type, 139 font,113 Confi~~us field, 139 Font••• ( File types, 6 ConfigOpuslist, 141 File viewer Fonts ConfigOpusfield, 111 ConfigOpusbutton, 143 file viewerscrolling, 12 fonts, 35, 136, 146,141,158 file viewer,movementin, 13 Footer, 69 Filelnfo, command,199 force,keyword, 235 filenaxne,19,198,204,243 Foregroundcolors, 126 filenamescontainingspace,94 foregroundcolors,86 files, 4, 6 Foregroundpalette box, 146 files, exclude,169 Form Feed,69 files, selected,21 Format, 51, 63 files, showlist of, 169 Format Requester,61 files, size,27 format the dock bar, 151 Filetype, 114 Format, command,201 filetype action editor, 104 format , date, 127,131 Filetype Actions, 87 FormatBG, command,202 Filetype configurationscreen,103 formating, 63 Filetype Edit CommandsRequester, free blocks, 163 116 free bytes, 163 Filetype managerscreen,111 free space,163,164 ( FileTypes, 102 free spacedisplay, 141 Filetypes,97, 102,104,136 FullView, 166 ConfigOpusbutton, 19 Function Argument Requester,93 Filetypes editor, 105 Function Editor, 45 Filetypes/Ediror, 106 Function Menu, 50 Filetypes/Manager,103 Function strings, 92 fileviewer, 112 Function/Disk Copy,51,63 Filter, 219 Functions,45 filter, 43, 231 filter, audio, 172 General filter, turn off, 44 ConfigOpusbutton, 128,144 Find File Requester,29 Generalf'Iaga,220 Fine print pitch, 69 Get Devicesfunetion, 40 FinishSeetion,command,200 Get drives first entry by letter, 19 ConfigOpusbutton, 98 first file by letter, 19 GetAll, command,202 fit, 27 GetDeviees,cornmand,203 flags,clock, 151 GetDirs, command, 203 flags,file, 55 GetEntry, command,204 ( flags,misc., 128,132-134,136,142,162 GetFiles,command,205 Flags... GefFileType. command,204 ConfigOpuslist, 92 GetNextSelected,command,205 floppies,62 GetSelectedAll,command, floppy drive, 8, 162 206 GetSelectedDirs,cornmand,206 284 INDEX

GetSelectedFiles,command,207 Hotkeys,87, 120 GetSizes,command,186,188,208 ConfigOpusbutton, 80 GetString, command,208,256 hotkeys, 49 graphieuser interface, 80 Hotkeys,configure,80 Hotkeys/Editor, 122 ( H bit, 168 Hotkeys/Manager, 121 Half-heightscreen HSPARWED, 55, 117 ConfigOpusbutton, 152 hunt pattern, 28 HAM,35 Hunt, command,44, 203,210 handle, 94, 228 hunt, device,28 hard drive, 6 hunt, file, 28 Header,69 Height, 156 I - Iconify, 44 ConfigOpusfield, 152 Icon,91 Height field, 152 icon, 137 Help, 36, 47 icon alternative image,36 Help button, 79 icon dragging, 50 Help Example, 43 icon file, 90 help file, 41, 46 icon Images,166 help function, 41 icon types, 165 Help, command, 209 IconFlags,220 HelpFile, 220 iconifica.tion,49 Hex, 112 Iconified, 159 Hex File Viewer, 75 iconified,9, 164 Hex Viewer, 75 iconified window, 158,159 Hex/ASCII,l11 iconified window position, 49 ( Hexadecimalfile viewer, 108 iconify function, 44 hexadecimalformat, 35,112,136 Iconify Type, 49 HexRead,108 Iconify type, 49 hexread,252 Iconify, command,210 HexRead,command,209 IconifyFlags, 220 hidden button, 17 IconInfo, command,211 hidden buttons, 73 Icons hidden sizebar, 19 ConfigOpusbutton, 128,154 Hidden, file protection bit, 55 icons,32,90, 103,136,165 Hide Iconsfor Workbench,102 ConfigOpusfield, 169 icons,creating, 26 Hide files with hidden bit set icons,remap colors,212 ConfigOpusbutton, 168 ICONSTART, ToolType, 9 HidePattern, 220 IconX, 30 High Res,150 idle time, 158 High ResLaced, 150 IFF, 35, 37, 114,136,171,172,231 high-passaudio filter, 172,231 IFF ILBM pictures, 104 high-resolution mode, 142 IFF pictures, 102 Highlight, 266 Ignore the deleteprotection bit ( Horizontal Window View Sliders,19 ConfigOpusbutton, 133 Hotkey, 122, 165 ILBM, 35, 104,136,171,172 ConfigOpusbutton, 154 import Custom Button banks,82 hotkey, 164 import custom button banks,85 Hotkey editor screen,121 import File Classdefinitions, 110 INDEX 285

import Hotkeys,121 LastSaved,eommand,214 import menus,125 Left Inactive, 266 ConfigOpusfield, 110 inactive,12 left Alt keys,165 inaetive Direetory Window, 12 Left margin, 68 ( Include DOpus-Startup,94 left shift key, 165 Include Shell-Startup,94 Left window, 110 Indieate button hasRMB funetion Left-justify filenamein status bar ConfigOpusbutton, 149 ConfigOpusbutton, 141 Info command,AmigaDOS 163 LeftEdge, 156 Initial RenameRequester,24 Letter, 69 initial renamerequester,25 LHA, 33, 53, 103 initialize, 51,63 LHARC, 33, 53 inovamusic.library,31 Line Number,print starting, 61 INOVAtronics,48 lines, 245 Input Preferences,16 linesper printed page,68 insert beforecurrent bank, 83 list deviees,40 Insert item list direetories,38, 40 ConfigOpusbutton, 125 List Format Install a disk, 52 ConfigOpusbutton, 128 Install Boot Sector,65 list formats, 138 Install Requester,63, 64 list volumes,40 Install, command,213 ListFormat, 221,235 installation program.1 Lists, ConfigOpus InstallBG, command,213 AddIcon's ieons••• , 165 ( InstallOpus, 1, 8 Display item... , 146 integrity verification, 59 Display mode••• , 150 inter, keyword,201 Events•.• , 106 interlaced, 152 External support modules••• , 161 interlacedscreen,150 Flags••• ,92 Internal CommandRequester,90 Font•.. , 141 International Mode,62 Language••• , 161 item, 234 Presets.•• , 149 Size••• , 141 jump to buffer, 38 Load eonfiguration,81 Jump to Line in File, 73 load from disk, 48 Jump to Percentof File, 74 LoadConfig,command,214 LoadStrings,eommand,215 keyboardequivalent,20 Loop on double-elick keyboardequivalents,19 ConfigOpusbutton, 112 Kickstart, 48 looped,112 Kilo/Megabytes free, 159,163 LoopPlay,108 kilobytes, 159,163 LoopPlay,eommand,215 low-memorysituations, 92 label, change,52 LSHIFT,165 ( Laeed,150 Lake ForestLogie,35 MacroPaint, 35 LALT,165 magnifyingglass,66 Language••• magnifying-glassbutton, 89 ConfigOpuslist, 161 Main ScreenFunctionMenu, 51 286 INDEX

Main ScreenProject Menu, 45 moveto bottom, 19 MakeDir Requester,27 moveto previousbank, 83 MakeDir, comrnand,137,216 moveto top, 19 Mask,58 Move,command,44,227 Match,116 MoveAs,command,44,228 ( match a FileType, 102 movementin file viewer,73 match the charact.erpattern,118 MoveTo,118 MatchBits, 117 musicscore,108 MatchComment,117 MatchDate, 117 Name matching file, 115 ConfigOpusfield, 101,122,126 MatchName,118 name,179-182,189,191-193,197,199, MatchSize,118 209-211,214-216,227,228, MED,231 231,232,234,236,239,242, Med,37 246,250-252 megabytes,159,163 nameof the directory,26 MEmax, 8 Namesubstitution (Today,Tomorrow, memory,158 etc) load cfg into, 44 ConfigOpusbutton, 132 saving,44 name,change,52 Memory Monitor, 158,159 name,directory,4 Memory moriitor, 159 name,keyword,247 Confi~Opusbutton, 158 Networks,163 Menu,26b Neverreplacefiles,130 Menu Configurationscreen,123 New, 58, 109,111 menuitem, 126 ConfigOpusbutton, 104 ( menuitem shortcut key,126 New bank Menus,87 ConfigOpusbutton, 83 ConfigOpusbutton, 80 new directory,161 menus,97 New entry,87 Menus,configure,80 ConfigOpusbutton, 114 Menus/Editor, 126 new filetypeentry, 104 New Hotkey Menus/Manager,123 message,208,240 ConfigOpusbutton, 120 newname,24,189,191,228 MIDI,37 miscellaneousflags,128 New-looksliders ConfigOpusbutton, 149 mode,screen,144,150 modify your startup sequence,7 NewCLI, ISS,156 NewCLI, modify your startup-sequence,8 command,228 NEWCON,156 Modify, comrnand,216,235,238,244 newname,237,239 Modules NewShell,155 ConfigOpusbutton, 154 NewTek,81 modules,song,231 NewWsh,155 monitors, 150 Next,36 mono, 231 Next and PreviousBufferbuttons, 13 ( MousePointer On/Off, 36 Next bank Move,14, 119 ConfigOpusbutton, 83 moveentriesbetweendirectories,23 Next Buffer button, 20 moveoneline, 18 Next Frame,36 moveonepage,18 INDEX 287

NextDrives,command,229 ConfigOpusbutton, 80 No Boot, 65 Operation Configuration Screen,121 No Disk Present,64 Operations, 128 No filenamequote, 94 Operations/Copy, 129 No Icons, 52 Operations/Date Format, 131 ( No Window, 160 Operationa/Delete, noboot,keyword,213 133 noicons,keyword,201 Operations/EITor Check,134 Noiee'Tracker,31,231 Operations/General,135 non-interlaced,152 Operations/Icons, 137 non-proportional fonts, 141 Operations/List Format, 138 Non-Standard,65 Operations/Update, 141 ncn-text characters;"35,136 optional parameters,156 None,command,2",9 Options, 156 None,protection bit button, 51 Opus error requesters Normal 1.3 OFS bootblock, 64 ConfigOpusbutton, 134 Normal 2.0+ FFS bootblock, 64 Or,116 notification, 142 Original Speed,36 novice, 1, 20, 18 OS1.3,146,148,150,156,166,212 num,204 OS2.0,62, 149,ISO, 163,166,212 number, 238,249 OS3.0,163 Number of dirs OtherWindow, command,229 Status value 5, 253 output to a file, 66, 11 Number of entries Output to file, 94 ( Status value6, 253 output to the printer, 66, 11 Number of files Output to••• , 66 Status value 4, 253 Output to••• , printer option, 10 Number of selecteddirs Output window, 94 Status value 8, 253 output window, 96 Number of selectedentries output windows,155,156 Statusvalue9, 253 OutputCmd, 221 Number of selectedfiles OutputWindow,221 Status value1, 253 overscan,35

Octalizer, 31 Pageno., printer option, 10 OctaMed,31 PAL,l12 offset,35, 15 Palette Okay and Cancel ConfigOpusbutton, 144 ConfigOpusbutton, 105,144,154 palette, 101,126,149 Okay string presets,150 Status value26, 256 palettes,86 Okay,ConfigOpusbutton, 80 parameters,156 Oktalizer, 231 parent directory, 5 01d,58 Parent, command,161,230, 242 ( onlydirs, keyword,241 Parent, hidden button, 11 onllfiles, keyword,241 Parent/Root operation on Ioff, keyword,184 ConfigOpusbutton, 161 Open, 110,266 ParNet, 163 Open••• ,81 password,34, 191 Operation Paste,91 288 INDEX

Paste••• ,97 Print formatting, 38 Path print formatting, 67 ConfigOpusfield, 101 Print pitch, 69 path, 6, 185,195,243 Print Requester,67 path lists, 94 print the directo~ 52, 65 path, file, 6 Print, command,,,32,233 ( pathname,6, 14 Print, printer option, 71 pathnameof startup directory, 169 PrintDir, command,233 pathnames,162 Printer, 66, 71 pattern, 28, 169,210,230,246,247 Printer Preferences,67 pattern matehing. 28, 29, 74 printers, 67 PatternMatch, command,230 printing a file, 38 pauseanimations, 171 Priority pen colors, 143,145 ConfigOpusfield, 96, 157 Percentageofspacefree, 164 progressindicator, 141 percentageof the file, 27 Project, 165 percentage,CPU time, 158 project,90 Perform all actions on ieonses weIl Project icon, 212 ConfigOpusbutton, 137 projecticons, 166 Pica, 69 Project'sDefault Tool••• pieture, 171 ConfigOpusfield, 166 pieture files,3 Protect Requester,33 Pieture viewer, 171 Protect, command,44, 212,234 pictures, 35, 104,136,171,172 protectedfiles, 133 pixels, 156 protecting files,32 Play, 108 protection, 179 ( play files assounds,37 protection bit , 168 play soundslooped, 37 protection bit buttons, 59 Play, command,231 Protection Bits player, sound,172 Archive, 56 Playing sounds,108 Deleteable,57 playing soundsin loops, 108 Executeable,57 PlayST, command,231 Hidden,55 portname, 178 Pure, 56 position, iconified window, 49 Readable,56 position, output window, 156 Script,56 Preferences,16,67 Writeable, 56 prefixes,filename,25 Protection bits, 139 preloadingmodules,167 ConfigOpusbutton, 130 presetcolor palettes, 149 protection bits, 19, 32, 52,55, 57, 117, Presets••• 135 ConfigOpuslist, 149 set, 57 PreviousBuffer button, 20 Protection Requester,56 Print, 36 protection, keyword,247 print all seleetedfiles,71 ProlIacker, 37, 231 ( Print button, 67 Pure, file protection bit, 56 print eurrent page,74 Put Trashcan, 62 Print Dir Requester,66 print file from text viewer, 74 Q- Quit, 44 Print File Requester,68 Quality,69 INDEX 289

Query,command,234 Requester,266 questionmark, 42 rescana file, 95 Quick,51 Rescandestination,95 quick, keyword,201 Rescanfunction, 39 Quit, 50 Rescansource,95 ( quit function, 44 Rescan,command,226,240 Quit Requester,45 reselectfunction, 39 Quit, command,235 Reselect,command,241 quotation marks,94 reserved,179 Reset,81 R - Reselect,39 ConfigOpusbutton, 140 RAM,167 resetcustombutton data, 84 re-install the boot sector,65 resetdrive button data, 100 Re-readchangedor incornpletebuffers resetfieldsin function editor, 98 ConfigOpusbutton, 161 resizingthe Directory Windows,19 re-readdirectory, 161 Restore,command,241 re-readthe directory, 142 ReverseSorting re-scana sub-directory,28 ConfigOpusbutton, 140 Read,107,108 Revert, protection bit button, 58 readdiskettes,162 Rexx:, 92 readselectedfiles,34 Right read the parent directory, 22 ConfigOpusfield, 170 read the root direct06:' 23 Right Amiga + q key, 14 Read,command,23 ,252 Right Amiga + x key, 14 Readable,file protection bit, 56 ( Right margin, 69 reconfiguration,98 Right Mousebutton, 11 Recursivedirectories,95 Right Mousebutton function, 149 Redrawmorethan a quarter of a page Right Mousebutton functions, 20 ConfigOpusbutton, 142 Right window, 170 Redraw,cornmand,226,237 RMB Button, 267 Relabel,52 Root Directory, 5 RelabelRequester,52 root directory, 7, 62, 161,162 Relabel,command,237, 254 root drive, 23 Reloadeachfile, 95 Root, command,161,242 reloadthe destinationdirectory,95 rows, 185 reload the sourcedirectory,95 Run Asynchronously,92,93 Remapcolors,212 Run asynchronously,95 Remember,command,238 Run command,156 removethe Hotkey, 165 Run files, 30 RemoveEntry,comman~ 238 RUN, CLI command,9 RernoveFile,command, 39 Run, command,242 rename,26 running script files,91 Rename,all selectedentries,25 Rename,command,239 S - Select,39 ( Replaceonly older files, 130 S:,92 replaceoriginal file, 130 S:directory, 9 replacesuffix, 25 Sampie ReplaceFlags,222 ConfigOpusbutton, 87, 102,122, reposition screen,10 126,165 Request,command,240,256 sampledsound,37, 231 290 INDEX

Save,82, 110 ConfigOpusbutton, 141 SaveAs•.. , 82, 110 scroll speed,72 saveeonfiguration,82 Serollto End, 36 savefile classes,110 SerollH,eommand,244 savethe eurrent configurerion,81 serolling,72 SaveConfig,eommand,243 SerollToShow,eommand,244 ( scanall sub-direetories,41 SerollV,eommand,245 seandiskettes,162 SerW,223 seansub-direetories,27,28 searchfor string, text viewe~74 SeanDir,eommand,243 Searchin Text File Viewer, /4 SerClockFlags,223 SearchRequester,29 ScrDepth,222 Search,eommand,44,203,246 Screen,143 search,deviee,30 ConfigOpusbutton, 80 search,file, 28 sereen,93,164,173 SearchFor,119 appearanee,144 seeonds,179 sereenblank, 171 sector, 52,63 Sereeneonfigurationscreen,143 seleetall entries,22 sereendepth, 144,150 seleetfunetion, 39 SereenDepthbutton, 79 Seleetieonsautomatically SereenDragBar, 79 ConfigOpusbutton, 137 screendrag bar, 165 Seleetpattern sereenHeight, 152 Status value12 254 Screenmode Seleet,eommand,247, 254 ConfigOpusbutton, 144 seleetable,177 sereenmode,150,152 Seleeted,267 sereensize,144,150 SeleetEntry,eommand,249 ScreenTitle Bar, 79 SeleetFile,eommand,250 sereento front, 96, 164 sendall seleetedentries,94 sereenwidth, 151 SeparateMethod,224,235 Sereen/Arrows, 145 separator,199,202,203,205-207 Sereen/Colors,146 setall proteetionbits, 57 Sereen/Fonts,147 Set archivebit of soureeafter finishing ConfigOpusbutton, 130 Sereen/General,148 setprotection bits, 57 Screen/Palette,150 set newvalue,keyword,252 Screen/Screen Mode, 151 SetWinTitle, eommand,250 SereenFlags,223 Shareware,33 SereenMode,222 Shell,156 SerH,223 ConfigOpusfield, 155 seript file, 4 Shell-Startup,94 script files, 91 Shortcut Key, 101 script, ARexx, 41 Shortcut key, 87, 102,126 Seript, file proteetionbit, 56 shortcut keys,19 Seroll,36 Show,108 ( seroll, 18 ConfigOpusfield, 169 Serollby Page,36 show,177,179,238,239,249,250 serolldireetion, 72 Showbutton, 50 Serolldireetory windowto follow Showdelay operation ConfigOpusfield, 172 INDEX 291

Showfreespaceas.•. , 163 ConfigOpusfield,96 Showpattern stacksize,90 ConfigOpusbutton, 154 Start animationpaused Show,command,251 ConfigOpusbutton, 171 ShowDelay,224 Start-UpScript ( ShowFreeFlags,224 ConfigOpusfield,156 ShowPatBits,224 starting ConfigOpus,18 ShowPattern,225 Starting Froma CLI, 8 size,119 Starting From Workbench,8 sizebar, hidden,19 StarTracker,31 sizein bytes,19 Starts, 36 size,arrows,144 Startup size,calculatingfile, 21 ConfigOpusbutton, 154 size,output window,156 ConfigOpusfield, 110 size,screen,144,150 Startup ARexx script, 110 Size.•• startup directory,110 ConfigOpusIist, 141 startup options,169 aizes,file, 129 startup-sequence,1,9 sizes,font, 146,141 state, 249,250 slider,button bank, 50 status, 10 slider,text viewer,113 statusbar, 21, 134,141 Sliders,18 StatusBar whenselectingFiles, 16 centering,20 Status,command,252 moving,18 stereo,231 sliding to the left, 19 Stops,36 ( sliding to the right, 19 StopST,command,257 sliders,136,142-144,149,113 string, 230 slideshow,112 string field, 25 SlowDown,36 string pattern, 29 SmartRead,command,252 string search,text viewer,14 songmodule,231 string, searchfor, 29 Sort bank sub-directories,5,6, 16,95 ConfigOpusbutton,100 selection,17 Sort menu sub-directoryFilter, 23,30-32,43 ConfigOpusbutton,124 sub-directory,creatingnew, 26 SortFlags,225 subjectbuttons, 19 sorting, 140 SubsequentRenameRequester,25 SortMethod,225,235 suffixes,filename,25 soundfiles,3 Swap,83,88 Soundplayer,112 ConfigOpusbutton, 104,115,121 sounds,136 Swapbank SoundTracker,31,231 ConfigOpusbutton, 84,99 source,194 Swapbutton, 88 SourceWindow,12 ConfigOpusbutton, 84 space,checkavailable,127 swapcolors,212 ( spaces,113 swapcommands,88 spacesinfilenarnes,94 Swapdrive SpeedUp, 36 ConfigOpusbutton, 100 Stack,211 swaphotkeys,121 Stacksize Swapitem 292 INDEX

ConfigOpusbutton, 125 title, output window, 156 Swapmenu Title, printer option, 70 ConfigOpusbutton, 124 Today, 132 SwapWindow,command,257 Toggle,22 System,153 togglebetweenwlndows,12 ConfigOpusbutton, 80 toggleprotection bit settings,57 ( systemtime, 46 Toggle,command,258 System/Amigados,155 Toggle,protection bit button, 57 System/Clocks,157 Tomorrow, 132 Tool,165 System/Directories,160 tool,90 System/Hotkey, 164 Tool icon, 212 System/lcons,166 Tool Types, 211 System/Modules, 167 Tool types, 212 System/Showpattern,168 ToolTypes System/Startup, 169 CONFIGFILE, 9 System/View & Play, 171 ICONSTART,9 Top margin, print, 67 T,73 Top text justification T:,94 Status value30, 256 t:configopus.clip,98 TopEdge,156 tab,69 TopText, command,259 tab character,173 Total bytes Tab Size,69 Status value 10,254 Tab size Total Memory, 158 ConfigOpusbutton, 173 Total selectedbytes tasks,157 Status value 11, 254 TechnicalSupport, 48 Treshcan,52 TechSupport,command,258 treshcan,62 temporary file, 94 Trashcanicon, 212 test protection bits, 117 tree, directory, 41 text, 177,259,260 Turn audio filter off for play text editor, 8, 37 ConfigOpusbutton, 172 Text File Viewer, 72, 72 type, 179,204 text files, 3, 67, 173 Text style, printer option, 70 U,73 text viewer, 30, 108,252 ucnlc, keyword,246 Text viewer borders uniconified,164 ConfigOpusbutton, 173 Uniconify The Tiny Bottom Right Buttons, 42 ConfigOpusfield, 170 The Tiny Center Buttons, 39 uniconify, 50, 159,160 Time, 160 Uniconify ARexx scriptj.170 ConfigOpusbutton, 158 Uniconify, command,2~9 time, changing,46 Uniconifyj'activareHotkey, 164 Tiny Buttons, 12,38 up/down arrows, 73 tiny buttons, 148 Update Title, 156 ConfigOpusbutton, 129 title, 250 Update free disk space Title Bar, 10 ConfigOpusbutton, 141 title bar, 148 UpdateFlags,225 INDEX 293

Usedefault wildcards,39 ConfigOpusbutton,151,152 win, 178,184,186-188,192,194,196, UseExAll( ) 199,202,203,205-208,230, ConfigOpusbutton,163 233,234,240,242-245,250 Usemiddlemousebutton Window, 159 ( ConfigOpusbutton,165 window,162 UserEvents,108 Window Area, 13,15 UserStartup Sequence,7 Window slider activate Userl, 108 ConfigOpusbutton, 136 Userl, User2,User3,User4,comrnand, Window View Sliders,13 260 window,extendingview, 18 User2,108 window,redraw,142 User3,108 WindowSize,226 User4,108 word processor,37 userdata,177 WorkBench,60,160 Workbench,7, 8, 48,49,89, 90, 93, 94, value,216,252 151,160,166 Various Speeds,36 WorkbenchAppIcon, 91 Verify, 51,63 Workbenchcolors,150 Verify, command,260 Workbenchicons,35, 103 verify,keyword,194,201 WorkbenchTo Front, 93 Version Workbenchto front, 96 Statusvalue2, 253 Workbench:Clone,151,152 version1, 135 Workbench:Use,151 version3.4, 172 write protected,133 ( version4.0,172 Writeable,file protection bit, 56 Version,command,261 WShell,155 version,current,48 Vertical Window View Sliders,19 x coordinate,156 vertical WindowView Sliders,18 VideoToaster,81 y coordinate,156 View & Play ConfigOpusbutton,154 ZOO, 33, 53, 103 viewers,171 ViewPlayFlags,226 virus, 65 virus checkerprogram,65 Visible screentitle buttons ConfigOpusbutton,148 volumename,163

Width,156 ConfigOpusfield,151 width, arrows,145 wild cards,268 ( wild, keyword,246 wildcard, 25,43, 169 wildcard pattern, 118 wildcard rename,25 Wildcards, 23