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

                       WebCopier version 1.3
                             July 1999

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


======================================================================
HOW TO USE THIS DOCUMENT
======================================================================

To view Readme.txt on-screen in Notepad, maximize the Notepad window.

To print Readme.txt, open it in Notepad or another word processor, 
and then on the File menu, click Print.


======================================================================
CONTENTS
======================================================================

1. Introduction

2. Installation

3. Program status and distribution

4. Contact Information

5. Frequently Asked Questions


======================================================================
Introduction
======================================================================

WebCopier is a powerful offline browser that downloads Web sites and 
stores them locally. It gives you instant access to critical Web sites 
at any time, regardless of where you are. WebCopier performs precise 
links searching, including JavaScript parsing, it can download up to 100 
files simultaneously and print entire Web site or only specific part of 
it. WebCopier supports proxy servers, allows to specify account name 
and password to access secure Web sites.


======================================================================
Installation
======================================================================

To install WebCopier:

- If you have downloaded file named "wcopier.exe", just run it. 
- If the file name has extension ".zip", you need to decompress it 
  with a program such as WinZip.  Then run the file "setup.exe". 


======================================================================
Program status and distribution
======================================================================

The program is FREE and freely distributable.


======================================================================
Contact Information
======================================================================

E-mail:		wcopier@columbus.rr.com
Internet:	http://home.columbus.rr.com/mklimov/


======================================================================
Frequently Asked Questions
======================================================================

General
============

1. I do not know when and how to use WebCopier?

You can use WebCopier every time you want to copy a web site or a part 
of it to your computer.
To download a Web site you need:
· Create New Project or Open existing one.
· Make sure that you are connected to the Internet.
· Start download by choosing "Project / Start Download" menu or pressing 
  special button on the Toolbar.
· WebCopier will show the "Download Info" dialog that displays the 
  information about the ongoing download.
· During the download you can use the Contents Tree to see what files 
  have been downloaded
· If any Error will happen during the download it can be viewed in the 
  Log File Window. Use the Appendix Appendix to find the error description.
· You can use the Integrated browser to see the downloaded files or 
  browse the Web.
· The program will stop download automatically when the web site will 
  be downloaded or certain stopping criteria will be reached. 
· You can stop manually by choosing "Project / Stop Download" menu, 
  pressing  Stop button on the Toolbar or the Stop button of  the 
  "Download Info" dialog.

2. Do I need to have any specific browser to download web pages?

WebCopier will work if you are using Windows 95, 98, NT or 2000 even 
when you do not have any browser installed. Few features (like the 
Integrated browser and printing) will not be available without 
Internet Explorer installation.


Installation
============

1. How can I install WebCopier?

If you have downloaded file named "wcopier.exe", just run it. 
If the file name has extension ".zip", you need to decompress it with 
a program such as WinZip. Then run the file "setup.exe". 


2. When WebCopier is unpacking itself, I got a "Corrupt Cabinet File" error. 
   What is wrong?

It seems that the program was not downloaded correctly.
You need to try again and it’s better to download it from WebCopier site.


3. "Bad or missing header information" message during the installation. 

The same problem. Please download WebCopier again.


4. I recently downloaded and installed WebCopier. Then I tried 
   to install the update but I got a message that the "previous installation
   is not found". What did I wrong?

The WebCopier update was made for existing WebCopier users that have 
the program already installed. Instead of downloading the full version, 
they can download only changes that transform old version into the new one. 
That’s why the update installation is searching for previous installation. 
Since you had download and install the full version, you do not need to 
install the update. 


5. I just ran WebCopier Setup and it seems to run fine, but there is no entry 
   in my Start Menu for it that I can find.  How can I start it?

The WebCopier installation should create a folder "Start \ Programs \WebCopier" 
that has the link to WebCopier v1.x. If this folder was not created by 
some reason, you still can start the program by running the file "WebCopier.exe" 
from the directory, where it was installed. The default directory name is 
"C:\Program Files\WebCopier". 


6. I get the error message "Installation Failed, Component: shared dlls, 
   File group: shared dlls" during install and it stops.

Please close all applications and try to run the installation again. 
The error you had means that some of the programs are using the DLL and the 
installation cannot check its version to decide whether to copy it over, or not.


Download
============

1. What is the Error Number 12002? Is there a way to avoid this?

The Error 12002 means the program does not receive a response from a web server 
during certain period of time.  To avoid it increase the "Timeout" value in the 
"Project Settings / Advanced" window. If it does not help, decrease the 
"Number of files to download simultaneously" in the "Project Settings / Download" 
window.


2. Is there anyway to extend the timeout length?

Yes, you can change it in the "Project Settings / Advanced" window.


3. Is there a way to resume the downloading a web site and its links from where I 
   left off after canceling the download?

To resume the download you need to start it again. WebCopier will check the date 
and size of each file to find out was it changed or not. If a file was not changed, 
the program will not download it again. As the result, the program will reach the 
place where you had cancel the download quite fast.


4. Is there a way to define that WebCopier will download a tree starting from 
   a specific directory, or does it go for the entire site regardless?

To start download from a specific directory you need to specify the directory URL, 
instead of site URL, in the "Project Settings / General" window. The program will 
download the directory first. Then it can try to download the rest of the site. 
To avoid it you need to use some restrictions in the "Project Settings / Download" 
window, for example, limit the number of files the program can get  or check the 
option "Download links below the starting URL only" in the "Project Settings / Advanced" 
window.


5. I would like to copy just 1 page (1 level) of a specific web site. 
   How can I do this?

Check the "Limit Levels" option in the "Project Settings / Advanced" window and set 
the value equal to 0.


6. I connect to the Internet through a Proxy server that needs a password and 
   a user name. Where would I type the entries?

You can enter them in the "WebCopier Options / Connection" window.


7. Can WebCopier download multiple sites without creating different projects?

WebCopier can download multiple sites as one project if they one of them has 
a link to another. You just need to set the option "Download Offsite Links" in 
the "Project Settings / Download" window. It’s recommended to set Directory structure 
to "Based on URLs" ("Project Settings / Advanced" window) in this case.
If the sites are completely unrelated you need to create different projects. 
But even in this case, you can run several copies of WebCopier simultaneously 
to download different projects in parallel or schedule a multiple projects download.


8. Is it possible to schedule a job or start the download of a site automatically 
   when the program starts?

Yes. Use "Edit / Schedule" menu or the corresponding toolbar button to schedule 
project(s) download.
Also the program provides command line equivalents for its options so you can use 
it with scheduling utilities such as Windows 98 Scheduler and System Agent, 
which comes with the Windows 95 Plus! pack.
Command line options to start a download are:
Webcopier.exe project.wcp -d -e
project.wcp	- project file
-d 		- start download automatically
-e		- close the program when the download is done


9. Some web sites have large ".exe" and ".zip" files within them. 
   How can I make WebCopier ignore them?

WebCopier has the ability to specify the upper file size limit you allow 
the program to download. This number can be found in the "Project Settings / 
Download" window and is named as "Max. File Size". The default value is 2 MB, 
but you can decrease it to ignore large ".exe" and ".zip" files.


10. Is there a way to use a "local" file (with URLs) as a starting point for WebCopier?

Yes. Go to the "Project Settings / General" window, click on the ">>" button, 
choose "Local Files" and select the file in the "Open" window. The program will 
use the file as the starting point for the download. If the file has link to web 
sites on the Internet, check the option "Download Offsite Links" in the 
"Project Settings / Download" window.


11. Is there a way to retry failed links?

You can specify the number of download retries in the "Project Settings / Advanced" 
window. The default value is 5.


12. Is there a way to retain the URLs of links that were not followed so that 
    they can be followed later when browsing?

The program can change the URL of links that had been downloaded. If the URL 
was not downloaded, it will not be changed.


13. Some sites have parameters like "progname?param1=xx&param2=yy". 
    Could WebCopier be setup so that the parameters could be entered?

Go to the "Project Settings / General" window and type a web site URL, 
including the name of the starting HTML file, followed by your parameters. 
For example, instead of "www.mysite.com" enter "www.mysite.com/index.htm?param1=xx&param2=yy".


14. How to select the type of files to download (e.g. *.pdf)?

WebCopier does not allow you to specify exact file types you want to download. 
However, you can exclude certain types. If you are interesting in download of 
"*.pdf" files, go to the "Project Settings / Download" window. Uncheck Images, 
Audio, Video and Java file types. After that WebCopier will download HTML files 
(it has to download them to trace web links) and all other files, including pdf.


15. Is there a way to set the level of links to retrieve?

Yes. You can specify the level in the "Project Settings / Advanced" window.


16. How can I download files from a directory and all its subdirectories avoiding all other files on that site?

Check the option "Download links below the starting URL only" in the "Project Settings / Advanced" window.


Browsing
============

1. How can I open and view a downloaded site with WebCopier?

There are two ways how to view a downloaded site.

 - You can use WebCopier integrated browser if you have Microsoft Internet Explorer 
   installed (not necessary running) on your computer. Click on the root node of the 
   Contents Tree, then double click on the fist tree subnode. The integrated browser 
   will load the site from your disk.
 - You can use any regular browser, like Netscape Communicator or Internet Explorer. 
   Check the option "Use External Browser..." in the "Project Settings / Contents" window. 
   Then double click on the fist tree subnode.
    or
   Start your browser manually and load the first HTML file of the site. The file is 
   located in the WebCopier project directory and has name the same name as the file 
   you specified as the site URL or "default.htm".


2. Is there a way to view the downloaded web sites in Internet Explorer or Netscape?

Check the option "Use External Browser..." in the "Project Settings / Contents" window. 
Then double click on the fist tree subnode.


3. How can I change the font size when displaying the copied site?

To change the font please use "Browser / Font Size" menu.


4. Can I browse a web site offline while it's being downloaded?

Yes. You can move the "Download Info" dialog to get access to the Contents Tree and 
use the Integrated browser or your regular web browser.


Other
============

1. Can I automatically transfer a URL to WebCopier?

Yes. Go to the "Project Settings / General" window, click on the ">>" button, choose 
"Internet Explorer Favorites" or "Netscape Bookmarks", select the URL and press OK. 
You will see the URL is copied to the Address field. Also you can transfer URL from 
your regular web browser through Windows Clipboard by using Cup and Paste.


2. Do you have a version of WebCopier for Windows 3.x?

Sorry, to use WebCopier you have to have Windows 95, 98, NT or 2000.


3. How can I see the Contents Tree with HTML files only and hide all other files?

Go to the "Project Settings / Contents" window and select "Show Only Text (HTML) Files".


4. Does the program understand JavaScript, specifically commands that open up new windows?

Yes, the latest version of WebCopier has improved JavaScript parsing.


5. I don't want to download the site (in fact I have it all ready on my local disk) 
   but I want to create just the site mapping to easy access to a specific file. 
   How can I do that ?

You need to specify the starting local file as the site URL. To do that go to the 
"Project Settings / General" window, click on the ">>" button, choose "Local Files" 
and select the file in the "Open" window. 


6. I want to collect downloaded files on CD. When I copy the whole downloaded tree 
   to the CD, the internal references still point to files on the hard disk. 
   How would I create a project that can be stored on a CD-ROM lately?

After a download WebCopier automatically updates all files references and makes them 
relative to the project directory. You also do it at any time by using "Project / 
Update Links" menu. That’s why you can copy WebCopier project to any drive you wish. 
The only thing you need to remember - you have to keep the project subdirectories 
structure.


