================================================================
	MIDI Netscape plug-in for Linux/AWE32
	ver.0.4.1 beta2; Nov. 1, 1998
	Takashi Iwai <iwai@ww.uni-erlangen.de>
================================================================

* GENERAL NOTES

This is a plug-in for Netscape navigator to play MIDI files embedded
in web pages like Crescendo or Yamaha MIDI Plugin.
The ver.0.4.1 (beta) supports the control panel including "play",
"stop" and "pause" buttons.

The source package includes source files from Netscape Plugin
Developer Kit (3.0b5).


* REQUIREMENTS

- Netscape navigator ver.3 (or newer -- it may work)
- AWE32 driver & utils ver.0.4.1 or newer
- drvmidi program ver.0.4.1 or newer
- X11/Xt/Xaw library (for pluging with control panel)


* INSTALLATION FROM SOURCE PACKAGE

- Extract source package

- Edit Makefile

  + If you want a plug-in without graphical control panel, use
  Makefile.nopanel instead.  The contorl panel plug-in causes a bus
  error on some specific situations (see known bugs).  In such a case, 
  use no-panel plug-in.  Since the program names are different, you
  can install both plug-in programs on the same netscape directory.

  + PLUGIN_DIR is the directory the plug-in binary npmidi.so will be
  installed.

  + Turn on PLUGIN_DEBUG defintion if want to trace the log message from 
  MIDI plug-in.  The messaged is logged on /tmp/midiplg.log.

  + SHLIBDIR and EXTRA_LOAD_FLAGS are necessary for X11 library.  This 
  is derived from XFree86-3.3 configuration.  If you installed your
  X-Window system on some other directory, change these definitions.

- Run "make install"

- Choose an apropriate plug-in from general options menu.


* INSTALLATION FROM BINARY PACKAGE

- Copy npmidi.so to plug-in directory.
  The system plug-in directory is usually
	/usr/local/lib/netscape/plugins
  Or, users can have their own directory,
	~/.netscape/plugins

- npmidi-nopanel.so is a plug-in without control panel window.
  Copy this on the same directory, too.

- If you want to use the graphical control plug-in, it's better
  to preload the plug-in program before starting Netscape.
  See know bugs section for details.

- Choose an apropriate plug-in from general options menu.


* USING NETSCAPE

Start Netscape navigator, and check the helper list from General
Options in Options menu.  You'll see new items with audio/midi and
audio/x-midi.  If not, something wrong in installation.  Please check
that the plugins are copied properly.

If you use some proxy servers like Delegate, and you see messages like
"no plug-in for text/html mime type..", this is because of incorrect
ftp transfer via proxy server.  These servers change ftp connection to 
http connection with text/html header, so Netscape is confused.
In such a case, turn off proxy caching.


* KNOWN BUGS

- Netscape crashes (bus error) when trying to display a directory from
  the page with MIDI control panel.  It happen even when back to the
  previous page.

  ===>	This bug can be avoided by preloading the plug-in before
	Netscape.  To do this, set LD_PRELOAD variable, and start
	netscape binary.  It'll be easy making a wrapper script, or
	make an alias.
	For example,
	----------------
	#!/bin/sh
	LD_PRELOAD="$LD_PRELOAD:/usr/local/lib/netscape/plugins/npmidi.so"
	exec /usr/bin/X11/netscape
	----------------


* ACKNOWLEDGEMENTS

Thanks to Andree Borrman for fixing a couple of bugs.


* COPYRIGHT

Copyright (C) 1996-1998 Takashi Iwai

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


Takashi iwai	<iwai@ww.uni-erlangen.de>
