From 7f76a78118abe9e31da8393ab706bf7fc5b07210 Mon Sep 17 00:00:00 2001
From: Nathan Whitehorn <nwhitehorn@FreeBSD.org>
Date: Tue, 24 Jan 2012 23:43:40 +0000
Subject: [PATCH] Update to reflect "recent" changes, like the powerpc64 port,
 and remove a bunch of warnings that apply only to older versions of FreeBSD.
 Provide some guidance on when to install the 32-bit vs. 64-bit port now that
 there is a choice.

Approved by:	bcr
---
 en/platforms/ppc.sgml | 38 +++++++++++++++++++++++++-------------
 1 file changed, 25 insertions(+), 13 deletions(-)
diff --git a/en/platforms/ppc.sgml b/en/platforms/ppc.sgml
index 83bf471733..ae6b84c89c 100644
--- a/en/platforms/ppc.sgml
+++ b/en/platforms/ppc.sgml
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
 <!ENTITY base CDATA "..">
-<!ENTITY date "$FreeBSD: www/en/platforms/ppc.sgml,v 1.28 2011/08/17 08:53:52 ryusuke Exp $">
+<!ENTITY date "$FreeBSD: www/en/platforms/ppc.sgml,v 1.29 2011/09/05 19:11:14 gjb Exp $">
 <!ENTITY title "FreeBSD/ppc Project">
 <!ENTITY email 'freebsd-ppc'>
 <!ENTITY % navinclude.developers "INCLUDE">
@@ -41,8 +41,10 @@
   <h3><a name="news">Latest News</a></h3>
 
   <ul>
-    <li><strong>03 April, 2009</strong>: Support for the PowerPC G5
+    <li><strong>05 January, 2011</strong>: Support for the Sony Playstation 3
       has been committed to SVN.</li>
+    <li><strong>13 July, 2010</strong>: Support for the powerpc64 architecture
+      added.</li>
     <li><strong>03 March, 2008</strong>: Support for Freescale&reg;
       PowerQUICC III MPC85XX family system-on-chip development boards
       has been committed into CVS.</li>
@@ -57,16 +59,15 @@
   <ol>
     <li><a href="#1">How can I install FreeBSD/ppc</a></li>
     <li><a href="#3">How to use ports on FreeBSD/ppc?</a></li>
-    <li><a href="#4">Who should I contact?</a></li>
+    <li><a href="#4">Should I install powerpc or powerpc64?</a></li>
+    <li><a href="#5">Who should I contact?</a></li>
   </ol>
 
   <h4><a name="1">How can I install FreeBSD/ppc?</a></h4>
 
   <p>ISO images of FreeBSD &rel.current; suitable for New-World Macs are
     available for download, for details on how to obtain these see the
-    <a href="&base;/releases/&rel.current;R/announce.html">release announcement.</a>
-    Please follow instructions given
-    <a href="http://people.freebsd.org/~nwhitehorn/ppcinstall.txt">here</a>.</p>
+    <a href="&base;/releases/&rel.current;R/announce.html">release announcement.</a></p>
 
   <h4><a name="3">How to use ports on FreeBSD/ppc?</a></h4>
 
@@ -75,7 +76,20 @@
     <a href="&base;/doc/en_US.ISO8859-1/books/handbook/ports-using.html">use
     the Ports Collection</a>.</p>
 
-  <h4><a name="4">Who should I contact?</a></h4>
+  <h4><a name="4">Should I install powerpc or powerpc64?</a></h4>
+
+  <p>The powerpc64 port provides a 64-bit kernel and userland, and is supported
+    on all 64-bit CPUs. Users of 32-bit CPUs (G3, G4) must use the 32-bit
+    powerpc platform, users of 64-bit CPUs that support 32-bit operating
+    systems (G5) have a choice, and users of 64-bit CPUs that do not (Cell)
+    must use powerpc64. For those users with a choice, powerpc64 provides
+    some additional features (the ability to use more than 2 GB of RAM and
+    ZFS support) while having slightly worse ports support due to being
+    a newer and less common architecture. Like other 64-bit platforms,
+    FreeBSD/powerpc64 supports running 32-bit binaries as well as 64-bit ones.
+    </p>
+
+  <h4><a name="5">Who should I contact?</a></h4>
 
   <p><a href="mailto:grehan@FreeBSD.org">Peter Grehan</a> is the project
     leader.  Contact him if you can contribute code.  If you just want
@@ -87,9 +101,10 @@
 
   <h3><a name="hardware">Supported Hardware</a></h3>
 
-  <p>The FreeBSD/ppc port should run on any New-World machine (any Apple
-    machine with a built-in USB port).  People reported FreeBSD runs on
-    following machines:</p>
+  <p>The FreeBSD/ppc port should run on any New-World Apple machine (any Apple
+    machine with a built-in USB port), as well as the Sony Playstation 3. A
+    port to IBM pSeries hardware is in progress. People reported FreeBSD runs
+    on following machines:</p>
 
   <table class="tblbasic">
     <tr class="heading">
@@ -183,9 +198,6 @@
   <h3><a name="issues">Known Issues</a></h3>
 
   <ul>
-    <li>sysinstall cannot partition disks correctly &mdash; gpart must be used instead.</li>
-    <li>For ATI Radeon-based machines, a ofw syscons range check needs to be
-      relaxed using the sysctl hw.ofwfb.relax_mmap.</li>
     <li>There is a known bug in the boot-loader, that prevents you from
       loading an alternate kernel, so testing your kernel is a bit risky.
       When booting the loader from the Open Firmware prompt, give it a
