bgneal@45: Edit CSS Style plug-in notes
bgneal@45: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
bgneal@45: Unlike WYSIWYG editor functionality that operates only on the selected text,
bgneal@45: typically by inserting new HTML elements with the specified styles.
bgneal@45: This plug-in operates on the HTML blocks surrounding the selected text.
bgneal@45: No new HTML elements are created.
bgneal@45: 
bgneal@45: This plug-in only operates on the surrounding blocks and not the nearest
bgneal@45: parent node.  This means that if a block encapsulates a node,
bgneal@45: e.g <p><span>text</span></p>, then only the styles in the block are
bgneal@45: recognized, not those in the span.
bgneal@45: 
bgneal@45: When selecting text that includes multiple blocks at the same level (peers),
bgneal@45: this plug-in accumulates the specified styles in all of the surrounding blocks
bgneal@45: and populates the dialogue checkboxes accordingly.  There is no differentiation
bgneal@45: between styles set in all the blocks versus styles set in some of the blocks.
bgneal@45: 
bgneal@45: When the [Update] or [Apply] buttons are pressed, the styles selected in the
bgneal@45: checkboxes are applied to all blocks that surround the selected text.