On Feb 9, 2011, at 11:19 AM, Bill Bumgarner wrote: > > On Feb 9, 2011, at 10:51 AM, Matt Neuburg wrote: > >>> error >>> An out value that returns any error encountered during initialization. >>> Returns nil if the regular expression pattern is invalid. >> >> Really? :) m. > > I read that as "The method returns nil if the pattern is invalid.
That's what the documentation should in fact say, but what I'm pointing out is that it doesn't, and an ordinary beginner would have no way of knowing this. My guess as to what's happened: There is supposed to be a section describing the result, and that section has gotten itself conflated with the section describing the "error" parameter. In a larger sense, let's face it, this pattern is problematic. It's hard for the docs to describe correctly, because it's hard to describe. I've been wondering whether we could now replace it with an error *block*... :) m. -- matt neuburg, phd = m...@tidbits.com, http://www.tidbits.com/matt/ pantes anthropoi tou eidenai oregontai phusei Among the 2007 MacTech Top 25, http://tinyurl.com/2rh4pf AppleScript: the Definitive Guide, 2nd edition http://www.tidbits.com/matt/default.html#applescriptthings Take Control of Exploring & Customizing Snow Leopard http://tinyurl.com/kufyy8 RubyFrontier! http://www.apeth.com/RubyFrontierDocs/default.html TidBITS, Mac news and reviews since 1990, http://www.tidbits.com _______________________________________________ Cocoa-dev mailing list (Cocoa-dev@lists.apple.com) Please do not post admin requests or moderator comments to the list. Contact the moderators at cocoa-dev-admins(at)lists.apple.com Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com This email sent to arch...@mail-archive.com
