From mboxrd@z Thu Jan  1 00:00:00 1970
From: "Eric Schulte" <schulte.eric@gmail.com>
Subject: Re: Re: Worg needs some reorganizing
Date: Thu, 20 Jan 2011 11:44:24 -0700
Message-ID: <8762tjxvnb.fsf@gmail.com>
References: <4CAD81B0.6090807@manor-farm.org>
	<AANLkTikmwyPCG=QV==RaaCuejOPKw6hSdoy7Rf1RxfDU@mail.gmail.com>
	<87aaj0kggo.fsf@gmail.com> <87zkr0load.fsf@riotblast.dunsmor.com>
	<87pqrwipjd.fsf@gmail.com> <87oc7glhef.fsf@riotblast.dunsmor.com>
	<87hbd8ins8.fsf@gmail.com> <87ipxolgji.fsf@riotblast.dunsmor.com>
	<87aaj0iiff.fsf@gmail.com> <87r5cbk28p.fsf@riotblast.dunsmor.com>
	<87fwsrtokh.fsf@gnu.org> <87lj2jouz7.fsf@fastmail.fm>
	<AANLkTinaHPgbWOH9s-CXo7hRE1nAAVM7Tn11dF6F37PP@mail.gmail.com>
	<877he2fvw0.fsf@gnu.org> <87fwsqw8u3.fsf@fastmail.fm>
	<87d3nufa7a.fsf@gmail.com> <87r5cagi6h.fsf@riotblast.dunsmor.com>
	<m1k4hzbyzy.fsf@94.197.142.47.threembb.co.uk>
	<AANLkTik+twehQS3dYU8navJMQKh9iQR9obOB+5JvJqOP@mail.gmail.com>
	<4D386F00.2070705@ccbr.umn.edu> <874o93a30t.fsf@riotblast.dunsmor.com>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from [140.186.70.92] (port=54128 helo=eggs.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1PfzUp-0002wl-Kx
	for emacs-orgmode@gnu.org; Thu, 20 Jan 2011 13:44:37 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <schulte.eric@gmail.com>) id 1PfzUm-0003jZ-PB
	for emacs-orgmode@gnu.org; Thu, 20 Jan 2011 13:44:35 -0500
Received: from mail-pv0-f169.google.com ([74.125.83.169]:56302)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <schulte.eric@gmail.com>) id 1PfzUm-0003ie-Ig
	for emacs-orgmode@gnu.org; Thu, 20 Jan 2011 13:44:32 -0500
Received: by pvc30 with SMTP id 30so225717pvc.0
	for <emacs-orgmode@gnu.org>; Thu, 20 Jan 2011 10:44:31 -0800 (PST)
In-Reply-To: <874o93a30t.fsf@riotblast.dunsmor.com> (Jason Dunsmore's message
	of "Thu, 20 Jan 2011 11:38:58 -0600")
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: Jason Dunsmore <emacs-orgmode@dunsmor.com>
Cc: Jeff Horn <jrhorn424@gmail.com>, emacs-orgmode@gnu.org, Dan Davison <dandavison7@gmail.com>

>
> I see this issue a lot on the Babel pages.  What needs to be done is
> wrap each source/example block in another block with "org" as the
> language.
>
> For example:
>
> #+begin_src org
>   ,#+begin_src sh :results output
>     ls -al
>   ,#+end_src
> #+end_src
>
> I think this should be done for all Babel documents to make them more
> coherent when reading them on the web.  I found the babel documentation
> quite confusing in the beginning because of this.
>
> Eric and Dan,
>
> Do you agree with this?

Yes, I do agree,

When writing the babel paper we ended up taking basically this approach,
and found that we had to duplicate most blocks, once for showing the
block and once for showing the output e.g.

#+begin_src org
  ,#+begin_src sh :results output
    ls -al
  ,#+end_src
#+end_src

#+begin_src sh :results output
 ls -al
#+end_src

maybe this process could be simplified by passing the body of the code
block to some function (could be defined in the library of babel) which
inserts both the begin_src org quoted body and the actual results into
exported documents.

Cheers -- Eric