[appledoc] Fix appledoc warnings. (#553)

AsyncDisplayKit/ASDisplayNode.h

@@ -13,7 +13,13 @@
 #import <AsyncDisplayKit/ASDealloc2MainObject.h>
 #import <AsyncDisplayKit/ASDimension.h>
 
+/**
+ * UIView creation block. Used to create the backing view of a new display node.
+ */
 typedef UIView *(^ASDisplayNodeViewBlock)();
+/**
+ * CALayer creation block. Used to create the backing layer of a new display node.
+ */
 typedef CALayer *(^ASDisplayNodeLayerBlock)();
 
 /**
@@ -50,6 +56,8 @@ typedef CALayer *(^ASDisplayNodeLayerBlock)();
 /**
  * @abstract Alternative initializer with a block to create the backing view.
  *
+ * @param viewBlock The block that will be used to create the backing view.
+ *
  * @return An ASDisplayNode instance that loads its view with the given block that is guaranteed to run on the main
  * queue. The view will render synchronously and -layout and touch handling methods on the node will not be called.
  */
@@ -58,6 +66,8 @@ typedef CALayer *(^ASDisplayNodeLayerBlock)();
 /**
  * @abstract Alternative initializer with a block to create the backing layer.
  *
+ * @param viewBlock The block that will be used to create the backing layer.
+ *
  * @return An ASDisplayNode instance that loads its layer with the given block that is guaranteed to run on the main
  * queue. The layer will render synchronously and -layout and touch handling methods on the node will not be called.
  */
@@ -332,7 +342,7 @@ typedef CALayer *(^ASDisplayNodeLayerBlock)();
  * This method is used to notify the node that it should purge any content that is both expensive to fetch and to
  * retain in memory.
  *
- * @see clearFetchedData and fetchData
+ * @see ASDisplayNode(Subclassing):clearFetchedData and fetchData
  */
 - (void)recursivelyClearFetchedData;
 
@@ -341,7 +351,7 @@ typedef CALayer *(^ASDisplayNodeLayerBlock)();
  *
  * @discussion Fetches content from remote sources for the current node and all subnodes.
  *
- * @see fetchData and clearFetchedData
+ * @see ASDisplayNode(Subclassing):fetchData and clearFetchedData
  */
 - (void)recursivelyFetchData;
 
@@ -556,18 +566,22 @@ typedef CALayer *(^ASDisplayNodeLayerBlock)();
 @interface ASDisplayNode (ASDisplayNodeAsyncTransactionContainer) <ASDisplayNodeAsyncTransactionContainer>
 @end
 
-
+/** UIVIew(AsyncDisplayKit) defines convenience method for adding sub-ASDisplayNode to an UIView. */
 @interface UIView (AsyncDisplayKit)
 /**
  * Convenience method, equivalent to [view addSubview:node.view] or [view.layer addSublayer:node.layer] if layer-backed.
+ *
+ * @param node The node to be added.
  */
 - (void)addSubnode:(ASDisplayNode *)node;
 @end
 
-
+/** CALayer(AsyncDisplayKit) defines convenience method for adding sub-ASDisplayNode to a CALayer. */
 @interface CALayer (AsyncDisplayKit)
 /**
  * Convenience method, equivalent to [layer addSublayer:node.layer].
+ *
+ * @param node The node to be added.
  */
 - (void)addSubnode:(ASDisplayNode *)node;
 @end