Posts

Showing posts with the label documentation

Unix manual pages for PHP functions

Did you know that unix manual pages for PHP functions and methods existed? For a while I had vim configured to run reflection when I hit " K ", but after the PHP documentation team released unix manual pages for PHP I now get the manual page in all its glory; function description, parameter descriptions, return values, examples, notes, see also and everything you are used to see from the online manual. Its awesome. As many PHP functions use "standard names" the documentation team decided to not install the manual in the standard man directory. When you install the unix manual package you get a little shell script (called "pman") which runs the normal "man" command for you, and sets the manual directory to wherever you installed the package. To install the PHP manual as unix manual pages: $ pear install doc.php.net/pman If you are running very old pear version you need to "discover" the doc.php.net channel first: $ pear c...

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 :)