Re: RFC: Moving documents in source

From: "Yasuo Ohgaki" <yasuo_ohgaki@yahoo.com> > Currently general documents are located in source root. > It might be nice if we put documents under "docs" or like. > > How about move files like this? > > [yohgaki@dev php4]$ ls -R docs > docs: > EXTENSIONS INSTALL README.QNX README.SELF-CONTAINED-EXTENSIONS > README.Zeus TODO TODO-4.2.txt developer > > docs/developer: > CODING_STANDARDS README.EXTENSIONS README.PARAMETER_PARSING_API > RELEASE_PROCESS apidoc.txt header > README.CVS-RULES README.EXT_SKEL README.STREAMS > apidoc-zend.txt footer > > We probably should rename filenames and make new README which > describes general infomation. (ext_skel script should be modified > a little. Anything else?) > > > README draft located under source root. > ------------- > WHAT IS PHP > > PHP is a server-side, cross-platform, HTML embedded scripting language. > If you are new to PHP and want to get some idea of how it works, refer > to http://www.php.net/ for more information. > > LICENSE > > PHP is avairable under PHP License. Zend and TSRM is avairable under BSD > style License. Refer to LICENSE files for details. > > HOWTO INSTALL FROM SOURCE > > PHP can compile under many UNIX like OS, Windows and Mac OSX. Refer to > <source root>/docs/INSTALL for details. > > GETTING MORE INFO > > General documents are located under <source root>/docs/ directory. > Develper's documents are located <source root>/docs/developer/. > For more information, refer to following URLs. > > PHP: http://www.php.net/ > PHP Manual: http://www.php.net/docs.php > PHP Support: http://www.php.net/support.php > PEAR: http://pear.php.net/ (PHP Libraly) > PHP GTK: http://gtk.php.net/ (GTK Application) > PHP Bugs: http://bugs.php.net/ (PHP Bug Tracking DB) > Zend Engine: http://www.zend.com/ (Zend Script Engine > and more) > --------------- > > Thanks for your comments :) I have talked yesterday with Hartmut Holzgraefe and Georg Richter about the future of the PHP manual. I made the following suggestion, the PHP manual could or should be the main PHP User Manual. The documents and text file you mentioned should or could be collected in a new PHP Developers Guide. Gabo´s HowTo is IMHO the first step in the right direction. -Egon