Posts

Showing posts from October, 2007

8 reasons why you should *not* write for the php.net manual

8 reasons why you should *not* write for the php.net manual : You get more page hits by publishing your work on your blog You get a free pass to conferences by converting your work into presentation You get paid to submit your work to magazines & commercial websites You get a "trading card" and considered a star The community will know your name You can flame the documentations without needing to do anything about it You can copy&paste parts from the manual and sell it (see point#3) You can license your work to forbid any commercial use or further improvements :)

PhD: The [PH]P based [D]ocbook renderer RC1 released

Quick note; We released PhD0.1RC1 today \o/ Building the php.net documentations has never been as easy or as fast. Note: You'll need 200M free diskspace (90M for the phpdoc XML sources and 110M for the generated html/php files). Fetching the phpdoc sources: bjori@lindsay:~$ cvs -d:pserver:cvsread@cvs.php.net/repository co phpdoc cvs checkout: Updating phpdoc U phpdoc/.cvsignore U phpdoc/LICENSE U phpdoc/Makefile.in [snip] Configure and test the XML bjori@lindsay:~$ cd phpdoc/ bjori@lindsay:~/phpdoc$ php configure.php configure.php: $Id: configure.php,v 1.7 2007/10/02 12:03:16 bjori Exp $ PHP version: 5.3.0-dev [snip] * No missing ids found All good. All you have to do now is run 'phd /home/bjori/phpdoc' Installing and rendering the php.net documentation bjori@lindsay:~/phpdoc$ cd .. bjori@lindsay:~$ pear install http://doc.php.net/phd/PhD-0.1RC1.tgz downloading PhD-0.1RC1.tgz ... Starting to download PhD-0.1RC1.tgz (19,683 bytes) .......done: 19,683 bytes install ok: channe