CyberSpyder Link Test 
Version 2.1 Alpha 2 
 
The first section of this 'readme' is a brief description of the changes made in 
Version 2.1 (from Version 2.0).  The alpha 2 release fixes bugs found in the 
alpha 1 release and adds an additional analysis report.

This 'readme' also contains instructions for installation of the program. Please
check the CyberSpyder Web site for possible additional information that may apply. 
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
Changes included in Version 2.1a2

1. All known bugs found in Version 2.0 have been fixed, as well as bugs found
     in the alpha 1 release.

2. Test Setup Screen changes:
     - The 'Basic Section' has been replaced with two sections, one for entering
		'Start URLs' and a separate one for entering 'Skip URLs'.
     - A new section has been added ('ID/PW URLs') to permit entry of URLs that
		require the use of an ID and Password for access, but that are not
		part of the 'home' site.
     - The type of test that can be run now includes three choices:
		- a 'Normal Test' (as available on earlier versions)
		- a 'Home site' only test (as could be selected on Version 2.0)
		- an option to limit the test to checking only the links contained
			in the pages entered as starting URLs to permit you to
			run checks on individual pages.
	These choices appear as options in the 'Start URLs' section.
     - A change to the method of entering URLs in the three sections ('Start URLs',
	'Skip URLs, and 'ID/PW URLs').  Each of these sections now shows three 
	buttons.
	     - use the 'New' button to enter a new URL.
 	     - use the 'Edit' button to edit an existing URL.  Click on the URL
		to highlight it, then click 'Edit' to edit it.
	     - use the 'Delete' button to delete a URL from the list. Click on the URL
		to highlight it, then click 'Delete' to delete it.
     - The 'Proxy Server Setup' in the 'Test Options' section now includes provision
	for entry of an ID and Password to access a proxy server.

3. Report Changes.
     - The existing reports that were contained in Version 2.0 remain unchanged.
	Some additional 'Analysis' type reports have been added.  When the 'Select'
	button is clicked on the Main screen, or 'Select' is chosen from the reports
	menu, a dialog is opened where you can choose 'Result Reports' or 'Analysis
	Reports'.  The 'Result Reports' are the same reports that where available in
	Version 2.0.  The 'Analysis Reports' are new reports.  You should be aware
	that these reports can take an appreciable amount of time to produce (depending
	on the size of the site) as the program must do quite a bit of work to produce
	them.  The reports are:
		- Site File Structure Report: this lists all of the home site URLs that
			were found in a 'File Structure' format.  Items on this report
			that are of an 'unknown type' for purposes of the report will
			include the 'Content-type' that was returned by the server to
			assist in identifying them. 
		- Site Map Report: this is similar to the File Structure report, except it 
			only lists URLs that are for HTML pages (an HTML page is any
			page that the server returned identifying the 'Content-type' as
			'text/html'.  This means broken links are excluded since they do
			not have a content type associated with them).
		- Cross Reference Reports:  (WARNING-these reports can be quite large.)
			These reports provide a cross-reference of your site.  You can
			sort the reports by page, showing the links contained in each
			page, or by links, showing which page(s) contain each link.
			The reports can show all links, or can be limited to only those	
			links identified as HTML links (requires a completed good test
			run), or only those links that appear within an anchor
			(<a href=).  since all links contained in the database may not
			be 'good', the reports can show the result messages associated
			with those that are not.  Optionally, the result messages
			can be suppressed.
		- Page Size Analysis Report: this report helps to determine the total size
			of a page (in bytes).  This total includes the HTML file itself,
			as well as all of the image files included in the page.  A well
			designed site should try to keep the entry page(s), as well as
			the first level below the entry point to relatively small total
			page size.  The recommended size is to try to keep these pages
			under 20K, or at the most, no more than 30K.  This report can
			be used to help reach this standard.
 
 

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
Update Installation

If you have installed the previous alpha release, then the only file that needs
to be replaced is the '.exe' file.  The zip you downloaded contains this 'readme.txt'
and the new '.exe' file.  This file will be 'lnkchk21.exe' for the 16 bit release,
or 'cyberspyder21.exe' for the 32 bit release.  Copy this file to the location where
you installed the alpha 1 release, overwriting the original '.exe' file.
 
Complete Installation 
 
Before attempting to install the program, be sure that nothing else is running 
on your system.  The most frequent install problems are caused by something 
else running on your system that is using a file that this install needs to be able 
to update.  Don't forget to check for programs that are set up to automatically 
start when Windows is started, as these are often missed. 
 
Both the 16 and 32 bit releases are standard Windows' installations.  To install 
the program, run 'setup.exe'. 
 
16 Bit Installation 
 
There are no special instructions for the 16 bit install 
 
32 Bit Installation 
 
Make sure that the 'zip' file was unzipped with a utility that can handle long 
file names.  You can confirm this by looking at the names of the unzipped files.  
If you find the file 'cyberspyder21.ex_', then you are OK.  If you do not find that, 
but you find the file 'cyberspy.ex_', then your utility does not handle long file 
names.  (Suggest you get the latest 32 bit version of Winzip from 
http://www.winzip.com/).  The workaround for this install is to rename 
'cyberspy.ex_' to 'cyberspyder21.ex_' before proceeding with the installion (it is 
the only file that needs the long name in this install.) 
 
Potential problems with the 32 bit install procedure: 
 
Some problems which occasionally occur when installing the 32 bit version are 
outlined here: 
 
Sometimes when installing the program, the install will display a message that 
it is about to replace a pre-existing file. If you drag the message window out of 
the way, the file name shown as the file currently being copied is the file it is 
warning about. In actual fact, the install does not replace the existing file unless 
the version on your system is older than the one being installed and it is 
normally safe to proceed. However, if this problem occurs and you want to play 
it safe, proceed as follows:  
        1.Make a copy of the existing file on your system, but leave the original in 
	place. 	The suggested rename is to keep the original file name, and 
	just add `.sav` to 	it..  
        2.Proceed with the install and let it replace the existing file (safe, since 
	you now have a backup copy).  
        3.After the install completes, look in the directory where the program was 
	installed and view the file `St4unst.log` (use notepad). Look for the file 
	that the install indicated it was replacing. The log clearly indicates 
	which files it actually replaced. If it indicates that `File currently on 
	disk was already up to date`, then you can delete your backup copy as 
	the file was not replaced. If it indicates that `File was not found or was 
	an older version -- new file copied`,  then the file was replaced and you 
	should retain the backup until you are sure there are no problems with 
	your system. 
 
If you attempt to install the 32 bit version, and the setup program will not run, 
indicating that it cannot find msvcrt.dll, it indicates that your system is missing 
this file. This file is used by a number of programs, but it is possible that it was 
inadverently deleted (possibly by the uninstall of some program). If you get this 
message, you can download the file from ftp://cyberspyder.com/msvcrt.zip. 
Unzip this file and place the contained `dll` (msvcrt.dll) in your 
windows\system directory 
 
If the install gives an error about being unable to register tabctl32.ocx, this is 
most likely caused by an error in the system registry on your machine. Registry 
problems can often be cleared up by using the latest version of regclean.exe. (It 
sometimes solves other problems as well).  
	Regclean is an unsupported Microsoft Utility and the latest version can 
		be found at 
	http://www.microsoft.com/kb/articles/Q147/7/69.htm  
	The download is about halfway down the page.  
	If you tried to continue the install after the error, uninstall the 
	program. Run regclean, then try the install again. It will most likely 
	now complete correctly.  
 
If you get the message 31037 Error loading from file when trying to start the 
program, there is a problem.  This is the unhelpful error that Microsoft Visual 
Basic gives when the program attempts to access a 'dll' or 'ocx' file that does not 
exist or is not correctly installed on your system. The error gives no indication 
of the file name.  
If you get this error when you attempt to run this version, and you have only 
installed the upgrade, you should uninstall the entire program, download the 
complete install, then reinstall it. 
If the error still occurs after a full install, the only option at present is to try 
installing the 16 bit version instead. The file causing this error is presently 
unknown. We are investigating the problem, and will post the solution on the 
Web site as soon as it is found. If you get this error, please report it, as we may 
ask for some details about certain files on your machine as part of our 
investigation..  
 
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

To use CyberSpyder Link Test, start the program, then review the Quick Start 
item in the help file for additional details
