Document the `auto' setting of `org-blank-before-new-entry'.
* lisp/org.el (org-blank-before-new-entry): Improve docstring.
This commit is contained in:
parent
aaab45081b
commit
4a8b676d28
10
lisp/org.el
10
lisp/org.el
|
@ -1076,9 +1076,13 @@ for the duration of the command."
|
||||||
(plain-list-item . auto))
|
(plain-list-item . auto))
|
||||||
"Should `org-insert-heading' leave a blank line before new heading/item?
|
"Should `org-insert-heading' leave a blank line before new heading/item?
|
||||||
The value is an alist, with `heading' and `plain-list-item' as car,
|
The value is an alist, with `heading' and `plain-list-item' as car,
|
||||||
and a boolean flag as cdr. For plain lists, if the variable
|
and a boolean flag as cdr. The cdr may lso be the symbol `auto', and then
|
||||||
`org-empty-line-terminates-plain-lists' is set, the setting here
|
Org will look at the surrounding headings/items and try to make an
|
||||||
is ignored and no empty line is inserted, to keep the list in tact."
|
intelligent decision wether to insert a blank line or not.
|
||||||
|
|
||||||
|
For plain lists, if the variable `org-empty-line-terminates-plain-lists' is
|
||||||
|
set, the setting here is ignored and no empty line is inserted, to avoid
|
||||||
|
breaking the list structure."
|
||||||
:group 'org-edit-structure
|
:group 'org-edit-structure
|
||||||
:type '(list
|
:type '(list
|
||||||
(cons (const heading)
|
(cons (const heading)
|
||||||
|
|
Loading…
Reference in New Issue