CopyDocs Version 2 Documentation

These scripts are provided "as is", with absolutely no warranty expressed or implied. Any use is at your own risk. I will try to update them as any issues are located, but there are no guarantees.
CopyDocs was written by Peter Riesett, for the Community College of Baltimore County. You may distribute these scripts, as long as you do so FOR FREE. Please include this file as well. Should you make any changes to them, please give credit to the original creator.

What is CopyDocs?

CopyDocs is a Perl program that searches the hard drives for files with the extensions you wish to look for, and copy them elsewhere. It can be used as a simple drive to drive backup utility, or aid rolling out PCs by finding user files without multiple searches. It will keep the directory structure that it found the files in, for quick and easy location afterward.

The zip file should contain the following files:

1.	Readme.html	This file
2.	cdoc1.gif	Image for ReadMe
3.	cdoc2.gif	Image for ReadMe
4.	cdoc3.gif	Image for ReadMe
5.	cdoc4.gif	Image for ReadMe
6.	cdoc5.gif	Image for ReadMe
7.	cdoc6.gif	Image for ReadMe
8.	cdoc7.gif	Image for ReadMe
9.	CopyDocs.bat	Batch file for running CopyDocs
10.	main.p	CopyDocs Launcher
11.	cdgui.pll	GUI module for CopyDocs
12.	cdprog.pll	Program module for CopyDocs
13.	cdoconfig.pcf	Configuration for CopyDocs

CopyDocs requires ActivePerl.
It has only been tested with version 5.8, but should work with 5.6

Installing CopyDocs

CopyDocs can be run either locally on a system with ActivePerl installed, or can be run from a network copy of ActivePerl.
In order to run the local copy of CopyDocs, simply unzip the files into a directory, and run the batch file.

In order to run CopyDocs from the network:

Install ActivePerl locally on a computer
Copy the Perl directory structure to a directory on the network (such as SYS\PUBLIC\ACTIVEPERL, or the like)
Create another directory after the Perl directory on the network (such as SYS\PUBLIC\ACTIVEPERL\COPYDOCS)
Unzip the files into that directory
Edit the batch file to reflect the new path

The batch file should be changed as such:

Change
perl main.p

To
\\Server\sys\public\activeperl\bin\perl.exe main.p

Or wherever you placed activeperl

DO NOT MAKE A SHORTCUT TO THE BATCH FILE, AS THIS TENDS TO BREAK COPYDOCS' FUNTIONALITY

Configuring CopyDocs

CopyDocs has a configuration file, cdocongig.pcf. It is an ASCII text file, and can be edited with ViM, Notepad, or whatever text editor you wish to use.
Cdocongig.pcf is broken into two sections: Extensions and Programs. If you wish to add or remove an extension to look for, add or remove them in the --EXT-- section. If you want to add or remove programs to look for, do so in the --PRG-- section.
The following directories are defaultly ignored when searching for files: cache, temporary internet files, system32, pchealth, and oobe. There is currently no way to add or remove these without going into the code.
By default, CopyDocs will always pick up bookmarks.htm regardless of whether or not you are looking for htm documents. If you would like this functionality removed, e-mail me at the address at the end of this document.

A brief tutorial

Double Click on the batch file.

From this screen, you can choose CopyDocs Wizard, Add Extensions to look for, Remove Extensions to look for, Add Programs to look for, Remove Programs to look for, and Help
The add/remove programs and extensions are for the current session only. If you wish to make a change permanently, edit the cdoconfig.pcf file. Select CopyDocs Wizard

Enter the starting directory.
It will now search the drive.

Here you can select or unselect files to copy.
There are a number of buttons on this screen. By clicking on the Progams button, you will get the following screen

Here it will list any programs you were searching for that it found. This is useful if you put in things like HTML editors, as this will let you know whether or not you wish to copy html documents.
By clicking on the Summary button, you will get the following screen

This shows a summary of checked items.
Clicking on Filter, you will get

You can filter by extension or keyword. Checking either box and typing in the extension (no dot), or the keyword will uncheck the files in the Wizard page.
Clicking on Next, you will get

Here you enter the directory you wish to copy to. The last directory in the path you type in does not need to be created, but the rest do. Once you have entered a directory to copy to, and click Next, it will copy the files, and let you know when it is finished.

You can download CopyDocs Here

If you wish to be put on a mailing list to receive the newest version of CopyDocs, E-mail the address in the readme.