Re: Predefined Constants
| From: | Edin Kadribasic | Date: | Wed, 07 Aug 2002 22:26:36 +0000 |
| Subject: | Re: Predefined Constants | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969347900@lists.php.net to get a copy of this message | ||
> > I've noticed "Predefined Constants" sections in the each extension
> > chapter. These are generated automatically, right? If they are, I
> > don't thinks its terribly useful to have them listed like that. Most
> > of predefined constants make litle sense when displayed out of
> > context.
> >
> > Just take a look at oci8 extension. Does it make sense that all
> > those constants are listed there, out of context, and providing very
> > little useful information.
> >
> > Or cURL. You have them listed on the front page, but fully explained
> > on curl_setopt page.
>
> Well, ideally the constants page on all extension pages should document
> the constants used by that extension with explanation... Other functions
> may also document function specific constants... We are in the progress
> of moving constants/ini/configure information from other places to
> extension documentation, so this is more in context then before (the
> predefined constants docs were documented in an appendix)...
Could you at least move them to a different file linked from the main
extension file?
Btw. the automatic generation has some funny side effects. You ended up
documenting some PHP insider jokes like SIGBABY in pcntl functions :)
Edin