      *  in the sequence.
      * 
      *  @param element The element that comes after this element in the sequence.
-     *  @return Returns true when this element is compatible with the previous
+     * 
+     *  @return Returns <code>true</code> when this element is compatible with the previous
      *  element in the sequence.
      * 
      *  @see #canShareWithPrevious

     *  In those cases, this method is not called.</p>
     * 
     *  @param element The element that comes before this element in the sequence.
     *  @return Returns true when this element is compatible with the previous
     *  element in the sequence.
     * 
     *  @see #canShareWithNext

 *  DisplayObject management.
 *
 *  <p>One typical use case is DisplayObject sharing.  
 *  the Group class, which implements <code>IGraphicElementContainer</code>, organizes its
 *  IGraphicElement children in sequences that share and draw to
 *  the same DisplayObject.
 *  The DisplayObject is created by the first element in the
 *  sequence.</p>
 *
 *  <p>Another use case is when an element does not derive from
 *  DisplayObject but instead maintains, creates and/or destroys
 *  its own DisplayObject. The <code>IGraphicElementContainer</code> will 
 *  call the element to create the DisplayObject, add the
 *  DisplayObject as its child at the correct index, and 
 *  handle its removal.</p> 
 *
 *  <p>Typically, you extend the GraphicElement class
 *  instead of directly implementing the IGraphciElement
 *  interface. The GraphicElement class already provides most of the
 *  required functionality.</p>
