Added some comments clarifying that appended, inserted, and deleted reflow

commands take a child list (i.e. more than one frame)

layout/base/public/nsIReflowCommand.h

@@ -76,15 +76,15 @@ public:
     /**
      * Reflow command generated by the style system in response to a
      * ContentInserted content notification. The target frame of the reflow
-     * command is the container frame itself. The "child frame" is the newly
+     * command is the container frame itself. The "child frame" is a linked
-     * created child frame. The "previous sibling" frame is the existing frame
+     * list of newly created child frames. The "previous sibling" frame is the
-     * immediately preceding where the newly created frame should be inserted.
+     * existing frame immediately preceding where the first of the newly created
-     * If the newly created frame should be the target frame's first child frame
+     * frames should be inserted. If the newly created frames should be the
-     * then "previous sibling" will be nsnull.
+     * target frame's first child frames then "previous sibling" will be nsnull.
      *
-     * The target frame should insert the new frame immediately after the previous
+     * The target frame should insert the new frames immediately after the previous
-     * frame, and then reflow the new frame using an eReflowReason_Initial reflow
+     * sibling frame, and then reflow the new frames using an eReflowReason_Initial
-     * reason.
+     * reflow reason.
      *
      * The target frame is determined as follows:
      *   - find the previous existing frame and use its content parent
@@ -99,9 +99,14 @@ public:
 
     /**
      * Reflow command generated by the style system in response to a
-     * ContentRemoved content notification. The "child frame" is the frame
+     * ContentRemoved content notification. The "child frame" is a linked list
-     * associated with the content that has been removed. The target frame
+     * of frames associated with the content that has been removed. Note that
-     * is the content parent of the "child frame".
+     * there can be more than one frame in which case they're adjacent siblings.
+     *
+     * The target frame should remove and delete each of the frames.
+     *
+     * The target frame is the content parent of the child frames to be
+     * deleted.
      *
      * @see #GetTarget()
      * @see #GetChildFrame()