From mboxrd@z Thu Jan 1 00:00:00 1970 From: Glenn Morris Subject: Re: [RFC] Moving "manual.org" into core Date: Sat, 03 Mar 2018 14:48:51 -0500 Message-ID: References: <87bmhooaj9.fsf@nicolasgoaziou.fr> <87tvveqi7u.fsf@bzg.fr> <87wp0a57i5.fsf@nicolasgoaziou.fr> <87d121yhwf.fsf@bzg.fr> <874llxikm4.fsf@nicolasgoaziou.fr> <87zi3pcvid.fsf@bzg.fr> <87y3j9gzy5.fsf@nicolasgoaziou.fr> <87bmg5xic2.fsf@bzg.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:43836) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1esD9Q-0003v4-5G for emacs-orgmode@gnu.org; Sat, 03 Mar 2018 14:49:01 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1esD9P-0001mn-7Q for emacs-orgmode@gnu.org; Sat, 03 Mar 2018 14:49:00 -0500 In-Reply-To: <87bmg5xic2.fsf@bzg.fr> (Bastien Guerry's message of "Sat, 03 Mar 2018 16:57:33 +0100") 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: Bastien Guerry Cc: Achim Gratz , Org Mode List , Nicolas Goaziou I'm sure this is an impressive technical achievement, but can I urge you to raise this on emacs-devel first, because I think it's potentially problematic. I'm not entirely sure what you are proposing here. If the .org version will become the "preferred form" for modification, it would eg need to be in the Emacs repository (when the time comes), with suitable Makefile rules for generating the final products from it, and distributed correctly in releases. Emacs has got into trouble before in this area. Bastien Guerry wrote: > One of my worries was that moving toward editing a manual in .org > does not match GNU developers good practices and habits, which are > to edit .texi files. But as long as the .texi file exists I guess > we can shake the habits by allowing to edit .org files, which are > more convenient to read and write. Speaking for myself, I don't want to learn yet another markup syntax for one single Emacs manual. I find it unlikely that GNU projects will start requiring Emacs to build their documentation. Although the GNU coding standards do say: https://www.gnu.org/prep/standards/html_node/GNU-Manuals.html#GNU-Manuals Nowadays some other formats such as Docbook and Sgmltexi can be converted automatically into Texinfo. It is ok to produce the Texinfo documentation by conversion this way, as long as it gives good results. so there's no problem from that aspect. > But still: RMS recently raised the question on emacs-devel of > whether using .rst for the GNU documentation would be better, > so using .org for this purpose is not entirely hypothetical. On the subject of rst, I can only find a topic two years ago that went nowhere, and note in particular this: http://lists.gnu.org/archive/html/emacs-devel/2016-02/msg00667.html "We don't want to replace Texinfo as the source language" Maybe I'm worried about nothing, but I do suggest asking on emacs-devel.