Copyright: P M Taylor and Starcourt Computers Ltd 1995,96


Contents
URL2Net 4.0

Welcome to URL2Net - the smart way to save Internet Shortcuts, Bookmarks and Hotlists

URL2Net is copyright 1995 - 1996 Peter Taylor and Starcourt Computers Limited, all rights reserved.

Use URL2Net to grab an Internet address, a World Wide Web page or an ftp site for example, from any document and automatically add it your Netscape bookmarks file or create an Internet Shortcut. URL2Net will also save the Internet address in a number of formats for use in other World Wide Web browsers and Internet tools.

Context sensitive help is available for most URL2Net features. Place the mouse pointer over the feature of interest and press F1.

Contents

How to use URL2Net

How to obtain Support

Licence and Registration

Warranty

All trademarks and copyright are acknowledged.


Example
URL2Net Example

Date: Sat, 6 Jan 96 14:43 GMT

From: pmtaylor@cix.compulink.co.uk (Peter Taylor)

Subject: URL2Net Home page

To: peter@starcourt.compulink.co.uk

Reply-To: pmtaylor@cix.compulink.co.uk

Just a reminder to visit the URL2Net home page at

http://www.compulink.co.uk/~starcourt/ for the latest

news about URL2Net.

A recently received e-mail message contains an important web address. To save this address follow these steps.

•	Highlight the text of the message, including the web address.

•	Use edit|copy to copy the selected, highlighted text to the windows clipboard.

•	Start URL2Net.

Notice that the URL is decoded, using IntelliParse, from the message text with the remainder forming the description.

•	Edit the description if required

•	Click on Save and the bookmark is added to your Netscape bookmark file.

•	The drop down Bookmark File list may be used to save the web address in a different format, as an Internet Shortcut for example


How to use URL2Net

URL2Net is designed to make the capture of Internet resource addresses, World Wide Web pages and ftp site for example, as simple as possible. Follow the example to see for yourself.

URL2Net features are described in the following help topics

Menu Items

Exit

Help

URL2Net tabs

Bookmark tab

File Tab

Folder Tab

Settings Tab

IntelliParse

Command Line Parameters

Supported World Wide Web browsers and Internet Tools

URL2Net is available in 16 and 32 bit versions. Use 16 bit URL2Net on Windows 3.1, Windows 3.11 and Windows for Workgroups systems. Use 32 bit URL2Net on Win 95 and Win NT3.51 systems.


Bookmarks
The Bookmark Tab

Use the Bookmark tab to edit and save bookmarks and to select the current Bookmark File and current Folder. The bookmark tab is normally displayed when URL2Net is started, with the Windows clipboard already decoded, using IntelliParse into URL and Description.

Bookmark File

Displays the current Bookmark File Use the down arrow to display the list of bookmark files and select a new current bookmark file.

Folder

Displays the current Folder Use the down arrow to display the list of folders in the current Bookmark File and select a new current Folder

URL

The URL of the new bookmark, decoded from the clipboard or entered manually, is displayed here.

A bookmark must have a URL before it can be saved.

Description

The descriptive portion of the new bookmark, decoded from the clipboard or entered manually, is displayed here.

If a description is not entered the URL is used as the description when the bookmark is saved.

The description is displayed by your Web Browser when viewing your bookmarks.

Save

The new bookmark is added to the current folder in the current bookmark file.

The URL is checked against a list of valid Resource Types maintained by URL2Net before the bookmark is saved.

The Check for Duplicate URL flag may cause a duplicate URL check to be performed before the bookmark is saved.

The URL and Description fields are cleared after the bookmark has been saved.

Clear

Clears the URL and Description fields

Reparse

Decodes the clipboard into the URL and Description fields

Input fields for ftp applications, WS_FTP for example, are described here


FTP Tools

WS_FTP and other FTP applications need a different set of inputs from web browsers. URL and Description are replaced by the following fields-

Profile Name

The descriptive name for the bookmark.

A profile name must be entered.

Host Name

The name of the ftp site.

A Host Name must be entered.

Remote Dir

The starting directory at the ftp site

Local Dir

The directory on your system which will receive files transferred from the ftp site.

Use the browse ... button to select this directory.

Host Name and Remote Dir are decoded from the URL portion of the Windows clipboard. The Profile Name is taken from the filename (if any) part of the URL plus the Description.


Resource Types

Each URL is checked against a list of valid Resource Types maintained by URL2Net. A message is displayed if the Resource Type of the URL is not recognised giving the option to add this new Resource Type to URL2Nets list before adding the bookmark, or to ignore the Resource Type list and add the bookmark

These Resource Type definitions are distributed with URL2Net

http

https

ftp

gopher

mailto

mid

cid

news

nntp

prospero

telnet

wais


Resource Prefix
Resource Prefixes

This table, contained in the Win 95/Windows NT registry or in the URL2Net initialisation file (URL2Net.ini), is used to support IntelliParse

The table contains a list of common URL prefixes and associated Resource Types. The following definitions are distributed with URL2Net.

www.	http://

ftp.	ftp://

gopher.	gopher://


IntelliParse

URL2Net features advanced algorithms used for decoding the Windows Clipboard or Command Line parameter into URL and Description.

The clipboard is searched using the tables of Resource Types and Resource Prefixes to identify the URL.

Often, the URL is incorrectly stated in the message being decoded. URL2Net will apply a set of rules to present a correctly formatted URL on the Bookmark Tab URLs that have been corrected in this way are highlighted in red on the Bookmark Tab.

These URL are all decoded by URL2Net

http://www.compulink.co.uk/~starcourt/

http//www.compulink.co.uk/~starcourt/

www.compulink.co.uk/~starcourt/

IntelliParse only operates when the clipboard is being decoded. You may edit the URL as required to cope with any peculiar addressing requirement.


Files
The File Tab

Use the File tab to add new Bookmark Files to URL2Net and to remove Bookmark Files you no longer use.

Bookmark File

Displays the current Bookmark File Use the down arrow to display the list of bookmark files and select a new current bookmark file.

Add File

Starts the Add File dialog allowing a bookmark file to be added to URL2Net.

Once added, the new bookmark file becomes the current Bookmark File.

Some bookmark formats allow an empty bookmark file to be created by URL2Net.

Bookmark Format

Select the format of a new bookmark file after clicking on Add File

Remove File

Removes the current Bookmark File from URL2Net.

The bookmark file is not deleted from your hard disk.


Folders
The Folder Tab

Use the Folder tab to add new folders and separators to the current Bookmark File

Bookmark File

Displays the current Bookmark File Use the down arrow to display the list of bookmark files and select a new current bookmark file.

Folder

Displays the current Folder Use the down arrow to display the list of folders in the current Bookmark File and select a new current Folder

Folder Description

Enter the description of the new folder

Add Folder

Adds a new folder to the end of the current Folder

A Folder Description must be entered.

Add Separator

Adds a separator line at the end of the current Folder


Settings
The Settings tab

URL2Nets range of configurable settings are altered here

Check for Duplicate URL

Setting this option causes URL2Net to check through the current Bookmark File before a new bookmark is saved to see if the URL of the new bookmark has already been added to the bookmark file. A message is displayed if a duplicate URL is found, giving the option to save the bookmark or to return to the Bookmark Tab without saving.

Reparse on Restore

Set this option to decode the Windows clipboard whenever URL2Net is restored to a normal sized window from a minimised Windows 3.1 Icon, or from a minimised Win 95 task bar entry.

This setting is ignored if the bookmark has been altered but not yet saved.

Minimize after Save

If this option is set URL2Net will be minimised to a Windows 3.1 Icon, or a Win 95 task bar entry, each time a bookmark is saved.


Supported Internet Tools
Supported WWW browsers and Internet tools

URL2Net supports a range of World Wide Web browsers and other Internet tools including, at time of writing (January 1996)

Netscape Navigator, version 1.1 onwards

Netscape Navigator Gold

Microsoft Internet Explorer

Microsoft Internet Explorer 16 bit

NCSA Mosaic

Netmanage WebSurfer

WS_FTP

Support for other Web browsers and Internet tools will be added to URL2Net from time to time.

Visit the URL2Net home page http://www.compulink.co.uk/~starcourt/ for very latest URL2Net news.

A number of URL2Net features are not available for some browsers or Internet tools because that feature is not supported by that application. For instance, WS_FTP does not support the concept of folders in its site list, so Add Folder button is not enabled for WS_FTP.


How to obtain Support

If you have any questions, comments or suggestions regarding the use, registration or distribution of URL2Net please contact the author, Peter Taylor, by e-mail at

pmtaylor@cix.compulink.co.uk

Please include URL2Net in the title of your e-mail message. If your message is concerns a problem using URL2Net please include full details of the nature of the problem, particularly the text of any message displayed by URL2Net or your operating system and the version of URL2Net which may be found by using the About menu entry.

You should normally receive a reply to your e-mail within 24 hours.

Support will be provided equally for both registered and unregistered users of URL2Net. However, the author reserves the right prioritise support responses and to discontinue support for unregistered users after the end of their evaluation period.

News about URL2Net, including the very latest version, may be obtained by visiting the URL2Net home page at http://www.compulink.co.uk/~starcourt/


Licence and Registration

Licence

Unregistered copies of URL2Net may be installed on any computer capable of running URL2Net for the purposes of evaluation URL2Net. This evaluation period must not exceed 30 days starting from the date URL2Net was installed on your computer. At the end of the evaluation period URL2Net must be removed from your computer unless you have registered URL2Net and obtained a registration number.

A Single User registration entitles you either to install URL2Net on a single computer, not on a network server, for use by all users of that single computer, or to install URL2Net on a number of computers, including a network server, for use by the registered user only. Put another way, a Single User registration entitles you to use URL2Net like a book. It may be used by a number of different users, but only by one user at a time.

A Site Licence registration entitles you to install URL2Net on any number of computers, up to the limit of your licence, for use by any user of those computers. If URL2Net is installed on a network server for use by any user  you must have site licence for all the workstations connected to that network from which URL2Net may be run.

Registration

Registering URL2Net brings 2 important benefits. Firstly registration removes the Unregistered URL2Net nag screen. Secondly, registration rewards the author and enables him to continue to develop URL2Net and other useful shareware programs. Please complete and mail the registration form REGISTER.TXT in your URL2Net installation directory.

Unregistered URL2Net is not crippled in any way, save for the Unregistered nag screen, so you are able to evaluate all the features of URL2Net. Please do not abuse this privilege by continuing to use URL2Net after the end of your evaluation period.

Copyright

URL2Net is owned by the author and Starcourt Computers Limited, who jointly retain the copyright to URL2Net. You may make copies of URL2Net for backup purposes.

You may make copies of URL2Net for distribution provided that this help file, including this notice, is included with any distribution. You may not make any charge for distributing URL2Net, save for a nominal charge for the media used for the distribution.


URL2Net Registration

~~~~~~~~~~~~~~~~~~~~

Please complete this order form and mail with full payment to

URL2Net Registration

Starcourt Computers Ltd

PO Box 3

ENFIELD

EN1 3DT

United Kingdom

Payment must be by cheque in Pounds Sterling drawn on a UK bank,

by international money order drawn in Pounds Sterling, or in

cash (notes only) in Pounds Sterling.

Orders received from outside the United Kingdom may be paid for

in cash (notes only) sent at the senders risk in US Dollars,

German Marks or French Francs. Cash payments should be for an

amount converted from the Sterling equivalent at the prevailing

tourist rate and may be rounded to eliminate cents, pfennigs,

centimes.

URL2Net Single User  ____    copies at £15 each = ______

URL2Net Site Licence

 2 to   5 computers: ____ computers at £10 each = ______

 6 to  14 computers: ____ computers at £7  each = ______

      15+ computers: ____           at £100     = ______

                         Total payment             ______

Price includes all taxes and all costs of returning your

registration details and purchase invoice.

Registered Name: ________________________________________

This name will be used to generate your registration number

Name:    ________________________________________________

Company: ________________________________________________

Address: ________________________________________________

         ________________________________________________

         ________________________________________________

         ________________________________________________

E-mail:  ________________________________________________

Registration details will be returned by e-mail if you

enter your e-mail address here.


Warranty

THE PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  IN NO EVENT WILL THE AUTHOR BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING INCIDENTAL OR CONSEQUENTIAL DAMAGES, ARISING OUT OF THE USE OF THE PROGRAM, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

YOU ACKNOWLEDGE THAT YOU HAVE READ THIS LICENCE, UNDERSTAND IT AND AGREE TO BE BOUND BY ITS TERMS AS THE COMPLETE AND EXCLUSIVE STATEMENT OF THE AGREEMENT BETWEEN US, SUPERSEDING ANY PROPOSAL OR PRIOR AGREEMENT, ORAL OR WRITTEN, AND ANY OTHER COMMUNICATIONS BETWEEN US RELATING TO THE SUBJECT MATTER OF THIS LICENCE.


Command Line Parameter
Command Line Parameters

If URL2Net is launched from the command line, a bookmark may be passed to URL2Net via a command line parameter. The command line parameter is decoded using IntelliParse and displayed on the Bookmark Tab

If no command line parameter is specified, the Windows clipboard is decoded using IntelliParse and displayed on the Bookmark Tab.


The tabs


The Bookmark Tab
Use the Bookmark tab to edit and save bookmarks.

The current Bookmark File and folder are selected here.


The Files Tab
Use the Files tab to maintain the list of Bookmark Files that URL2Net will work with.


The Settings Tab
URL2Nets range of configurable settings are altered using the Settings tab.


Folders Tab
Add new folders and separators to the bookmark file


Save Command Button
Save the bookmark to the current Bookmark File in the current Folder.


Clear Command Button
Clear the current bookmark from the URL and Description input boxes.


Reparse Command Button
Decode the content of the windows clipboard into the URL and Description boxes.


Add Folder Command Button
Add Folder

Adds a new folder to the current bookmark file. The new folder is added as a sub folder of the current folder.


Folder Description
Descriptive Name for the new folder


Add Seperator Command Button
Add Separator

Adds a new separator to the current folder.


URL Input
The bookmark URL, decoded from the clipboard, is displayed here. You may edit this URL before saving the bookmark.

URLs highlighted in red have been decoded by IntelliParse.

A URL must be entered before a bookmark can be saved.


Description Input
The bookmark Description, decoded from the clipboard, is displayed here. You may edit this description before saving the bookmark.


Add New Bookmark File
Displays the Select bookmark file dialog to add an existing bookmark file, of the selected in the format of the selected Internet tool, into URL2Net. If the select Internet tool supports multiple bookmark files the Select bookmark file dialog will allow an empty bookmark file to be created.


Bookmark Files
Shows the current Bookmark File. New bookmarks and folders will be written to this file. Use the down arrow to show the full list of bookmark files and select a different current Bookmark File.

New bookmark files can be added to URL2Net by selecting the File tab.


Bookmark Folders
New bookmarks will be written to this folder. Use the down arrow to display the full list of folders in the current bookmark file and select a different folder.

New folders can be added to the current Bookmark File by selecting the Folder tab.


Check for Duplicates
Setting Check for duplicate URL will give a warning message when saving a bookmark if the URL has already been saved in the current Bookmark File.


Reparse on Restore
Setting Reparse on Restore causes the windows clipboard to be decoded into the URL and Description boxes whenever URL2Net is restored to a normal window from a minimised icon on a windows 3.1 system or from the task bar on win 95. This feature does not operate if the current bookmark has been altered but not yet saved.


Minimise after Save
Setting Minimise after Save causes URL2Net to be minimised after a bookmark has been saved.


New Bookmark First
Setting New Bookmark First causes URL2Net to save the bookmark at the start of the current folder. New separators and folders are also added to the start of the current folder. This setting has no effect if the bookmark format does not support ordering of bookmarks.


Use IntelliParse
Setting Use IntelliParse adds extra intelligence to the clipboard decoding.


Exit After Save
Setting Exit after Save causes URL2Net to exit after a bookmark has been saved. This setting take precedence over the Minimise after Save setting.


Remove Bookmark File
Remove the current Bookmark File from URL2Net.

The Bookmark File is not deleted from your hard disk.


Current Bookmark File

The Bookmark File to which new bookmarks will be saved and new folders added


Current Folder

New bookmarks and separators will be added to this folder in the current Bookmark File.


URL - Uniform Address Location

The unique address of each resource , web page or ftp file for example, on the Internet.


 Exit

Exit from URL2Net.

A message is displayed if the current bookmark has been altered and not saved. This message gives the option of saving the bookmark, exit without saving, or cancelling and returning to URL2Net without exit.


About
About Menu

Displays URL2Net version number, contact  and registration details.


Help
Help Menu

About

Contents

Registration


Contents
Contents Menu

Displays this help file.


Registration
Registration Dialog

When you send in your URL2Net registration fee you will receive notification of your registered name and registration number. This will be sent to you by e-mail, if you specified an e-mail address when filling out the registration form, and by snail-mail with your purchase invoice.

Use the Help and Registration menu commands to display the Registration dialog.

Enter your Registered Name and Registration Number exactly as shown on your registration notification, including any punctuation, and click the Register button.

A thank you message will be displayed and your registration details recorded by URL2Net. Registration turns off the Unregistered URL2Net display and is valid for all future URL2Net versions.

If your registration details are not accepted by URL2Net, please check carefully that you have entered your Registered Name and Registration Number exactly as shown on your registration notification. Please contact the author if you have any problem entering your registration details.


Bookmark Formats
Shows the format of the current Bookmark File.

Select the format of a new bookmark file before using the Add button.


Netscape Bookmark File
Bookmark files supported by Netscape Navigator use this format.


WS_FTP Site List
WS_FTP Format contains ftp site information.


Mosaic Hotlist
Hotlist files supported by NCSA Mosaic use this format.


Microsoft Internet Explorer Internet Shortcuts
Microsoft Internet Explorer favourites are saved using this format.


Ncompas Hotlist
Ncompass Format


CuteFTP
CuteFTP format


Option_6 Format
Option 6 Format


Option_7 Format
Option 7 Format


Option_8 Format
Option 8 Format


Option_9 Format
Option 9 Format


A descriptive name must be entered before a new folder can be created.


The bookmark, URL or description, has been altered but not saved.

 Click Yes to save the bookmark before quitting URL2Net

Click No to quit without saving

Click Cancel to return to URL2Net


Netscape is running. A bookmark saved at this time will be overwritten when Netscape ends.


The bookmark file specified could not be opened. Check that the file and path exists and that the files attributes are not set to read only, hidden, or system


The bookmark file specified could not be found. Check the actual location for this file and use the File Tab to add the file and new location to URL2Net.

The old file will be automatically removed from URL2Net when URL2Net restarts.


The URL of the new bookmark has already been added to your bookmark file.


The new bookmark file cannot be created. Check that the path exists and is not write protected.


This bookmark file is already known to URL2Net


A bookmark file must be added before URL2Net can be used to save bookmarks.


The bookmark file cannot be found and will be removed from URL2Net


An Internet Explorer Shortcut description cannot contain any of these characters

\ / : * ? < > |

Amend the description before saving the shortcut.


Profile Name and Host Name must be entered for a WS_FTP entry


A URL must be entered before a bookmark can be saved.


The URL entered does not start with a recognised  Resource Type. Check that the URL is correct before continuing.


The unrecognised Resource Type can be added to URL2Nets list of valid resources.


The folder specified cannot be found. Check that the folder exists in the bookmark file before saving the bookmark.


Netscape Bookmark File In Use check

Netscape does not save changes to its bookmark file until the end of the Netscape session. URL2Net should not be used to save bookmarks to the Netscape Bookmark File whilst Netscape is running because these new bookmarks will be overwritten when Netscape terminates.

Before saving a bookmark to the current Netscape Bookmark File, URL2Net checks to see if Netscape is running and displays a warning message if Netscape is running.

This check correctly detects all current Netscape versions,  up to version 2.0b6 at time of writing. But, the warning message may also be triggered by several other programs, including Agent/Free Agent. If you are sure that Netscape is not running when the warning message is displayed the click the Save URL button to save the bookmark.