AutoFormat.AutoParagraph
TYPE: bool
VERSION: 2.0.1
DEFAULT: false
--DESCRIPTION--

  This directive turns on auto-paragraphing, where double newlines are
  converted in to paragraphs whenever possible. Auto-paragraphing:

- Always applies to inline elements or text in the root node,
  
- Applies to inline elements or text with double newlines in nodes
      that allow paragraph tags,
  
- Applies to double newlines in paragraph tags

  p tags must be allowed for this directive to take effect.
  We do not use br tags for paragraphing, as that is
  semantically incorrect.

  To prevent auto-paragraphing as a content-producer, refrain from using
  double-newlines except to specify a new paragraph or in contexts where
  it has special meaning (whitespace usually has no meaning except in
  tags like pre, so this should not be difficult.) To prevent
  the paragraphing of inline text adjacent to block elements, wrap them
  in div tags (the behavior is slightly different outside of
  the root node.)

--# vim: et sw=4 sts=4
