***********************************************************
Linux Napster Client, instructions for Windows distribution
***********************************************************

Nap was written by Kevin Sullivan, and modified by Peter Selinger and
others. See COPYRIGHT, ChangeLog, and AUTHORS.


This file contains instructions specific to the Windows distribution
of nap. Please see README for general information on usage etc.


INSTALLATION for Windows 95/98/2000/NT:

(1) Download the file nap-XXX.cygwin-i386.zip, and unpack it. The
    Windows distribution includes two executable files "nap.exe" and
    "napping.exe", the DLL (dynamically linked library) "cygwin1.dll",
    and the terminal description file "cygwin" in a subdirectory
    called "c".

(2) You need to put the executables and the DLL in a place where
    Windows can find them. One way to do this is to run nap from within
    the directory where these files are. Another way is to copy all
    three files to a location (such as C:\WINDOWS) where Windows looks
    for DLLs and executable files. A third way is to amend your PATH
    environment variable, by adding something like the following line
    to C:\AUTOEXEC.BAT:

	PATH=%PATH%;C:\DIRECTORY\WHERE\FILES\ARE

    If you already have a different version of cygwin installed, you
    cannot use this binary unless you up/downgrade to the version of
    cygwin that comes with the nap distribution. However, there should
    be no problem re-compiling nap under your version of cygwin.

(3) Unless you already have Cygwin installed, you may also need to set
    up the terminal description. Again, there are several ways to do
    this.  If you run nap.exe from within the directory of the nap
    distribution (the directory that you unpacked in step (1)), then you
    may not have to do anything. Otherwise, copy the file "c\cygwin"
    to the following location. You may have to create the directory if
    it does not already exist:

	mkdir C:\cygwin\usr\share\terminfo\c
	copy c\cygwin C:\cygwin\usr\share\terminfo\c 


RUNNING:

Nap on Windows runs exactly the same way as under Linux and other
Unix-like operating systems, due to the amazing magic of cygwin
(http://sources.redhat.com/cygwin/), which simulates a unix
environment under Windows. However, there are two caveats:

* Performance: the ncurses implementation under cygwin appears to be
  very inefficient, resulting in a relatively slow screen update.
  Thus, characters will appear much more slowly on the screen than
  under Linux and friends.

* Location of config files: under Linux & co., nap puts its
  configuration files in a directory called .nap in the user's home
  directory. Under Windows, there is no such thing as a user's home
  directory, and nap will by default look for the .nap directory in
  the *current working directory*. You can change this behavior by
  defining an environment variable HOME. I do this by something like
  the line

        set HOME=C:\SOME\DIRECTORY

  in my C:\AUTOEXEC.BAT. This will cause nap to look for (and create) its
  configuration files in the directory C:\SOME\DIRECTORY\.nap.
  It is also possible to set the HOME variable directly from the DOS
  prompt, rather than in C:\AUTOEXEC.BAT. In this case, you don't have
  to reboot, but the setting will not be permanent. 

TROUBLE SHOOTING:

* If you get this error: "This application has failed to start because
  cygwin1.dll was not found. Re-installing the application may fix this
  problem":

  Go back to step (2) under INSTALLATION above.

* If you get this error: "Error opening terminal":

  Go back to step (3) under INSTALLATION above.


For usage and other non-Windows specific information, see README.
