From mboxrd@z Thu Jan  1 00:00:00 1970
From: Jonas Bernoulli <jonas@bernoul.li>
Subject: Re: ox-texinfo: use an Org section as Info Top node
Date: Mon, 18 Jun 2018 15:42:33 -0500
Message-ID: <87efh3u8qu.fsf@bernoul.li>
References: <87lgbe0yga.fsf@bernoul.li> <87k1qxizd8.fsf@nicolasgoaziou.fr>
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]:50664)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jonas@bernoul.li>) id 1fV0z7-0007zZ-QD
	for emacs-orgmode@gnu.org; Mon, 18 Jun 2018 16:42:46 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <jonas@bernoul.li>) id 1fV0z2-0002OD-TJ
	for emacs-orgmode@gnu.org; Mon, 18 Jun 2018 16:42:45 -0400
Received: from mail.hostpark.net ([212.243.197.30]:36458)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <jonas@bernoul.li>) id 1fV0z2-0002NT-M5
	for emacs-orgmode@gnu.org; Mon, 18 Jun 2018 16:42:40 -0400
In-reply-to: <87k1qxizd8.fsf@nicolasgoaziou.fr>
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"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Cc: emacs-orgmode@gnu.org


Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:
>
> Jonas Bernoulli <jonas@bernoul.li> writes:
>
>> Currently ox-texinfo uses the text before the first Org section as the
>> "Top" Info node.  That is fine for manuals like org-manual.org where
>> that part of the document only consists of a few lines.  In my manuals
>> there are up to 40 lines before the first heading, which makes it
>> desirable to make that part of the document collapsible.
>
> You can use a drawer for that:
>
>     :PREAMBLE:
>     ...
>     :END:

That works for me.

>> It is already possible to set the section whose content is to be used
>> on the copyright page (and which can be inserted elsewhere using
>> "#+texinfo: @insertcopying") using the COPYING property.
>>
>> Could you please implement something similar for the "Top" node, using
>> a property such as TOP?
>
> This sounds awkward, e.g., what would become the text before the first
> heading?

I guess it could either be ignored or prepended to the text from the TOP
section.

> AFAIU, there no really need for it, isn't it?

I didn't know about the PREAMBLE thing.  Now that I do, I don't need
anything else.

  Thanks for your help
  Jonas