Re: Protocols documentation missing required methods?
Re: Protocols documentation missing required methods?
- Subject: Re: Protocols documentation missing required methods?
- From: Laurent Daudelin <email@hidden>
- Date: Thu, 10 Nov 2011 09:40:46 -0800
On Nov 10, 2011, at 08:29, Christiaan Hofman wrote:
>
> On Nov 10, 2011, at 17:19, Νικόλας Τουμπέλης wrote:
>
>> @Christiaan: I think it's because the protocols (NSURLConnectionDelegate, NSURLConnectionDataDelegate etc.) are all specified in NSURLConnection.h; I'm not sure whether this is an error in the docs.
>>
>
> That's true for any of the delegate protocols. And the fact is that there IS a separate documentation for the delegate protocol, so if SOME delegate methods are in that doc than ALL delegate methods should be in that doc.
>
>> @Laurent: I have the latest docs installed here. If I remember correctly, these delegates have always been documented in NSURLConnection. However,... I've noticed a couple of things:
>>
>
> Actually, the current docs on the web does not contain them, not in any place. Also, the links in the Foundation Changes document are missing precisely for these delegate methods.
>
> AFAIK only the old deprecated ones in the *informal* NSObject protocol were listed in the NSURLConnection doc. I don't think the ones in the *formal* protocol were ever documented properly.
>
> And are they really required? In the old informal protocol they were never documented as required, none of them.
>
>> Even though the delegate methods are declared inside their respective protocols, the docs have them listed in NSURLConnection.
>>
>> All of them are listed as being available in iOS 3.0 through 4.3 but the docs don't have them anywhere else.
>>
>
> That actually confirms what I said above, you;re talking about the deprecated informal protocol, not the new formal protocol.
>
>> Some of them -most of the authentication-related delegate methods- are listed twice in the docs, in both NSURLConnection and NSURLConnectionDelegate, e.g. connection:DidReceiveAuthenticationChallenge:.
>>
>
> Those are the ones the OP was expressly not talking about.
>
> Christiaan
>
>> On 10 Νοε 2011, at 5:51 μ.μ., Laurent Daudelin wrote:
>>
>>> Thanks Nick. We must not use the same set of documentation because right now, right before me, I have the NSURLConnection page opened (from the iOS 5 set). The only mention of the delegate methods is in the overview. However, there is no explanation of any parameters received and what should be returned.
>>>
>>> Are you looking at the same docs set of documentation, "iOS 5.0 Library", in Xcode 4.2?
>>>
>>> -Laurent.
>>> --
>>> Laurent Daudelin
>>> AIM/iChat/Skype:LaurentDaudelin http://www.nemesys-soft.com/
>>> Logiciels Nemesys Software email@hidden
>>>
>>> On Nov 10, 2011, at 00:34, Νικόλας Τουμπέλης wrote:
>>>
>>>> Hi Laurent,
>>>>
>>>> the delegate methods you're looking for are in the NSURLConnection documentation.
>>>>
>>>>
>>>>
>>>> On 10 Νοε 2011, at 9:12 π.μ., Laurent Daudelin wrote:
>>>>
>>>>> Hello.
>>>>>
>>>>> Am I missing something? I'm looking at the NSURLConnectionDelegate in the documentation. The document states at the beginning that it describes the optional methods for NSURLConnectionDelegate. Where can I find the required methods in the documentation? I know I can find them in the NSURLConnection.h header but that's rather tedious drilling down the framework and headers to find it.
>>>>>
>>>>> So, where are those methods documented?
>>>>>
>>>>> Thanks!
>>>>>
>>>>> -Laurent.
I guess I'll file a bug on this. When I look for the delegate methods for a specific protocol, I'm expecting all the methods to be documented there.
Thanks.
-Laurent.
--
Laurent Daudelin
AIM/iChat/Skype:LaurentDaudelin http://www.nemesys-soft.com/
Logiciels Nemesys Software email@hidden
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Xcode-users mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden