Copyright: Copyright © 1995 Ariel Communications Limited


URL conversion, Present links

Convert to full URL
the full original Web page path is added to a referenced Web file name if it was not already present

Point to dump file
the URL is changed so that it points to a temporary dump file if pages are being displayed from the cache, or the dump file if images are being displayed from a dump

Leave unchanged
no conversion is done on the URL read from the cache

See also
full and relative URLs

examples of conversion usage


 What is Secret Agent?

Secret Agent is the ultimate accessory for the Netscape or Internet Explorer user,.giving access off-line to all the information that a browser saves on-line in its disk cache.

After a heavy session of on-line Web browsing, you can now close down your link to your service provider and revisit off-line all the pages you accessed during your session, complete with in-line images and working links between accessed pages. You can even build full off-line versions of the best multimedia web presentations.

Supported platforms


 What can Secret Agent do?

Secret Agent can:

list all the contents of your browser cache

list the HTML files in your browser cache

list the image files in your browser cache

dump to another part of your disc the entire contents of your browser cache

dump to disc selected entries (HTML pages or image files) from your browser cache

call your browser to display a selected Web page or image from either the cache or a dump of the cache

build full off-line versions of any multimedia web presentations

call your browser to display a special summary of thumbnail size copies of the image files in a dump, from which the original images may be displayed.

delete Web page(s) and/or image file(s) from your browser cache

delete the whole browser cache

Supported platforms


Secret Agent How Tos...
 Secret Agent  Contents

What is Secret Agent?

What can Secret Agent do?

Secret Agent's listboxes

READ THIS!!!!!

Secret Agent How Tos

How to run the Secret Agent demonstration

How to display your browser cache

How to list the Web pages in your browser cache

How to list the images in your browser cache

How to list all files in your browser cache

How to list all the files in a dump

How to toggle between a cache filelist and a dump file list

How to summarise the information in the current cache or dump

How to sort the listbox entries

How to dump the complete cache

How to dump selected files from the cache

How to open a previous dump

How to display a page or image from the cache or dump in your browser

How to display a selection of multiple pages and/or images from the cache or a dump in your browser

How to remove a dump

How to remove files from a complete or partial dump

How to remove files from your browser cache

How to remove the currently open cache

How to view a summary of the image files in a complete or partial dump in your browser

How to save a selected (or a selection of) file or image

How to copy the URL (or a selection of) of a page or image to the clipboard

How to revisit on-line a selected page or image

How to search for a specified string in the listing of the dump or cache displayed

The Secret Agent menus

The Secret Agent Toolbar

The Secret Agent Pop-up menu

Secret Agent FAQs

How to Contact Us

Registering Secret Agent


The Secret Agent menus
 Secret Agent  Contents

What is Secret Agent?

What can Secret Agent do?

Secret Agent's listboxes

READ THIS!!!!!

Secret Agent How Tos

The Secret Agent menus

File menu

Edit menu

View menu

Search menu

Settings menu

Help menu

The Secret Agent Toolbar

The Secret Agent Pop-up menu

Secret Agent FAQs

How to Contact Us

Registering Secret Agent


 File menu

Click on the particular menu item for which you need help:


 View menu

Click on the particular menu item for which you need help:


 Search menu

Click on the particular menu item for which you need help:


 Settings menu

Click on the particular menu item for which you need help:


 Help menu

Click on the particular menu item for which you need help:


File, Load cache

Extracts the entries from the current browser cache and refreshes the list displayed. The type of file displayed - HTML, image or all depends on the setting made in the View menu or from Secret Agent's toolbar.

If Secret Agent finds that the cache directory contains both a Netscape 1.xx and Netscape 2.0 cache, then a dialog is displayed as shown below asking which cache Secret Agent should analyse.


File, Open
File, Open	Tool bar 	Hotkey Ctl+O

Allows you to select a previous dump index file from the Open Dump Index dialog. By default Secret Agent's dump index files are saved with the extension idx. The files that were saved in the selected dump will then be displayed in the Secret Agent main window.


File, Dump all
File, Dump all	Tool bar

Allows you to dump all the files from your browser cache to a dump file whose name is chosen through the Save Dump As dialog.


File, Dump select
File, Dump select	Tool bar

Allows you to dump files which have been selected from the browser cache list to a dump file whose name is chosen through the Save Dump As dialog.


File, Remove

Removes the currently open dump file and all its associated files from disc. You are asked to confirm or cancel the action through the Remove dump dialog.

OR

Removes the current browser cache and all its associated files from disc. You are asked to confirm or cancel the action through the Confirm dialog.


File, Remove select
File, Remove select	Hotkey Del

Allows you to remove the selected files and/or images from the currently open dump. You are asked to confirm or cancel the action through the Selective delete dialog.

OR

Allows you to remove selected files and/or images from the currently opened cache. You are asked to confirm or cancel the action through the Confirm dialog


 Edit menu

Click on the particular menu item for which you need help:


File, Information
File, Information	Tool bar

Displays statistics -

number of Web pages
number of image files
number of other files
total dump or cache size in bytes

in the currently opened dump file or browser cache.


File, Exit
File, Exit	Hotkey Alt+F4

Exits the Secret Agent program


 Save Dump As

Secret Agent is creating an index file, the dump file for the dump (either the whole or selected) of the cache that you are making. Use this dialog to select the directory where you want the dump to be saved and enter the file name that you wish the dump to be saved as.

Click on the particular area for which you need help:


 The Secret Agent Tool bar

Click on the particular tool bar button for which you need help:


URL conversion, Present images

Convert to full URL
the full original Web page path is added to the image file name if it was not already present

Point to dump file
the URL is changed so that it points to a temporary dump file if images are being displayed from the cache, or the dump file if images are being displayed from a dump

Leave unchanged
no conversion is done on the URL read from the cache

See also
full and relative URLs

examples of conversion usage


 Open Dump Index

Use this dialog to select the name of the dump file, named when the cache (or part of) was dumped, that you wish to open.

Click on the particular area for which you need help:


 Remove dump

This dialog is displayed for you to confirm that a selected dump should be deleted.


View, Cache
View, Cache	Tool bar  [image] or

Displays the list of files in the cache.


View, Dump
View, Dump	Tool bar

Displays the list of files in the currently open dump index (only accessible if there is a dump index open).


View, HTML files
View, HTML files	Tool bar

Selects the type of file displayed in the currently displayed list to be HTML i.e. Web page files only.


View, All files
View, All files	Tool bar

Selects the type of file displayed in the currently displayed list of dump or cache files to be any file.


View, Images
View, Images	Tool bar

Selects the type of file displayed in the currently displayed list as Image files only.


View, Show
View, Show	Tool bar  [image] or 	    Right mouse button, Show

Starts your browser, if this is not already running on your desktop, to display the currently selected page (HTML file) or image. This feature may also be used to display a selection of pages or images in your browser. When the first item of the selection is displayed in your browser, click on the Secret Agent button, [image] normally displayed in the top left hand corner of the screen, to advance to the next selection.


Search, Find next
Search, Find Next	Hotkey F3

Allows you to carry on searching the list of cache or dump entries for a search string which was entered in the Find dialog after clicking on the Search menu, Find item.


Search, Find
Search, Find	Hotkey Ctl+F

Allows you to search the list of cache or dump entries for a search string through the Find dialog. Clicking the Find Next button of the Find dialog will find the first instance of the string which then be highlighted in the file list. Further instances of the same string may be found by clicking on the Search menu, Find Next menu item or the F3 hotkey.


Settings, Tool bar

Toggles the display of the tool bar on and off.


Settings, Status bar

Toggles the display of the status bar on and off.


Help, Contents

Displays the Contents page of the Secret Agent Help file.


Help, Using Help

Displays the standard Windows Help guide on using the Windows Help system.


Help, About

Displays version information about the Secret Agent product and licence information where the product is a registered copy.


File name

The name of the file that you will use.


File list

The list of files of the given type in the selected directory


File type

A drop down list from which the file type to be displayed in the file list may be selected.This will be those files with an idx extension for Secret Agent dump files.


Directory path

The directory listing from which the directory may be selected.


Directory

The currently selected directory from the directory list.


Drive

Drop down list of drives which are configured.


Network...

Clicking this button displays a dialog from which a networked drive may be selected.


 Selective delete

This dialog is displayed when selected files are to be removed from an existing dump file.


How to list the Web pages in the current Netscape cache
 How to list the Web pages in your browser cache

1.	Display your browser cache

2.	Click on the tool bar button [image] or select View, HTML from the menus to display the HTML (Web page) files.


How to list the images in the current Netscape cache
 How to list the images in your browserb cache

1.	Display your browser cache

2.	Click on the tool bar button [image] or select View, Images from the menus to display the image files.


How to display the current Netscape cache
 How to display your browser cache

You may wish to display your browser cache in a situation corresponding to one of the three below:

1.	On initially starting Secret Agent click on Yes in the Query dialog asking if you wish to examine the information in your browser cache.

2.	When Secret Agent is running and you have already examined the cache in this run, then click on the tool bar button [image] or select View, Cache from the menus to toggle the Secret Agent file list back to your browser cache list.

3.	When Secret Agent is running , select File, Load cache from the menus. (This will cause the cache to be re-examined if you have already looked at it in the current Secret Agent 'run'.)


How to list all files in the current Netscape cache
 How to list all files in your browser cache

1.	Display your browser cache

2.	Click on the tool bar button [image] or select View, All entries from the menus to display all the files in the cache.


 How to summarise the information in the current cache or dump

Click on the tool bar button [image] or select File, Information from the menus. A dialog will then be displayed giving the following information: number of Web page files, number of Image files and the total size in bytes of the cache or dump.


 How to dump the complete cache

1.	Click on the tool bar button [image] or select File, Dump all from the menus.

2.	The Save Dump As dialog will then be displayed in which you should select the path to the directory in which you wish the dump to be made, and enter the name of the dump file you wish to dump to.

3.	A Progress dialog is displayed which may be aborted at any time if you wish to stop the dump.

See also Secret Agent's Dump Index


 How to dump selected files from the cache

1. 	Display your browser cache.

2.	Select the type of files you wish to dump i.e. HTML files, Image files or All files.

3.	Using the mouse click, or click and drag or press Control and click, or press Control and click and drag to select the files you wish to dump in the Secret Agent's file list.

4.	Click on the tool bar button [image] or select File, Dump select from the menus.

5	The Save Dump As dialog will then be displayed in which you should select the path to the directory in which you wish the dump to be made, and enter the name of the dump file you wish to dump to.

6.	The Progress dialog will then be displayed which may be aborted at any point during the dump.

Note: If you are dumping HTML files, then any in-line images associated with a page will also be dumped.


 How to remove a dump

1.	The dump that you wish to remove must be the currently opened dump.

2.	Select File, Remove from the menus and confirm by clicking Yes in the Remove dump dialog.

Removing a dump deletes all the files associated with a dump, also its index file.


How to remove files from the Netscape cache
 How to remove files from your browser cache

1. 	Display your browser cache.

2.	Select the files that you wish to remove from the cache listing.

3.	Select File, Remove select in the menus or use the hotkey Del to remove the items. You will be asked to confirm or cancel the action through the  Confirm dialog.


 How to open a previous dump

1.	Click on tool bar button [image] or select File, Open from the menus or use the hotkey combination Ctl+O to display the Open Dump Index dialog.

2.	Use the dialog to select the dump index file that you wish to open and click OK.

The Secret Agent file list will then be refreshed, reflecting the contents of the newly opened dump.


 How to remove files from a complete or partial dump

1.	The dump that you wish to remove must be the currently opened dump.

2.	Highlight the file(s) you wish to remove in Secret Agent's file list

3.	Select File, Remove select from the menus or press the Del key on the keyboard, then confirm by clicking Yes in the Selective delete dialog.

Note: If you are deleting HTML files in a selective remove, then any in-line image files associated with particular pages are NOT removed from the dump.


Settings, Options, Netscape
Settings, Options, Browser

Click on the particular area for which you need help, the Misc tab for help on the Misc options dialog and the Conversion tab for help on the options available for URL conversion by Secret Agent.


 Secret Agent FAQs

Which versions of Netscape does Secret Agent support?

Secret Agent supports Netscape Navigator 1.1, 1.2 and 2.0.

My dump directory seems to be getting very much larger than my browser cache directory. Why?

If you are creating a full dump every time you do a dump and have not cleared your cache in between, then files that are in the cache will be copied to the dump directory each time you make a dump. If you do not want to clear the cache, then for the time being use Secret Agent to remove the previous full dump, before you create the next full dump. The licensed version of Secret Agent contains an append option which will avoid this duplication of dumped data.

Can I append selected files to an existing dump?

This feature is available in the licensed version of Secret Agent.

I have just started using Netscape 2.0. However, Secret Agent does not show me the links that are available in a dump like it used to when I was using Netscape 1.2. Why?

This feature is not currently available in Secret Agent with dumps made from a Netscape 2.0 cache.

Does Netscape put News postings that you read in the cache?

Yes - if you are using Netscape 2.0. And you can use Secret Agent to replay them off-line.

I have checked, using Options/Browser in Secret Agent's menus that Secret Agent is looking at the right directory for my cache. However, Secret Agent is reporting that there is no cache. Why?

Secret Agent looks for a cache index file (called FAT in Netscape 1.1 and 1.2, and FAT.DB in Netscape 2.0 and main.ndx in Internet Explorer 2.x) in the cache directory. It outputs the above message if it cannot find either of these files in the specified directory. This may occur if the cache has recently been cleared, or if the cache is in a different directory.

Why can't I follow links to other pages when I know I visited the link and waited for the page to load completely so that it should have been put in the cache?

Have a close look at the URL that is displayed in the status bar as you move the mouse over a link that you are unable to follow. If you see that there are screen coordinates that are changing as you move the mouse, then the link is an image map that requires a server program or table to work. The latter are not available off-line.

Note also that we have found that a few pages never get put in the cache... and hence will never be available.

Doesn't Secret Agent driving my browser upset the cache?

No. Your browser only caches files that it downloads across the Internet; it doesn't waste cache space with files that are on the local disk. Secret Agent only reads the cache so it cannot upset its contents. Secret Agent will ask you if you wish to close your browser before it reads the cache only to ensure that the browser writes all the latest cache information to disk.

When I display a single page from the cache and position the cursor over the links, why does the status bar refer to a file called missing.htm when I can see from the cache listing that the page under the link is in the cache?

If you are displaying a single page from the cache listing, then none of the links are available to you. Display a page from a dump of the cache in order to see the links which you can follow - these are coloured by Secret Agent. Then links which point to missing.htm are links to pages which were not in the cache.  This is Secret Agent's default behaviour - this may be changed through the Conversion tab of the Settings, Options menu item.

I have converted my links to full URLs but now I get 'Network socket unavailable'.

If your browser is not loaded when you request a page to be displayed through Secret Agent, then Secret Agent attempts to load a dummy winsock.dll before loading your browser. This prevents the browser from loading your TCP/IP stack, because doing this may cause hangs, or attempt to dial your service provider. If you want to access pages on-line whilst Secret Agent is running, then you should either load the browser before Secret Agent, or you should disable the dummy winsock option in the Browser tab of Secret Agent's Options dialog. If you use the latter approach you must close both your browser and Secret Agent for the change to take effect.

If I display a selection of pages from the Netscape cache with Secret Agent why are some links coloured and some not when I know that the pages are in the cache?

As Netscape displays your selection of pages it will mark any links to pages which have already been displayed - this is its default action.
To get an accurate picture of which links are followable, and which not, first dump your selection of files with Secret Agent and display them from the dump listing. Any links that are available will be coloured.

I start Secret Agent and view the cache. From the cache listing I display a page in my browser. I find a link coloured, yet this is the first page I have displayed. Why is it coloured?

Believe it or not there are some pages which have links which point to the current Web page! This might confuse you when you are on-line too!

Can I use Secret Agent to clear and replace corrupt Web pages or image files in the cache?

Yes, you can! Use File, Remove Select to delete the corrupt entry from the cache. If there is a link to the missing page or file on one of your existing Web pages, then go on-line with that page displayed (View, Show) and follow the link. For a page where you have deleted a file corresponding to a corrupt in-line image, then use Secret Agent's revisit facility (View, Revisit) to reload the complete page in the cache.

Note: Netscape's Reload facility will only retrieve a copy of a file from the remote server if it thinks that the file has changed - i.e. a corrupt cache file with the same date and time stamp as the server original will not be reloaded.


How to Contact Us

Registered users of Secret Agent will receive support by e-mail.

We can be contacted at the following addresses:

http://www.nildram.co.uk/sagent/

This is our Web Page for Secret Agent. From this page you can scan the Frequently Asked Questions and obtain the latest release for downloading.

sagent@nildram.co.uk

To report problems, request technical support or send comments. Please remember to tell us what release you are using.

sales@nildram.co.uk

Our sales email address if you can't wait to buy a licence!

Find out more about the developers of Secret Agent.....


Registering Secret Agent

By using Secret Agent you have accepted the terms of the licence agreement, in particular the obligation to purchase a licence if you wish to continue to use Secret Agent after the 21 day evaluation perios has elapsed. Secret Agent is shareware, for which a registration fee is required!

Purchasing the licence gives you
additional features
support by e-mail

What are the additional features?
a full set of GIF image summary pages
JPEG image summary pages
facilities to grab pages, missing images and missing links automatically on-line
the ability to append to an existing dump

How do I register?
by printing the page Secret Agent Registration Form and filling in the order form it contains. Alternatively on-line in your browser - Select File, Open File in the menus and enter the file name and path http://www.ariel.co.uk/sagent/order.htm and submitting the completed form on-line using the Submit button on the form.

When we have received your completed order form and payment, you will receive confirmation and your registration details by e-mail in 2 working days.

Enter your registration details, by clicking on the item Registration in the Secret Agent Help menu.

How much does it cost to register?
The registration cost of Secret Agent is £24.95 sterling (approx. $39) including VAT, if applicable.


Contents
 Secret Agent  Contents

What is Secret Agent?

What can Secret Agent do?

Secret Agent's listboxes

READ THIS!!!!!

Secret Agent How Tos

The Secret Agent menus

The Secret Agent Toolbar

The Secret Agent Pop-up menu

The Secret Agent FAQs

How to Contact Us

Licence Agreement

Registering Secret Agent


Settings, Options, Conversion

Click on the particular area for which you need help, the browser tab for help on the browser options, or the Misc tab for the Misc help dialog.


How to display a page or image from the cache or dump in Netscape
 How to display a page or image from the cache or dump in your browser

Select the required page or image file in the dump or cache listing and click your browser toolbar button [image] or [image] or select View, Show from the menus. If your browser is not already running, then it will be started and the required page or image displayed. See also READ THIS!!!!!


How to display a selection of multiple pages and/or images from the cache or a dump in Netscape
 How to display a selection of multiple pages and/or images from the cache or a dump in your browser

Select the required pages and/or image files in the Secret Agent dump or cache listing and click your browser toolbar button [image] or [image] or select View, Show from the menus. If your browser is not already running, then it will be started and the first required page or image will be displayed. In order to move to the next page or image in your selection, click on the Secret Agent Next window which will normally be displayed in the top left hand corner of your browser window. See also READ THIS!!!!!


Secret Agent Next window
Secret Agent Next button

This is a Secret Agent feature which allows you to play a selection of web pages and/or images from the dump or cache file list through your browser. It is started when a selection of pages and/or images has been made and you have clicked on the tool bar button [image] or [image] or selected View, Show from the menus. Clicking in the small Secret Agent button which is displayed in the top left hand corner of the screen (unless moved) will cause your browser to display the next selected item. The sequence may be aborted by clicking the Close button in the top left hand corner of this small window.


View, Sort by URL

Causes the files and/or images in the cache or dump listing to be sorted by their URLs. The sort status of the cache and dump listings is independently maintained, so that toggling between the two listboxes will always display a listbox by its last sort method.


View, Sort by access

Checking this causes the files and/or images in the cache or dump listing to be listed in order of access, those last accessed being at the top of the list. The sort status of the cache and dump listings is independently maintained, so that toggling between the two listboxes will always display a listbox by its last sort method.


Help, Demonstration

Clicking on this menu item starts a demonstration of Secret Agent's features. The demonstration shows the reading and subsequent listing of the files in your browser cache and the dumping of the complete cache to a location where your browser may be used to browse its contents off-line. How to run the Secret Agent demonstration gives more details.


Netscape program directory
Browser program directory

Enter the full path to your browser program directory here if different from default.


Netscape cache directory
Browser cache directory

Enter the full path to your browser cache directory here, if different from default.


History file

Enter the full path to your browser history file here if different from default.


OK button

Click on this button to accept the dialog's settings.


Cancel button

Click on this button to ignore any changes you have made to the settings of this dialog.


Defaults button

Clicking this button will restore the directory and file settings to the Secret Agent or browser defaults.


Help button

Click on this button to get Help for this dialog


Cache load options

Click on the appropriate action that  you wish Secret Agent to take when it examines your browser cache. If the browser is not closed, then the disc copy of the cache will not reflect exactly the state of the pages you have visited as the history file is only written to disc when the browser is closed.


Settings, Options, Misc

Click on the particular area for which you need help or on the Browser tab for help on the browser options dialog.


Netscape history file
History file

Your browser maintains a list of pages you have visited in a history file and marks links to these sites to be displayed in a particular colour so that you can see what links you have followed. The file is read into memory when you browser is loaded, and updated in memory; only to be written to disc again when it is closed. Note that Netscape's links expire by default after 30 days, although the default can be changed through Netscape's Preference, Styles dialog.


Misc defaults

Resets the options of this dialog to the Secret Agent defaults.


Confirm dump

Check this box if you wish to be asked to confirm your action, having selected that the currently open dump and its associated files are to be removed.


Secret Agent start options

Click the action you wish Secret Agent to take with your browser cache when Secret Agent starts.


How to run the Secret Agent demonstration

Select the menu item Help, Demonstration to start the demonstration. Your browser cache will be located, and its contents examined. A list of the Web pages found in the cache will be displayed. The whole cache is then dumped to file and selected entries are displayed. Finally the dump is removed. The demonstration is guided by a series of dialogs which explain the actions that Secret Agent is taking.


 READ THIS!!!!!

Displaying pages with your browser from Secret Agent

IF THE PAGE HAS BEEN SELECTED FROM THE CACHE LISTING.......

the page is displayed including the images contained within the page and showing all links from the page. The display DOES NOT mark the links which have been followed when you were on-line. This is Secret Agent's default action when the selections of the Settings, Options, Conversion tab are left at default. If the latter are changed, then your browser will take its normal action with respect to followed links and missing images.

IF THE PAGE HAS BEEN SELECTED FROM A SECRET AGENT DUMP OF THE CACHE.....

the page is displayed including the images contained within the page and showing all links from the page. This time links to pages which are in the cache, and which are therefore followable off-line, are marked.

So.... if you want to be able to browse your on-line sessions again off-line, then you MUST dump the cache with Secret Agent first and leave the settings of the Conversion tab at default.

Using the advanced options of the Settings, Options, Conversion tab gives you the possibility of displaying pages from a Secret Agent dump, and being able to follow previously unfollowed links or retrieving missing images easily.

DO NOT BE SURPRISED if links you know you have followed don't have corresponding pages in the cache -

if you abort the load of a page, it won't be stored in the cache

if you re-visit a page that you had previously been to, and abort the load, your browser will remove the cache entry

there are a few pages which your browser never puts in its cache that will never be available off-line


URL conversion, Missing images

Convert to full URL
the full original Web page path is added to the image file name if it was not already present

Point to missing file
the URL is changed so that it points to a file with name missing. When your browser is asked by Secret Agent to display the page containing the missing image it will display its broken image picture because it can't find the image file called missing to display.

Leave unchanged
no conversion is done on the URL read from the cache

See also
full and relative URLs

examples of conversion usage


 Secret Agent's Dump Index

Secret Agent creates a special page !!!This PC!!! , shown as the first entry in the Secret Agent list of files when either the HTML files or All files menu items are checked in the View menu.

The page contains a list of all the pages in the cache which are sorted according to their URL. It also shows the titles of the Web pages. The latter are marked with links to the corresponding files in the dump.


 Cache list help

When the list of HTML files and/or images in the cache is displayed, you may take any one of the following actions:

list all the Web pages in the cache

list all the Image files in the cache

list all the files in the cache

sort any of the above in order of access or in order of URL

display a selected page or image from the cache in your browser

display a selection of multiple pages or images from the cache in your browser

summarise the information in the cache

dump the whole cache

dump a selection of files from the cache

save a selected file or image

save a selection of multiple pages or images

copy the URL (or a selection of) of a page or image to the clipboard

revisit on-line a selected page or image

search for a specified string in the listing of the cache displayed


Dump list help

When the list of HTML files and/or images from a Secret Agent dump of the browser cache is displayed, you may take any one of the following actions:

list all the Web pages in the dump

list all the Image files in the dump

list all the files in the dump

sort any of the above in order of access or in order of URL

display a selected page or image from the dump in your browser

display a selection of multiple pages or images from the dump in your browser

summarise the information in the dump

remove the whole dump

remove a selection of files from a dump

open a previously made dump

analyse your browser cache

save a selected file or image

save a selection of multiple pages or images

copy the URL (or a selection of) of a page or image to the clipboard

revisit on-line a selected page or image

search for a specified string in the listing of the dump displayed


 No list help

If you have not already viewed the cache or opened an existing dump file, then the following options are open to you:

change any of the settings in the Settings, Options... menu item

view the files in the current browser cache

open an existing Secret Agent dump of files from your browser cache


 How to sort the listbox entries

To sort the entries displayed in the listbox in order of their access, select View, Sort by access to place a check by the Sort by access menu item. The listbox will then be sorted so that the most recently accessed item is at the top of the listbox list.

To sort the entries displayed in the listbox in order of URL, select View, Sort by URL to place a check by the Sort by access menu item.

The sort method for cache and dump listboxes are maintained independently, so that switching between these listboxes will automatically display the listbox contents in the last method in which it was displayed.


URL

The Uniform Resource Locator or URL for short, provides the means of finding your way around the Internet. It identifies the type of service you want to use, the site that you want to retrieve information from and the file, if the service involves one, that you want to access.

All World Wide Web page or image files are identified by the prefix http://. Following this, a Web page will have the name of the site where the information is to be found, then the (optional) path and file name of the file which corresponds to the page in question. Usually Web pages have the file extension .html.


 How to list all the Web pages in a dump

Click on the tool bar button [image] or select View, HTML from the menus to display the HTML (Web page) files.


 How to list all the image files in a dump

Click on the tool bar button [image] or select View, Images from the menus to display the image files.


 How to list all the files in a dump

Click on the tool bar button [image] or select View, All entries from the menus to display all the files in a dump.


Help, Context help

Pressing F1 or selecting Help, Context help in the menus will give you the possible courses of action when

you have no cache or dump files listed in the listbox

you have the list of files in the cache displayed

you have the list of files in a dump displayed


Help, Registration

Use the Product Registration dialog to register your evaluation copy of Secret Agent when you have received your registration details after sending an order and payment for obtaining a licence.

You must enter the details of your User name, Company name and Registration number exactly as you received them on your licence into the Product Registration dialog. Where you do not belong to a company, part of your address will be used for the registration details. Enter it exactly as it appears on the details you will receive.

For information on how to obtain a Secret Agent licence, please refer to the topic Registering Secret Agent.


Secret Agent's listbox
 Secret Agent's listboxes

Secret Agent displays a listbox when it has examined the cache and a further one if you have dumped the whole or a selected portion of the cache. The two listboxes are very similar in appearance; both may be sorted by URL or by access time. You may choose to display Web pages only (html files), image files (gif or jpg files), or all types of file in the listing. You may toggle between a dump listing and a cache listing if both are available. You may select one or more pages or image files from either list to display in your browser. If your browser is not already running then Secret Agent will start it for you, and cause it to display the selection you made. The first few entries of the Secret Agent listbox displayed when a dump of the cache has been made are special Web pages created by Secret Agent containing summaries of the Web pages and the image files found in the dump. These form the difference between a listbox showing the cache and a listbox showing a dump.

Below is a listing of part of the your browser cache showing some of the Web pages found there. The list had been sorted by access. The URL of each Web page extracted is shown, also its title.

Below is shown a list obtained from dumping the part of the your browser cache shown above. The first entry in the dump listing is a special page created by Secret Agent which contains a sorted list of all the Web pages in the dump. The second and third entries in the dump listing are also special pages created by Secret Agent and they summarise the image files of type gif which Secret Agent found in the dump. The fourth entry in the listbox is similar to the second, but for image files of type jpeg, another image format. For either jpeg or gif files, Secret Agent will create as many Web pages as necessary, storing 30 'thumbnails' per page.


How to view a summary of the image files in a complete or partial dump in Netscape
How to view a summary of the image files in a complete or partial dump in your browser

1.	Dump the cache or a selected portion of the cache. See How to dump the complete cache or How to dump selected files from the cache

2.	Select View, HTML files in the menus or [image] from the toolbar.

3.	Select one of the special Secret Agent pages from the dump listbox that begins either !!!This.Pc.GIFs.. or !!!This.Pc.JPEGs....

4.	Click on your browser toolbar button.

The selected summary page is then displayed which contains thumbnail size copies of the images of the particular type. Click on any thumbnail to display an image in the size it was in the Web page from which it came.


 Dump Index

Below is shown part of the special Web page, created by Secret Agent when the cache is dumped, as displayed by your browser. Clicking on a title in the left hand list displays the particular page. If links were followed in the on-line browser session when the page was cached, Secret Agent will colour any links that can be followed off-line.


Activate Netscape
Activate Browser

This option allows the user to disable activating your browser when View, Show or the tool bar button [image] or [image] is clicked to display files in your browser.

If the box is unchecked and your browser is running on the Windows desktop, then it will not be brought to the front of the desktop when the selected file(s) are displayed by clicking on View, Show or [image] or [image].


WINSOCK.DLL

A browser's default action when it loads, is to start your TCP/IP stack because it expects to be establishing links across the Internet. When Secret Agent needs to load your browser in order to display Web pages or images, it will, by default, load a dummy winsock.dll as the full dll is not needed.

If you wish to use Secret Agent to display a page from your browser cache or from a dump file and then to follow links from that page that you had previously not followed across the Internet on-line, then you need to change Secret Agent's default action  Either you must load your browser before Secret Agent, or you must stop Secret Agent from loading the dummy winsock.dll by disabling this check box.


Update history file

Check this box if you wish Secret Agent to identify the links that have been followed in the on-line session when displaying a page from a dump listing of the cache. In doing this, Secret Agent writes information in the browser history file - information which is removed when a dump is removed. If you do not wish Secret Agent to use the history file, then uncheck this box, but you must then appreciate that pages which Secret Agent displays from a dump of the cache will not have links coloured that were previously visited on-line.


URL conversion, Missing links

Convert to full URL
the full original Web page path is added to the image file name if it was not already present

Point to missing file
the URL is changed so that it points to a file with name missing.htm. When your browser is asked by Secret Agent to display a page containing a link to a missing page and you attempt to follow this link, it will display a page created by Secret Agent telling you that the link you requested is unavailable.

Leave unchanged
no conversion is done on the URL read from the cache

See also
full and relative URLs

examples of conversion usage


Home page default

If a URL in the cache has no file name following the site name and path, then it is assumed to be a home page and the file name is assumed to be index.html if the box is checked.


Full and relative URLs

A full URL of a Web page contains http:// followed by the Web server site name of the location where the Web page is stored, followed by the path to the Web page file, then the name of the file itself.

e.g. http://www.blogs.co.uk/company-info/contact.html  could be the URL of a Web page, contact.html in a directory company-info, on a Web server who site is identified by www blogs.co.uk.

A full URL to an image file will contain the same information but with the file name the name of the image file.

Relative URLs contain only part of the full URL information - usually only the file name if a link in a page is to a reference to be found at the same location. The most common instance of relative URL usage is for in-line images in a Web page.


Examples of conversion usage

You may wish to convert to full URL in order to load a page from a dump and launch into an on-line session with the ability to follow links not previously followed.

You may wish to convert to full URL so that going on-line will enable you to pull down images that are missing - either in-line images or images from links previously unfollowed.


Check for start page

By default Netscape makes the URL of Netscape's home page the location that will be first connected when Netscape starts. This start location is configurable within Netscape's menus. However, this can present Secret Agent with problems when it wishes to start Netscape to display a page from the cache or a dump. Checking this box will force Secret Agent to check for the existence of a configured start location - if present you will be warned and asked whether you wish Secret Agent to disable this feature of Netscape's. Doing so will allow Secret Agent to start Netscape without problem.

Internet Explorer always displays its configured start location when first started by Secret Agent, then the page that has been selected from a Secret Agent listbox. This action is not affected by the state of the Check for start page checkbox.


Dump file

When Secret Agent dumps your browser cache, it creates a file summarising the contents of the cache that have been included with this dump. This is the dump file which you name in the Save Dump As dialog when the whole cache or a selective dump from the cache is made. It is used by Secret Agent to generate the listbox contents when a dump is opened.and will be processed each time a request is made to Secret Agent for the display of anything from the current dump.


License Agreement
Licence Agreement

Copyright/Licence/Warranty

Copyright

Secret Agent Copyright © 1995 by Ariel Communications Limited.

All rights reserved.

Licence Agreement

You should carefully read the terms and conditions set out below before using the computer program called Secret Agent. Unless you have a different licence agreement signed by Ariel Communications Limited, then your use of Secret Agent indicates your acceptance of the licence agreement and warranty.

You may make copies of Secret Agent for distribution as evaluation shareware - the terms for doing this are set out in the Shareware Licence.

Registered Version

You may use each registered copy of Secret Agent at a single workstation only at any one time. If you need to use Secret Agent at more than one workstation concurrently, then you must purchase additional licences. You may make copies of the product for backup purposes only. You may not distribute copies of the registered software to others.

The licence is effective until terminated. You have the right to terminate it at any stage by destroying all software related to the product, and any backup copies which have been made.

Secret Agent is the property of Ariel Communications Limited and you are entitled to use it in accordance with the conditions set out in this agreement.

All rights not expressly granted in this licence agreement are reserved entirely to Ariel Communications Limited.

Governing Law

This agreement shall be governed by the laws of the United Kingdom of Great Britain and by International Copyright Law.

Disclaimer of Warranty

ARIEL COMMUNICATIONS MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS SOFTWARE, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. THIS SOFTWARE IS LICENSED 'AS IS', AND YOU THE LICENSEE, BY MAKING USE THEREOF, ARE ASSUMING THE ENTIRE RISK AS TO ITS QUALITY AND PERFORMANCE.

IN NO EVENT WILL ARIEL COMMUNICATIONS LIMITED BE LIABLE FOR DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THIS SOFTWARE.

ANY LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF THE PURCHASE PRICE.


Shareware License
Shareware Licence

Evaluation and Registration

The computer software called Secret Agent is not free software. You are hereby licensed to use the shareware evaluation version of Secret Agent for evaluation purposes only without charge for a period of 21 days. If you wish to use this software after the evaluation period has elapsed, then you are required to register it and pay the registration fee, as described in the Secret Agent order form.

Unregistered use of Secret Agent after the 21 day evaluation period is in violation of International Copyright laws.

Distribution of the Evaluation Version of Secret Agent

You are hereby licensed to make as many copies of the shareware evaluation version of Secret Agent as you wish; give exact copies of the original shareware version to anyone; and to 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 with other products (commercial or otherwise) without prior written permission.

Click here if you wish to register Secret Agent.


Secret Agent Registration Form

Fill in the details on the form below and when completed send or fax it, together with your payment, to

Nildram Software
23A High Street
Tring
Herts
HP23 5AH
United Kingdom

Tel:	+44 (0) 1442 891331 	Fax:	+44 (0) 1442 890303

BBS:	+44 (0) 1442 891109

e-mail:	sales@nildram.co.uk

When we have received your completed order form and payment, you will receive confirmation and your registration details by e-mail in 2 working days.

______________________________________________________________________________________

Name

Company

Address

Post/Zip Code

Country

e-mail address

_______________________________________________________________________________________

Payment method

The registration price is £24.95 (approx $39) including VAT. Please make cheques payable to Nildram Software.

Please charge my	Mastercard  [  ]	Visa  [  ]

Number

Expiry date

Name on card

Address on card (if different from delivery address)

Signature	Date


Supported platforms

Secret Agent 1.n can be used with Netscape 1.2 or Netscape 2.0.

Secret Agent 1.n can be used on Windows 3.1, 3.11 or Windows '95.

Secret Agent 1.n can be used with Internet Explorer 2.x on Windows 3.1 or 3.11


The developers of Secret Agent

Ariel Communications Ltd

Ariel House, 10a Frogmore Street, Tring, Hertfordshire HP23 5AU, United Kingdom

Telephone:	(44) 01442-828989

Fax:	(44) 01442-828947

e-mail	sagent@ariel.co.uk

Our World Wide Web home page is at http://www.ariel.co.uk


File, Save file as
File, Save file as	Right mouse button, Save As

Allows you to save selected file(s) and/or image(s) to a named file or named files using the Save f-name as dialog where f-name is the name of the file to be saved. If a selection of multiple files has been made, then the Save f-name as dialog is re-displayed for each file that was selected.


GIF image files

Secret Agent creates special Web pages summarising the image files it finds when it dumps the whole or part of the cache. The page below shows the image files, thumbnail size. Clicking on an individual item on this special page, will display the image in the size it was displayed in the Web page from which it came.


 Save f-name as

Use this dialog to select the name of the file that you wish to save the selected file to.

Click on the particular area for which you need help:


 Confirm

This dialog is displayed for you to confirm that the currently open browser cache should be removed.


 Confirm, Remove select

This dialog is displayed for you to confirm that selected entries in your browser cache should be deleted.


Edit, Copy Url
Edit, Copy Url	Hotkey Ctl+C	Right mouse button, Copy Url

Allows you to copy the URL(s) of selected item(s) in the dump or cache listbox to the clipboard.


View. Revisit
View, Revisit	Right mouse button, Revisit

Allows you to revisit the selected entry from dump or cache listing on-line. For this to be possible you must either have loaded your browser before starting Secret Agent or have un-checked the box Use dummy winsock in the Browser tab of the Settings, Options dialog before loading your browser.


Settings. Options, Select
 Settings, Options, Select

Click on the particular area for which you need help, the browser tab for help on the browser options, the Misc tab for the Misc help dialog or the Conversion tab for help on conversion options


 The Secret Agent Pop-up menu

Clicking the right mouse button will display Secret Agent's pop-up menu, which is shown below.

Click on the particular menu item for which you need help:


File, Add bookmark
File, Add bookmark	Right mouse button, Add bookmark

Allows you to add the selected page or pages to the list of bookmarks for your browser. If your browser is running when you you use this facility, then you will be asked to confirm that Secret Agent can close it, since the bookmark file can only be updated by Secret Agent when the browser is not running.


How to remove the currently open Netscape cache
 How to remove the currently open cache

1. 	Display your browser cache.

2.	Select File, Remove in the menus or use the hotkey Del to remove the items. You will be asked to confirm or cancel the action through the Confirm dialog.


 How to save a selected (or a selection of) file or image

1.	    Select the file or files (or image or image files) that  you wish to save from either a cache or dump listing of image files.

2.	    Either select File, Save as in the menus or click on the right mouse button and select Save As. Save the file using the Save f-name as dialog where f-name is the name of the file to be saved. If a selection of multiple files has been made, then the Save f-name as dialog is re-displayed for each file that was selected.


 How to copy the URL (or a selection of) of a page or image to the clipboard

1.	  Display the listing of files or in the cache or in a dump as appropriate. (Click on the tool bar button [image] or select View, Images in the menus if the image file list is needed).

2.	  Select the item(s) in the list for which the URL(s) are to be copied to the clipboard.

3.	  Either
Select Edit, Copy URL in the menus
or
use the hotkey Ctl+C
or
Click the right mouse button and select Copy URL
and the URLs of the selected item(s) will  be copied to the clipboard.


 How to revisit on-line a selected page or image

For this to be possible you must either have loaded your browser before starting Secret Agent or have un-checked the box Use dummy winsock in the Browser tab of the Settings, Options dialog before loading the browser.

Having selected an entry from the dump or cache listing, select View, Revisit in the menus or click on the right mouse button and select Revisit to revisit the entry on-line.


 How to toggle between a cache file list and a dump file list

To display the cache file list either select View, Cache in the menus or click on the [image] button in the tool bar.

to display a dump file list of a dump that is already open, either select View, Dump in the menus or click on the [image] in the tool bar.


 How to search for a specified string in the listing of the dump or cache displayed

Select the cache file listing as appropriate for your search.

Select Search, Find in the menus or use the hotkey Ctl+F to display the Find dialog.

Enter the string you wish to search for in the Find What edit box of the dialog.

Click the Find Next button of the Find dialog to find the first instance of the string which will then be highlighted in the file list. Further instances of the same string may be found by clicking on the Search menu, Find Next menu item or the F3 hotkey.


Java scripts option

Check this box if you wish Secret Agent to skip Java scripts when processing your browser cache.

(Java scripts are not supported by versions of Netscape below Netscape 2.0).


Select browser

If you have both Netscape and Internet Explorer loaded on your system, then Secret Agent detects this situation. Select the browser you want to use, and Secret Agent will set the default paths for this browser.


Search, Locate

Allows you to search all the web documents in the currently displayed cache or dump listbox for specified text. Clicking on this menu item displays the Search dialog, pictured below where you enter the text you wish to search for.

Selecting the And option means that a search will only be deemed to be successful if a web page contains all the words specified.

Selecting the Or option means that a search will be deemed to be successful if a document contains one of the search words specified.