From nobody@FreeBSD.org  Sun May  9 11:53:01 2004
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 60A2716A4CE
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  9 May 2004 11:53:01 -0700 (PDT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 4C1A643D1F
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  9 May 2004 11:53:00 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.12.11/8.12.11) with ESMTP id i49Ir0cm076989
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 9 May 2004 11:53:00 -0700 (PDT)
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.11/8.12.11/Submit) id i49IqxWa076988;
	Sun, 9 May 2004 11:53:00 -0700 (PDT)
	(envelope-from nobody)
Message-Id: <200405091853.i49IqxWa076988@www.freebsd.org>
Date: Sun, 9 May 2004 11:53:00 -0700 (PDT)
From: platanthera <platanthera@web.de>
To: freebsd-gnats-submit@FreeBSD.org
Subject: handbook update (desktop section): web browser plug-ins
X-Send-Pr-Version: www-2.3

>Number:         66426
>Category:       docs
>Synopsis:       handbook update (desktop section): web browser plug-ins
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pav
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun May 09 12:00:37 PDT 2004
>Closed-Date:    Fri Aug 19 11:56:29 GMT 2005
>Last-Modified:  Fri Aug 19 11:56:29 GMT 2005
>Originator:     platanthera
>Release:        FreeBSD 5.2.1-RELEASE-p5 i386
>Organization:
>Environment:
FreeBSD liza.hacienda.herti 5.2.1-RELEASE-p5 FreeBSD 5.2.1-RELEASE-p5 #1: Tue May  4 19:27:22 CEST 2004     root@liza.hacienda.herti:/usr/obj/share/FreeBSD/src/sys/LIZA  i386
>Description:
      suggestion to add 2 subsections to handbook section 15.2 (web browsers) concerning
- Flash6 for Konqueror and Mozilla via www/linuxpluginwrapper
- additional plug-ins for Mozilla via www/plugger
>How-To-Repeat:
      n/a
>Fix:
      patch for doc/books/handbook/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml

--- chapter.sgml.old	Thu May  6 18:05:36 2004
+++ chapter.sgml	Sun May  9 19:53:25 2004
@@ -292,7 +292,136 @@
 	<application>&shockwave; &flash;</application> should both be listed.</para>
     
     </sect2>
+    
+    
+    <sect2 id="flash6">
+    
+      <title>Linuxpluginwrapper enables &flash;6 support for Konqueror and Mozilla
+      </title>
+           
+      <para>As an alternative to the <filename role="package">www/flashpluginwrapper</filename> 
+	port which installs the Linux &flash;5 plug-in as dependency, you may 
+	install <filename role="package">www/linuxpluginwrapper</filename> which 
+	depends on <filename role="package">www/linux-flashplugin6</filename> and 
+        <filename role="package">print/acroread</filename>.
+      </para>
+      
+      <note>
+	<para>You need to be running either FreeBSD 5.1 or newer, or 4-STABLE from 
+	February 5th 2004 or later (including 4.10 and eventually following releases).
+	</para>
+      </note>
+      
+      <note>
+        <para><application>Linuxpluginwrapper</application> requires Linux compatibility 
+	to be enabled.
+	</para>
+      </note>
+      
+      <note>
+        <para>You cannot have installed <filename role="package">www/flashpluginwrapper</filename> 
+	  and <filename role="package">www/linuxpluginwrapper</filename> 
+	  at the same time. <application>Mozilla</application> users who had previously 
+	  installed <filename role="package">www/flashpluginwrapper</filename> need to 
+	  remove
+        </para>
+      
+        <programlisting>LD_PRELOAD=/usr/local/lib/libflashplayer.so.1
+export LD_PRELOAD</programlisting>
+      
+        <para>from their browser startup scripts.
+	</para>
+      </note>
+      
+      <para>After having installed the <filename role="package">www/linuxpluginwrapper</filename> 
+	port you need to set up 
+	<citerefentry><refentrytitle>libmap.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>. 
+	The required configuration depends on whether you are running FreeBSD 4.x or 5.x.
+      </para>
+	
+      <para>To enable &flash;6 for <application>Konqueror</application> and for 
+	<application>Mozilla</application> and other gecko based web browsers 
+	on a 5.x system, <filename>/etc/libmap.conf</filename> should include 
+	the following lines
+      </para>
+	
+      <programlisting># Flash6 with Konqueror
+[/opt/mozilla/plugins/libflashplayer.so]
+libpthread.so.0                 pluginwrapper/flash6.so
+libdl.so.2                      pluginwrapper/flash6.so
+libz.so.1                       libz.so.2
+libstdc++-libc6.2-2.so.3        libstdc++.so.4
+libm.so.6                       libm.so.2
+libc.so.6                       pluginwrapper/flash6.so
 
+# Flash6 with Mozilla/Firebird/Galeon/Epiphany
+[/usr/local/lib/linux-flashplugin6/libflashplayer.so]
+libpthread.so.0                 pluginwrapper/flash6.so
+libdl.so.2                      pluginwrapper/flash6.so
+libz.so.1                       libz.so.2
+libstdc++-libc6.2-2.so.3        libstdc++.so.4
+libm.so.6                       libm.so.2
+libc.so.6                       pluginwrapper/flash6.so</programlisting>
+
+      <para>To create a sample configuration which you can adjust using a text editor of your 
+        choice you can do
+      </para>
+      
+      <screen>&prompt.root; <userinput>cd /var/db/pkg  && pkg_info -D linuxpluginwrapper* > /etc/libmap.conf</userinput>
+      </screen>
+      
+      <para><application>Konqueror</application> expects plug-ins to reside in 
+        <filename>/opt/mozilla/plugins/</filename> by default. You can either copy 
+	<filename>libflashplayer.so</filename> and <filename>flashplayer.xpt</filename>
+	from <filename>/usr/local/lib/linux-flashplugin6/</filename> to <filename>
+	/opt/mozilla/plugins/</filename> or you may configure <application>Konqueror
+	</application> to look for plug-ins in <filename>/usr/local/lib/linux-flashplugin6/
+	</filename> and adjust <filename>/etc/libmap.conf</filename> accordingly.
+      </para>
+      
+      <para>
+	Have a look at the <ulink url="http://freebsd.kde.org/howtos/konqueror-flash.php">Konqueror & Flash HowTo</ulink>
+	at <ulink url="http://freebsd.kde.org/">freebsd.kde.org</ulink>
+      </para>
+       
+    </sect2>
+      
+        
+    <sect2 id="plugger">
+      
+      <title>Plugger enables additional plug-ins for Mozilla</title>
+      
+      <para>The <filename role="package">www/plugger</filename> port provides 
+	a multimedia plug-in for <application>Mozilla</application> that handles 
+	various audio, video and document formats. <citerefentry><refentrytitle>
+	plugger</refentrytitle><manvolnum>7</manvolnum></citerefentry> is a small 
+	plug-in, which uses external programs to show or play the different formats.
+      </para>
+      
+      <para>
+        For instance, you may choose to install the 
+	<filename role="package">www/mplayer-plugin</filename> port to play various 
+	audio and video formats. By default, this port uses <filename role="package">www/mozilla</filename> 
+	for gecko support. You can change this by defining <makevar>WITH_MOZILLA</makevar> 
+	as <quote>firefox</quote>, <quote>mozilla-devel</quote>, 
+	<quote>mozilla-gtk1</quote> or <quote> mozilla-devel-gtk1</quote> at build time. 
+	<filename role="package">www/mplayer-plugin</filename> depends on 
+	<filename role="package">multimedia/mplayer</filename> which gets installed 
+	automatically if necessary. If you decide to build and install it separately, 
+	you can make use of its build options. Have a look at <xref linkend="video-mplayer"> 
+	and <filename>/usr/ports/multimedia/mplayer/Makefile</filename>.
+      </para>
+	
+      <para>
+	Check the <ulink url="http://fredrik.hubbe.net/plugger.html">Plugger homepage</ulink> 
+	for a detailed list of supported file formats and the required
+	helper applications. Additionally, there are testing grounds to see your 
+	new plug-ins in action.
+      </para>	
+	      
+    </sect2>
+
+    
     <sect2>
       <title>&netscape;</title>
       <indexterm>
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: pav 
State-Changed-When: Fri Aug 19 11:54:36 GMT 2005 
State-Changed-Why:  
I replaced existing chapter about jdk13 and flash5 plugins with a brand new 
chapters about jdk15 and linuxflashplugin. I kept the text more terse than yours, 
it's a bad idea to put libmap.conf examples into Handbook IMHO, as they tend 
to change in time, and the port have an always fresh examples anyway. 

I don't feel plugger is significant enough to be mentioned in the Handbook, 
absolutely not in the extend you provided. I think that people who need 
this kind of plugin are able to find it on Freshports or elsewhere... 


Responsible-Changed-From-To: freebsd-doc->pav 
Responsible-Changed-By: pav 
Responsible-Changed-When: Fri Aug 19 11:54:36 GMT 2005 
Responsible-Changed-Why:  
Take followups. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=66426 
>Unformatted:
