-------------------------------
Netscape Communicator 4.03 Fix!
Archived by Shawn De Cesari
Revision 2
-------------------------------

YOU MUST READ THIS FILE FIRST!!  FAILURE TO DO SO COULD RESULT IN DISASTER
FOR YOUR NETSCAPE SETUP!!

NOTE TO REDHAT 4.2 USERS: Your distribution already has the exact versions
of all the libraries here, except gnumalloc.so (so I've been told).  So,
after installation, you can delete everything in /usr/local/lib/netscape
except gnumalloc.so.

Also: You must be root to install this.  If you have no access to the root
account, then get your SysAdmin to install this.  It'll be the smartest
thing he's ever done!

1.1 - What the hell is this?
----------------------------
OK, basically, what you have just downloaded is Godsend for anyone using
the Linux 2.0 version of Netscape Communicator 4.03.  In Linux 2.0,
running Communicator on a daily basis, most users will notice random times
when Communicator halts with a bus error and other times when Communicator
just hangs for untold amounts of time.  The libraries contained herein fix
these problems once and for all.  If you view the release notes for
Communicator 4.03, it just says "Some versions may be incompatible" and to
go to SunSITE to find newer, more compatible versions.  Well, there's a
small problem.  The libraries listed in the release notes are older than
stone and were used in the Linux 1.2 version, not 2.0.  A couple of days
ago, I was looking at the release notes again and I saw something on the
release notes that said in bold "Linux 2.0.x only".  As I read, I noticed
something that said "If you're experiencing random system hangs, you may
have one or more incompatible shared libraries" and then it listed the
versions of the libs that were linked into the Linux 2.0 version (for
once)!!  So, I browsed the net until 5:30 in the morning looking for all
12 of the libs and I finally succeeded and now I have them available for
you.  The libraries contained herein are the EXACT libraries listed by
Netscape.  This should eliminate all bus errors and random system hangs
from Communicator.

1.2 - Alright, enough with the boring explanation!  Let's get this thing
      installed!!
------------------------------------------------------------------------
OK, well first of all, this works ONLY for the Linux 2.0 version of
Netscape Communicator 4.03 running on any Linux 2.0.x or 2.1.x kernel.
Keep in mind that this fix should work for both the Motif and non-Motif
version.  The Motif version has not been tested because I don't use the
Motif version.  However, if someone could test it for me, I'd be grateful.

I would recommend deleting your current Netscape directory
(e.g. /usr/local/netscape).  Don't panic and call me every stupid name in
the book.  I'm serious!  All your preferences are stored in your home
directory in $HOME/.netscape, so they will not be affected by this.
Delete your Netscape directory!!! If you insist on keeping your Netscape
directory, just make sure that your Netscape directory is /usr/local/netscape.
The Netscape binaries and components must be installed there in order for
this to work.  If you have Netscape installed in a different directory,
then change it to /usr/local/netscape.  If you refuse to move it, then
you'll have to modify the Runme script for whatever directory Netscape
might be in.  Then after running the Runme script, you'll have to modify
the script called "nets" that's thrown in your /usr/local/bin directory
(or nets-dynMotif if you use the Motif version).

Make sure that Communicator is installed in /usr/local/netscape
(Communicator MUST be installed in this directory in order for this fix 
to work right) (have I emphasized this enough?) and that there are NO
existing links (symbolic, scripts, or otherwise) to your Communicator
binary.  If there are, DELETE THEM!

Also, the included script (Runme) deletes Netscape's default plug-in out
of /usr/local/netscape/plugins because having it does more harm than good.
Basically, it can cause Communicator to crash for numerous reasons.  The
biggest one being that it doesn't do what it was supposed to do!!  It was
supposed to simply tell you that you have no plug-in and take you to the
plug-in page so you can get the plug-in.  Well, it does anything but that.
Say you go to www.testsite.net and the website calls for a plug-in to play
embeded MIDI.  Well, if you don't have a MIDI plug-in, bye bye
Communicator!!  If you delete the plug-in, then you'll just get a simple
message saying "No plug-in found for mime type audio/x-midi", and then
Communicator will continue to be on it's merry way, no crashes.

Next, make sure that you have no directory called /usr/local/lib/netscape.
If you do have it, then rename it to something else because this fix
requires its libraries to be installed in that directory.  Don't even
think about sharing the directory with old stuff and this new stuff,
because the symlinks will get all messed up and it'll create a huge mess.
So, make sure there is NO directory called /usr/local/lib/netscape.

Afterward, make sure that /usr/local/bin is in your path.  To check this,
logout of the root account and log in as yourself and type "echo $PATH"
and check for /usr/local/bin. If you don't see it, then (for BASH users)
put the following lines in your .profile file:

PATH=$PATH:/usr/local/bin
export PATH

OR, if you use a C-Shell, then add the following line to your .login file:

setenv PATH /usr/local/bin:$PATH

Save the file, exit and log in as root again.

Now, switch to the directory in which you unpacked ns403-fix.linux-2.0.tar.gz
and type Runme and when asked to continue, say yes.

The Runme script will move the new libraries to /usr/local/lib/netscape,
install the scripts and remove Netscape's default plug-in.  If you don't
want the plug-in deleted, then edit the Runme script and comment out the
line.

You're done!  If Communicator is installed in a different directory other
than /usr/local/netscape, then you'll have to modify the script called
"nets" in your /usr/local/bin directory accordingly.

Now, to run Communicator, type "nets" or if you want the dynamic Motif
version, type "nets-dynMotif".
