═══ 1. Copyright notice ═══ This software and documentation is copyrighted by Alexander Wilkens, iLogic Software This software is SHAREWARE and is provided as-is. The author will in no event be liable for loss of profits, nor incidental or consequential damages. You use this software at your own risk. This software may not be modified, disassembled or reverse engineered in any way, except by the author, Alexander Wilkens. DirMaster may be distributed in unmodified shareware form freely, provided no charge is made for it, with the exclusion of BBS service charges. Shareware vendors may NOT charge any fee for distributing this software. Users are entitled to use DirMaster free of charge for a trial period of thirty days. If the user wishes continue the use of DirMaster beyond this trial period, he/she must register. DirMaster may not be distributed in registered form by any means. This includes distribution of registration NAMES registration KEYS. Registration entitles the user rights to use DirMaster indefinitely. Registrations are non-transferable and non-redeemable. Check out the How to register chapter for information on how to register your copy of DirMaster. ═══ 2. How to contact the author ═══ You can contact me in several ways: BBSs in Norway: VilleMo BBS # +47 77 74 74 93 Oslo Hard Disco # +47 22 57 03 90 # +47 22 57 09 90 Big Blue # +47 22 46 51 27 ProSoft BBS # +47 77 65 78 31 Sound Server BBS # +47 22 57 16 00 # +47 22 57 16 04 Worldwide networks: Fidonet: 2:212/8.13@fidonet.org SBCnet: 14:1600/100.13 You can probably reach me by email from Internet too, if you can figure out how to route it to fidonet. Sorry I don't have an Internet address yet, but sometime in the future maybe.. Mail: iLogic Software, Attn: Alexander Wilkens, Hansmarkveien 37, 9013 Tromsoe, Norway. ═══ 3. Members of iLogic Software ═══ Alexander Wilkens (alias INLiNE): OS/2 C programmer and ASM programmer Stian Andorsen (alias dRam): DOS/Win Pascal programmer and graphician ═══ 4. Main window ═══ Contains help concerning DirMaster main window. ═══ 4.1. Menus ═══ Menus: DirMaster: o Configure - Loads configuration notebook o Save Window config - Saves current window position and size o Exit - Quits DirMaster. Exactly the same as the Quit button. Cmd lines: o OS/2 Win - Starts an OS/2 windowed command prompt o OS/2 Full - Starts an OS/2 fullscreen command prompt o DOS Win - Starts an DOS windowed command prompt o DOS Full - Starts an DOS fullscreen command prompt Help: o View INF doc - Views this doc using VIEW.EXE o View Revision file - Views DMaster.Rev using E.EXE o View Register.Doc - Views Register.Doc using E.EXE o Register - Brings up the registration dialog o About - Brings up the about dialog ═══ 4.2. Status line ═══ Statusline: The statusline is the 3D box directly below the menu. It has two purposes: 1. Displaying the number of selected files and their bytesize, and displaying the total number of files in the directory and their total filesize. The format is like this: # of selected files / total # of files selected bytes / total bytes What it looks like: 2. Displaying information that need no confirmation, like "Operation complete!". ═══ 4.3. Label and freespace boxes ═══ Label and freespace boxes: Purposes: - Display disk label of the current drive - Display free diskspace on the current drive. - Show which directory window is selected. The box above the selected window is depressed. Switching between directory windows: This can be acomplished in several ways. The easiest way is by clicking the right mouse button in the window you want selected. This also causes free diskspace and disklabel to be updated for this window. Another way is to use the left mouse button. This does NOT cause free diskspace or disklabel to be updated. Note: The last method causes the file beneath the pointer to be selected. ═══ 4.4. Directory windows ═══ Directory windows: The directory (dir from now on) windows are two listboxes containing files in the current dirs (you have two current dirs. A source and a target.). The selected dir automatically becomes the source and the other the target. Multiple files can be selected in the dir windows by either clicking on the files one by one or using the ALL button or NONE button. Left mouse button double clicking: The dir windows support double clicking. DirMaster will take an action when any of the following are double clicked: - Directories. Double clicking on one will cause DirMaster to enter it and display it (replacing the current dir) in the dir window. - Files with the extension EXE or COM. DirMaster will try to figure out wheather it is a DOS, OS/2 textmode or PM program. You can then specify cmd line parameters in execute dialog that pops up. - Files with the extention CMD. DirMaster will load the cmdline interpreter (CMD.EXE) and run the batch file. - Files with the extention BAT or BTM. The DOS cmdline interpreter will be loaded and the batch file run. - Files with with extensions configured in the User button configuration. The corresponding user function will be executed. Right mouse button double clicking: Double clicking with the right mouse button in a dir window does a "parent" in that directory. The is the same as pressing the Parent button. ═══ 4.5. Directory path boxes ═══ Directory path boxes: Path boxes (se picture below) are situated below the two dir windows. Their functions are to contain the path for the drive window above it. The boxes are automatically updated whenever a new directory is loaded. The path boxes can also be used to change directories. Just click inside it, enter the desired directory (including drive) and press enter. If you made a mistake in the directory name DirMaster will let you know by writing in the label box above the dir window. The directory path you had typed will still be in the path box so you won't have to type it all over again. ═══ 4.6. Button Panel ═══ The button panel is the 28 buttons at the bottom of the DirMaster window. They are divided into to types of buttons: Drive buttons Function buttons ═══ 4.6.1. Drive Buttons ═══ Drive buttons: The four drive buttons are posisioned to the right on the button panel. Their function is to allow the user to quickly change between 12 (Yes, twelve) dirs and/or drives configured in Configure - Drive Buttons. These buttons appear like normal buttons, but are in fact not quite normal. Remember I said 12 and not 4 dirs and/or drives. This means there are 12 buttons too, but only 4 of them are visible at one time (Not quite room for 12 buttons, eh?). So, for those of you who know your math. 4 * 3 = 12. There are therefor 3 pages of buttons. Switching between these pages is easy. Press the right mouse button on any of the four drive buttons and the next page is shown. Pressing right mouse button on the last of the three pages takes you back to page one. ═══ 4.6.2. Function Buttons ═══ Function buttons: The function buttons consists of to types of buttons. Internal functions are those supplied by DirMaster (Copy, Move, Rename etc.) and user functions specified and configured by the user in the User configuration. Just like the Drive buttons, these buttons behave a little different from ordinary buttons. They can each contain two functions. Double click here to get explanation. This gives you a total of 48 function buttons at you disposal. The following internal function are availible: All Archive Archive (Background) Archive list Attribute Copy Copy as Clone Delete Makedir Move Move as None Parent Quit Relabel Rename Reread Root Unarchive Unarchive (background) ═══ Copy ═══ Function: Copy file(s) and/or dir(s). Query on overwrite. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed by DirMaster's own error dialog. Can be aborted by pressing the cancel button in the progress dialog. ═══ Copy as ═══ Function: Copy file(s) and/or dir(s) to target dir with a new name. A dialog will pop up for each file/dir asking for the new name. Skip and cancel buttons are availible. DirMaster will query on overwrite. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed in DirMaster's own error dialog. Can be aborted by pressing the cancel button in the progress dialog. ═══ Move ═══ Function: Move file(s) and/or dir(s). Query on overwrite. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed in DirMaster's own error dialog. Can be aborted by pressing the cancel button in the progress dialog. ═══ Move as ═══ Function: Move file(s) and/or dir(s) to target dir with a new name. A dialog will pop up for each file/dir asking for the new name. Skip and cancel buttons are availible. DirMaster will query on overwrite. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed in DirMaster's own error dialog. Can be aborted by pressing the cancel button in the progress dialog. ═══ Delete ═══ Function: Delete file(s) and/or dir(s). Query on read-only. Requires: Selected file(s) and/or dir(s) in source dir. Notes: Errors are displayed in DirMaster's own error dialog. Can be aborted by pressing the cancel button in the progress dialog. ═══ Clone ═══ Function: Clone selected file(s) and/or dir(s). Operates like Copy as, except that the source dir is also the target dir. Requires: Selected file(s) in source dir. Notes: Errors are displayed in DirMaster's own error dialog. Can be aborted by pressing the cancel operation button. ═══ Archive ═══ Function: Archive files. Pops up a dialog asking for a name for the archive and what archiver to use (ZIP, ARJ, LHA, ZOO or ARC). The archive is put in the target dir. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed in the statusline. The archiver is executed in the foreground while DirMaster waits. ═══ Archive (background) ═══ Function: Archive files in the background. Pops up a dialog asking for a name for the archive and what archiver to use (ZIP, ARJ, LHA, ZOO or ARC). The archive is put in the target dir. Requires: Selected file(s) and/or dir(s) in source dir, target dir. Notes: Errors are displayed in the statusline. The archiver is executed in the background. ═══ Unarchive ═══ Function: Unarchive files. Determines the archive type by looking at the first bytes in the archive and then executes the correct unarchiver. Requires: Selected file(s) in source dir, target dir. Notes: Errors are displayed in the statusline. DirMaster waits till the archiver is done. ═══ Unarchive (background) ═══ Function: Unarchive files. Determines the archive type by looking at the first bytes in the archive and then executes the correct unarchiver. Requires: Selected file(s) in source dir, target dir. Notes: Errors are displayed in the statusline. The unarchiver is executed in the background. ═══ Achive List ═══ Function: View contents of archives. Determines the archive type by looking at the first bytes in the archiven, executes the correct archiver with the list switch and views the list of files with the configured lister. Requires: Selected file(s) in source dir. Notes: Errors are displayed in the statusline. DirMaster waits while the archive lister is executed. ═══ Parent ═══ Function: Changes to the parent directory in the selected dir window. If the current dir is root no action is taken. Requires: Source dir. Notes: Errors are displayed in the statusline. ═══ Select All ═══ Function: Selects all files and dirs in the selected dir window. Requires: Source dir. Notes: No errors. ═══ Select None ═══ Function: Deselects all files and dirs in the selected dir window. Requires: Source dir. Notes: No errors. ═══ Root ═══ Function: Changes to the root directory in the selected dir window. If the current dir is root no action is taken. Requires: Source dir. Notes: Errors are displayed in the statusline. ═══ Reread ═══ Function: Rereads the directory in the selected dir window. Useful when an external program has changed the contents of the directory. Requires: Source dir. Notes: Errors are displayed in the statusline. ═══ Makedir ═══ Function: Create a directory in the selected dir window. Requires: Source dir. Notes: Errors are displayed in the statusline. ═══ Attribute ═══ Function: Pops up the attribute dialog to allow the user to change the file attributes for the selected files. Requires: Selected file(s) in the source dir. Notes: Errors are displayed in the statusline. ═══ Rename ═══ Function: Rename the selected files and dirs in the selected dir window. Pops up a dialog where the user can specify a new name. Requires: Selected file(s) and/or dir(s) in the source dir. Notes: Errors are displayed in DirMaster's own error dialog. ═══ Relabel ═══ Function: Changes the label on the disk in the selected dir window. Disk labels may only be 11 characters long. Requires: Source dir. Notes: Errors are displayed in DirMaster's own error dialog. ═══ Quit ═══ Function: Quits DirMaster. Requires: Nothing. Notes: No errors. ═══ Two buttons on each button ═══ Just like the drive buttons, these buttons respond to the right mouse button. In a little different way, though. Each button can have one or two functions. The primary function (the one you can se written on the button) is always activated by pressing the left mouse button on it. The second function (where availible) is activated by pressing the right mouse button on it. To see its label, hold the right mouse button down. If you decide that you dont want to 'press' it then, move the mouse pointer away from the button and release it. If you want to 'press' it then release the mouse button with the pointer above the button you pressed. ═══ 5. Configuration ═══ Configuration: The configuration of DirMaster is done in a notebok in the configuration dialog. The four buttons in the dialog have the following functions: Save - Saves the new configuration to "c:\os2\DMASTER.INI". This file is automatically loaded at startup. Use - Uses the new configuration, but does not save it do disk. Load - Loads configuration from the "c:\os2\DMASTER.INI" file on disk. Cancel - Cancels any changes you have made to the configuration, and uses the same configuration as before. ═══ 5.1. General config ═══ Delete warning: The configuration of delete warning gives you the control over the warnings DirMaster may, or may not display when you press delete. o Single file - Warn the user when a single or multiple file delete is about to occur. o Single Directory - Warn the user when a single or multiple dir delete is about to occur. o Multiples files & directories - Warn the user when multiple file and/or dir delete is about to occur. Note: The Multiple files & directories warning will always be displayed when one (or two) of the two first checkboxes are checked. Temp directory: This box allows you to specify a directory where DirMaster can store its temporary files. They will be deleted automatically when DirMaster quits. The default here is "c:\". Freespace display options: This lets you configure how DirMaster will display the amount of free disk space on the current disk(s). The "Use denomination" specifies whether to write kb/b/MB or not after the free space. The radio buttons lets you choose whether to display in bytes, kilobytes or megabytes. Enable 3D border boxes: Checking this checkbox enables the 3D borders around different controls. This might not display correctly on all hi res gfx cards, so if the boxes are too small or too big, then simply disable this checkbox. Autoread: Specifies which two (if any) directories to automatically read at startup. Check the appropriate checkbox to the right of the appropriate edit box to enable it. ═══ 5.2. Drive buttons ═══ Drive buttons: This is where you set up the three drive pages. Click on the button you wish to change, enter a label (the text that appears on the button) and the drive or path to the directory you want to load. The buttons are aligned like this: The leftmost 4 are page 1, the middle 4 page 2 and the rightmost 4 page 3. ═══ 5.3. Archivers ═══ Archivers: This configuration dialog lets you configure the five archivers (ZIP, ARJ, LHA, ZOO and ARC). DirMaster does not have the archivers built in, rather it uses external commandline programs. A default setup will be created the first time you run DirMaster, so all you have to do then is to make sure the paths are correct. You choose the archiver to configure from the listbox. Name: Lets you specify the name of the archiver. Not much used by DirMaster yet. Ident: Specifies the archive identification code that can usually be found in the first characters in the archive. This is in hex format. The spinbutton next to it specifies the offset at which the identification code can be found. You are advised NOT to change this unless you know what you are doing! Archive Cmd: The path and filename of the archiver. The BROWSE button brings up the system's filerequester. Archive Switches: Specify switches for the archiver. Extract Cmd: The path and filename of the unarchiver. The BROWSE button brings up the system's filerequester. Archive Switches: Specify switches for the unarchiver. List Cmd: The path and filename of the archiver lister/viewer. The BROWSE button brings up the system's filerequester. List Switches: Specify switches for the archive lister/viewer. ═══ 5.4. User functions ═══ Custom buttons: The custom button feature allows the user to define up to 9999 user functions in addition to DirMaster's own internal functions. These user buttons can be placed together with the internal buttons on DirMaster's button panel to do whatever taks the user wants with the use of external programs. You have a range of different options. Select a function from the list, or add a new on by pressing "Add". "Delete" removes a function and "Rename" renames a function. Label: The text to appear on the button. Command line: This is where you enter the command line to the button. You can use any of the tokens described below anywhere in the commandline, but the commandline MUST start with an executable file or a CMD.EXE internal command. The browse button brings up the system's filerequester. Tokens: %f = selected file(s). If the All files on same cmd line is checked all selected files are inserted here (as long as there is room on the cmd line). If not then only one selected file is inserted and the others will be processed one by one. %F = same as above except that it includes full path. %s = Inserts the source directory including trailing "\". %t = Inserts the target directory including trailing "\". %q"" = Displays a question dialog asking the question you put between the quotes. The dialog contains an edit box where the user can type in argument. %r"" = Displays the system's filerequester. Put the path and wildcards in the quotes. Extensions: Specify double clicking extensions here. The format is like this. Write ONLY the extensions (no '.') and seperate each extension with a comma. (Ex. "me,doc,txt" (don't include the quotes!)) Checkboxes: Requires selection - specifies that file(s) must be selected for the button to execute. If not checked then DirMaster ignores any selected files and the function will only be executed once no matter how many files were selected. CD to target - command line is executed from the target directory. All files on same cmd line - command line is executed only once with all selected files on the same command line (%f or %F token). Start CMD.EXE - CMD.EXE is executed with "/C" + command line as the argument. Use this when running commands like "print" and so on. Run async on multi - The program is run asyncronously if multiple files were selected in the dir window. This causes DirMaster to execute the function with one selected file at a time waiting until the previous one terminated before executing the next. Useful when viewing pictures or when you want to reread a dir after program completion. Run async on single - The program is run asyncronously if only one file was selected. Fullscreen - command line is executed in a fullscreen session. To front - command line is executed in the foreground. Start CMD.EXE - CMD.EXE is executed with "/C" + command line as the argument. Requires source dir - function will not execute if no source dir is present. Requires target dir - function will not execute if no target dir is present. Reread source directory - Rereads source dir after command line is executed. Should be used in conjunction with "Run async..". Reread target directory - Rereads target dir after command line is executed. Should be used in conjunction with "Run async..". ═══ 5.5. Button configuration ═══ Button configuration: This configuration page lets you position functions on the 24 (48 really) buttons. The top 24 buttons are for the left mouse button and the bottom 24 buttons are for the right mouse button. To assign a function to a button, do the following. Select a button by pressing it. It wil now remain depressed until another button is pressed. Next, select either an "internal function", a "user function" or "no function". Then, if you didn't select "no function", select a function from the appropriate dropdown box (below the radio button you selected). The text will then appear on the button and it is configured! ═══ 5.6. Font and color configuration ═══ Font and color configuration: Some of the fonts DirMaster uses can be configured by the user. The listbox presents a list containing these. To configure one, select one from the box, select a foreground and background color of your choice by spinning the spin controls. The font can be changed by pressing the "Font" button. ═══ 6. Dialog windows ═══ Contains help concerning DirMaster dialog windows. ═══ 6.1. Makedir ═══ Function: Create a new directory. Lets the user enter a directory name into the edit box. Displays an error message if illegal characters are entered in the directory name edit box. Buttons: OK - creates the directory. Cancel - aborts the operation. ═══ 6.2. Rename ═══ Function: Rename a file. The current filename is displayed in the depressed box. Enter a new name in the edit box. Buttons: OK - renames the file. Skip - Skips this file and proceeds to the next one, if any. Cancel operation - aborts the operation. ═══ 6.3. Relabel ═══ Function: Relabel a disk. The current disk label is displayed in the depressed box. Enter a new label in the edit box. Buttons: OK - relabels the disk. Skip - aborts the operation. ═══ 6.4. Copy as / move as ═══ Function: Copies or moves a file to a file with a new name. Current filename in the depressed box. New filename in the edit box. Buttons: OK - renames the file. Skip - Skips this file and proceeds to the next one, if any. Cancel operation - aborts the operation. ═══ 6.5. Attribute ═══ Function: Change the attributes of a file. The file in question is put in the depressed box. Check and uncheck the desired attributes. Buttons: OK - Changes attributes. Cancel - aborts the operation. ═══ 6.6. Archive Add ═══ Function: Archive one or several files. Enter a name for the archive in the edit box and choose archive type by pressing the appropriate button. (Enter = Zip) Buttons: ZIP, LHA, ARJ, ZOO, ARC - Starts the appropriate archiver. Cancel - aborts the operation. ═══ 6.7. Execute ═══ Function: Provides the user a range of options when executing a program. Topmost editbox: contains the name of the file to be executed. "Args" editbox: enter commandline arguments here. Use browse to bring up the system's default filerequester. The filename will be inserted in the argument line. The radio buttons specify programtype. DirMaster will try to guess the the programtype on beforehand. All buttons will be greyed if it is a PM program. Child application: Specifies that the program is to be executed as a child app. To front: Runs program in the foreground. Buttons: Execute - Starts the program. Cancel - aborts the operation. Browse - loads the system's default filerequester. The filename and path you select is inserted at the cursor position in the args editbox. ═══ 7. Registration ═══ Select one of the following: Why register? How to register ═══ 7.1. Why register? ═══ Why bother to register? Well. I've tried to put down many good reasons to do just that below. Read on, read on! -First of all, registering removes the irritating "beg" dialog that pops up when you start DirMaster. -DirMaster will no longer display "Unregistered" in the title bar. Instead an 'r' will be appended to the version number indicating it is a registered version. -The about dialog will display your name as well as your serial number. -It doesn't cost much! Only $20 (140NOK). No hidden costs such as postage or anything. Just hand me the money and a registration key will be mailed to you by either email (Fido, SBC or any of the mentioned BBSs in How to contact the author part of the documentation) or snailmail. -The author has put down ALOT of work on DirMaster. The author has used much of his sparetime (I still attend school) programming. He deserves SOMETHING, doesn't he? -The more people who register, the more encouraged I will be to continue improving and developing DirMaster. -This version (1.10) has gone through a few changes. It can no longer be considered "crippleware" in ANY ways, since all the functions are availible for you to evaluate. Even though I have don this, it doesn't mean that I am giving away DirMaster for free. If very few of the people using DirMaster registers it, then I may be foreced to add more beg dialogs, delays and other cruel things. I don't want to do that, and I dont think you, as a user, would like that much either. I suppose that speaks for itself.. ═══ 7.2. How to register ═══ How to register To see how you can register DirMaster ($20/140NOK) take a look in Register.Doc included in the DirMaster archive. This can be done from the help menu in DirMaster.