Re: Protocols documentation missing required methods?
Re: Protocols documentation missing required methods?
- Subject: Re: Protocols documentation missing required methods?
- From: Christiaan Hofman <email@hidden>
- Date: Thu, 10 Nov 2011 17:29:57 +0100
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.
>>>> --
>>>> 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
>>>
>>> --
>>> Nick :wq
>>>
>>>
>>>
>>>
>>
>
> --
> Nick :wq
>
>
>
>
_______________________________________________
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