Re: Predefined Constants

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

« previous php.doc (#969347900) next »