1AutoFormat.AutoParagraph
2TYPE: bool
3VERSION: 2.0.1
4DEFAULT: 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
32