Re: [PATCH] Refactoring context options

From: Date: Tue, 15 Apr 2008 03:39:31 +0000
Subject: Re: [PATCH] Refactoring context options
References: 1 2 3  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969378806@lists.php.net to get a copy of this message
On 14 Apr 2008, at 11:01, Hannes Magnusson wrote:
On Mon, Apr 14, 2008 at 7:24 PM, Philip Olson <philip@roshambo.org> wrote:
On 13 Apr 2008, at 15:05, Hannes Magnusson wrote:
Hi all Attached is a patch refactoring context options into its own reference page under the language reference. Pretty much only refactoring and new markup, almost no new content.
Hello Hannes- I'm wondering if these should go within the extension docs themselves (ex. reference/curl/context.xml) or all together in one place. Why did you choose to put them all in one place?
Before the change they were scattered all around various chapters in the appendix and extremely hard to navigate. Because of that I doubt many people have used any of these features, except for maybe the absolute basic http context options. Furthermore we've had a bug report about the ssl options for good period of time with seemingly noone even knowing where to document them - so how would the user know where they are? :) Since not many extensions define context options I think its better to group them all together for a quick lookup and a better overview over their usefulness.
Okay sounds reasonable, will you be adding links to them from the appropriate extensions? I wonder if each context parameters documentation should link to them too... hmm. Also, nice work documenting this scary topic :) Regards, Philip

« previous php.doc (#969378806) next »