From mboxrd@z Thu Jan  1 00:00:00 1970
From: Eric Abrahamsen <eric@ericabrahamsen.net>
Subject: Re: setting local variables
Date: Thu, 03 Aug 2017 09:11:31 -0700
Message-ID: <877eykbpho.fsf@ericabrahamsen.net>
References: <871sotiqld.fsf@ericabrahamsen.net>
	<87r2wsly88.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]:45966)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <geo-emacs-orgmode@m.gmane.org>) id 1ddIj1-0002eO-F4
	for emacs-orgmode@gnu.org; Thu, 03 Aug 2017 12:11:52 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <geo-emacs-orgmode@m.gmane.org>) id 1ddIix-0006q7-GV
	for emacs-orgmode@gnu.org; Thu, 03 Aug 2017 12:11:51 -0400
Received: from [195.159.176.226] (port=47912 helo=blaine.gmane.org)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <geo-emacs-orgmode@m.gmane.org>)
	id 1ddIix-0006nt-9O
	for emacs-orgmode@gnu.org; Thu, 03 Aug 2017 12:11:47 -0400
Received: from list by blaine.gmane.org with local (Exim 4.84_2)
	(envelope-from <geo-emacs-orgmode@m.gmane.org>) id 1ddIin-0003cX-Ft
	for emacs-orgmode@gnu.org; Thu, 03 Aug 2017 18:11:37 +0200
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: emacs-orgmode@gnu.org

Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:

> Hello,
>
> Eric Abrahamsen <eric@ericabrahamsen.net> writes:
>
>> I'm writing an Emacs manual in Org, using
>> https://github.com/tarsius/ox-texinfo-plus to make things a bit
>> easier.
>
> I don't know that library, but as a biased POV, it would be nice to use
> "ox-texinfo" and let us know about its shortcomings. Just saying.

Oh I don't think it's about shortcomings, just about having a version
that's tweaked specifically for writing Emacs manuals. I _really_ want
my packages to have info manuals, and I _really_ don't want to learn how
to write texinfo. I saw Rasmus' Org manual in org, and it looked like a
lot of work. Then I noticed that the Magit manuals used this
texinfo-plus thing, and it seemed good enough.

I think what might be nice would be to have another exporter, derived
from ox-texinfo, specifically for writing Emacs manuals, that helps
authors conform to the Emacs manual conventions. The way texinfo-plus
handles lists of keybindings/user options/etc is nice, and it appears to
set up the indexes for you, you only have to add concept index entries
manually.

Does that sound feasible? It would be great if this was available out of
the box.

Eric