From 852fb39e4658e3860febe909ac8c395cc936fb9f Mon Sep 17 00:00:00 2001
From: Tom Rhodes <trhodes@FreeBSD.org>
Date: Mon, 30 Dec 2002 19:34:02 +0000
Subject: [PATCH] Current information on installing Mozilla is weak.  Add a
 section on setting up Mozilla with Java and Shockwave Flash.

---
 .../books/handbook/desktop/chapter.sgml       | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)

diff --git a/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml b/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml
index 66eb7f1124..17c9b7ff4f 100644
--- a/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml
@@ -215,6 +215,91 @@
 
       <screen>&prompt.user; <userinput>mozilla -mail</userinput></screen>
     </sect2>
+    
+    <!-- Added December 30 by Tom Rhodes -->
+    
+    <sect2 id="moz-java-flash">
+      <sect2info>
+	<authorgroup>
+	  <author>
+	    <firstname>Tom</firstname>
+	    <surname>Rhodes</surname>
+	    <contrib>Contributed by </contrib>
+	  </author>
+	</authorgroup>
+      <!-- 15 JUL 2002 -->
+    </sect2info>
+
+      <title>Mozilla, Java, and Shockwave Flash</title>
+      
+      <para>Installing <application>Mozilla</application> is simple, but
+	unfortunately installing <application>mozilla</application> with
+	support for things like <emphasis>java</emphasis> and
+	<emphasis>Shockwave Flash</emphasis> consumes both time and disk
+	space.</para>
+
+      <para>The first thing is to download the files which will be used
+	with <application>Mozilla</application>.  Take your current web
+	browser up to
+	<ulink url="http://www.sun.com/software/java2/download.html">
+	http://www.sun.com/software/java2/download.html</ulink> and
+	create an account on their website.  Remember to save the username
+	and password from here as it may be needed in the future.  Download
+	a copy of the j2sdk-1_3_1-src.tar.gz and place this in
+	<filename>/usr/ports/distfiles/</filename> as the port will not
+	fetch it manually.  This is due to license restrictions.  While
+	we are here, open the <quote>java environment</quote> from
+	<ulink url="http://java.sun.com/webapps/download/Display?BundleId=7163">
+	http://java.sun.com/webapps/download/Display?BundleId=7163</ulink>.
+	The filename is j2sdk-1_3_1_06-linux-i586.bin and is large (about 25
+	megabytes!  Like before, this file must be placed into
+	<filename>/usr/ports/distfiles/</filename>.  Finally download a copy
+	of the <quote>java patchkit</quote> from
+	<ulink url="http://www.eyesbeyond.com/freebsddom/java/">
+	http://www.eyesbeyond.com/freebsddom/java/</ulink> and place it
+	into <filename>/usr/ports/distfiles/</filename></para>
+      
+      <para>Install the <filename role="package">java/jdk13</filename> port
+	with the standard <maketarget>make install clean</maketarget> and
+	then install the <filename role="package">www/flashpluginwrapper</filename>
+	port.  This port requires
+	<filename role="package">emulators/linux_base</filename> which is a
+	large port.  True that other flash plugins exist, however they have
+	not worked for me.</para>
+      
+      <para>Now copy the flash plug-in files with:
+    
+      <screen>&prompt.root; <userinput>cp /usr/local/lib/flash/libflashplayer.so
+	/usr/X11R6/lib/mozilla/plugins/libflashplayer_linux.so</userinput></screen>
+
+      <screen>&prompt.root; <userinput>cp /usr/local/lib/flash/ShockwaveFlash.class
+	/usr/X11R6/lib/mozilla/plugins/</userinput></screen>
+
+      <note><para>If you are using
+	<filename role="package">www/mozilla-devel</filename>,
+	the destination directories will be different.</para></note>
+
+    <para>Now add the following lines to the top of (but right under
+      #!/bin/bash) <application>mozilla</application> startup script:
+      <filename>/usr/X11R6/bin/mozilla</filename>.</para>
+
+<programlisting>LD_PRELOAD=/usr/local/lib/libflashplayer.so.1
+export LD_PRELOAD</programlisting>
+
+      <para>This will enable the flash plug-in.</para>
+
+      <para>Install the <filename role="package">www/mozilla</filename> port,
+	if <application>mozilla</application> is already installed then just
+	start it with:</para>
+
+      <screen>&prompt.root; <userinput>mozilla &amp;</userinput></screen>
+
+      <para>And access the <quote>About Plugins</quote> option from the
+	<quote>Help</quote> menu.  A list should appear with all the currently
+	available plugins.  <application>java</application> and
+	<application>shockwave flash</application> should both be listed.</para>
+    
+    </sect2>
 
     <sect2>
       <title>Netscape</title>