On Tue, Apr 15, 2008 at 5:39 AM, Philip Olson <[EMAIL PROTECTED]> wrote: > > > On 14 Apr 2008, at 11:01, Hannes Magnusson wrote: > > > On Mon, Apr 14, 2008 at 7:24 PM, Philip Olson <[EMAIL PROTECTED]> 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.
The stream docs need to link to it, and curl too, but since most of these options/params aren't really extension specific I don't know if we should link from all exts using them. For instance, extensions that use the http context option include book.dom, book.network and book.filesystem... Actually, when thinking about you are right. We should probably add a list of functions that use the default context and/or can take optional context argument.. I'll look into it. > Also, nice work documenting this scary topic Thanks! -Hannes
