From mboxrd@z Thu Jan  1 00:00:00 1970
From: Dan Davison <davison@stats.ox.ac.uk>
Subject: Re: [babel] options to the example directive
Date: Tue, 03 Nov 2009 12:34:52 -0500
Message-ID: <87ws27jyv7.fsf@stats.ox.ac.uk>
References: <87ljinwtdm.wl%ucecesf@ucl.ac.uk>
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 mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1N5NHc-0007TE-0e
	for emacs-orgmode@gnu.org; Tue, 03 Nov 2009 12:35:04 -0500
Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1N5NHX-0007Rd-Go
	for emacs-orgmode@gnu.org; Tue, 03 Nov 2009 12:35:03 -0500
Received: from [199.232.76.173] (port=45836 helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1N5NHX-0007RY-76
	for emacs-orgmode@gnu.org; Tue, 03 Nov 2009 12:34:59 -0500
Received: from markov.stats.ox.ac.uk ([163.1.210.1]:49048)
	by monty-python.gnu.org with esmtp (Exim 4.60)
	(envelope-from <davison@stats.ox.ac.uk>) id 1N5NHW-0007NC-Oe
	for emacs-orgmode@gnu.org; Tue, 03 Nov 2009 12:34:59 -0500
In-Reply-To: <87ljinwtdm.wl%ucecesf@ucl.ac.uk> (Eric S. Fraga's message of
	"Tue, 03 Nov 2009 14:55:01 +0000")
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/pipermail/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: Eric S Fraga <e.fraga@ucl.ac.uk>
Cc: emacs org-mode mailing list <emacs-orgmode@gnu.org>

Eric S Fraga <ucecesf@ucl.ac.uk> writes:

> I am finding org-babel incredibly useful in the preparation of
> documentation for didactic purposes.  Kudos to the developers!  
>
> I have two queries that I cannot seem to find an answer to in the
> documentation: 
>
> 1. is there any way to specify arguments that should be generated for
>    the #+begin_example line for the results of a babel invocation?

Not currently. When exporting the *code* contained in a block, then any
switches placed after begin_src are reinstated in the output code
block. I.e.

begin_src XXX <switches> :exports code
...

becomes

begin_src XXX <switches>
...

However when a begin_example block is created as *results*, it is
created without any switches. I'm tending to think that it would be
inappropriate to simply reinstate the src block switches in the results
block. How do you suggest this option should be made available? Perhaps
a new header arg, or as a variable org-babel-results-block-switches, or
both?

Note that you will need to set org-babel-min-lines-for-block-output to
zero in order to guarantee that output is enclosed in a begin_example
block. Otherwise small chunks of output will be made verbatim by
prepending lines with ': ', in which case (I believe) the -t switch is
unavailable.


>    Specifically, I would like to append automatically, for instance,
>    arguments such as "-t -w 100 -h 20" so that the export to HTML
>    output is presented in a text box that has scroll bars etc.

>
> 2. even if I manually put the options on the begin_example line, the
>    export to HTML creates a '<pre class="example">' directive instead
>    of what I would expect: '<textarea cols="40" rows="10">' or
>    something similar.  I don't understand why exporting a file without
>    babel constructs should behave differently from exporting with

This is a consequence of the same issue: org-exp-blocks preprocesses
your src block in a pre-export buffer (a copy of the original), hands it
to org-babel, which creates the results block (overwriting the version
where you had manually inserted switches), and that results block lacks
any switches.

Dan

>    babel.  Should a begin_example section not export the same in both
>    cases?
>
> I am using org-mode and babel up to date as of this morning.
>
> Any pointers highly welcome!
>
> Thanks,
> eric
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Remember: use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode