1  AutoFormat.AutoParagraph
 2  TYPE: bool
 3  VERSION: 2.0.1
 4  DEFAULT: false
 5  --DESCRIPTION--
 6  
 7  <p>
 8    This directive turns on auto-paragraphing, where double newlines are
 9    converted in to paragraphs whenever possible. Auto-paragraphing:
10  </p>
11  <ul>
12    <li>Always applies to inline elements or text in the root node,</li>
13    <li>Applies to inline elements or text with double newlines in nodes
14        that allow paragraph tags,</li>
15    <li>Applies to double newlines in paragraph tags</li>
16  </ul>
17  <p>
18    <code>p</code> tags must be allowed for this directive to take effect.
19    We do not use <code>br</code> tags for paragraphing, as that is
20    semantically incorrect.
21  </p>
22  <p>
23    To prevent auto-paragraphing as a content-producer, refrain from using
24    double-newlines except to specify a new paragraph or in contexts where
25    it has special meaning (whitespace usually has no meaning except in
26    tags like <code>pre</code>, so this should not be difficult.) To prevent
27    the paragraphing of inline text adjacent to block elements, wrap them
28    in <code>div</code> tags (the behavior is slightly different outside of
29    the root node.)
30  </p>
31  --# vim: et sw=4 sts=4