0
0
Fork 1
mirror of https://git.savannah.gnu.org/git/emacs/org-mode.git synced 2024-08-25 00:02:51 +00:00

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:
Carsten Dominik 2010-10-08 12:29:11 +02:00
parent aaab45081b
commit 4a8b676d28

View file

@ -1076,9 +1076,13 @@ for the duration of the command."
(plain-list-item . auto))
"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,
and a boolean flag as cdr. 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 keep the list in tact."
and a boolean flag as cdr. The cdr may lso be the symbol `auto', and then
Org will look at the surrounding headings/items and try to make an
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
:type '(list
(cons (const heading)