Bastien <bastien.gue...@wikimedia.fr> writes:

> Jason Dunsmore <ja...@dunsmor.com> writes:
>
>> I now understand this is a formatting convention issue.  
>
> I'm trying to figure out when this patch is useful.  I understand this
> is when `org-blank-before-new-entry' doesn't set heading to t or auto, 
> but I don't understand what it the difference the patch introduces then.
>
> Could you send a _visual_ example, with useless empty lines that you
> want to get rid off when org-metaup etc ?

Convention 1: Newline above headings

This seems to be used more often when the body does not have delimiting
newlines.

Configuration:

--8<---------------cut here---------------start------------->8---
(setq org-blank-before-new-entry '((heading . t)
                                   (plain-list-item . t)))
--8<---------------cut here---------------end--------------->8---

Org example:

--8<---------------cut here---------------start------------->8---

* Section

** Subsection 1
Body

** Subsection 2
Body
--8<---------------cut here---------------end--------------->8---


Convention 2: Newline after bodies

This seems to be used more often when the body does have delimiting
newlines.

Configuration:

--8<---------------cut here---------------start------------->8---
(setq org-blank-before-new-entry '((heading . nil)
                                   (plain-list-item . nil)))
--8<---------------cut here---------------end--------------->8---

Org example:

--8<---------------cut here---------------start------------->8---
* Section
** Subsection 1

Body

** Subsection 2

Body

--8<---------------cut here---------------end--------------->8---

I've seen both conventions in use on Worg and in Org-mode tutorials.

I just tested these configurations and Org examples out with the patch
and it seems to work well.  I've been using the patch on my systems for
a while now and haven't noticed any bad side-effects.

Let me know if you need any other information.

Regards,
Jason

_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

Reply via email to