++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

	WIN32 gecko-sharp (and gtkembedmoz.dll)

	Copyright 2005(C) Zac Bowling - 
	
	QUESTIONS/COMMENTS:
	- zac@zacbowling.com 
	- http://zacbowling.com
	
	INCLUDED CODE RELEASED UNDER GPL, MPL or LGPL LICENCES.

	
Install Instructions:

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

STEP 1 -
	a.	(MOZILLA SUITE) If you have already installed Mozilla 1.7.x or 
		newer check to see if it installed the GRE into your
		"%Program Files%\Common Files\mozilla.org\GRE" folder. 
		If it hasn't then goto step b.

	b.	(MOZILLA GRE INSTALL) Download the standalone mozilla GRE from 
		my site: 

 	* http://polystimulus.com/gtkembedmoz-sharp/MOZ-GRE-1.7.3.zip (4.9MB)
	
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

STEP 2 - 

Put the gtkembedmoz.dll in to you're shared GRE directory -
"%Program Files%\Common Files\mozilla.org\GRE\<Version Number\"

You have the option of putting the other gtkembedmoz.pdb (debug information) 
into that directory incase it crashes you can figure out what caused it. 

You can get the other two files gtkembedmoz.lib or gtkembedmoz.exp only if your
planing on developing C/C++ code and you know how to use them. Don't ask me
anything about these.

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

STEP 3 -
	a.	(GAC) From command line, run ether/both Mono's or .NET's gacutil
		on the gecko-sharp.dll file. 
			
			eg: `gacutil /i gecko-sharp.dll`

	b.	(Standalone) Copy the gecko-sharp.dll file to the application
		build directory you want to use with gecko-sharp. Reference as
		normal when you build.

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

STEP 4 - 

When your ready to run your app, make sure your gtk runtimes and your
mozilla GRE install directory in your PATH variable before running, and finally
run your app. 

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

STEP 5 (OPTIONAL)
 - Sample apps: 
	* 	TestGtkEmbed.exe 
			C app that uses GtkEmbedMoz.dll and GTK directly
	
	*	GtkMozApp.exe
			.NET/Mono testing app that calls gecko-sharp.dll 
			to test the gecko-sharp.dll functionaliy.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

TIPS: 

* If you get any errors about a missing HOME directory variable, set your HOME 
variable to by running `set HOME=%TEMP%` before launching.

* I used Mono-1.1.3 to build against. I also had the gtk-sharp-2.0 dlls added to
Microsoft.NET gac and my Mono gac.

* If you still have an issue with GTK, it may help to install the gtk runtimes I 
included. Don't forget to the add the install path to your PATH directive.

* Also try using the TestGtkEmbed.exe app. Since it doesn't use gecko-sharp it 
should help figure out where the problem might be comming from.

* If you still have issues, try running it with both Mono and the default 
.NET runtime and see what happens. I can use those dumps if you can email me.
If you can install a copy of Dr.Mingw and get the debug output from 
TestGtkEmbed.exe that would really help. (Dr.Mingw is in the MINGW-Utils package
http://prdownloads.sourceforge.net/mingw/mingw-utils-0.3.tar.gz?download )