Re: Manual page suggestions (was: dba_open...)
| From: | Philip Olson | Date: | Thu, 07 Nov 2002 21:11:40 +0000 |
| Subject: | Re: Manual page suggestions (was: dba_open...) | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969349474@lists.php.net to get a copy of this message | ||
> > function in_array:
> >
> > --------------------------------------------------------------
> > Parameter | Description | Notes
> > --------------------------------------------------------------
> > needle | What is being searched for | Became mixed in
> > | | PHP 4.2.0
> > haystack | What we're searching in |
> > strict | If set to true, the type will | Defaults to false
> > | also be compared. |
> > ==============================================================
> > On failure: returns false
> > --------------------------------------------------------------
> >
> > Seeing that below the proto might be useful and easy to read.
> > Anyway, something to think about :)
>
> There are some functions somewhere in the documentation with
> parameters documented this way, but I cannot find them right
> now... This would be a very nice thing (TM) IMHO, but needs a
> tremendous amount of work and/or a very long time. We discussed
> the idea of restructuring the manual pages in a "man" like manner,
> to organize content... It would be quite nice, but I cannot
> volunteer any time to this project.
> Goba
One day here I'll create a few to see how they look, I also
agree it would be a nice thing but as you mention would
require a LOT of work to complete. Maybe we can do one
extension at a time. Man pages are nice but since all PHP
functions have such a few amount of "options" (parameters),
using the above table might work.
I really look forward to the individual function CHANGELOG
implementation, has there been any work or news on that? I
would like to work on that before the above.
Regards,
Philip