-*-text-*-

Installing the MouseLess Commander
----------------------------------

Currently the MouseLess Commander has been tested under Sun Sparc
machines running SunOS 4.1, DECstations running Ultrix 4.2 and with
both Linux 1.0 and Linux 1.1.

You'll need GNU C (or an ANSI C Compiler) and the NCurses Library
version 1.8.5 or higher. For more information on obtaining these
programs refer to the end of the file.

Many Linux systems ship with version 1.8.0 or 1.8.1, the MouseLess
Commander may run with this version but some bugs in that ncurses
version sometimes makes the display look strange (not the intended
case).

So, if you have a time, give you a little present -we all know you
deserve it!- and install the latest NCurses library on your box.

Since version 0.9 the MouseLess Commander comes with mouse support. In
order to take advantage of the mouse support you will need the gpm
mouse server (see the section on Obtaining the Missing Pieces at the
end of this file).  Once you get the Mouse Server, compile it and
install it.

Once you grab all the components, edit the Makefile to suit your needs
or add the modification to a file called Make.local, all the changes
will replace the defaults in the Makefile.  The Make.local file is a
file that doesn't come with the distribution so you can save your
defaults in that file and copy them in future versions of the program
instead of editing each time the Makefile.

(if you have the GPM Mouse Server, you must enable the support in the
Makefile), and after you have done all this, type:

make clean; 
make depend; 
make

After some minutes of patient waiting you will have a good-looking
executable file in your home directory. Try the program, if you find
that the program is what you expected, then you may install the
program in your favorite net-stuff directory by typing:

make install

We are working on further enhancements to the program, but we're not
sure which ones must go first, if you would like to point us in the
Right Direction we will be glad to hear from you (you could check the
file TODO included with this distribution for the current projects).

If you happen to find an undocumented feature that doesn't do what
you expected, please drop us a note telling us as much as you can
about the problem you're experimenting.

One common problem is that NCurses 1.8.5 doesn't include an entry in
the terminfo database for the Insert character (this character is used
for marking files). In this case, you should edit the console
terminfo source file and include a line defining the insert character
escape sequence. On the Linux console, you should add this entry:

	kich1=\e[2~

After this, rerun the tic command for the edited console entry (it
should install a new console entry in /usr/lib/terminfo/c). This
problem is not present with the Slackware 2.0 Linux distribution.

In big endian machines like the Sun Sparc, version 1.8.5 of the
ncurses 1.8.5 package has a bug. I saw a patch in:
ftp.netcom.com:/pub/zmbenhal/ncurses/ncurses-1.8.5

If you are going to use it under Linux/386 or Ultrix you don't need
this patch.


Obtaining the missing pieces of the MouseLess Commander
-------------------------------------------------------

o The NCurses 1.8.5 library may be obtained from:

  ftp.netcom.com:/pub/zmbenhal. 

o The GPM Mouse Server is available at:

  iride.unipv.it:/pub/gpm


If you're using Linux version 1.1.34, then you will have to choose yes
to selection when you compile your kernel. If your Linux version is
previous to this, you may try to apply one of the patches included in
the gpm package.

And the GNU C Compiler may be obtained from the following sites:

        ASIA: ftp.cs.titech.ac.jp, utsun.s.u-tokyo.ac.jp:/ftpsync/prep,
  cair.kaist.ac.kr:/pub/gnu
        AUSTRALIA: archie.au:/gnu (archie.oz or archie.oz.au for ACSnet)
        AFRICA: ftp.sun.ac.za:/pub/gnu
        MIDDLE-EAST: ftp.technion.ac.il:/pub/unsupported/gnu
        EUROPE: irisa.irisa.fr:/pub/gnu, ftp.univ-lyon1.fr:pub/gnu,
  ftp.mcc.ac.uk, unix.hensa.ac.uk:/pub/uunet/systems/gnu,
  src.doc.ic.ac.uk:/gnu, ftp.win.tue.nl, ugle.unit.no, ftp.denet.dk,
  ftp.informatik.rwth-aachen.de:/pub/gnu, ftp.informatik.tu-muenchen.de,
  ftp.eunet.ch, nic.switch.ch:/mirror/gnu, nic.funet.fi:/pub/gnu,
  isy.liu.se,   ftp.stacken.kth.se, ftp.luth.se:/pub/unix/gnu, archive.eu.net
        CANADA: ftp.cs.ubc.ca:/mirror2/gnu
        USA: wuarchive.wustl.edu:/mirrors/gnu, labrea.stanford.edu,
  ftp.kpc.com:/pub/mirror/gnu, ftp.cs.widener.edu, uxc.cso.uiuc.edu,
  col.hp.com:/mirrors/gnu, ftp.cs.columbia.edu:/archives/gnu/prep,
  gatekeeper.dec.com:/pub/GNU, ftp.uu.net:/systems/gnu

