reviewing the installation documentation (we need help)

php.internals

Gabor Hojtsy

22 years ago
Hi there, We are in restructuring and reviewing the installation instructions provided in the manual for PHP. We expect the updated instructions to work properly for actual PHP versions and recent versions of the servers. We are going to remove irrelevant instructions on the way, and add more servers if possible and desired. We also would like to ask people experienced in setting up PHP *properly* on different platforms to help us refine and fix the documentation. We know that the windows instructions are a mess in suggesting moving and copying stuff all around the system and windows dirs. We are not certain though what should be there instead as proper instructions, so would like to ask people who have expertise in setting up PHP on these platforms. [Wez already promised he is going to help with general Windows instructions, but seems like he had no time this week to reply to our mails]. We are very much interested in people reviewing the MacOS, different Unix variants, different servers, etc. Basically everything related to the installation. Pick the part you have experience in! We are also in need of people fixing the docs for PHP 5 (so the suggestions will work for PHP 4 and PHP 5 too). The restructuring of the installation part is now complete, and awaits your help in refining the instructions for different servers, and add more if desired. Here is how you can help: 1. Check out the phpdoc module. Get to the en/install folder. On the web: http://cvs.php.net/cvs.php/phpdoc/en/install/ 2. This is the start folder for our new install instructions structure. Do not let any other place confuse you, where you might find instructions on installation. This is the folder to work with. 3. Provide diffs against installation instructions to phpdoc@lists.php.net if possible. Thanks for your cooperation, Gabor Hojtsy (AKA Goba) - PHP Documentation Editor

Jacques Marneweck

22 years ago
On Fri Jun 11 21:46:08 2004 Gabor Hojtsy wrote: Hi Gabor, I'm going to start hacking up some instructions for installing PHP4 / PHP5 under FreeBSD 4.X and 5.X. Would there be a problem if I added a freebsd.xml file as I go along? Regards --jm

Gabor Hojtsy

22 years ago
Hi,
> I'm going to start hacking up some instructions for installing PHP4 / PHP5 > under FreeBSD 4.X and 5.X. > > Would there be a problem if I added a freebsd.xml file as I go along?
No problem for new stuff. For modifications, it is better to provide a diff, since more people might work on it. Or post a notice first if you are going to make significant modifications to some existing file. BTW it would be nice if you could get someone else too to review your new docs, so it is accurate. Also do not duplicate info for Apache. If the general apache stuff works on FreeBSD, then there is nothing to add. If it only needs additional comments, then a new freebsd.xml is desired. If setting up PHP is so different, then you will probably need to put completely new stuff up (into freebsd.xml). Goba