From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: setting local variables Date: Fri, 04 Aug 2017 00:02:21 +0200 Message-ID: <87a83gl382.fsf@nicolasgoaziou.fr> References: <871sotiqld.fsf@ericabrahamsen.net> <87r2wsly88.fsf@nicolasgoaziou.fr> <877eykbpho.fsf@ericabrahamsen.net> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:55472) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ddOCU-0007f8-OU for emacs-orgmode@gnu.org; Thu, 03 Aug 2017 18:02:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ddOCR-0006Wm-1e for emacs-orgmode@gnu.org; Thu, 03 Aug 2017 18:02:38 -0400 Received: from relay3-d.mail.gandi.net ([217.70.183.195]:57328) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ddOCQ-0006SC-R6 for emacs-orgmode@gnu.org; Thu, 03 Aug 2017 18:02:34 -0400 In-Reply-To: <877eykbpho.fsf@ericabrahamsen.net> (Eric Abrahamsen's message of "Thu, 03 Aug 2017 09:11:31 -0700") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Eric Abrahamsen Cc: emacs-orgmode@gnu.org Eric Abrahamsen writes: > 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 "ox-texinfo" is (almost) able to write Emacs manuals. IMO, you are comparing oranges and apples. Org's manual is historically written as a (very convoluted) pure Texinfo document, with many macros and different authors. Trying to convert it to Org for an Org to Texinfo process is bound to be painful. OTOH, Magit's manual is probably more straightforward, i.e., written as an Org document from the beginning, with simpler requirements. In both cases, you cannot eschew learning a bit of Texinfo, if only for the various indices commands and the installation part in the Info directory. > 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. AFAIU, the way texinfo-plus handles lists of ... is certainly nice, but it's unrelated to Emacs manual conventions. It helps authors conform Magit's author conventions. Those are fine, but I'm pretty sure not all Emacs manuals follow them (Org doesn't, obviously). > Does that sound feasible? It would be great if this was available out of > the box. Even though such specialized back-ends are a good thing, I don't think Org needs another Texinfo back-end in core, however. "ox-texinfo.el" is really getting better. It is very versatile so it can bend to almost any convention. I won't pretend it makes learning Texinfo useless, though, because you need to learn it to write good manuals. The devil is in the details, and those are sometimes located at the Texinfo level. Regards,