ndwarshuis
/
org-mode
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

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
1 changed files with 7 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
lisp/org.el
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)