1 files changed, 51 insertions, 17 deletions

diff --git a/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml b/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml
index 503f742bc1..f072fb99dc 100644
--- a/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml
@@ -247,23 +247,57 @@
 	exists.  This wrapper also supports &adobe; &acrobat; plugin,
 	&realplayer; plugin and more.</para>
 
-      <warning>
-	<para>The following text covers the installation of &flash;
-	  9.X on recent -STABLE branch, &os; 7.1-RELEASE and above.
-	  If you run an older version of &os; or encounter issues, you
-	  should install <filename
-	  role="package">www/linux-flashplugin7</filename> and skip
-	  the &man.linprocfs.5; part.</para>
-      </warning>
-
-      <para>Install the <filename role="package">www/nspluginwrapper</filename>
-	port.  This port requires
-	<filename role="package">emulators/linux_base-fc4</filename> which is a
-	large port.</para>
-
-      <para>The next step is to install the <filename
-	role="package">www/linux-flashplugin9</filename> port.  Once
-	this port is installed, the plugin must be installed by each
+      <para>According to the version of &os; you run various steps are
+	required:</para>
+
+      <procedure>
+	<step>
+	  <title>Under &os;&nbsp;7.X</title>
+
+	  <para>Install the <filename
+	    role="package">www/nspluginwrapper</filename> port.  This
+	    port requires <filename
+	    role="package">emulators/linux_base-fc4</filename> which
+	    is a large port.</para>
+
+	  <para>The next step is to install the <filename
+	    role="package">www/linux-flashplugin9</filename>
+	    port.  This will install &flash; 9.X, this version is
+	    known to run correctly under &os;&nbsp;7.X.</para>
+
+	  <note>
+	    <para>On &os; versions older than &os; 7.1-RELEASE you have
+	      to install <filename
+	      role="package">www/linux-flashplugin7</filename> and
+	      skip the &man.linprocfs.5; part below.</para>
+	  </note>
+	</step>
+
+	<step>
+	  <title>Under &os;&nbsp;8.X</title>
+
+	  <para>Install the <filename
+	    role="package">www/nspluginwrapper</filename> port.  This
+	    port requires <filename
+	    role="package">emulators/linux_base-f10</filename> which
+	    is a large port.</para>
+
+	  <para>The next step is to install the <filename
+	    role="package">www/linux-f10-flashplugin10</filename>
+	    port.  This will install &flash; 10.X, this version is
+	    known to run correctly under &os;&nbsp;8.X.</para>
+
+	  <para>This version will require the following link to be
+	    created:</para>
+
+      <screen>&prompt.root; <userinput>ln -s /usr/local/lib/npapi/linux-f10-flashplugin/libflashplayer.so \
+  /usr/local/lib/browser_plugins/</userinput></screen>
+	  </step>
+	</procedure>
+
+      <para>Once the right &flash; port, according to the &os; version
+	you run,
+	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>