INSTALL: libcisco 1.3
August 7, 2002

Copyright (C) June 2002 Andy Ziegelbein
All rights reserved
-------------------

Automated Installation
======================

1.  Run the "install.tcl" file included in the root directory of this
    distribution.

2.  Follow the directions.

Manual Installation
===================

1.  Create a "libcisco1.3" directory in one of the directories in the Tcl
    library search path.  This is typically /usr/local/lib, /usr/lib, or
    /usr/lib/tcl8.3.  You can determine the path by executing "puts $auto_path"
    from an interactive Tcl shell.  See the following example:

    $ tclsh
    % puts $auto_path
    /usr/lib/tcl8.3 /usr/lib /usr/local/lib
    %

    Note: Multiple versions of libcisco CAN coexist on the same system.  By
          default, Tcl will load the latest installed version if the package
          is loaded with a "package require libcisco" statement.  If you have
          multiple versions installed (e.g. 1.0 and 1.1) and you require a
          specific version of the package, you may load the specific version
          with the following command: "package require -exact libcisco 1.0".

2.  Copy the entire contents of the "lib" directory from this distribution
    into the newly created directory.

3.  (Optional) Copy the NROFF man pages (*.n) to an appropriate directory
    where they may be located by the man utility.  You may also need to copy
    the "man.macros" file into a directory searched by the man utility
    (e.g. /usr/local/man, /usr/man).  Copy the HTML (*.html) files from the
    "doc" directory into a web server accessible directory.

4.  (Optional) Verify the installation by launching an interactive Tcl
    interpreter and attempt to load the package.  If the library has been
    successfully installed, the version number should be returned.

    $ tclsh
    % package require libcisco
    1.3
    %

