cvs: peardoc /en/chapters/faq users.xml

saltybeagle		Sat Dec  1 16:22:40 2007 UTC

  Modified files:              
    /peardoc/en/chapters/faq	users.xml 
  Log:
  Bug #10333 - Does PEAR work on Mac OS X? Add an FAQ entry with details on the configuration and usage problems common for Mac OS X users.
  
http://cvs.php.net/viewvc.cgi/peardoc/en/chapters/faq/users.xml?r1=1.5&r2=1.6&diff_format=u
Index: peardoc/en/chapters/faq/users.xml
diff -u peardoc/en/chapters/faq/users.xml:1.5 peardoc/en/chapters/faq/users.xml:1.6
--- peardoc/en/chapters/faq/users.xml:1.5	Tue Mar 27 20:57:27 2007
+++ peardoc/en/chapters/faq/users.xml	Sat Dec  1 16:22:40 2007
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <sect1 id="faq.users">
  <title>User FAQ</title>
 
@@ -156,6 +156,59 @@
    </para>
  </sect2>
 
+ <sect2 id="faq.macosx">
+  <title>
+    Does PEAR work on Mac OS X?
+   </title>
+  <titleabbrev>
+    PEAR &amp; Max OS X
+   </titleabbrev>
+   <simpara>
+   answer by Brett Bieber
+  </simpara>
+  <para>
+   All Mac OS X versions up until 10.5 come with PEAR by default. Mac OS X 10.5
+   (Leopard) users will need to install PEAR using the standard installation
+   instructions.
+  </para>
+  <para> 
+   If you are a OS X 10.4 or lower user, you may wish to upgrade to a newer version
+   of PHP using a binary installable package such as Marc Liyanage's PHP packages.
+   If you have installed another PHP package, you may have two versions of PHP and
+   PEAR installed on your system. To be sure which version you are using, type
+	<command>which pear</command> in your console to find out where PEAR is 
+	located, and <command>pear -V</command> to find out some info about the pear
+	version, and also <command>pear config-show</command> to see the configuration 
+	details.
+	</para>
+	<para>
+	If you have not made any modifications to the default Max OS X install, the PEAR
+	version you	are running is the <filename>/usr/bin/pear</filename> which is
+	configured for the PHP 4 version distributed with OS X. If this is the case,
+	there are a couple options.
+	</para>
+	<para>
+	If you're using Marc Liyanage's PHP package, you might want to specify
+	<command>/usr/local/php5/bin/pear install {packagename}</command> (will probably
+	require sudo to install/upgrade packages), and always specify the full path when
+	you run pear &amp; php through the console.
+	</para>
+	<para>
+	Or you could change every path for the OS X provided PEAR using config-set,
+	or, what I do is <command>sudo rm /usr/bin/php /usr/bin/pear</command> and then
+	<command>sudo ln -s	/usr/local/php5/bin/php /usr/bin/php</command>
+	<command>sudo ln -s /usr/local/php5/bin/pear /usr/bin/pear</command> - which
+	will remove the PHP 4 version and link it to Marc Liyanage's PHP 5 version.
+	Keep in mind, Apple occasionally updates PHP on OSX, which will revert your
+	<filename>/usr/bin/php</filename> to their distributed version.
+   </para>
+  <simpara>
+    Note: It is uncertain if Apple will continue to distribute PHP version 4 for 
+    Mac OS X &lt;= 10.4. So these instructions may change, and may differ for your
+    specific version of Mac OS X. Always consult the Apple documentation to
+    understand the default install provided before making modifications.
+   </simpara>
+ </sect2>
 
  <sect2 id="faq.windows">
   <title>
@@ -208,7 +261,7 @@
     You are seeing the warnings because <literal>pear.php.net</literal> 
     uses a SSL key that is signed by <ulink url="&url.cacert;">CAcert</ulink>,
     whose root certificate is unfortunately not bundled with most 
-    browser.
+    browsers.
   </para>
   <para>
     If you are using a Mozilla browser, you can import the certificate