Re: [PHP-DOC] Predefined Constants From: Edin Kadribasic (edink <email protected>)
Date: 08/07/02

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

-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php