From mboxrd@z Thu Jan  1 00:00:00 1970
From: Marcin Borkowski <mbork@wmi.amu.edu.pl>
Subject: What does org-html--build-pre/postamble do?
Date: Sat, 01 Nov 2014 00:21:23 +0100
Message-ID: <871tpnrfkc.fsf@wmi.amu.edu.pl>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:45690)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mbork@wmi.amu.edu.pl>) id 1XkLVp-0003IS-Go
	for emacs-orgmode@gnu.org; Fri, 31 Oct 2014 19:21:51 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mbork@wmi.amu.edu.pl>) id 1XkLVj-0003Z2-QX
	for emacs-orgmode@gnu.org; Fri, 31 Oct 2014 19:21:45 -0400
Received: from msg.wmi.amu.edu.pl ([2001:808:114:2::50]:59345)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mbork@wmi.amu.edu.pl>) id 1XkLVj-0003XH-Jq
	for emacs-orgmode@gnu.org; Fri, 31 Oct 2014 19:21:39 -0400
Received: from localhost (localhost [127.0.0.1])
	by msg.wmi.amu.edu.pl (Postfix) with ESMTP id F11314225C
	for <emacs-orgmode@gnu.org>; Sat,  1 Nov 2014 00:21:35 +0100 (CET)
Received: from msg.wmi.amu.edu.pl ([127.0.0.1])
	by localhost (msg.wmi.amu.edu.pl [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id 4xK6rjFujBlG for <emacs-orgmode@gnu.org>;
	Sat,  1 Nov 2014 00:21:35 +0100 (CET)
Received: from localhost (99-229.echostar.pl [213.156.99.229])
	by msg.wmi.amu.edu.pl (Postfix) with ESMTPSA id C1A6042255
	for <emacs-orgmode@gnu.org>; Sat,  1 Nov 2014 00:21:35 +0100 (CET)
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/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: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Org-Mode mailing list <emacs-orgmode@gnu.org>

Hi all,

I've started to write a derived backend based on the HTML one.  Since I
want my HTML file to be rather minimalist, I exclude as much as
possible.  While looking at org-html-template, I noticed the
(org-html--build-pre/postamble 'preamble info)
line.  I'm wondering, what does it do?  Including it in my backend does
not influence the result (admittedly, the Org file I'm testing it on is
quite simple for now).  I instrumented org-html--build-pre/postamble for
edebug, but it didn't help me a lot.

What is this for?  I guess it inserts whatever is in
org-html-preamble-format for the current language; anything else?  In
particular: most of this function deals with the case when
(plist-get info :html-preamble)
is non-nil.  When is it possible?

TIA,

-- 
Marcin Borkowski
http://octd.wmi.amu.edu.pl/en/Marcin_Borkowski
Adam Mickiewicz University