From mboxrd@z Thu Jan  1 00:00:00 1970
From: Jason Dunsmore <emacs-orgmode@dunsmor.com>
Subject: Re: [PATCH] Preserve trailing blank lines
Date: Wed, 26 Jan 2011 12:52:04 -0600
Message-ID: <87oc73xzu3.fsf@riotblast.dunsmor.com>
References: <87mxngqh1o.fsf@riotblast.dunsmor.com>
	<078486EA-3EAD-4E6B-B428-D0DC477DFCB3@gmail.com>
	<87wrmchht6.fsf@riotblast.dunsmor.com> <87k4i3qg27.fsf@gnu.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from [140.186.70.92] (port=33627 helo=eggs.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1PiATR-00049O-9L
	for emacs-orgmode@gnu.org; Wed, 26 Jan 2011 13:52:10 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <emacs-orgmode@dunsmor.com>) id 1PiATQ-0007JF-1z
	for emacs-orgmode@gnu.org; Wed, 26 Jan 2011 13:52:09 -0500
Received: from deathroller.dunsmor.com ([98.129.169.48]:35131)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <emacs-orgmode@dunsmor.com>) id 1PiATP-0007Iv-Uu
	for emacs-orgmode@gnu.org; Wed, 26 Jan 2011 13:52:08 -0500
In-Reply-To: <87k4i3qg27.fsf@gnu.org> (Bastien's message of "Tue, 18
	Jan 2011 00:13:52 +0100")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Bastien <bastien.guerry@wikimedia.fr>
Cc: emacs-orgmode@gnu.org, Carsten Dominik <carsten.dominik@gmail.com>

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

> Jason Dunsmore <jason@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