SwiftDoc for nib + instance is now a function

Author: mac-cain13

Library/Core/NibResource.swift

@@ -8,8 +8,19 @@
 
 import Foundation
 
+/// Represents a nib file on disk
 public protocol NibResource {
+
+  /// Bundle this nib is in or nil for main bundle
   var bundle: NSBundle? { get }
-  var instance: UINib { get }
+
+  /// Name of the nib file on disk
   var name: String { get }
+
+  /**
+   Create a new instance of this nib file
+   
+   - returns: A new instance of this nib
+  */
+  func instantiate() -> UINib
 }

Library/UIKit/UICollectionView+ReuseIdentifierProtocol.swift

@@ -50,7 +50,7 @@ public extension UICollectionView {
    - parameter nibResource: A nib resource (R.nib.*) containing a object of type UICollectionViewCell that has a reuse identifier
    */
   public func registerNib<Resource: NibResource where Resource: ReuseIdentifierProtocol, Resource.ReusableType: UICollectionViewCell>(nibResource: Resource) {
-    registerNib(nibResource.instance, forCellWithReuseIdentifier: nibResource.identifier)
+    registerNib(nibResource.instantiate(), forCellWithReuseIdentifier: nibResource.identifier)
   }
 
   /**
@@ -68,6 +68,6 @@ public extension UICollectionView {
    - parameter nibResource: A nib resource (R.nib.*) containing a object of type UICollectionReusableView. that has a reuse identifier
    */
   public func registerNib<Resource: NibResource where Resource: ReuseIdentifierProtocol, Resource.ReusableType: UICollectionReusableView>(nibResource: Resource, forSupplementaryViewOfKind kind: String) {
-    registerNib(nibResource.instance, forSupplementaryViewOfKind: kind, withReuseIdentifier: nibResource.identifier)
+    registerNib(nibResource.instantiate(), forSupplementaryViewOfKind: kind, withReuseIdentifier: nibResource.identifier)
   }
 }

Library/UIKit/UITableView+ReuseIdentifierProtocol.swift

@@ -63,7 +63,7 @@ public extension UITableView {
    - parameter nibResource: A nib resource (R.nib.*) containing a table view cell that has a reuse identifier
   */
   public func registerNib<Resource: NibResource where Resource: ReuseIdentifierProtocol, Resource.ReusableType: UITableViewCell>(nibResource: Resource) {
-    registerNib(nibResource.instance, forCellReuseIdentifier: nibResource.identifier)
+    registerNib(nibResource.instantiate(), forCellReuseIdentifier: nibResource.identifier)
   }
 
   /**
@@ -72,6 +72,6 @@ public extension UITableView {
    - parameter nibResource: A nib resource (R.nib.*) containing a view that has a reuse identifier
    */
   public func registerNibForHeaderFooterView<Resource: NibResource where Resource: ReuseIdentifierProtocol, Resource.ReusableType: UIView>(nibResource: Resource) {
-    registerNib(nibResource.instance, forHeaderFooterViewReuseIdentifier: nibResource.identifier)
+    registerNib(nibResource.instantiate(), forHeaderFooterViewReuseIdentifier: nibResource.identifier)
   }
 }