From nobody@FreeBSD.org  Sun Nov  9 01:19:31 2008
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 3A8B6106567B
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  9 Nov 2008 01:19:31 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 2A3AB8FC0C
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  9 Nov 2008 01:19:31 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id mA91JUPS009108
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 9 Nov 2008 01:19:30 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id mA91JU1B009107;
	Sun, 9 Nov 2008 01:19:30 GMT
	(envelope-from nobody)
Message-Id: <200811090119.mA91JU1B009107@www.freebsd.org>
Date: Sun, 9 Nov 2008 01:19:30 GMT
From: Eitan Adler <EitanAdlerList@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Re: [patch] for handbook browsers page
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         128711
>Category:       docs
>Synopsis:       Re: [patch] for handbook browsers page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    blackend
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Nov 09 01:20:03 UTC 2008
>Closed-Date:    Wed Aug 05 18:58:29 UTC 2009
>Last-Modified:  Wed Aug 05 18:58:29 UTC 2009
>Originator:     Eitan Adler
>Release:        N/A
>Organization:
>Environment:
N/A
>Description:
1) the list at the top of handbook/desktop-browsers.html is changed to a list of major browsers in the system
2) An Entry for dillo and links is added
4) some "ids" are added so that <xref> works properly
5) A note of support for linux flash9 on -STABLE is added
6) Made links to port pkg-descr
7) Some other minor changes that I don't remember

Patch attached.
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

--- chapter.sgml.orig	2008-10-25 13:16:32.000000000 -0400
+++ chapter.sgml.try.2	2008-11-05 20:44:02.000000000 -0500
@@ -118,13 +118,7 @@
       Please refer to <xref linkend="x11-wm"> for more information on
       how to set up these complete desktops.</para>
 
-    <para>If you are looking for light-weight browsers, you should
-      investigate the Ports Collection for
-      <filename role="package">www/dillo</filename>,
-      <filename role="package">www/links</filename>, or
-      <filename role="package">www/w3m</filename>.</para>
-
-    <para>This section covers these applications:</para>
+    <para>The following browsers can be found using the freeBSD ports system:</para>
 
     <informaltable frame="none" pgwide="1">
       <tgroup cols="4">
@@ -139,14 +133,14 @@
 
         <tbody>
           <row>
-            <entry><application>Mozilla</application></entry>
+            <entry><application><filename role="package">www/mozilla</filename></application></entry>
             <entry>heavy</entry>
             <entry>heavy</entry>
             <entry><application>Gtk+</application></entry>
           </row>
 
           <row>
-            <entry><application>Opera</application></entry>
+            <entry><application><filename role="package">www/opera</filename></application></entry>
             <entry>light</entry>
             <entry>light</entry>
 	    <entry>FreeBSD and Linux versions available.  The Linux
@@ -155,23 +149,50 @@
           </row>
 
           <row>
-            <entry><application>Firefox</application></entry>
+            <entry><application><filename role="package">www/firefox3</filename></application></entry>
             <entry>medium</entry>
             <entry>heavy</entry>
             <entry><application>Gtk+</application></entry>
           </row>
           
-	  <row>
-	    <entry><application>Konqueror</application></entry>
-	    <entry>medium</entry>
-	    <entry>heavy</entry>
-	    <entry><application>KDE</application> Libraries</entry>
+	    <row>
+	      <entry><application>konqueror</application></entry>
+	      <entry>medium</entry>
+	      <entry>heavy</entry>
+	      <entry><application>KDE</application> Libraries</entry>
           </row>
+
+	    <row>
+	      <entry><application><filename role="package">www/dillo</filename></application></entry>
+	      <entry>light</entry>
+	      <entry>light</entry>
+	      <entry><application>FLTK2</application> </entry>
+          </row>
+
+	    <row>
+	      <entry><application><filename role="package">www/lynx</filename></application></entry>
+	      <entry>light</entry>
+	      <entry>light</entry>
+	      <entry> - </entry>
+          </row>
+	    <row>
+	      <entry><application><filename role="package">www/links</filename></application></entry>
+	      <entry>light</entry>
+	      <entry>light</entry>
+	      <entry> - </entry>
+          </row>
+	    <row>
+	      <entry><application><filename role="package">www/w3m</filename></application></entry>
+	      <entry>light</entry>
+	      <entry>light</entry>
+	      <entry> ? </entry>
+          </row>
+
         </tbody>
       </tgroup>
     </informaltable>
 
-    <sect2>
+    <sect2 id="browser-mozilla">
       <title>Mozilla</title>
       <indexterm>
 	<primary><application>Mozilla</application></primary>
@@ -228,7 +249,7 @@
       <screen>&prompt.user; <userinput>mozilla -mail</userinput></screen>
     </sect2>
     
-    <sect2>
+    <sect2 id="browser-firefox">
       <title>Firefox</title>
       <indexterm>
 	<primary><application>Firefox</application></primary>
@@ -306,8 +327,27 @@
 	large port.</para>
 
       <para>The next step is to install the <filename
-	role="package">www/linux-flashplugin7</filename> port.  Once
-	this port is installed, the plugin must be installed by each
+	role="package">www/linux-flashplugin7</filename> port.</para>
+	<para>If you are running 7-STABLE or later then <filename role="package">www/linux-flashplugin9</filename> will also work. 
+	However you need certain prerequisites.</para>
+	<para>1) You need to be running -STABLE from at least Mon Oct 20 11:15:57 2008 UTC</para>
+	<para>2) You nead change to the 2.6.16 version of the linux kernel:</para>
+	<para><screen>&prompt.root <userinput>sysctl compat.linux.osrelease=2.6.16</userinput></screen>
+	Adding this line to sysctl.conf should also work.</para>
+	<para>3) Make sure linprocfs is mounted to /compat/linux/proc</para>
+	<para>4) Make sure www/nspluginwrapper, www/linux-flashplugin9 and dependencies are installed and up to date.
+	(the default emulators/linux_base-fc4 should work, if you want to use a later one don't forget to set
+	compat.linux.osrelease=2.6.16 in sysctl.conf and OVERRIDE_LINUX_BASE_PORT 
+	to whichever version you use in make.conf.  Note however that on 6, only the default compat.linux.osrelease=2.4.2 really works.)</para>
+	<para>
+	To run flash from native firefox you need <filename role="package">www/nspluginwrapper</filename>. 
+	If the plugin doesnt show up in firefox' about:plugins, run 
+	<screen>&prompt.user <userinput>nspluginwrapper -i /usr/local/lib/npapi/linux-flashplugin/libflashplayer.so</userinput></screen>
+	and restart firefox.
+	</para>
+
+	<para>
+	Once this port is installed, the plugin must be installed by each
 	user with <command>nspluginwrapper</command>:</para>
 
       <screen>&prompt.user; <userinput>nspluginwrapper -v -a -i</userinput></screen>
@@ -380,6 +420,28 @@
 	<application>Konqueror</application>
 	is available at <ulink url="http://freebsd.kde.org/howtos/konqueror-flash.php"></ulink>.</para>
     </sect2>
+    <sect2>
+      <title>Dillo</title>
+      <indexterm>
+        <primary>
+          <application>Dillo</application>
+        </primary>
+      </indexterm>
+	<para>
+		<application>Dillo</application> is a stand-alone lightweight web browser which is known for its fast speed and small size.
+	</para>
+      <para>To browse the Web with <application>Dillo</application>, install the package:</para>
+
+      <screen>&prompt.root; <userinput>pkg_add -r dillo</userinput></screen>
+
+      <para>Some FTP sites do not have all the packages, but  <application>Dillo</application> can still be obtained
+        through the Ports Collection by typing:</para>
+
+      <screen>&prompt.root; <userinput>cd /usr/ports/www/dillo</userinput>
+&prompt.root; <userinput>make install clean</userinput></screen>
+
+
+    </sect2>
   </sect1>
 
   <sect1 id="desktop-productivity">


>Release-Note:
>Audit-Trail:

From: Marc Fonvieille <blackend@FreeBSD.org>
To: Eitan Adler <EitanAdlerList@gmail.com>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/128711: Re: [patch] for handbook browsers page
Date: Sun, 9 Nov 2008 09:25:07 +0100

 On Sun, Nov 09, 2008 at 01:19:30AM +0000, Eitan Adler wrote:
 > 
 > >Number:         128711
 > >Category:       docs
 > >Synopsis:       Re: [patch] for handbook browsers page
 > >Confidential:   no
 > >Severity:       non-critical
 > >Priority:       low
 > >Responsible:    freebsd-doc
 > >State:          open
 > >Quarter:        
 > >Keywords:       
 > >Date-Required:
 > >Class:          doc-bug
 > >Submitter-Id:   current-users
 > >Arrival-Date:   Sun Nov 09 01:20:03 UTC 2008
 > >Closed-Date:
 > >Last-Modified:
 > >Originator:     Eitan Adler
 > >Release:        N/A
 > >Organization:
 > >Environment:
 > N/A
 > >Description:
 > 1) the list at the top of handbook/desktop-browsers.html is changed to a list of major browsers in the system
 
 The goal of this section is indeed talking about major browsers, the
 audience is the newcomer to FreeBSD.  Firefox (and Mozilla, well Mozilla
 part should be removed since Firefox is now preferred), Opera and
 Konqueror can be seen as major browsers since they can really render any
 site.  Dillo, links, lynx, w3m, etc. are light-weight browsers, they can't
 be seen as major browsers for obvious reasons...
 
 The current layout of the page is not bad and I don't see the need to
 add links, lynx, w3m to the table since we don't talk about them.
 I've no objection about adding something regarding Dillo, but we must be
 honest with the reader: Dillo cannot render correctly and be used on
 every websites around the world.
 
 > 2) An Entry for dillo and links is added
 > 4) some "ids" are added so that <xref> works properly
 > 5) A note of support for linux flash9 on -STABLE is added
 [...]
 
 This part is a bit "messy", it must be reworked and be sure it's working
 and stable.  I have to do some tests.
 
 -- 
 Marc
Responsible-Changed-From-To: freebsd-doc->blackend 
Responsible-Changed-By: blackend 
Responsible-Changed-When: Sun Nov 9 08:30:57 UTC 2008 
Responsible-Changed-Why:  
I'll work on an update of the browsers page. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=128711 
State-Changed-From-To: open->closed 
State-Changed-By: blackend 
State-Changed-When: Wed Aug 5 18:55:50 UTC 2009 
State-Changed-Why:  
This PR should have been closed since a while.  This section has been 
updated to match Flash 9 and Flash on both 7.X and 8.X branches, the 
rest was discussed in the audit-trail. 

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