From 24b21c6a57d0ea3814bc77bb79db9d6bca4647da Mon Sep 17 00:00:00 2001
From: Anil Madhavapeddy <avsm@php.net>
Date: Fri, 1 Nov 2002 18:31:14 +0000
Subject: [PATCH] update for openbsd 3.2 (released today).  i'll flesh it out
 some more as the FAQ's come in

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@102257 c90b9560-bf6c-de11-be94-00142212c4b1
---
 chapters/install.openbsd.xml | 85 ++++++++++++++++++++++++------------
 1 file changed, 57 insertions(+), 28 deletions(-)

diff --git a/chapters/install.openbsd.xml b/chapters/install.openbsd.xml
index cffbcf6a1c..4efd460f50 100644
--- a/chapters/install.openbsd.xml
+++ b/chapters/install.openbsd.xml
@@ -1,45 +1,74 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
 <sect1 id="install.openbsd">
  <title>Unix/OpenBSD installs</title>
  <para>
  This section contains notes and hints specific to installing
- PHP on <ulink url="&url.openbsd;">OpenBSD</ulink>.
+ PHP on <ulink url="&url.openbsd;">OpenBSD 3.2</ulink>.
  </para>
- <sect2 id="install.openbsd.ports">
-  <title>Using Ports</title>
+ <sect2 id="install.openbsd.packages">
+  <title>Using Binary Packages</title>
    <simpara>
-    This is the recommended method of installing PHP on OpenBSD, as it will have 
-    the latest patches and security fixes applied to it by the maintainers.  To
-    use this method, ensure that you have a <ulink url="&url.openbsd.ports;">
-    recent ports tree</ulink>.  Then simply find out which flavors you wish
-    to install, and issue the <command>make install</command> command.  Below
-    is an example of how to do this.
+    Using binary packages to install PHP on OpenBSD is the recommended
+    and simplest method.  The core package has been separated from the various
+    modules, and each can be installed and removed independently from the others.
+    The files you need can be found on your OpenBSD CD or on the FTP site.
+   </simpara>
+   <simpara>
+    The main package you need to install is <filename>php4-core-4.2.3.tgz</filename>,
+    which contains the basic engine (plus gettext and iconv).  Next, take a look
+    at the module packages, such as <filename>php4-mysql-4.2.3.tgz</filename>
+    or <filename>php4-imap-4.2.3.tgz</filename>.  You need to use the <command>phpxs</command>
+    command to activate and deactivate these modules in your <filename>php.ini</filename>
+    file.
    </simpara>
    <example id="install.openbsd.ports.example">
-    <title>OpenBSD Ports Install Example</title>
+    <title>OpenBSD Package Install Example</title>
     <programlisting>
 <![CDATA[
-$ cd /usr/ports/www/php4
-$ make show VARNAME=FLAVORS
- (choose which flavors you want from the list)
-$ env FLAVOR="imap gettext ldap mysql gd" make install
-$ /usr/local/sbin/php4-enable
+# pkg_add php4-core-4.2.3.tgz
+# /usr/local/sbin/phpxs -s
+# cp /usr/local/share/doc/php4/php.ini-recommended /var/www/conf/php.ini
+  (add in mysql)
+# pkg_add php4-mysql-4.2.3.tgz
+# /usr/local/sbin/phpxs -a mysql
+  (add in imap)
+# pkg_add php4-imap-4.2.3.tgz
+# /usr/local/sbin/phpxs -a imap
+  (remove mysql as a test)
+# pkg_delete php4-mysql-4.2.3
+# /usr/local/sbin/phpxs -r mysql
+  (install the PEAR libraries)
+# pkg_add php4-pear-4.2.3.tgz
 ]]>
     </programlisting>
    </example>
- </sect2>
- <sect2 id="install.openbsd.packages">
-  <title>Using Packages</title>
-  <simpara>
-   There are pre-compiled packages available for your release
-   of <ulink url="&url.openbsd;">OpenBSD</ulink>.  These integrate 
-   automatically with the version of Apache installed with the OS.
-   However, since there are a large number of options (called 
-   <emphasis>flavors</emphasis>) available for this port,
-   you may find it easier to compile it from source using the ports tree.
+   <simpara>
    Read the <ulink url="&url.openbsd.packages;">packages(7)</ulink>
-   manual page for more information in what packages are available.
+   manual page for more information about binary packages on OpenBSD.
+   </simpara>
+ </sect2>
+ <sect2 id="install.openbsd.ports">
+  <title>Using Ports</title>
+  <simpara>
+   You can also compile up PHP from source using the <ulink url="&url.openbsd.ports;">ports tree</ulink>.
+   However, this is only recommended for users familiar with OpenBSD.  The PHP4 port
+   is split into three sub-directories: core, extensions and pear.  The
+   extensions directory generates sub-packages for all of the supported
+   PHP modules.  If you find you do not want to create some of these modules,
+   use the <command>no_*</command> FLAVOR.  For example, to skip building
+   the imap module, set the FLAVOR to <command>no_imap</command>.
+  </simpara>
+ </sect2>
+ <sect2 id="install.openbsd.older">
+  <title>Older Releases</title>
+  <simpara>
+   Older releases of OpenBSD used the FLAVORS system to compile up
+   a statically linked PHP.  Since it is hard to generate binary packages using
+   this method, it is now deprecated.  You can still use the old stable
+   ports trees if you wish, but they are unsupported by the OpenBSD team.
+   If you have any comments about this, the current maintainer for the port
+   is <ulink url='mailto:avsm@openbsd.org'>Anil Madhavapeddy</ulink>.
   </simpara>
  </sect2>
 </sect1>
@@ -63,4 +92,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->