README for Narval version 1.1 on Windows systems

$Date: 2002/02/27 17:45:41 $ $Revision: 1.11 $

DOWNLOADING
-----------

To run Narval, you need the following packages on your machine:

 * python 2.1 available from http://www.python.org/2.1.1/. The good old
   Python interpreter. 
 * Narval itself, available from ftp://ftp.logilab.org/pub/narval/

INSTALLING NARVAL
-----------------

Run all the installers in the following order : 
 * python (if python is not installed on your system)
 * narval

Running the Narval installer will offer to install several other packages for
you. Unless you are sure that a compatible version of each of these packages is
already installed on your machine, it is strongly advised that you use the
'full' setup.

The Narval installer has been tested with Windows 98/2K. We are interested
in hearing from you about experience with that installer, so that we can
enhance the installation process.

LAUNCHING
---------

You can now use the shortcuts in the start menu to launch Horn or Narval.

USING
-----

0. Upgrading from 1.0.x or 1.1betaN
--------------------------------

If you already had Narval installed on your machine, you should either manually
upgrade your NARVAL_HOME directories, or erase them and let Narval upgrade it
for you. If you chose to erase the NARVAL_HOME directories, you should backup
any custom modules, recipes and transformations, as well as the memory.xml file
if you have edited it to include your data in it.

To manually upgrade, just copy the files from the NARVAL_SHARE directory to 
your NARVAL_HOME, and overwrite existing files. This will upgrade the Narval 
standard library files that are available locally in your NARVAL_HOME.

1. quick start
--------------

Launch Narval and Horn from the Startup menu. You will then be able to use the
"Narval -> Connect" menu from Horn to connect to Narval (using your hostname 
and 8787 as the port). Play with the menus if you want, but don't lose too 
much of your time and...

Read the tutorial at http://www.logilab.org/narval/doc.html that describes how
to download, set up and start an existing application available from
ftp://ftp.logilab.org/pub/narval/applications...  

But be aware that you most probably won't get away without reading the fine
manuals :-).

2. going further
----------------

Read the tutorial first (see http://www.logilab.org/narval/doc.html). Really.

It describes what you can do with Narval, and shows how to build a recipe and
lauch it from Horn, step by step. After that, reading the user manual will
provide useful information. Feel free to subscribe to our mailing lists
(http://www.logilab.org/narval/dev.html#ml) and questions there, we shall be
glad to answer them.


          Have Fun

          The Logilab Team
