Copyright: DirMatch Help Copyright ® 1994,1995 Cliff Wong


Contents
DirMatch Help Contents

Introduction

DirMatch is a great directory match utility for Windows 3.1.  It lets you easily match and compare two directories, side by side.  Files can be Compared, Copied, Edited, or Deleted from both directories. DirMatch also updates the directory (and its sub directories) you specify. It copies files until the target directory contains the most recent copies of all the files you want updated.

DirMatch will be invaluable to people with portable computers or those who take work home on floppy disks. These users need to ensure that they are always working on the most up-to-date versions of all Files.

DirMatch is also useful for users who regularly back up their work directory onto a diskette or to a network directory but who wish to be free of the hassle of either copying all the files each time, or remembering which files have changed and need backing up. These users want to know what files have changed, see the changes, delete the file if necessary, and then perform the automatic update.

One scenario is : you just installed the latest and greatest program on your system. Minutes later you found out that it does not work. But, wait a second, it works like a charm in your co-worker's system. DirMatch can help you to find out the differences between two systems, copy those missing files or edit the INI files.

Procedures

Main Display

Menu Tree

Tool Bar

Status Bar

Drag and Drop

Command Line Parameters

Reference

Index

General

Registration

Copyright/Warranty


Main Display

Directories Panel

The area between the tool bar and the list box is used to display the path for each directory. You can use the File Manager's Drag and Drop interface to select the directory path as well.

Main List Box

The separator line between the two directory File Lists will be 1 of 4 characters based on whether the Left and Right files are matched or not.

•	'='   The two files are matched.  Both files have identical Name, Size, Date, and Time.  (Left File = Right File)

•	'>'   In the case of the Sort order is by File Name. Two files have the same Name, but the Left File has a newer Date/Time Stamp than the Right File, or they have the same Name, same Date/Time Stamp, but Left File is larger than the Right File (Left File > Right File)

•	'<'   In the case of the Sort order is by File Name. Two files have the same Name, but the Left File has an older Date/Time Stamp than the Right File, or they have the same Name, same Date/Time Stamp, but Left File is smaller than the Right File.   (Left File < Right File)

•	' '    The files do not match.  There is not a matching file with the same File Name.

International Date/Time format

DirMatch supports the international users in the following ways. It uses the Short Date Format and the 24 hour Time Format set up by the Control Panel to display the Date/Time information. You have the options to change Date Order, Date Separator and Time Separator via Control Panel or by editing WIN.INI directly. All changes will NOT take effect until the next time you select the Refresh/Match (F5) menu item.

Using Extened Selection List Box

DirMatch uses Extended Selection List Boxes in the main display.  You can select files the same way as you select files in the File Manager.

To select an individual file in an Extended Selection List Box, click on the file.  This cancels all previous selections.  To select two or more files in sequence click on the first file, then press and hold down the Shift key while you click on the last file in the group.  To select two or more items out of sequence press and hold down the Ctrl key while you click on each file.  This feature was added for compatibility with Norton Desktop for Windows.


Font Dialog

Use the Font dialog box to select a font and its characteristics to use in the main window.

The Sample box shows the font in the selected style and size, as it will appear in windows on your display.

Font	Select a font from the list displayed. These are the fonts installed with Windows on your computer.

Size	Select a point size from the list displayed for the chosen font. The sizes available depend on the installed font.

Font Style	Select a style from the list displayed for the chosen font. The list displayed depends on the installed font. Besides regular, you may be able to choose bold, italic or combined bold and italic styles.

Tips

To restore the displayed font to its startup characteristics if you have selected a new default font, select New Courier 10-point regular.


Menu Tree

File Menu

• Copy	Copy selected file(s) from one directory to the other. DirMatch will ask you for the copy direction if files from both directories are selected. (Copy from the Left to the Right or Copy from the Right to the Left)

• Delete	Delete selected file(s). If files from both directories are selected, DirMatch will ask which file(s) you want to erase.

• Edit	Edit the selected file(s) with the program specified in the Setup|Options menu. If the selected line contains two files, DirMatch will ask you if one or both files are to be edited. If you have not set up Edit program path, the Edit Button and the File Edit menu will be disabled. Note that NOTEPAD.EXE shipped with Windows 3.1 can only accept one file in the command line.

• Compare	Compare selected files with the Compare Program specified in the Setup|Options menu. The Compare Button and the File Compare menu item will only be enabled if you selected a line contains two files.

• Launch	Launch the application associated with the selected file(s).

• Print	Print the contents in the list box. Windows standard Print dialog will be displayed to select a printer and its options..

• Exit	exit DirMatch.

Setup Menu

• Left directory	Select the left panel directory.

• Right directory	Select the right panel directory

• Options	modify confirmation options and setup external program paths.

• Include Mask	Specify include file masks.

• Color and Font	Select colors and font for the main display.

Directories Menu

• Swap	Swap the Left and the Right directories.

• Match/Refresh	Match and refresh list box display to reflect current settings.

• Update	Update all files and sub-directories by making files up to date.  Bidirectional update keep your directories in sync.

View Menu

• All Files	Show All files in the Left and the Right Directories.  This is the default setting when DirMatch is first started.

• Different Files	Change the display to show only the Left and the Right files that are the Different (those without identical Filename, Date, Time and Size).  Files that have the same Filename, but different Date, Time, or Size will be included in the display.

• Same Files	Show files that are identical in both directory.

The check mark next to the menu item indicates the current filtering mode.

Help Menu

• Content	Start Windows Help and display topic in DirMatch help file.

• Search	Open search dialog box for DirMatch help.

• Registration 	Display the Registration information

• Copyright 	Display the Copyright information

• About	Display the copyright notice.


Tool Bar

Toolbar is displayed across the top of the application window, below the menu bar. The toolbar provides quick mouse access to many tools used in DirMatch.

Click   To

     Select the left panel directory.

     Select the right panel directory

     Match and refresh list box display to reflect current settings.

     Copy selected file from one directory to the other.

     Delete selected file(s).

     Edit selected file(s).

     Compare selected files.

     Launch selected file(s) with their associated program.

     Print the contents in the list box.

     Update the directory by making files in the directory up to date.


Status Bar

The status bar is displayed at the bottom of the DirMatch window.

The left area of the status bar describes actions of menu items as you use the arrow keys to navigate through menus. This area similarly shows messages that describe the action of the toolbar buttons as you depress them, before releasing them. If after viewing the description of the toolbar button command you wish not to execute the command, then release the mouse button while the pointer is off the toolbar button.

The right area of the status bar shows the System Date at the time DirMatch was launched.


Drag and Drop

An easier way to select directories is to use the Drag and Drop interface.

1. Click on a file or directory in the Windows 3.1 File Manager file window.

2. While holding down the mouse button, drag (move) the mouse pointer over a Directory panel (as shown above). The mouse cursor will change to look like the one below.

3. Release the mouse button. If you dropped a directory, this set the directory to the one you selected. However, if you dropped a file, DirMatch will set the directory to where the file is in.

Note: DirMatch does not accept multiple files.


Command Line Parameters

If you add DirMatch for Windows to your Program Manager group, you can add two directories path to DirMatch's command line box. e.g. If you always use A: and C:\XFER as your main directories,  put C:\DIRMATCH\DIRMATCH.EXE A:\ C:\XFER\ in the Command Line of DirMatch's properties. When you launch DirMatch for Windows, it will automatically match them for you.


Index

B

Browse Dialog

C

Color and Font Dialog

Command Line Parameters

Contents

Copyright and Warranty

D

Drag and Drop

E

Exit Command

I

Include Mask Dialog

Index

K

Keyboard

M

Main Display

Menu Tree

O

Options Dialog

P

Print Dialog

Print Setup Dialog

R

Registration

S

Select Directory Dialog

Status Bar

T

Tool Bar

U

Update Dialog


Registration

To order DirMatch for Windows 1.5.1: Send this order form and a check or money order to Cliff Wong, 12220 K, Eagles Nest Court, Germantown, MD 20874  U.S.A.. To print this form, click on Print Topic in the File menu. Or you can print the ASCII text file ORDER.TXT.

DirMatch Single Copy ________ copies at $12 each  = _______

Maryland resident add 5% sales tax                      +    _______

Shipping/Handling - Outside of US only      $5 each  =  _______

                     Total in US Funds drawn on a US Bank  _______

Name : _____________________________  Date : __________

Company : ___________________________________________

Address : ____________________________________________

               ____________________________________________

City, State, Zip : _______________________________________

Country : _____________________________________________

Day Phone : __________________________________________

Disk Size preferred    3.5"_________    5.25"__________

Comments :


Copyright and Warranty
Copyright/Warranty

DirMatch for Windows Copyright © 1994-1995 by Cliff Wong - All right reserved.

License Agreement

You should carefully read the following terms and conditions before using this software.

Shareware Version

You are hereby licensed to: use the Shareware version of the software for a 21 day evaluation period; make as many copies of the Shareware version of this software and documentation as you wish; give exact copies of the original Shareware version to anyone; and distribute the Shareware version of the software and documentation in its unmodified form via electronic means. There is no charge for any of the above.

You are specifically prohibited from charging, or requesting donations, for any such copies, however made; and from distributing the software and/or documentation with other products (commercial or otherwise) without prior written permission, with one exception: Disk Vendors approved by the Association of Shareware Professionals are permitted to redistribute DirMatch, subject to the conditions in this license, without specific written permission.

Unregistered use of DirMatch after the 21-day evaluation period is in violation of federal copyright laws.

Evaluation and Registration

This is not free software. This license allows you to use this software for evaluation purposes without charge for a period of 21 days. If you use this software after the 21 day evaluation period, you must register it. When payment is received you will be sent a registered copy of the latest version of DirMatch.

One registered copy of DirMatch may either be used by a single person who uses the software personally on one or more computers, or installed on a single workstation used nonsimultaneously by multiple people, but not both.

You may access the registered version of DirMatch through a network, provided that you have obtained individual licenses for the software covering all workstations that will access the software through the network.

Governing Law

This agreement shall be governed by the laws of the State of Maryland.

Disclaimer of Warranty

THIS SOFTWARE AND THE ACCOMPANYING FILES ARE SUPPLIED "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANT ABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. Because of the various hardware and software environments into which DirMatch may be put, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.

Good data processing procedure dictates that any program be thoroughly tested with non-critical data before relying on it. The user must assume the entire risk of using the program. ANY LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.


Browse Dialog

Use this dialog box to select the program file that you want to invoke when you choose to edit or compare file(s) from the menu or the tool bar.

File Name

Select a filename, and then choose the OK button. Or type a filename in this box, and then choose the OK button. If the file is not in the current directory, include the path.

List Files of Type

Open the list, and then select the type of file you want to appear in the File Name box.

Directories

Select the directory that contains the program file you want to use. The names of the files in that directory will appear in the File Name box.

Drives

Open the list, and then select the drive that contains the program file you want. The directories on that drive will appear in the Directories box.


Exit Command
Exit Command(File menu)

Use this command to end DirMatch session. You can also use the Close command on the application Control Menu.

Shortcuts

       Mouse:     Double-click the application's Control menu button.

       Keys:       ALT-F4


Include Mask Dialog
Include Mask Dialog Box

When you select Setup|Include Mask from the menu, the following dialog box will be displayed :

To add a mask:

•	Enter the mask in the Current mask edit box or

•	Select a previous mask from the List of masks list box with the mouse

Note:
   - there is a limit of 100 bytes per mask.
   - List of masks only contain 10 most recently used masks.

To accept you choice:

•	Type ENTER or

•	Type <Alt + O> or

•	Click on OK button with the mouse.

Wildcards

The following wildcard characters are accepted:

•	'*' will match zero or more characters. e.g. '*.*' will include all files. '*GRADE.TXT' will include 'GRADE.TXT', '1GRADE.TXT', 'ALLGRADE.TXT' etc.

•	'?' will match any one character. e.g. 'README.BK?' will include 'README.BK1',
'README.BK2', 'README.BKT' etc.

•	 A range is a sequence of characters enclosed in `[]'. It normally matches any single character from the sequence. If two characters in the sequence are separated by `-', this is shorthand for the full list of ASCII characters between them (e.g. `[0-9]' matches any decimal digit). To include a literal `]' in the sequence, make it the first character  To include a literal `-', make it the first or last character.

The Default mask is '*.*'.


Keyboard

If you prefer to keep your hands on the keyboard when you are working, you can use shortcut keys.

To	Press

Get Help	F1

Select Left Directory	F2

Select Right Directory	F3

Swap Directories	F4

Match or Refresh 	F5

Copy File(s)	F8

Delete File(s)	Delete

Quit	Alt+F4

Ctrl+Slash (/)	Select all items in the list box.

Ctrl+Backslash (\)	Cancel the selection of all items in the list box.

Shift+direction keys	Select multiple items in list box.


Options Dialog
Options Dialog Box

When you select Setup|Options, the following dialog box will be displayed :

Compare program path

Select a compare program to compare two files. DirMatch passes the full path of the two files selected as the program's command line parameter(s). Choose the Browse button to open a dialog box that you can use to select a program file.

Edit program path

Select a program which will be used when Edit Button is clicked or File Edit menu item is selected. DirMatch will invoke the program with the selected file(s) as it's command line parameter(s). Choose the Browse button to open a dialog box that you can use to select a program file.

Sorting Files

By default, files are listed alphabetically by name. You can choose to display files ordered by size (from smallest to largest); or by date, with the most recently modified file listed first.

Confirm on File Copy

When checked, DirMatch will ask you to confirm before it copies a file from one directory to the other.

Confirm on File Delete

When checked, DirMatch will ask you to confirm before it deletes a file from the directory.

Note : DirMatch always asks for your confirmation before it copies to or deletes a file marked by DOS as read-only file.


Print Dialog

This dialog box appears when you click on Print button from the tool bar or select File|Print from the menu.

Click on Setup button if you want to print to a specific print or to change the orientation.


Print Setup Dialog

This dialog box appears when you click on Setup button from the Print Dialog Box.

To change printer settings:

1 	Select another printer in the Printer option box.

2 	Select the page orientation in the Orientation option box.

3 	Select the paper size and source from the list boxes in the Paper box.

4 	Select the Options button to define additional printer settings, or
Select the OK button to save the changes and close this dialog box, or
Select the Cancel button to close this dialog box without saving any changes.


Select Directory Dialog

This dialog box appears when you click on Left or Right Directory Folder button from the tool bar or select Setup|Left/Right Directory from the menu.

Note: the Network button will appear only if you are running Windows for Workgroups. Click on Network button to connect to a network drive.


Update Dialog
Update Dialog Box

When you select Update|Directory from the menu or click Update icon from the tool bar, the following dialog box will be displayed :

Directory Selection

This will instruct DirMatch what directory (and its subdirectories if requested. see below) will be updated. Checking both box will make these directories in sync.
The OK button will be enable only if at least one of the two boxes is checked.

Subdirectory Options

•	Include All Subdirectories - If you check this box,  DirMatch will include all subdirectories, it uses the directory structure of the tree topped by directory specified.

•	Create New directories If Needed - .  DirMatch might need to create new directories to synchronize files. If the box is not checked, all files and directories below that directory will be skipped.

Log Options

•	Write Log File - You can ask DirMatch to log every actions taken for your reference by checking the box.

•	Append data if file exists - if the box is not checked, DirMatch will overwrite the log file if it already exists. Otherwise, DirMatch will append log information to the end of the log file.

•	Log File Path Use the 'Browse' button to choose the log file location. If you omit this step, DirMatch will use 'DIRMATCH.LOG' as the default file name.

File Options

•	Replace older file(s) only -  instruct DirMatch to copy all files which exists in both source and destination directory and files in the destination directory has an earlier date/time stamp.

•	Replace older file(s) and Add new file(s) - in addition to replace older files, DirMatch will copy files to the destination directory if file does not exist yet.


Color Dialog
Color and Font Dialog

Use the Color and Font dialog to set the colors for various text elements and font of the main list display.

Items

Items in this box are the text elements for which you are changing the color. Select and item from the list and then select the foreground color for that item.

The list box always includes the following items:

Item	Coloring Affects

Greater Files	Files are newer or larger than the files in the other directory

Less Files	Files are older or smaller than the files in the other directory.

Other Files	Files are the same or do not exist in the other directory.

Symbols(>,<,=)	Symbols indicate relation between files.

Font

Click on this button to select a font and its characteristics to use in the main window.