ReadMe file for Fortel's VisualRoute(tm).
 
                 FreeBSD VERSION 5.0a

+--------------------------------------------------------------------+
|     PLEASE, read this file completely before proceeding, thanks.   |
+--------------------------------------------------------------------+

     ----- Program Requirements -----
1. FreeBSD kernel 3.4RELEASE or above (VisualRoute may work on earlier versions.
	3.4RELEASE were used for testing.)
2. Architecture - Intel architecture only.
3. X Windowing environment for output display.
4. www.freebsd.org/java Java Virtual Machine. (tested with 1.1.8)
5. TCP/IP Stack
6. Internet Connection

     ----- Items of note -----

VisualRoute will still work without the following applications; you will just
not get the functionality provided for the menu items referenced in each section. 

1.) The VisualRoute 'Help' menu item invokes a browser to access web pages.
Netscape Communicator is the default.  If you want another browser started, set
the environment variable VR_BROWSER to specify the browser to start.  You must
either specify the absolute path, or the browser must be on the path.  If you
do not have Netscape Communicator installed, and do not specify another browser
the web page accesses will not happen.  By default, the netscape-communicator
binary is assumed to be on the path.

To download Netscape Communicator (make sure to check on your FreeBSD 
	distribution first) reference:

	http: //www.netscape.com

and select the "Download" link at the top of the page.  Follow the instructions
presented.

2.) The VisualRoute 'Edit | Snap table as text...' menu item uses a text editor
to capture the generated report.  By default GNU Emacs is used.  If you want to
start another editor, set the environment variable VR_EDITOR or VR_EDITOR_EQ
(see below) to specify the editor to start.  The editor must be started in a new
window.  When the environment variable is set, the default editor is overridden,
and the specified editor is started with name of the file to edit, supplied by
VisualRoute, appended to the end of the string provided by the environment
variable.  If both VR_EDITOR and VR_EDITOR_EQ are set, VR_EDITOR_EQ is used.

	VR_EDITOR="xterm -e vim"; export VR_EDITOR

(This assumes the x-terminal and the vim binary files are on the path.)

3.) Right mouse clicks in the VisualRoute report 'Node Name' column access the
WHOIS server information (RFC954).  Informational items presented include an
e-mail address.  If the e-mail address is clicked, VisualRoute starts an e-mail
application.
	VR_EMAIL="xterm -e mutt"; export VR_EMAIL

If you want to start an e-mail interface, set the environment variable
VR_EMAIL or VR_EMAIL_EQ (EQ for "end quote") to specify the application to
start.   The specified email application must be started in a new window. 
Note that the recipient's name is appended to the string provided by 
the VR_EMAIL or VR_EMAIL_EQ environment variable.  

(This assumes that both the x-terminal and the mutt binary files are on
the path.)

     ---- Determining the Java Runtime Environment version ----
Enter the command 'java -version' or  'jre'.  The version number is displayed.
If java or jre is not on the path, you will need to specify the absolute path.


     ---- How to obtain the FreeBSD JDK Port ----
Reference:

     http ://www.freebsd.org/java/

to obtain the JDK port to FreeBSD.  Before downloading make sure to read 
the install instructions.

======================================================================
How is the FreeBSD version different from the Microsoft Windows(tm) version?

The FreeBSD version uses a different "ping" engine to elicit network responses.
It also brings up different applications for the'Edit | Snap table as text...',
the 'Help' menu items, and e-mail.

If web access (which can take several seconds to appear), the Edit menu item
operations, or e-mail access fails, it may be because the path to the
appropriate application is not in the PATH environment variable.  Specifically,
the path to 'netscape-communicator' for browser access, the path to 'emacs' for
the editor, and the path to 'mutt' for e-mail for the defaults.  Or, the path
to the application specified by VR_BROWSER, VR_BROWSER_EQ, VR_EDITOR,
VR_EDITOR_EQ, or VR_EMAIL, VR_EMAIL_EQ.


If you have used VisualRoute previously, the functionality should be the same.

======================================================================
What to note in this FreeBSD version:

(Please note the version of the OS you are running, and the distribution source.) 

1.) Did you have to do anything "special" to get VisualRoute to run.

2.) Did the editor come up for the "Edit | Snap table as text..."
option? (If not, what editor are you running?)

3.) Was the web accessed for Help menu item selection?

4.) If you have previously used VisualRoute did things "seem the same?"

5.) Any other comments on this version?
