iOS 5 view controller containment API documentation is lacking

Originator:defagos
Number:rdar://10884377 Date Originated:17-Feb-2012
Status:Duplicate Resolved:
Product:Documentation Product Version:iOS 5
Classification: Reproducible:
 
Summary:
The UIViewController documentation and the View Controller Programming Guide poorly explain how the new view controller containment API (iOS 5) must be used, what it does under the hood, and how current pre-iOS 5 implementations must be updated.

For example, a container view controller implementing automaticallyForwardAppearanceAndRotationMethodsToChildViewControllers to return NO (i.e. pre-iOS 5 behavior) must register its children view controllers using the addChildViewController: method (otherwise there might be issues; See Problem ID 10822029, which I incorrectly described as a bug).

Links:
https://developer.apple.com/library/ios/#DOCUMENTATION/UIKit/Reference/UIViewController_Class/Reference/Reference.html
https://developer.apple.com/library/ios/#featuredarticles/ViewControllerPGforiPhoneOS/Introduction/Introduction.html

Steps to Reproduce:
-

Expected Results:
-

Actual Results:
-

Regression:
-

Notes:

Comments

Duplicate of bug 10437601

By defagos at Sept. 1, 2012, 9:05 a.m. (reply...)

Please note: Reports posted here will not necessarily be seen by Apple. All problems should be submitted at bugreport.apple.com before they are posted here. Please only post information for Radars that you have filed yourself, and please do not include Apple confidential information in your posts. Thank you!