From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nick Dokos Subject: Re: template for writing Emacs manuals in Org Date: Tue, 17 May 2016 14:56:33 -0400 Message-ID: <87futgikda.fsf@alphaville.usersys.redhat.com> References: <87eg955clk.fsf@ericabrahamsen.net> <87wpmt7u5i.fsf@gmx.us> <87r3d1u5yn.fsf@saiph.selenimh> <87eg91ten0.fsf@saiph.selenimh> <87a8jou24u.fsf@saiph.selenimh> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:46450) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2kAe-0008Cv-Gs for emacs-orgmode@gnu.org; Tue, 17 May 2016 14:56:45 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b2kAa-0001bE-EQ for emacs-orgmode@gnu.org; Tue, 17 May 2016 14:56:44 -0400 Received: from plane.gmane.org ([80.91.229.3]:44350) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2kAa-0001b2-7Y for emacs-orgmode@gnu.org; Tue, 17 May 2016 14:56:40 -0400 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1b2kAY-0006BE-Ru for emacs-orgmode@gnu.org; Tue, 17 May 2016 20:56:38 +0200 Received: from nat-pool-bos-t.redhat.com ([66.187.233.206]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 17 May 2016 20:56:38 +0200 Received: from ndokos by nat-pool-bos-t.redhat.com with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 17 May 2016 20:56:38 +0200 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: emacs-orgmode@gnu.org "Thomas S. Dye" writes: > Aloha Nicolas, > > Nicolas Goaziou writes: > >> "Thomas S. Dye" writes: >> >>> Nicolas Goaziou writes: >>>> >>>> Once the manual is up-to-date, we might consider moving it to doc/ in >>>> main distribution. >>> >>> IIRC, Bastien doesn't like this idea. >> >> Really? I admit I would be surprised. Do you recall why so, or do you >> have any reference about it? > > That is all I remember from three years ago, but it's not really > important. > > Looking ahead, the question is whether or not maintaining the > documentation in Org, rather than texinfo, is a possibility, and, if so, > what are the conditions under which that change will or will not happen? > > What are Bastien's expectations and preferences? > I believe the main obstacle is that the emacs policy requires a texinfo manual for all its component parts. If that can be generated automatically from the org document, then any objections probably disappear. Of course, Bastien might object to the extra effort required to do the conversion, but if the conversion is indeed completely automatic (or, perhaps more likely, a volunteer can be found to take care of the conversion and any problems that might arise), then he might be amenable to it. But it would be an extra step required at release time and would require some coordination. -- Nick